fuchsia/bluetooth/metrics.yaml

# Copyright 2018 The Fuchsia Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

metric_definitions:

#####################################################################
# a2dp_codec_availability
#
# Log an event with a given codec event code if that codec is available
# on the remote peer when an A2DP connection is initiated.
#####################################################################
- id: 3
  metric_name: "a2dp_codec_availability"
  metric_type: EVENT_OCCURRED
  metric_dimensions:
    - dimension: "codec"
      event_codes: &a2dp_codec_dimension
        0: Unknown
        1: SBC
        2: MPEG12
        3: AAC
        4: ATRAC
        5: VendorSpecific
      max_event_code: 8
  reports:
    #####################################################################
    # a2dp_remote_codec_availability
    #
    # Generate a histogram where the buckets are bluetooth codecs and
    # the frequency is measured in terms of availability on the remote
    # peer when an A2DP connection is initiated
    #####################################################################
    - report_name: a2dp_codec_availability
      id: 125264903 # legacy long report_id
      report_type: SIMPLE_OCCURRENCE_COUNT
      local_privacy_noise_level: NONE
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"


#####################################################################
# pairing_method
#
# Log an event with the given pairing method event code whenever a
# pairing request is made by this device or its peer.
#####################################################################
- id: 4
  metric_name: "pairing_method"
  metric_type: EVENT_OCCURRED
  metric_dimensions:
    - dimension: "method"
      event_codes:
        0: Consent
        1: PasskeyDisplay
        2: PasskeyComparison
        3: PasskeyEntry
      max_event_code: 3
  reports:
    #####################################################################
    # pairing_frequency_by_method
    #
    # Generate a histogram where the buckets indicate the pairing method
    # used for a pairing request and the frequency is the count of
    # pairing requests initiated.
    #####################################################################
    - report_name: pairing_frequency_by_method
      id: 1812798440 # legacy long report_id
      report_type: SIMPLE_OCCURRENCE_COUNT
      local_privacy_noise_level: NONE
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"


#####################################################################
# pairing_result
#
# Log an event with a success or error result event code everytime a
# pairing request is completed.
#####################################################################
- id: 5
  metric_name: "pairing_result"
  metric_type: EVENT_OCCURRED
  metric_dimensions:
    - dimension: "result"
      event_codes:
        0: Success
        1: ErrorUnknown
        2: ErrorCanceled
        3: ErrorInProgress
        4: ErrorTimedOut
        5: ErrorNotFound
        6: ErrorNotSupported
        7: ErrorBluetoothNotAvailable
        8: ErrorBadState
        9: ErrorInvalidArguments
        10: ErrorAlready
        11: ErrorProtocolError
      max_event_code: 11
  reports:
    #####################################################################
    # pairing_result_frequency_by_result_reason
    #
    # Generate a histogram where the buckets indicate the pairing method
    # used for a pairing request and the frequency is the count of
    # pairing requests initiated.
    #####################################################################
    - report_name: pairing_result_frequency_by_result_reason
      id: 961937957 # legacy long report_id
      report_type: SIMPLE_OCCURRENCE_COUNT
      local_privacy_noise_level: NONE
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"


#####################################################################
# l2cap_open_channel
#
# Each time a new l2cap channel is created, an event is generated with
# the link layer type of channel specified and whether the reporting
# device is in the LL master role.
#####################################################################
- id: 6
  metric_name: "l2cap_open_channel"
  metric_type: EVENT_COUNT
  metric_dimensions:
    - dimension: "link_layer_type"
      event_codes:
        0: ACL
        1: LE
    - dimension: "initiator"
      event_codes:
        0: "True"
        1: "False"
  reports:
    - report_name: l2cap_open_channel_frequency_by_type
      id: 637549880 # legacy long report_id
      report_type: NUMERIC_AGGREGATION
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"


#####################################################################
# a2dp_remote_codec_availability
#
# Log an event with a given codec event code if that codec is available
# on the remote peer when an A2DP connection is initiated.
#####################################################################
- id: 7
  metric_name: "a2dp_remote_codec_availability"
  metric_type: EVENT_OCCURRED
  metric_dimensions:
    - dimension: "codec"
      event_codes: *a2dp_codec_dimension
      max_event_code: 8
  reports:
    #####################################################################
    # a2dp_remote_codec_availability
    #
    # Generate a histogram where the buckets are bluetooth codecs and
    # the frequency is measured in terms of availability on the remote
    # peer when an A2DP connection is initiated
    #####################################################################
    - report_name: a2dp_remote_codec_availability
      id: 1101478648 # legacy long report_id
      report_type: SIMPLE_OCCURRENCE_COUNT
      local_privacy_noise_level: NONE
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"

#####################################################################
# a2dp_stream_duration_in_seconds
#
# We log the number of seconds of audio streamed each time a stream
# ends, noting the audio codec used.
#####################################################################
- id: 8
  metric_name: "a2dp_stream_duration_in_seconds"
  metric_type: ELAPSED_TIME
  metric_dimensions:
    - dimension: "codec"
      event_codes: *a2dp_codec_dimension
  reports:
    #####################################################################
    # a2dp_total_number_of_seconds_streamed_per_device
    #
    # Statistical breakdown across the fleet of the number of seconds a
    # device was streaming A2DP audio during a day
    #####################################################################
    - report_name: a2dp_total_number_of_seconds_streamed_per_device
      report_type: PER_DEVICE_NUMERIC_STATS
      id: 1
      window_size:
        - 1
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]

    #####################################################################
    # a2dp_total_number_of_seconds_streamed_across_fleet
    #
    # Sum the total number of seconds of A2DP audio streamed across the
    # entire fleet of devices.
    #####################################################################
    - report_name: a2dp_total_number_of_seconds_streamed_across_fleet
      report_type: NUMERIC_AGGREGATION
      id: 2
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]

    #####################################################################
    # a2dp_stream_duration_in_seconds_per_connection
    #
    # Generate a histogram where the buckets are the length of A2DP audio
    # connections in seconds and the frequency is measured in terms of
    # all connections across all devices in the fleet.
    #####################################################################
    - report_name: a2dp_stream_duration_in_seconds_per_connection
      report_type: INT_RANGE_HISTOGRAM
      id: 3
      int_buckets:
        exponential:
          floor: 0
          num_buckets: 17 # 2^17 > 1 day in seconds
          initial_step: 1
          step_multiplier: 2
      system_profile_field: [BOARD_NAME, PRODUCT_NAME]
  meta_data:
    max_release_stage: GA
    expiration_date: "2020/01/31"