xref: /packages/modules/Wifi/service/proto/src/metrics.proto

/*
 * Copyright (C) 2016 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

syntax = "proto2";

package com_android_server_wifi;

option java_package = "com.android.server.wifi.proto";
option java_outer_classname = "WifiMetricsProto";

// The information about the Wifi events.
message WifiLog {
  reserved 122;

  // Session information that gets logged for every Wifi connection.
  repeated ConnectionEvent connection_event = 1;

  // Number of saved networks in the user profile.
  optional int32 num_saved_networks = 2;

  // Number of open networks in the saved networks.
  optional int32 num_open_networks = 3;

  // Number of legacy personal networks.
  optional int32 num_legacy_personal_networks = 4;

  // Number of legacy enterprise networks.
  optional int32 num_legacy_enterprise_networks = 5;

  // Does the user have location setting enabled.
  optional bool is_location_enabled = 6;

  // Does the user have scanning enabled.
  optional bool is_scanning_always_enabled = 7;

  // Number of times user toggled wifi using the settings menu.
  optional int32 num_wifi_toggled_via_settings = 8;

  // Number of times user toggled wifi using the airplane menu.
  optional int32 num_wifi_toggled_via_airplane = 9;

  // Number of networks added by the user.
  optional int32 num_networks_added_by_user = 10;

  // Number of networks added by applications.
  optional int32 num_networks_added_by_apps = 11;

  // Number scans that returned empty results.
  optional int32 num_empty_scan_results = 12;

  // Number scans that returned at least one result.
  optional int32 num_non_empty_scan_results = 13;

  // Number of single scans requests.
  optional int32 num_oneshot_scans = 14;

  // Number of repeated background scans that were scheduled to the chip.
  optional int32 num_background_scans = 15;

  // Error codes that a scan can result in.
  enum ScanReturnCode {

    // Return Code is unknown.
    SCAN_UNKNOWN = 0;

    // Scan was successful.
    SCAN_SUCCESS = 1;

    // Scan was successfully started, but was interrupted.
    SCAN_FAILURE_INTERRUPTED = 2;

    //  Scan failed to start because of invalid configuration
    //  (bad channel, etc).
    SCAN_FAILURE_INVALID_CONFIGURATION = 3;

    // Could not start a scan because wifi is disabled.
    FAILURE_WIFI_DISABLED = 4;

  }

  // Mapping of error codes to the number of times that scans resulted
  // in that error.
  repeated ScanReturnEntry scan_return_entries = 16;

  message ScanReturnEntry {

    // Return code of the scan.
    optional ScanReturnCode scan_return_code = 1;

    // Number of entries that were found in the scan.
    optional int32 scan_results_count = 2;
  }

  // State of the Wifi.
  enum WifiState {

    // State is unknown.
    WIFI_UNKNOWN = 0;

    // Wifi is disabled.
    WIFI_DISABLED = 1;

    // Wifi is enabled.
    WIFI_DISCONNECTED = 2;

    // Wifi is enabled and associated with an AP.
    WIFI_ASSOCIATED = 3;
  }

  // Mapping of system state to the number of times that scans were requested in
  // that state
  repeated WifiSystemStateEntry wifi_system_state_entries = 17;

  message WifiSystemStateEntry {

    // Current WiFi state.
    optional WifiState wifi_state = 1;

    // Count of scans in state.
    optional int32 wifi_state_count = 2;

    // Is screen on.
    optional bool is_screen_on = 3;
  }

  // Mapping of Error/Success codes to the number of background scans that resulted in it
  repeated ScanReturnEntry background_scan_return_entries = 18;

  // Mapping of system state to the number of times that Background scans were requested in that
  // state
  repeated WifiSystemStateEntry background_scan_request_state = 19;

  // Total number of times the Watchdog of Last Resort triggered, resetting the wifi stack
  optional int32 num_last_resort_watchdog_triggers = 20;

  // Total number of networks over bad association threshold when watchdog triggered
  optional int32 num_last_resort_watchdog_bad_association_networks_total = 21;

  // Total number of networks over bad authentication threshold when watchdog triggered
  optional int32 num_last_resort_watchdog_bad_authentication_networks_total = 22;

  // Total number of networks over bad dhcp threshold when watchdog triggered
  optional int32 num_last_resort_watchdog_bad_dhcp_networks_total = 23;

  // Total number of networks over bad other threshold when watchdog triggered
  optional int32 num_last_resort_watchdog_bad_other_networks_total = 24;

  // Total count of networks seen when watchdog triggered
  optional int32 num_last_resort_watchdog_available_networks_total = 25;

  // Total count of triggers with atleast one bad association network
  optional int32 num_last_resort_watchdog_triggers_with_bad_association = 26;

  // Total count of triggers with atleast one bad authentication network
  optional int32 num_last_resort_watchdog_triggers_with_bad_authentication = 27;

  // Total count of triggers with atleast one bad dhcp network
  optional int32 num_last_resort_watchdog_triggers_with_bad_dhcp = 28;

  // Total count of triggers with atleast one bad other network
  optional int32 num_last_resort_watchdog_triggers_with_bad_other = 29;

  // Count of times connectivity watchdog confirmed pno is working
  optional int32 num_connectivity_watchdog_pno_good = 30;

  // Count of times connectivity watchdog found pno not working
  optional int32 num_connectivity_watchdog_pno_bad = 31;

  // Count of times connectivity watchdog confirmed background scan is working
  optional int32 num_connectivity_watchdog_background_good = 32;

  // Count of times connectivity watchdog found background scan not working
  optional int32 num_connectivity_watchdog_background_bad = 33;

  // The time duration represented by this wifi log, from start to end of capture
  optional int32 record_duration_sec = 34;

  // Counts the occurrences of each individual RSSI poll level
  repeated RssiPollCount rssi_poll_rssi_count = 35;

  // Total number of times WiFi connected immediately after a Last Resort Watchdog trigger,
  // without new networks becoming available.
  optional int32 num_last_resort_watchdog_successes = 36;

  // Total number of saved hidden networks
  optional int32 num_hidden_networks = 37;

  // Total number of saved passpoint / hotspot 2.0 networks
  optional int32 num_passpoint_networks = 38;

  // Total number of scan results
  optional int32 num_total_scan_results = 39;

  // Total number of scan results for open networks
  optional int32 num_open_network_scan_results = 40;

  // Total number of scan results for legacy personal networks
  optional int32 num_legacy_personal_network_scan_results = 41;

  // Total number of scan results for legacy enterprise networks
  optional int32 num_legacy_enterprise_network_scan_results = 42;

  // Total number of scan results for hidden networks
  optional int32 num_hidden_network_scan_results = 43;

  // Total number of scan results for hotspot 2.0 r1 networks
  optional int32 num_hotspot2_r1_network_scan_results = 44;

  // Total number of scan results for hotspot 2.0 r2 networks
  optional int32 num_hotspot2_r2_network_scan_results = 45;

  // Total number of scans handled by framework (oneshot or otherwise)
  optional int32 num_scans = 46;

  // Counts the occurrences of each alert reason.
  repeated AlertReasonCount alert_reason_count = 47;

  // Counts the occurrences of each Wifi score
  repeated WifiScoreCount wifi_score_count = 48;

  // Histogram of Soft AP Durations
  repeated SoftApDurationBucket soft_ap_duration = 49;

  // Histogram of Soft AP ReturnCode
  repeated SoftApReturnCodeCount soft_ap_return_code = 50;

  // Histogram of the delta between scan result RSSI and RSSI polls
  repeated RssiPollCount rssi_poll_delta_count = 51;

  // List of events
  repeated StaEvent sta_event_list = 52;

  // Total number of times WiFi HAL crashed.
  optional int32 num_hal_crashes = 53;

  // Total number of times WiFicond crashed.
  optional int32 num_wificond_crashes = 54;

  // Indicates the number of times an error was encountered in
  // Wifi HAL on |WifiNative.setupInterfaceForClientMode|.
  optional int32 num_setup_client_interface_failure_due_to_hal = 55;

  // Indicates the number of times an error was encountered in
  // Wificond on |WifiNative.setupInterfaceForClientMode|.
  optional int32 num_setup_client_interface_failure_due_to_wificond = 56;

  // Wi-Fi Aware metrics
  optional WifiAwareLog wifi_aware_log = 57;

  // Number of saved Passpoint providers in user profile.
  optional int32 num_passpoint_providers = 58;

  // Count of times Passpoint provider being installed.
  optional int32 num_passpoint_provider_installation = 59;

  // Count of times Passpoint provivider is installed successfully.
  optional int32 num_passpoint_provider_install_success = 60;

  // Count of times Passpoint provider is being uninstalled.
  optional int32 num_passpoint_provider_uninstallation = 61;

  // Count of times Passpoint provider is uninstalled successfully.
  optional int32 num_passpoint_provider_uninstall_success = 62;

  // Count of saved Passpoint providers device has ever connected to.
  optional int32 num_passpoint_providers_successfully_connected = 63;

  // Histogram counting instances of scans with N many ScanResults with unique ssids
  repeated NumConnectableNetworksBucket total_ssids_in_scan_histogram = 64;

  // Histogram counting instances of scans with N many ScanResults/bssids
  repeated NumConnectableNetworksBucket total_bssids_in_scan_histogram = 65;

  // Histogram counting instances of scans with N many unique open ssids
  repeated NumConnectableNetworksBucket available_open_ssids_in_scan_histogram = 66;

  // Histogram counting instances of scans with N many bssids for open networks
  repeated NumConnectableNetworksBucket available_open_bssids_in_scan_histogram = 67;

  // Histogram counting instances of scans with N many unique ssids for saved networks
  repeated NumConnectableNetworksBucket available_saved_ssids_in_scan_histogram = 68;

  // Histogram counting instances of scans with N many bssids for saved networks
  repeated NumConnectableNetworksBucket available_saved_bssids_in_scan_histogram = 69;

  // Histogram counting instances of scans with N many unique SSIDs for open or saved networks
  repeated NumConnectableNetworksBucket available_open_or_saved_ssids_in_scan_histogram = 70;

  // Histogram counting instances of scans with N many BSSIDs for open or saved networks
  repeated NumConnectableNetworksBucket available_open_or_saved_bssids_in_scan_histogram = 71;

  // Histogram counting instances of scans with N many ScanResults matching unique saved passpoint providers
  repeated NumConnectableNetworksBucket available_saved_passpoint_provider_profiles_in_scan_histogram = 72;

  // Histogram counting instances of scans with N many ScanResults BSSIDs matching a saved passpoint provider
  repeated NumConnectableNetworksBucket available_saved_passpoint_provider_bssids_in_scan_histogram = 73;

  // Counts the number of AllSingleScanLister.onResult calls with a full band scan result
  optional int32 full_band_all_single_scan_listener_results = 74;

  // Counts the number of AllSingleScanLister.onResult calls with a partial (channels) scan result
  optional int32 partial_all_single_scan_listener_results = 75;

  // Pno scan metrics
  optional PnoScanMetrics pno_scan_metrics = 76;

  // Histogram of "Connect to Network" notifications.
  // The notification Action should be unset.
  repeated ConnectToNetworkNotificationAndActionCount connect_to_network_notification_count = 77;

  // Histogram of "Connect to Network" notification user actions.
  repeated ConnectToNetworkNotificationAndActionCount connect_to_network_notification_action_count = 78;

  // The number of SSIDs blocked from recommendation by the open network
  // notification recommender
  optional int32 open_network_recommender_blocklist_size = 79;

  // Is the available network notification feature turned on
  optional bool is_wifi_networks_available_notification_on = 80;

  // Count of recommendation updates made by the open network notification
  // recommender
  optional int32 num_open_network_recommendation_updates = 81;

  // Count of connection attempts that were initiated unsuccessfully
  optional int32 num_open_network_connect_message_failed_to_send = 82;

  // Histogram counting instances of scans with N many HotSpot 2.0 R1 APs
  repeated NumConnectableNetworksBucket observed_hotspot_r1_aps_in_scan_histogram = 83;

  // Histogram counting instances of scans with N many HotSpot 2.0 R2 APs
  repeated NumConnectableNetworksBucket observed_hotspot_r2_aps_in_scan_histogram = 84;

  // Histogram counting instances of scans with N many unique HotSpot 2.0 R1 ESS.
  // Where ESS is defined as the (HESSID, ANQP Domain ID), (SSID, ANQP Domain ID) or
  // (SSID, BSSID) tuple depending on AP configuration (in the above priority
  // order).
  repeated NumConnectableNetworksBucket observed_hotspot_r1_ess_in_scan_histogram = 85;

  // Histogram counting instances of scans with N many unique HotSpot 2.0 R2 ESS.
  // Where ESS is defined as the (HESSID, ANQP Domain ID), (SSID, ANQP Domain ID) or
  // (SSID, BSSID) tuple depending on AP configuration (in the above priority
  // order).
  repeated NumConnectableNetworksBucket observed_hotspot_r2_ess_in_scan_histogram = 86;

  // Histogram counting number of HotSpot 2.0 R1 APs per observed ESS in a scan
  // (one value added per unique ESS - potentially multiple counts per single
  // scan!)
  repeated NumConnectableNetworksBucket observed_hotspot_r1_aps_per_ess_in_scan_histogram = 87;

  // Histogram counting number of HotSpot 2.0 R2 APs per observed ESS in a scan
  // (one value added per unique ESS - potentially multiple counts per single
  // scan!)
  repeated NumConnectableNetworksBucket observed_hotspot_r2_aps_per_ess_in_scan_histogram = 88;

  // SoftAP event list tracking sessions and client counts in tethered mode
  repeated SoftApConnectedClientsEvent soft_ap_connected_clients_events_tethered = 89;

  // SoftAP event list tracking sessions and client counts in local only mode
  repeated SoftApConnectedClientsEvent soft_ap_connected_clients_events_local_only = 90;

  // WPS connection metrics - removed
  reserved 91;
  reserved "wps_metrics";

  // Wifi power statistics
  optional WifiPowerStats wifi_power_stats = 92;

  // Number of connectivity single scan requests.
  optional int32 num_connectivity_oneshot_scans = 93;

  // WifiWake statistics
  optional WifiWakeStats wifi_wake_stats = 94;

  // Histogram counting instances of scans with N many 802.11mc (RTT) supporting APs
  repeated NumConnectableNetworksBucket observed_80211mc_supporting_aps_in_scan_histogram = 95;

  // Total number of times supplicant crashed.
  optional int32 num_supplicant_crashes = 96;

  // Total number of times hostapd crashed.
  optional int32 num_hostapd_crashes = 97;

  // Indicates the number of times an error was encountered in
  // supplicant on |WifiNative.setupInterfaceForClientMode|.
  optional int32 num_setup_client_interface_failure_due_to_supplicant = 98;

  // Indicates the number of times an error was encountered in
  // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|.
  optional int32 num_setup_soft_ap_interface_failure_due_to_hal = 99;

  // Indicates the number of times an error was encountered in
  // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|.
  optional int32 num_setup_soft_ap_interface_failure_due_to_wificond = 100;

  // Indicates the number of times an error was encountered in
  // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|.
  optional int32 num_setup_soft_ap_interface_failure_due_to_hostapd = 101;

  // Indicates the number of times we got an interface down in client mode.
  optional int32 num_client_interface_down = 102;

  // Indicates the number of times we got an interface down in softap mode.
  optional int32 num_soft_ap_interface_down = 103;

  // Indicates the number of scan requests from external apps.
  optional int32 num_external_app_oneshot_scan_requests = 104;

  // Indicates the number of times a scan request from an external foreground app was throttled.
  optional int32 num_external_foreground_app_oneshot_scan_requests_throttled = 105;

  // Indicates the number of times a scan request from an external background app was throttled.
  optional int32 num_external_background_app_oneshot_scan_requests_throttled = 106;

  // WifiLastResortWatchdog time milliseconds delta between trigger and first connection success
  optional int64 watchdog_trigger_to_connection_success_duration_ms = 107 [default = -1];

  // The number of times wifi experienced failures after watchdog has already been triggered and is
  // waiting for a connection success
  optional int64 watchdog_total_connection_failure_count_after_trigger = 108;

  // Number of times DFS channel scans are requested in single scan requests.
  optional int32 num_oneshot_has_dfs_channel_scans = 109;

  // Wi-Fi RTT metrics
  optional WifiRttLog wifi_rtt_log = 110;

  // Flag which indicates if Connected MAC Randomization is enabled
  optional bool is_mac_randomization_on = 111 [default = false];

  // Number of radio mode changes to MCC (Multi channel concurrency).
  optional int32 num_radio_mode_change_to_mcc = 112;

  // Number of radio mode changes to SCC (Single channel concurrency).
  optional int32 num_radio_mode_change_to_scc = 113;

  // Number of radio mode changes to SBS (Single band simultaneous).
  optional int32 num_radio_mode_change_to_sbs = 114;

  // Number of radio mode changes to DBS (Dual band simultaneous).
  optional int32 num_radio_mode_change_to_dbs = 115;

  // Number of times the firmware picked a SoftAp channel not satisfying user band preference.
  optional int32 num_soft_ap_user_band_preference_unsatisfied = 116;

  // Identifier for experimental scoring parameter settings.
  optional string score_experiment_id = 117;

  // Data on wifi radio usage
  optional WifiRadioUsage wifi_radio_usage = 118;

  // Stores settings values used for metrics testing.
  optional ExperimentValues experiment_values = 119;

  // List of WifiIsUnusableEvents which get logged when we notice that WiFi is unusable.
  // Collected only when WIFI_IS_UNUSABLE_EVENT_METRICS_ENABLED Settings is enabled.
  repeated WifiIsUnusableEvent wifi_is_unusable_event_list = 120;

  // Counts the occurrences of each link speed (Mbps) level
  // with rssi (dBm) and rssi^2 sums (dBm^2)
  repeated LinkSpeedCount link_speed_counts = 121;

  // Hardware revision (EVT, DVT, PVT etc.)
  optional string hardware_revision = 124;

  // Total wifi link layer usage data over the logging duration in ms.
  optional WifiLinkLayerUsageStats wifi_link_layer_usage_stats = 125;

  // Multiple lists of timestamped link layer stats with labels to represent whether wifi is usable
  repeated WifiUsabilityStats wifi_usability_stats_list = 126;

  // Counts the occurrences of each Wifi usability score provided by external app
  repeated WifiUsabilityScoreCount wifi_usability_score_count = 127;

  // List of PNO scan stats, one element for each mobility state
  repeated DeviceMobilityStatePnoScanStats mobility_state_pno_stats_list = 128;

  // Wifi p2p statistics
  optional WifiP2pStats wifi_p2p_stats = 129;

  // Easy Connect (DPP) metrics
  optional WifiDppLog wifi_dpp_log = 130;

  // Number of Enhanced Open (OWE) networks in the saved networks.
  optional int32 num_enhanced_open_networks = 131;

  // Number of WPA3-Personal networks.
  optional int32 num_wpa3_personal_networks = 132;

  // Number of WPA3-Enterprise networks.
  optional int32 num_wpa3_enterprise_networks = 133;

  // Total number of scan results for Enhanced open networks
  optional int32 num_enhanced_open_network_scan_results = 134;

  // Total number of scan results for WPA3-Personal networks
  optional int32 num_wpa3_personal_network_scan_results = 135;

  // Total number of scan results for WPA3-Enterprise networks
  optional int32 num_wpa3_enterprise_network_scan_results = 136;

  // WifiConfigStore read/write metrics.
  optional WifiConfigStoreIO wifi_config_store_io = 137;

  // Total number of saved networks with mac randomization enabled.
  optional int32 num_saved_networks_with_mac_randomization = 138;

  // Link Probe metrics
  optional LinkProbeStats link_probe_stats = 139;

  // List of NetworkSelectionExperimentDecisions stats for each experiment
  repeated NetworkSelectionExperimentDecisions network_selection_experiment_decisions_list = 140;

  // Network Request API surface metrics.
  optional WifiNetworkRequestApiLog wifi_network_request_api_log = 141;

  // Network Suggestion API surface metrics.
  optional WifiNetworkSuggestionApiLog wifi_network_suggestion_api_log = 142;

  // WifiLock statistics
  optional WifiLockStats wifi_lock_stats = 143;

  // Stats on number of times Wi-Fi is turned on/off though the WifiManager#setWifiEnabled API
  optional WifiToggleStats wifi_toggle_stats = 144;

  // Number of times WifiManager#addOrUpdateNetwork is called.
  optional int32 num_add_or_update_network_calls = 145;

  // Number of times WifiManager#enableNetwork is called.
  optional int32 num_enable_network_calls = 146;

  // Passpoint provison metrics
  optional PasspointProvisionStats passpoint_provision_stats = 147;

  // Histogram of the EAP method type of all installed Passpoint profiles for R1
  repeated PasspointProfileTypeCount installed_passpoint_profile_type_for_r1 = 123;

  // Histogram of the EAP method type of all installed Passpoint profiles for R2
  repeated PasspointProfileTypeCount installed_passpoint_profile_type_for_r2 = 148;

  // Histogram of Tx link speed at 2G
  repeated Int32Count tx_link_speed_count_2g = 149;

  // Histogram of Tx link speed at 5G low band
  repeated Int32Count tx_link_speed_count_5g_low = 150;

  // Histogram of Tx link speed at 5G middle band
  repeated Int32Count tx_link_speed_count_5g_mid = 151;

  // Histogram of Tx link speed at 5G high band
  repeated Int32Count tx_link_speed_count_5g_high = 152;

  // Histogram of Rx link speed at 2G
  repeated Int32Count rx_link_speed_count_2g = 153;

  // Histogram of Rx link speed at 5G low band
  repeated Int32Count rx_link_speed_count_5g_low = 154;

  // Histogram of Rx link speed at 5G middle band
  repeated Int32Count rx_link_speed_count_5g_mid = 155;

  // Histogram of Rx link speed at 5G high band
  repeated Int32Count rx_link_speed_count_5g_high = 156;

  // Count of IP renewal failures.
  optional int32 num_ip_renewal_failure = 157;

  // Metrics collected by health monitor
  optional HealthMonitorMetrics health_monitor_metrics = 158;

  // Metrics related to the WifiBlocklistMonitor
  optional BssidBlocklistStats bssid_blocklist_stats = 159;

  // Connection duration under various health conditions
  optional ConnectionDurationStats connection_duration_stats = 160;

  // Number of WAPI-Personal saved networks.
  optional int32 num_wapi_personal_networks = 161;

  // Number of WAPI-Enterprise saved networks.
  optional int32 num_wapi_enterprise_networks = 162;

  // Total number of scan results for WAPI-Personal networks
  optional int32 num_wapi_personal_network_scan_results = 163;

  // Total number of scan results for WAPI-Enterprise networks
  optional int32 num_wapi_enterprise_network_scan_results = 164;

  // Is the external WiFi connected network scorer from OEM extension module turned on
  optional bool is_external_wifi_scorer_on = 165 [default = false];

  // Metrics related to Wi-Fi off
  optional WifiOffMetrics wifi_off_metrics = 166;

  // Total number of scan results for MBO supported networks
  optional int32 num_mbo_supported_network_scan_results = 167;

  // Total number of scan results for MBO cellular data aware networks
  optional int32 num_mbo_cellular_data_aware_network_scan_results = 168;

  // Total number of scan results for OCE supported networks
  optional int32 num_oce_supported_network_scan_results = 169;

  // Total number of scan results for FILS supported networks
  optional int32 num_fils_supported_network_scan_results = 170;

  // Total number of bssids filtered from network selection due to mbo association
  // disallowed indication
  optional int32 num_bssid_filtered_due_to_mbo_assoc_disallow_ind = 171;

  // Total number of connection to network supporting MBO
  optional int32 num_connect_to_network_supporting_mbo = 172;

  // Total number of connection to network supporting OCE
  optional int32 num_connect_to_network_supporting_oce = 173;

  // Total number of scans triggered due to steering request from AP
  optional int32 num_force_scan_due_to_steering_request = 174;

  // Total number of cellular switch requests from MBO supported AP
  optional int32 num_mbo_cellular_switch_request = 175;

  // Total number of connect request to AP adding FILS AKM
  optional int32 num_connect_request_with_fils_akm = 176;

  // Total number of successful L2 connection through FILS authentication
  optional int32 num_l2_connection_through_fils_authentication = 177;

  // Metrics related to limitation in soft ap config
  optional SoftApConfigLimitationMetrics soft_ap_config_limitation_metrics = 178;

  // WiFi channel utilization histogram of various RF bands
  optional ChannelUtilizationHistogram channel_utilization_histogram = 179;

  // WiFi Tx and Rx throughput histogram at various RF bands
  optional ThroughputMbpsHistogram throughput_mbps_histogram = 180;

  // Total number of steering requests which include MBO assoc retry delay
  optional int32 num_steering_request_including_mbo_assoc_retry_delay = 181;

  // Total number of scan results from 11ax network
  optional int32 num_11ax_network_scan_results = 182;

  // Total number of scan results from 6GHz band
  optional int32 num_6g_network_scan_results = 183;

  // Initial partial scan stats
  optional InitPartialScanStats init_partial_scan_stats = 184;

  // Total number of scan results for hotspot 2.0 r3 networks
  optional int32 num_hotspot2_r3_network_scan_results = 185;

  // Histogram counting instances of scans with N many HotSpot 2.0 R3 APs
  repeated NumConnectableNetworksBucket observed_hotspot_r3_aps_in_scan_histogram = 186;

  // Histogram counting number of HotSpot 2.0 R3 APs per observed ESS in a scan
  // (one value added per unique ESS - potentially multiple counts per single
  // scan!)
  repeated NumConnectableNetworksBucket observed_hotspot_r3_aps_per_ess_in_scan_histogram = 187;

  // Histogram counting instances of scans with N many unique HotSpot 2.0 R3 ESS.
  // Where ESS is defined as the (HESSID, ANQP Domain ID), (SSID, ANQP Domain ID) or
  // (SSID, BSSID) tuple depending on AP configuration (in the above priority
  // order).
  repeated NumConnectableNetworksBucket observed_hotspot_r3_ess_in_scan_histogram = 188;

  // Total number of Passpoint providers with no Root CA in their profile.
  optional int32 num_passpoint_provider_with_no_root_ca = 189;

  // Total number of Passpoint providers with self-signed root CA in their profile.
  optional int32 num_passpoint_provider_with_self_signed_root_ca = 190;

  // Total number of Passpoint providers with subscription expiration date in their profile.
  optional int32 num_passpoint_provider_with_subscription_expiration = 191;

  // List of user initiated actions
  repeated UserActionEvent user_action_events = 192;

  // Does the user have wifi verbose logging enabled.
  optional bool is_verbose_logging_enabled = 193;

  // Does the user have enhanced MAC randomization forced to on.
  optional bool is_enhanced_mac_randomization_force_enabled = 194;

  // Metered stats for saved networks.
  optional MeteredNetworkStats metered_network_stats_saved = 195;

  // Metered stats for suggestion networks.
  optional MeteredNetworkStats metered_network_stats_suggestion = 196;

  // Does the user have wifi wake enabled.
  optional bool is_wifi_wake_enabled = 197;

  // User reaction to the carrier or suggestion app approval UI.
  optional UserReactionToApprovalUiEvent user_reaction_to_approval_ui_event = 198;

  // Number of connection with different BSSID between framework and firmware selection.
  optional int32 num_bssid_different_selection_between_framework_and_firmware = 199;

  // Metrics about carrier wifi network.
  optional CarrierWifiMetrics carrier_wifi_metrics = 200;

  // Long version code of wifi mainline module, 0 means not available.
  optional int64 mainline_module_version = 201;

  // Histogram of Tx link speed at 6G low band
  repeated Int32Count tx_link_speed_count_6g_low = 202;

  // Histogram of Tx link speed at 6G middle band
  repeated Int32Count tx_link_speed_count_6g_mid = 203;

  // Histogram of Tx link speed at 6G high band
  repeated Int32Count tx_link_speed_count_6g_high = 204;

  // Histogram of Rx link speed at 6G low band
  repeated Int32Count rx_link_speed_count_6g_low = 205;

  // Histogram of Rx link speed at 6G middle band
  repeated Int32Count rx_link_speed_count_6g_mid = 206;

  // Histogram of Rx link speed at 6G high band
  repeated Int32Count rx_link_speed_count_6g_high = 207;

  // Metrics about the first connection after boot.
  optional FirstConnectAfterBootStats first_connect_after_boot_stats = 208;

  // Metrics for Wifi to Wifi switches.
  optional WifiToWifiSwitchStats wifi_to_wifi_switch_stats = 209;

  // Bandwidth estimator stats.
  optional BandwidthEstimatorStats bandwidth_estimator_stats = 210;

  // Total number of scan results from 6GHz PSC band
  optional int32 num_6g_psc_network_scan_results = 211;

  // Total number of Passpoint connections with a venue URL
  optional int32 total_number_of_passpoint_connections_with_venue_url = 212;

  // Total number of Passpoint connections with a T&C URL
  optional int32 total_number_of_passpoint_connections_with_terms_and_conditions_url = 213;

  // Total number of user accepted and T&C process completed successfully
  optional int32 total_number_of_passpoint_acceptance_of_terms_and_conditions = 214;

  // Total number of Passpoint profiles with decorated identity prefix
  optional int32 total_number_of_passpoint_profiles_with_decorated_identity = 215;

  // Scope of Passpoint deauth-imminent notification: ESS or BSS
  repeated Int32Count passpoint_deauth_imminent_scope = 216;

  // Total number of steering requests from AP
  optional int32 num_steering_request = 217;

  // Histogram corresponding to the number of times recent connection failure status are reported
  // per WifiConfiguration.RecentFailureReason
  repeated Int32Count recent_failure_association_status = 218;

  // Histogram of country codes observed from scan results.
  // Bucket WifiMetrics.COUNTRY_CODE_CONFLICT_WIFI_SCAN for the code conflict within scan results.
  // Bucket WifiMetrics.COUNTRY_CODE_CONFLICT_WIFI_SCAN_TELEPHONY for the code conflict between wifi
  // and telephony.
  // Bucket value is capped to WifiMetrics.MAX_COUNTRY_CODE_COUNT.
  repeated Int32Count country_code_scan_histogram = 219;
}

// Information that gets logged for every WiFi connection.
message RouterFingerPrint {

  enum RoamType {

    // Type is unknown.
    ROAM_TYPE_UNKNOWN = 0;

    // No roaming - usually happens on a single band (2.4 GHz) router.
    ROAM_TYPE_NONE = 1;

    // Enterprise router.
    ROAM_TYPE_ENTERPRISE = 2;

    // DBDC => Dual Band Dual Concurrent essentially a router that
    // supports both 2.4 GHz and 5 GHz bands.
    ROAM_TYPE_DBDC = 3;
  }

  enum Auth {

    // Auth is unknown.
    AUTH_UNKNOWN = 0;

    // No authentication.
    AUTH_OPEN = 1;

    // If the router uses a personal authentication.
    AUTH_PERSONAL = 2;

    // If the router is setup for enterprise authentication.
    AUTH_ENTERPRISE = 3;
  }

  enum RouterTechnology {

    // Router is unknown.
    ROUTER_TECH_UNKNOWN = 0;

    // Router Channel A.
    ROUTER_TECH_A = 1;

    // Router Channel B.
    ROUTER_TECH_B = 2;

    // Router Channel G.
    ROUTER_TECH_G = 3;

    // Router Channel N.
    ROUTER_TECH_N = 4;

    // Router Channel AC.
    ROUTER_TECH_AC = 5;

    // When the channel is not one of the above.
    ROUTER_TECH_OTHER = 6;

    // Router Channel AX.
    ROUTER_TECH_AX = 7;
  }

  enum EapMethod {

    // No EAP method used
    TYPE_EAP_UNKNOWN = 0;

    // EAP with Transport Layer Security
    TYPE_EAP_TLS = 1;

    // EAP with Tunneled Transport Layer Security
    TYPE_EAP_TTLS = 2;

    // EAP with Subscriber Identity Module [RFC-4186]
    TYPE_EAP_SIM = 3;

    // EAP with Authentication and Key Agreement [RFC-4187]
    TYPE_EAP_AKA = 4;

    // EAP with Authentication and Key Agreement Prime [RFC-5448]
    TYPE_EAP_AKA_PRIME = 5;

    // Protected EAP
    TYPE_EAP_PEAP = 6;

    // EAP for Hotspot 2.0 r2 OSEN
    TYPE_EAP_UNAUTH_TLS = 7;

    // EAP with Password
    TYPE_EAP_PWD = 8;

    // EAP with WAPI certifcate
    TYPE_EAP_WAPI_CERT = 9;
  }

  enum AuthPhase2Method {

    // No phase2 method
    TYPE_PHASE2_NONE = 0;

    // Password Authentication Protocol
    TYPE_PHASE2_PAP = 1;

    // Microsoft Challenge Handshake Authentication Protocol
    TYPE_PHASE2_MSCHAP = 2;

    // Microsoft Challenge Handshake Authentication Protocol v2
    TYPE_PHASE2_MSCHAPV2 = 3;

    // Generic Token Card
    TYPE_PHASE2_GTC = 4;

    // EAP-Subscriber Identity Module [RFC-4186]
    TYPE_PHASE2_SIM = 5;

    // EAP-Authentication and Key Agreement [RFC-4187]
    TYPE_PHASE2_AKA = 6;

    // EAP-Authentication and Key Agreement Prime [RFC-5448]
    TYPE_PHASE2_AKA_PRIME = 7;
  }

  enum OcspType {
    // Do not use OCSP stapling
    TYPE_OCSP_NONE = 0;

    // Try to use OCSP stapling, but not require response
    TYPE_OCSP_REQUEST_CERT_STATUS = 1;

    // Require valid OCSP stapling response
    TYPE_OCSP_REQUIRE_CERT_STATUS = 2;

    // Require valid OCSP stapling response for all not-trusted certificates
    // in the server certificate chain
    TYPE_OCSP_REQUIRE_ALL_NON_TRUSTED_CERTS_STATUS = 3;
  }

  optional RoamType roam_type = 1;

  // Channel on which the connection takes place.
  optional int32 channel_info = 2;

  // DTIM setting of the router.
  optional int32 dtim = 3;

  // Authentication scheme of the router.
  optional Auth authentication = 4;

  // If the router is hidden.
  optional bool hidden = 5;

  // Channel information.
  optional RouterTechnology router_technology = 6;

  // whether ipv6 is supported.
  optional bool supports_ipv6 = 7;

  // If the router is a Passpoint / Hotspot 2.0 network
  optional bool passpoint = 8;

  // EAP method used by the enterprise network
  optional EapMethod eap_method = 9;

  // Phase 2 authentication method after setting up a secure channel
  optional AuthPhase2Method auth_phase2_method = 10;

  // Online certificate status protocol stapling type
  optional OcspType ocsp_type = 11;

  // PMK caching enablement
  optional bool pmk_cache_enabled = 12;

  // Max Tx link speed (in Mbps) supported by current network (STA and AP)
  optional int32 max_supported_tx_link_speed_mbps = 13;

  // Max Rx link speed (in Mbps) supported by current network (STA and AP)
  optional int32 max_supported_rx_link_speed_mbps = 14;

  // If the Passpoint connection is provided by the Home provider or Roaming/visited network
  optional bool is_passpoint_home_provider = 15;
}

enum ClientRole {
  // default/Invalid role
  ROLE_UNKNOWN = 0;

  // STA created for scans only.
  ROLE_CLIENT_SCAN_ONLY = 1;

  // secondary STA used for make before break.
  ROLE_CLIENT_SECONDARY_TRANSIENT = 2;

  // secondary STA created for local connection (no internet connectivity).
  ROLE_CLIENT_LOCAL_ONLY = 3;

  // primary STA.
  ROLE_CLIENT_PRIMARY = 4;

  // Long lived secondary STA used for restricted use cases
  ROLE_CLIENT_SECONDARY_LONG_LIVED = 5;
}

message ConnectionEvent {

  // Roam Type.
  enum RoamType {

    // Type is unknown.
    ROAM_UNKNOWN = 0;

    // No roaming.
    ROAM_NONE = 1;

    // DBDC roaming.
    ROAM_DBDC = 2;

    // Enterprise roaming.
    ROAM_ENTERPRISE = 3;

    // User selected roaming.
    ROAM_USER_SELECTED = 4;

    // Unrelated.
    ROAM_UNRELATED = 5;
  }

  // Connectivity Level Failure.
  enum ConnectivityLevelFailure {

    // Failure is unknown.
    HLF_UNKNOWN = 0;

    // No failure.
    HLF_NONE = 1;

    // DHCP failure.
    HLF_DHCP = 2;

    // No internet connection.
    HLF_NO_INTERNET = 3;

    // No internet connection.
    HLF_UNWANTED = 4;
  }

  // Level 2 failure reason.
  enum Level2FailureReason {

    // Unknown default
    FAILURE_REASON_UNKNOWN = 0;

    // The reason code if there is no error during authentication. It could
    // also imply that there no authentication in progress.
    AUTH_FAILURE_NONE = 1;

    // The reason code if there was a timeout authenticating.
    AUTH_FAILURE_TIMEOUT = 2;

    // The reason code if there was a wrong password while authenticating.
    AUTH_FAILURE_WRONG_PSWD = 3;

    // The reason code if there was EAP failure while authenticating.
    AUTH_FAILURE_EAP_FAILURE = 4;

    // The reason code if the AP can no longer accept new clients.
    ASSOCIATION_REJECTION_AP_UNABLE_TO_HANDLE_NEW_STA = 5;

    // The reason code if AP disconnects STA during the connecting state.
    DISCONNECTION_NON_LOCAL = 6;

    // The reason code if a user rejects this connection.
    AUTH_FAILURE_REJECTED_BY_USER = 7;

    // The reason code if an insecure Enterprise connection requires user's approval
    DISCONNECTED_USER_APPROVAL_NEEDED = 8;
  }

  // Entity that recommended connecting to this network.
  enum ConnectionNominator {
    // Unknown nominator
    NOMINATOR_UNKNOWN = 0;

    // User selected network manually
    NOMINATOR_MANUAL = 1;

    // Saved network
    NOMINATOR_SAVED = 2;

    // Suggestion API
    NOMINATOR_SUGGESTION = 3;

    // Passpoint
    NOMINATOR_PASSPOINT = 4;

    // Carrier suggestion
    NOMINATOR_CARRIER = 5;

    // External scorer
    NOMINATOR_EXTERNAL_SCORED = 6;

    // Network Specifier
    NOMINATOR_SPECIFIER = 7;

    // User connected choice override
    NOMINATOR_SAVED_USER_CONNECT_CHOICE = 8;

    // Open Network Available Pop-up
    NOMINATOR_OPEN_NETWORK_AVAILABLE = 9;
  }

  enum NetworkType {
    // Unknown network type
    TYPE_UNKNOWN = 0;

    // WPA2 network
    TYPE_WPA2 = 1;

    // WPA3 network
    TYPE_WPA3 = 2;

    // Passpoint network
    TYPE_PASSPOINT = 3;

    // EAP network, excluding passpoint
    TYPE_EAP = 4;

    // OWE network
    TYPE_OWE = 5;

    // Open network
    TYPE_OPEN = 6;

    // WAPI network
    TYPE_WAPI = 7;
  }

  enum NetworkCreator {
    // This network is created by an unknown app.
    CREATOR_UNKNOWN = 0;

    // This network is created by the user.
    CREATOR_USER = 1;

    // This network is created by a carrier app.
    CREATOR_CARRIER = 2;
  }

  // Start time of the connection, in milliseconds since Unix epoch (1970-01-01).
  optional int64 start_time_millis = 1 [deprecated=true]; // [(datapol.semantic_type) = ST_TIMESTAMP];

  // Start time of the connection, in milliseconds since device boot
  optional int64 start_time_since_boot_millis = 28 [default = 0];

  // Duration to connect.
  optional int32 duration_taken_to_connect_millis = 2;

  // Router information.
  optional RouterFingerPrint router_fingerprint = 3;

  // RSSI at the start of the connection.
  optional int32 signal_strength = 4;

  // Roam Type.
  optional RoamType roam_type = 5;

  // Result of the connection.
  optional int32 connection_result = 6;

  // Reasons for level 2 failure (needs to be coordinated with wpa-supplicant).
  optional int32 level_2_failure_code = 7;

  // Failures that happen at the connectivity layer.
  optional ConnectivityLevelFailure connectivity_level_failure_code = 8;

  // Has bug report been taken.
  optional bool automatic_bug_report_taken = 9;

  // Connection is using locally generated random MAC address.
  optional bool use_randomized_mac = 10 [default = false];

  // Who chose to connect.
  optional ConnectionNominator connection_nominator = 11;

  // The currently running network selector when this connection event occurred.
  optional int32 network_selector_experiment_id = 12;

  // Breakdown of level_2_failure_code with more detailed reason.
  optional Level2FailureReason level_2_failure_reason = 13
          [default = FAILURE_REASON_UNKNOWN];

  // Connection is using an aggressively generated random MAC address.
  optional bool use_aggressive_mac = 14;

  // Number of BSSIDs for this network that were excluded from network selection.
  optional int32 num_bssid_in_blocklist = 15;

  // The type of network for this connection.
  optional NetworkType network_type = 16;

  // UID of the app that created this network.
  optional NetworkCreator network_creator = 17;

  // Whether the screen is on when the connection event starts
  optional bool screen_on = 18;

  // Number of consecutive connection failures with the same SSID at high RSSI
  // before current connection event. Any connection failure at low RSSI in the
  // middle won't break the streak count. The count is cleared after
  // a network disconnection event.
  optional int32 num_consecutive_connection_failure = 19 [default = -1];

  // Indicates if the profile used for the connection was provisioned by Passpoint OSU server
  optional bool is_osu_provisioned = 20;

  // The wireless interface name e.g. "wlan0", "wlan1". Used to distinguish which event stream this
  // ConnectionEvent belongs to when multiple interfaces are active concurrently.
  optional string interface_name = 27;

  // The role of the wireless interface at the start of the connection.
  // Gives more information on what purpose this interface is used for.
  optional ClientRole interface_role = 29;

  // Indicates if the profile used for the connection is carrier merged.
  optional bool is_carrier_merged = 30;

  // Indicates if this was the first connection event after boot
  optional bool is_first_connection_after_boot = 31;
}

// Number of occurrences of a specific RSSI poll rssi value
message RssiPollCount {
  // RSSI
  optional int32 rssi = 1;

  // Number of RSSI polls with 'rssi'
  optional int32 count = 2;

  // Beacon frequency of the channel in MHz
  optional int32 frequency = 3;
}

// Number of occurrences of a specific alert reason value
message AlertReasonCount {
  // Alert reason
  optional int32 reason = 1;

  // Number of alerts with |reason|.
  optional int32 count = 2;
}

// Counts the number of instances of a specific Wifi Score calculated by WifiScoreReport
message WifiScoreCount {
  // Wifi Score
  optional int32 score = 1;

  // Number of Wifi score reports with this score
  optional int32 count = 2;
}

// Counts the number of instances of a specific Wifi Usability Score
message WifiUsabilityScoreCount {
  // Wifi Usability Score
  optional int32 score = 1;

  // Number of Wifi score reports with this score
  optional int32 count = 2;
}

// Number of occurrences of a specific link speed (Mbps)
// and sum of rssi (dBm) and rssi^2 (dBm^2)
message LinkSpeedCount {
  // Link speed (Mbps)
  optional int32 link_speed_mbps = 1;

  // Number of RSSI polls with link_speed
  optional int32 count = 2;

  // Sum of absolute values of rssi values (dBm)
  optional int32 rssi_sum_dbm = 3;

  // Sum of squares of rssi values (dBm^2)
  optional int64 rssi_sum_of_squares_dbm_sq = 4;
}


// Number of occurrences of Soft AP session durations
message SoftApDurationBucket {
  // Bucket covers duration : [duration_sec, duration_sec + bucket_size_sec)
  // The (inclusive) lower bound of Soft AP session duration represented by this bucket
  optional int32 duration_sec = 1;

  // The size of this bucket
  optional int32 bucket_size_sec = 2;

  // Number of soft AP session durations that fit into this bucket
  optional int32 count = 3;
}

// Number of occurrences of a soft AP session return code
message SoftApReturnCodeCount {

  enum SoftApStartResult {

    // SoftApManager return code unknown
    SOFT_AP_RETURN_CODE_UNKNOWN = 0;

    // SoftAp started successfully
    SOFT_AP_STARTED_SUCCESSFULLY = 1;

    // Catch all for failures with no specific failure reason
    SOFT_AP_FAILED_GENERAL_ERROR = 2;

    // SoftAp failed to start due to NO_CHANNEL error
    SOFT_AP_FAILED_NO_CHANNEL = 3;

    // SoftAp failed to start due to unsupported configuration error
    SOFT_AP_FAILED_UNSUPPORTED_CONFIGURATION = 4;
  }

  // Historical, no longer used for writing as of 01/2017.
  optional int32 return_code = 1 [deprecated = true];

  // Occurrences of this soft AP return code
  optional int32 count = 2;

  // Result of attempt to start SoftAp
  optional SoftApStartResult start_result = 3;
}

message StaEvent {
  message ConfigInfo {
    // The set of key management protocols supported by this configuration.
    optional uint32 allowed_key_management = 1 [default = 0];

    // The set of security protocols supported by this configuration.
    optional uint32 allowed_protocols = 2 [default = 0];

    // The set of authentication protocols supported by this configuration.
    optional uint32 allowed_auth_algorithms = 3 [default = 0];

    // The set of pairwise ciphers for WPA supported by this configuration.
    optional uint32 allowed_pairwise_ciphers = 4 [default = 0];

    // The set of group ciphers supported by this configuration.
    optional uint32 allowed_group_ciphers = 5;

    // Is this a 'hidden network'
    optional bool hidden_ssid = 6;

    // Is this a Hotspot 2.0 / passpoint network
    optional bool is_passpoint = 7;

    // Is this an 'ephemeral' network (Not in saved network list, recommended externally)
    optional bool is_ephemeral = 8;

    // Has a successful connection ever been established using this WifiConfiguration
    optional bool has_ever_connected = 9;

    // RSSI of the scan result candidate associated with this WifiConfiguration
    optional int32 scan_rssi = 10 [default = -127];

    // Frequency of the scan result candidate associated with this WifiConfiguration
    optional int32 scan_freq = 11 [default = -1];
  }

  enum EventType {
    // Default/Invalid event
    TYPE_UNKNOWN = 0;

    // Supplicant Association Rejection event. Code contains the 802.11
    TYPE_ASSOCIATION_REJECTION_EVENT = 1;

    // Supplicant L2 event,
    TYPE_AUTHENTICATION_FAILURE_EVENT = 2;

    // Supplicant L2 event
    TYPE_NETWORK_CONNECTION_EVENT = 3;

    // Supplicant L2 event
    TYPE_NETWORK_DISCONNECTION_EVENT = 4;

    // Supplicant L2 event
    TYPE_SUPPLICANT_STATE_CHANGE_EVENT = 5;

    // Supplicant L2 event
    TYPE_CMD_ASSOCIATED_BSSID = 6;

    // IP Manager successfully completed IP Provisioning
    TYPE_CMD_IP_CONFIGURATION_SUCCESSFUL = 7;

    // IP Manager failed to complete IP Provisioning
    TYPE_CMD_IP_CONFIGURATION_LOST = 8;

    // IP Manager lost reachability to network neighbors
    TYPE_CMD_IP_REACHABILITY_LOST = 9;

    // Indicator that Supplicant is targeting a BSSID for roam/connection
    TYPE_CMD_TARGET_BSSID = 10;

    // Wifi framework is initiating a connection attempt
    TYPE_CMD_START_CONNECT = 11;

    // Wifi framework is initiating a roaming connection attempt
    TYPE_CMD_START_ROAM = 12;

    // SystemAPI connect() command, Settings App
    TYPE_CONNECT_NETWORK = 13;

    // Network Agent has validated the internet connection (Captive Portal Check success, or user
    // validation)
    TYPE_NETWORK_AGENT_VALID_NETWORK = 14;

    // Framework initiated disconnect. Sometimes generated to give an extra reason for a disconnect
    // Should typically be followed by a NETWORK_DISCONNECTION_EVENT with a local_gen = true
    TYPE_FRAMEWORK_DISCONNECT = 15;

    // The NetworkAgent score for wifi has changed in a way that may impact
    // connectivity
    TYPE_SCORE_BREACH = 16;

    // Framework changed Sta interface MAC address
    TYPE_MAC_CHANGE = 17;

    // Wifi is turned on
    TYPE_WIFI_ENABLED = 18;

    // Wifi is turned off
    TYPE_WIFI_DISABLED = 19;

    // The NetworkAgent Wifi usability score has changed in a way that may
    // impact connectivity
    TYPE_WIFI_USABILITY_SCORE_BREACH = 20;

    // Link probe was performed
    TYPE_LINK_PROBE = 21;
  }

  enum FrameworkDisconnectReason {
    // default/none/unknown value
    DISCONNECT_UNKNOWN = 0;

    // API DISCONNECT
    DISCONNECT_API = 1;

    // Some framework internal reason (generic)
    DISCONNECT_GENERIC = 2;

    // Network Agent network validation failed, user signaled network unwanted
    DISCONNECT_UNWANTED = 3;

    // Roaming timed out
    DISCONNECT_ROAM_WATCHDOG_TIMER = 4;

    // P2P service requested wifi disconnect
    DISCONNECT_P2P_DISCONNECT_WIFI_REQUEST = 5;

    // SIM was removed while using a SIM config
    DISCONNECT_RESET_SIM_NETWORKS = 6;

    // The network being evaluated in Make-Before-Break was disconnected due to no internet.
    DISCONNECT_MBB_NO_INTERNET = 7;

    // The network has been removed from the database.
    DISCONNECT_NETWORK_REMOVED = 8;

    // The network has been marked as metered.
    DISCONNECT_NETWORK_METERED = 9;

    // The network has been disabled temporarily.
    DISCONNECT_NETWORK_TEMPORARY_DISABLED = 10;

    // The network has been disabled permanently.
    DISCONNECT_NETWORK_PERMANENT_DISABLED = 11;

    // Carrier offload for this network has been disabled.
    DISCONNECT_CARRIER_OFFLOAD_DISABLED = 12;

    // Disconnected due to an issue with passpoint terms and conditions URL.
    DISCONNECT_PASSPOINT_TAC = 13;

    // VCN policy is requesting to tear down the network.
    DISCONNECT_VCN_REQUEST = 14;

    // Connected to a network that's not found in the database.
    DISCONNECT_UNKNOWN_NETWORK = 15;

    // The network has been marked as untrusted.
    DISCONNECT_NETWORK_UNTRUSTED = 16;
  }

  // Authentication Failure reasons as reported through the API.
  enum AuthFailureReason {
    // Unknown default
    AUTH_FAILURE_UNKNOWN = 0;

    // The reason code if there is no error during authentication. It could also imply that there no
    // authentication in progress,
    AUTH_FAILURE_NONE = 1;

    // The reason code if there was a timeout authenticating.
    AUTH_FAILURE_TIMEOUT = 2;

    // The reason code if there was a wrong password while authenticating.
    AUTH_FAILURE_WRONG_PSWD = 3;

    // The reason code if there was EAP failure while authenticating.
    AUTH_FAILURE_EAP_FAILURE = 4;
  }

  // What event was this
  optional EventType type = 1;

  // 80211 death reason code, relevant to NETWORK_DISCONNECTION_EVENTs
  optional int32 reason = 2 [default = -1];

  // 80211 Association Status code, relevant to ASSOCIATION_REJECTION_EVENTs
  optional int32 status = 3 [default = -1];

  // Designates whether a NETWORK_DISCONNECT_EVENT was by the STA or AP
  optional bool local_gen = 4 [default = false];

  // Network information from the WifiConfiguration of a framework initiated connection attempt
  optional ConfigInfo config_info = 5;

  // RSSI from the last rssi poll (Only valid for active connections)
  optional int32 last_rssi = 6 [default = -127];

  // Link speed from the last rssi poll (Only valid for active connections)
  optional int32 last_link_speed = 7 [default = -1];

  // Frequency from the last rssi poll (Only valid for active connections)
  optional int32 last_freq = 8 [default = -1];

  // Enum used to define bit positions in the supplicant_state_change_bitmask
  // See {@code frameworks/base/wifi/java/android/net/wifi/SupplicantState.java} for documentation
  enum SupplicantState {
    STATE_DISCONNECTED = 0;

    STATE_INTERFACE_DISABLED = 1;

    STATE_INACTIVE = 2;

    STATE_SCANNING = 3;

    STATE_AUTHENTICATING = 4;

    STATE_ASSOCIATING = 5;

    STATE_ASSOCIATED = 6;

    STATE_FOUR_WAY_HANDSHAKE = 7;

    STATE_GROUP_HANDSHAKE = 8;

    STATE_COMPLETED = 9;

    STATE_DORMANT = 10;

    STATE_UNINITIALIZED = 11;

    STATE_INVALID = 12;
  }

  // Bit mask of all supplicant state changes that occurred since the last event
  optional uint32 supplicant_state_changes_bitmask = 9 [default = 0];

  // The number of milliseconds that have elapsed since the device booted
  optional int64 start_time_millis = 10 [default = 0];

  optional FrameworkDisconnectReason framework_disconnect_reason = 11 [default = DISCONNECT_UNKNOWN];

  // Flag which indicates if an association rejection event occurred due to a timeout
  optional bool association_timed_out = 12 [default = false];

  // Authentication failure reason, as reported by WifiManager (calculated from state & deauth code)
  optional AuthFailureReason auth_failure_reason = 13 [default = AUTH_FAILURE_UNKNOWN];

  // NetworkAgent score of connected wifi
  optional int32 last_score = 14 [default = -1];

  // NetworkAgent Wifi usability score of connected wifi
  optional int32 last_wifi_usability_score = 15 [default = -1];

  // Prediction horizon (in second) of Wifi usability score provided by external
  // system app
  optional int32 last_prediction_horizon_sec = 16 [default = -1];

  // Only valid if event type == TYPE_LINK_PROBE.
  // true if link probe succeeded, false otherwise.
  optional bool link_probe_was_success = 17;

  // Only valid if event type == TYPE_LINK_PROBE and link_probe_was_success == true.
  // Elapsed time, in milliseconds, of a successful link probe.
  optional int32 link_probe_success_elapsed_time_ms = 18;

  // Only valid if event type == TYPE_LINK_PROBE and link_probe_was_success == false.
  // Failure reason for an unsuccessful link probe.
  optional LinkProbeStats.LinkProbeFailureReason link_probe_failure_reason = 19;

  // Number of bytes transmitted across mobile networks since device boot.
  optional int64 mobile_tx_bytes = 20 [default = -1];

  // // Number of bytes received across mobile networks since device boot.
  optional int64 mobile_rx_bytes = 21 [default = -1];

  // Number of bytes transmitted since device boot.
  optional int64 total_tx_bytes = 22 [default = -1];

  // Number of bytes received since device boot.
  optional int64 total_rx_bytes = 23 [default = -1];

  // Whether screen is on when the event happens
  optional bool screen_on = 24;

  // Whether cellular data network is available
  optional bool is_cellular_data_available = 25;

  // Whether Adaptive Connectivity is enabled
  optional bool is_adaptive_connectivity_enabled = 26;

  // The wireless interface name e.g. "wlan0", "wlan1". Used to distinguish which event stream this
  // StaEvent belongs to when multiple interfaces are active concurrently.
  optional string interface_name = 27;

  // The role of the wireless interface
  // Gives more information on what purpose this interface is used for.
  optional ClientRole interface_role = 28;
}

// Wi-Fi Aware metrics
message WifiAwareLog {
  // total number of unique apps that used Aware (measured on attach)
  optional int32 num_apps = 1;

  // total number of unique apps that used an identity callback when attaching
  optional int32 num_apps_using_identity_callback = 2;

  // maximum number of attaches for an app
  optional int32 max_concurrent_attach_sessions_in_app = 3;

  // histogram of attach request results
  repeated NanStatusHistogramBucket histogram_attach_session_status = 4;

  // maximum number of concurrent publish sessions in a single app
  optional int32 max_concurrent_publish_in_app = 5;

  // maximum number of concurrent subscribe sessions in a single app
  optional int32 max_concurrent_subscribe_in_app = 6;

  // maximum number of concurrent discovery (publish+subscribe) sessions in a single app
  optional int32 max_concurrent_discovery_sessions_in_app = 7;

  // maximum number of concurrent publish sessions in the system
  optional int32 max_concurrent_publish_in_system = 8;

  // maximum number of concurrent subscribe sessions in the system
  optional int32 max_concurrent_subscribe_in_system = 9;

  // maximum number of concurrent discovery (publish+subscribe) sessions in the system
  optional int32 max_concurrent_discovery_sessions_in_system = 10;

  // histogram of publish request results
  repeated NanStatusHistogramBucket histogram_publish_status = 11;

  // histogram of subscribe request results
  repeated NanStatusHistogramBucket histogram_subscribe_status = 12;

  // number of unique apps which experienced a discovery session creation failure due to lack of
  // resources
  optional int32 num_apps_with_discovery_session_failure_out_of_resources = 13;

  // histogram of create ndp request results
  repeated NanStatusHistogramBucket histogram_request_ndp_status = 14;

  // histogram of create ndp out-of-band (OOB) request results
  repeated NanStatusHistogramBucket histogram_request_ndp_oob_status = 15;

  // maximum number of concurrent active data-interfaces (NDI) in a single app
  optional int32 max_concurrent_ndi_in_app = 19;

  // maximum number of concurrent active data-interfaces (NDI) in the system
  optional int32 max_concurrent_ndi_in_system = 20;

  // maximum number of concurrent data-paths (NDP) in a single app
  optional int32 max_concurrent_ndp_in_app = 21;

  // maximum number of concurrent data-paths (NDP) in the system
  optional int32 max_concurrent_ndp_in_system = 22;

  // maximum number of concurrent secure data-paths (NDP) in a single app
  optional int32 max_concurrent_secure_ndp_in_app = 23;

  // maximum number of concurrent secure data-paths (NDP) in the system
  optional int32 max_concurrent_secure_ndp_in_system = 24;

  // maximum number of concurrent data-paths (NDP) per data-interface (NDI)
  optional int32 max_concurrent_ndp_per_ndi = 25;

  // histogram of durations of Aware being available
  repeated HistogramBucket histogram_aware_available_duration_ms = 26;

  // histogram of durations of Aware being enabled
  repeated HistogramBucket histogram_aware_enabled_duration_ms = 27;

  // histogram of duration (in ms) of attach sessions
  repeated HistogramBucket histogram_attach_duration_ms = 28;

  // histogram of duration (in ms) of publish sessions
  repeated HistogramBucket histogram_publish_session_duration_ms = 29;

  // histogram of duration (in ms) of subscribe sessions
  repeated HistogramBucket histogram_subscribe_session_duration_ms = 30;

  // histogram of duration (in ms) of data-paths (NDP)
  repeated HistogramBucket histogram_ndp_session_duration_ms = 31;

  // histogram of usage (in MB) of data-paths (NDP)
  repeated HistogramBucket histogram_ndp_session_data_usage_mb = 32;

  // histogram of usage (in MB) of data-path creation time (in ms) measured as request -> confirm
  repeated HistogramBucket histogram_ndp_creation_time_ms = 33;

  // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: minimum
  optional int64 ndp_creation_time_ms_min = 34;

  // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: maximum
  optional int64 ndp_creation_time_ms_max = 35;

  // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum
  optional int64 ndp_creation_time_ms_sum = 36;

  // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum of sq
  optional int64 ndp_creation_time_ms_sum_of_sq = 37;

  // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: number of
  // samples
  optional int64 ndp_creation_time_ms_num_samples = 38;

  // total time within the logging window that aware was available
  optional int64 available_time_ms = 39;

  // total time within the logging window that aware was enabled
  optional int64 enabled_time_ms = 40;

  // maximum number of concurrent publish sessions enabling ranging in a single app
  optional int32 max_concurrent_publish_with_ranging_in_app = 41;

  // maximum number of concurrent subscribe sessions specifying a geofence in a single app
  optional int32 max_concurrent_subscribe_with_ranging_in_app = 42;

  // maximum number of concurrent publish sessions enabling ranging in the system
  optional int32 max_concurrent_publish_with_ranging_in_system = 43;

  // maximum number of concurrent subscribe sessions specifying a geofence in the system
  optional int32 max_concurrent_subscribe_with_ranging_in_system = 44;

  // histogram of subscribe session geofence minimum (only when specified)
  repeated HistogramBucket histogram_subscribe_geofence_min = 45;

  // histogram of subscribe session geofence maximum (only when specified)
  repeated HistogramBucket histogram_subscribe_geofence_max = 46;

  // total number of subscribe sessions which enabled ranging
  optional int32 num_subscribes_with_ranging = 47;

  // total number of matches (service discovery indication) with ranging provided
  optional int32 num_matches_with_ranging = 48;

  // total number of matches (service discovery indication) for service discovery with ranging
  // enabled which did not trigger ranging
  optional int32 num_matches_without_ranging_for_ranging_enabled_subscribes = 49;

  // Total number of different types of NDP requests
  repeated NdpRequestTypeHistogramBucket histogram_ndp_request_type = 50;

  // Histogram bucket for Wi-Fi Aware logs. Range is [start, end)
  message HistogramBucket {
    // lower range of the bucket (inclusive)
    optional int64 start = 1;

    // upper range of the bucket (exclusive)
    optional int64 end = 2;

    // number of samples in the bucket
    optional int32 count = 3;
  }

  // Status of various NAN operations
  enum NanStatusTypeEnum {
    // constant to be used by proto
    UNKNOWN = 0;

    // NAN operation succeeded
    SUCCESS = 1;

    // NAN Discovery Engine/Host driver failures
    INTERNAL_FAILURE = 2;

    // NAN OTA failures
    PROTOCOL_FAILURE = 3;

    // The publish/subscribe discovery session id is invalid
    INVALID_SESSION_ID = 4;

    // Out of resources to fufill request
    NO_RESOURCES_AVAILABLE = 5;

    // Invalid arguments passed
    INVALID_ARGS = 6;

    // Invalid peer id
    INVALID_PEER_ID = 7;

    // Invalid NAN data-path (ndp) id
    INVALID_NDP_ID = 8;

    // Attempting to enable NAN when not available, e.g. wifi is disabled
    NAN_NOT_ALLOWED = 9;

    // Over the air ACK not received
    NO_OTA_ACK = 10;

    // Attempting to enable NAN when already enabled
    ALREADY_ENABLED = 11;

    // Can't queue tx followup message foor transmission
    FOLLOWUP_TX_QUEUE_FULL = 12;

    // Unsupported concurrency of NAN and another feature - NAN disabled
    UNSUPPORTED_CONCURRENCY_NAN_DISABLED = 13;

    // Unknown NanStatusType
    UNKNOWN_HAL_STATUS = 14;
  }

  // Histogram bucket for Wi-Fi Aware (NAN) status.
  message NanStatusHistogramBucket {
    // status type defining the bucket
    optional NanStatusTypeEnum nan_status_type = 1;

    // number of samples in the bucket
    optional int32 count = 2;
  }

  enum NdpRequestTypeEnum {
    // Unknown Type
    NETWORK_SPECIFIER_TYPE_UNKNOWN = 0;

    // TYPE: in band, specific peer: role, client_id, session_id, peer_id, pmk/passphrase optional
    NETWORK_SPECIFIER_TYPE_IB = 1;

    // TYPE: in band, any peer: role, client_id, session_id, pmk/passphrase optional
    NETWORK_SPECIFIER_TYPE_IB_ANY_PEER = 2;

    //TYPE: out-of-band: role, client_id, peer_mac, pmk/passphrase optional
    NETWORK_SPECIFIER_TYPE_OOB = 3;

    //TYPE: out-of-band, any peer: role, client_id, pmk/passphrase optional
    NETWORK_SPECIFIER_TYPE_OOB_ANY_PEER = 4;

  }

  message NdpRequestTypeHistogramBucket {
    // request type defining the bucket
    optional NdpRequestTypeEnum ndp_request_type = 1;
    // number of samples in the bucket
    optional int32 count = 2;

  }
}

// Data point used to build 'Number of Connectable Network' histograms
message NumConnectableNetworksBucket {
  // Number of connectable networks seen in a scan result
  optional int32 num_connectable_networks = 1 [default = 0];

  // Number of scan results with num_connectable_networks
  optional int32 count = 2 [default = 0];
}

// Pno scan metrics
// Here "Pno Scan" refers to the session of offloaded scans, these metrics count the result of a
// single session, and not the individual scans within that session.
message PnoScanMetrics {
  // Total number of attempts to offload pno scans
  optional int32 num_pno_scan_attempts = 1;

  // Total number of pno scans failed
  optional int32 num_pno_scan_failed = 2;

  // Number of pno scans started successfully over offload
  optional int32 num_pno_scan_started_over_offload = 3;

  // Number of pno scans failed over offload
  optional int32 num_pno_scan_failed_over_offload = 4;

  // Total number of pno scans that found any network
  optional int32 num_pno_found_network_events = 5;
}

// Number of occurrences for a particular "Connect to Network" Notification or
// notification Action.
message ConnectToNetworkNotificationAndActionCount {

  // "Connect to Network" notifications
  enum Notification {

    // Default
    NOTIFICATION_UNKNOWN = 0;

    // Initial notification with a recommended network.
    NOTIFICATION_RECOMMEND_NETWORK = 1;

    // Notification when connecting to the recommended network.
    NOTIFICATION_CONNECTING_TO_NETWORK = 2;

    // Notification when successfully connected to the network.
    NOTIFICATION_CONNECTED_TO_NETWORK = 3;

    // Notification when failed to connect to network.
    NOTIFICATION_FAILED_TO_CONNECT = 4;
  }

  // "Connect to Network" notification actions
  enum Action {

    // Default
    ACTION_UNKNOWN = 0;

    // User dismissed the "Connect to Network" notification.
    ACTION_USER_DISMISSED_NOTIFICATION = 1;

    // User tapped action button to connect to recommended network.
    ACTION_CONNECT_TO_NETWORK = 2;

    // User tapped action button to open Wi-Fi Settings.
    ACTION_PICK_WIFI_NETWORK = 3;

    // User tapped "Failed to connect" notification to open Wi-Fi Settings.
    ACTION_PICK_WIFI_NETWORK_AFTER_CONNECT_FAILURE = 4;
  }

  // Recommenders of the "Connect to Network" notification
  enum Recommender {

    // Default.
    RECOMMENDER_UNKNOWN = 0;

    // Open Network Available recommender.
    RECOMMENDER_OPEN = 1;
  }

  // Notification Type.
  optional Notification notification = 1;

  // Action Type.
  optional Action action = 2;

  // Recommender Type.
  optional Recommender recommender = 3;

  // Occurrences of this action.
  optional int32 count = 4;
}

// SoftAP event tracking sessions and client counts
message SoftApConnectedClientsEvent {

  // Soft AP event Types
  enum SoftApEventType {

    // Soft AP in single AP mode is Up and ready for use.
    // The sequence of the events in single AP mode:
    // SOFT_AP_UP -> ... (ex:NUM_CLIENTS_CHANGED) -> SOFT_AP_DOWN
    SOFT_AP_UP = 0;

    // Soft AP in single/dual AP mode is Down.
    SOFT_AP_DOWN = 1;

    // Number of connected soft AP clients has changed.
    NUM_CLIENTS_CHANGED = 2;

    // Soft AP in dual AP mode is Up and ready for use.
    // There are two DUAL_AP_BOTH_INSTANCES_UP events in dual AP mode for
    // storing each instance information.
    // The sequence of the events in dual AP mode:
    // DUAL_AP_BOTH_INSTANCES_UP -> DUAL_AP_BOTH_INSTANCES_UP
    // ... (ex: DUAL_AP_ONE_INSTANCE_DOWN or NUM_CLIENTS_CHANGED) -> SOFT_AP_DOWN
    DUAL_AP_BOTH_INSTANCES_UP = 3;

    // One of the dual AP instance is Down.
    DUAL_AP_ONE_INSTANCE_DOWN = 4;
  }

  // Soft AP channel bandwidth types
  enum ChannelBandwidth {

    BANDWIDTH_INVALID = 0;

    BANDWIDTH_20_NOHT = 1;

    BANDWIDTH_20 = 2;

    BANDWIDTH_40 = 3;

    BANDWIDTH_80 = 4;

    BANDWIDTH_80P80 = 5;

    BANDWIDTH_160 = 6;
  }

  // The operational mode  of the Soft AP.
  enum Generation {

    WIFI_STANDARD_UNKNOWN = 0;

    WIFI_STANDARD_LEGACY = 1;

    WIFI_STANDARD_11N = 4;

    WIFI_STANDARD_11AC = 5;

    WIFI_STANDARD_11AX = 6;
  }

  // Type of event being recorded
  optional SoftApEventType event_type = 1;

  // Time passed since last boot in milliseconds
  optional int64 time_stamp_millis = 2;

  // Number of connected clients if event_type is NUM_CLIENTS_CHANGED, otherwise zero.
  optional int32 num_connected_clients = 3;

  // Channel frequency used for Soft AP
  optional int32 channel_frequency = 4;

  // Channel bandwidth used for Soft AP
  optional ChannelBandwidth channel_bandwidth = 5;

  // Maximum number of client setting in SoftApConfiguration
  optional int32 max_num_clients_setting_in_softap_configuration = 6;

  // Maximum number of client setting in SoftApCapability
  optional int32 max_num_clients_setting_in_softap_capability = 7;

  // Auto shutdown timeout setting in SoftApConfiguration
  optional int64 shutdown_timeout_setting_in_softap_configuration = 8;

  // Framework default auto shutdown timeout setting
  optional int64 default_shutdown_timeout_setting = 9;

  // Indicates if user enabled the client_control
  optional bool client_control_is_enabled = 10;

  // The operational mode of the AP
  optional Generation generation = 11;

  // Number of connected clients on current frequency if event_type is NUM_CLIENTS_CHANGED,
  // otherwise zero. On dual AP, it may be different from num_connected_clients
  // because there are two instances and num_connected_clients is used to record
  // total number of the clients. But num_connected_clients_on_current_frequency
  // is used to record the number of the clients on specific instance. (depends
  // on channel_frequency)
  optional int32 num_connected_clients_on_current_frequency = 12;
}

// Power stats for Wifi
message WifiPowerStats {

  // Duration of log (ms)
  optional int64 logging_duration_ms = 1;

  // Energy consumed by wifi (mAh)
  optional double energy_consumed_mah = 2;

  // Amount of time wifi is in idle (ms)
  optional int64 idle_time_ms = 3;

  // Amount of time wifi is in rx (ms)
  optional int64 rx_time_ms = 4;

  // Amount of time wifi is in tx (ms)
  optional int64 tx_time_ms = 5;

  // Amount of time kernel is active because of wifi data (ms)
  optional int64 wifi_kernel_active_time_ms = 6;

  // Number of packets sent (tx)
  optional int64 num_packets_tx = 7;

  // Number of bytes sent (tx)
  optional int64 num_bytes_tx = 8;

  // Number of packets received (rx)
  optional int64 num_packets_rx = 9;

  // Number of bytes sent (rx)
  optional int64 num_bytes_rx = 10;

  // Amount of time wifi is in sleep (ms)
  optional int64 sleep_time_ms = 11;

  // Amount of time wifi is scanning (ms)
  optional int64 scan_time_ms = 12;

  // Actual monitored rail energy consumed by wifi (mAh)
  optional double monitored_rail_energy_consumed_mah = 13;
}

// Metrics for Wifi Wake
message WifiWakeStats {
  // An individual session for Wifi Wake
  message Session {
    // A Wifi Wake lifecycle event
    message Event {
      // Elapsed time in milliseconds since start of session.
      optional int64 elapsed_time_millis = 1;

      // Number of scans that have occurred since start of session.
      optional int32 elapsed_scans = 2;
    }

    // Start time of session in milliseconds.
    optional int64 start_time_millis = 1;

    // The number of networks the lock was provided with at start.
    optional int32 locked_networks_at_start = 2;

    // The number of networks in the lock at the time of the initialize event. Only valid if
    // initialize_event is recorded.
    optional int32 locked_networks_at_initialize = 6;

    // Event for fully initializing the WakeupLock (i.e. WakeupLock is "locked").
    optional Event initialize_event = 7;

    // Event for unlocking the WakeupLock. Does not occur if lock was initialized with 0 networks.
    optional Event unlock_event = 3;

    // Event for triggering wakeup.
    optional Event wakeup_event = 4;

    // Event for WifiWake reset event. This event marks the end of a session.
    optional Event reset_event = 5;
  }

  // Total number of sessions for Wifi Wake.
  optional int32 num_sessions = 1;

  // Session information for every Wifi Wake session (up to a maximum of 10).
  repeated Session sessions = 2;

  // Number of ignored calls to start (due to WakeupController already being active).
  optional int32 num_ignored_starts = 3;

  // Number of Wifi Wake sessions that have recorded wakeup events.
  optional int32 num_wakeups = 4;
}

// Metrics for Wi-Fi RTT
message WifiRttLog {
  // Number of RTT request API calls
  optional int32 num_requests = 1;

  // Histogram of RTT operation overall status
  repeated RttOverallStatusHistogramBucket histogram_overall_status = 2;

  // RTT to Access Points metrics
  optional RttToPeerLog rtt_to_ap = 3;

  // RTT to Wi-Fi Aware peers metrics
  optional RttToPeerLog rtt_to_aware = 4;

  // Histogram of how long a measurement with only AP take.
  repeated HistogramBucket histogram_measurement_duration_ap_only = 5;

  // Histogram of how long a measurement with aware peer included take.
  repeated HistogramBucket histogram_measurement_duration_with_aware = 6;

  // Metrics for a RTT to Peer (peer = AP or Wi-Fi Aware)
  message RttToPeerLog {
    // Total number of API calls
    optional int32 num_requests = 1;

    // Total number of individual requests
    optional int32 num_individual_requests = 2;

    // Total number of apps which requested RTT
    optional int32 num_apps = 3;

    // Histogram of total number of RTT requests by an app (WifiRttManager#startRanging)
    repeated HistogramBucket histogram_num_requests_per_app = 4;

    // Histogram of number of peers in a single RTT request (RangingRequest entries)
    repeated HistogramBucket histogram_num_peers_per_request = 5;

    // Histogram of status of individual RTT operations (RangingResult entries)
    repeated RttIndividualStatusHistogramBucket histogram_individual_status = 6;

    // Histogram of measured distances (RangingResult entries)
    repeated HistogramBucket histogram_distance = 7;

    // Histogram of interval of RTT requests by an app (WifiRttManager#startRanging)
    repeated HistogramBucket histogram_request_interval_ms = 8;
  }

  // Histogram bucket for Wi-Fi RTT logs. Range is [start, end)
  message HistogramBucket {
    // lower range of the bucket (inclusive)
    optional int64 start = 1;

    // upper range of the bucket (exclusive)
    optional int64 end = 2;

    // number of samples in the bucket
    optional int32 count = 3;
  }

  // Status codes for overall RTT operation
  enum RttOverallStatusTypeEnum {
    // constant to be used by proto
    OVERALL_UNKNOWN = 0;

    // RTT operation succeeded (individual results may still fail)
    OVERALL_SUCCESS = 1;

    // RTT operation failed (unspecified reason)
    OVERALL_FAIL = 2;

    // RTT operation failed since RTT was not available (e.g. Airplane mode)
    OVERALL_RTT_NOT_AVAILABLE = 3;

    // RTT operation timed-out: didn't receive response from HAL in expected time
    OVERALL_TIMEOUT = 4;

    // RTT operation aborted since the app is spamming the service
    OVERALL_THROTTLE = 5;

    // RTT request to HAL received immediate failure
    OVERALL_HAL_FAILURE = 6;

    // RTT to Wi-Fi Aware peer using PeerHandle failed to get a MAC address translation
    OVERALL_AWARE_TRANSLATION_FAILURE = 7;

    // RTT operation failed due to missing Location permission (post execution)
    OVERALL_LOCATION_PERMISSION_MISSING = 8;
  }

  // Status codes for individual RTT operation
  enum RttIndividualStatusTypeEnum {
    // constant to be used by proto
    UNKNOWN = 0;

    // RTT operation succeeded
    SUCCESS = 1;

    // RTT failure: generic reason (no further information)
    FAILURE = 2;

    // Target STA does not respond to request
    FAIL_NO_RSP = 3;

    // Request rejected. Applies to 2-sided RTT only
    FAIL_REJECTED = 4;

    // Operation not scheduled
    FAIL_NOT_SCHEDULED_YET = 5;

    // Timing measurement times out
    FAIL_TM_TIMEOUT = 6;

    // Target on different channel, cannot range
    FAIL_AP_ON_DIFF_CHANNEL = 7;

    // Ranging not supported
    FAIL_NO_CAPABILITY = 8;

    // Request aborted for unknown reason
    ABORTED = 9;

    // Invalid T1-T4 timestamp
    FAIL_INVALID_TS = 10;

    // 11mc protocol failed
    FAIL_PROTOCOL = 11;

    // Request could not be scheduled
    FAIL_SCHEDULE = 12;

    // Responder cannot collaborate at time of request
    FAIL_BUSY_TRY_LATER = 13;

    // Bad request args
    INVALID_REQ = 14;

    // WiFi not enabled
    NO_WIFI = 15;

    // Responder overrides param info, cannot range with new params
    FAIL_FTM_PARAM_OVERRIDE = 16;

    // HAL did not provide a result to a framework request
    MISSING_RESULT = 17;
  }

  // Histogram bucket for Wi-Fi RTT overall operation status
  message RttOverallStatusHistogramBucket {
    // status type defining the bucket
    optional RttOverallStatusTypeEnum status_type = 1;

    // number of samples in the bucket
    optional int32 count = 2;
  }

  // Histogram bucket for Wi-Fi RTT individual operation status
  message RttIndividualStatusHistogramBucket {
    // status type defining the bucket
    optional RttIndividualStatusTypeEnum status_type = 1;

    // number of samples in the bucket
    optional int32 count = 2;
  }
}

// Usage data for the wifi radio while device is running on battery.
message WifiRadioUsage {
  // Duration of log (ms)
  optional int64 logging_duration_ms = 1;

  // Total time for which the radio is awake due to scan.
  optional int64 scan_time_ms = 2;
}

message ExperimentValues {
  // Indicates if we are logging WifiIsUnusableEvent in metrics
  optional bool wifi_is_unusable_logging_enabled = 1;

  // Minimum number of txBad to trigger a data stall
  optional int32 wifi_data_stall_min_tx_bad = 2;

  // Minimum number of txSuccess to trigger a data stall
  // when rxSuccess is 0
  optional int32 wifi_data_stall_min_tx_success_without_rx = 3;

  // Indicates if we are logging LinkSpeedCount in metrics
  optional bool link_speed_counts_logging_enabled = 4;

  // Duration for evaluating Wifi condition to trigger a data stall
  // measured in milliseconds
  optional int32 data_stall_duration_ms = 5;

  // Threshold of Tx throughput below which to trigger a data stall
  // measured in Kbps
  optional int32 data_stall_tx_tput_thr_kbps = 6;

  // Threshold of Rx throughput below which to trigger a data stall
  // measured in Kbps
  optional int32 data_stall_rx_tput_thr_kbps = 7;

  // Threshold of Tx packet error rate above which to trigger a data stall
  // in percentage
  optional int32 data_stall_tx_per_thr = 8;

  // Threshold of CCA level above which to trigger a data stall in percentage
  optional int32 data_stall_cca_level_thr = 9;

  // Health monitor RSSI poll valid time in ms
  optional int32 health_monitor_rssi_poll_valid_time_ms = 10;
}

message BssidBlocklistStats {
  // Distributions of number of blocked BSSIDs filtered out from network selection.
  repeated Int32Count network_selection_filtered_bssid_count = 1;

  // If this is enabled, then network connections in high movement state will be skipped unless
  // we find a candidate BSSID with similar RSSI in 2 scans sufficiently far apart.
  optional bool high_movement_multiple_scans_feature_enabled = 2;

  // Number of times connection is skipped in the high movement state
  // only relevant if high_movement_multiple_scans_feature_enabled=true
  optional int32 num_high_movement_connection_skipped = 3;

  // Number of times connection is initiated in the high movement state
  // only relevant if high_movement_multiple_scans_feature_enabled=true
  optional int32 num_high_movement_connection_started = 4;

  // Histogram corresponding to the number of times BSSIDs are blocked per
  // WifiBlocklistMonitor.FailureReason.
  repeated Int32Count bssid_blocklist_per_reason_count = 5;

  // Histogram corresponding to the number of times WifiConfigurations are blocked per
  // WifiConfiguration.NetworkSelectionStatus.NetworkSelectionDisableReason.
  repeated Int32Count wifi_config_blocklist_per_reason_count = 6;
}

message WifiIsUnusableEvent {
  enum TriggerType {
    // Default/Invalid event
    TYPE_UNKNOWN = 0;

    // There is a data stall from tx failures
    TYPE_DATA_STALL_BAD_TX = 1;

    // There is a data stall from rx failures
    TYPE_DATA_STALL_TX_WITHOUT_RX = 2;

    // There is a data stall from both tx and rx failures
    TYPE_DATA_STALL_BOTH = 3;

    // Firmware generated an alert
    TYPE_FIRMWARE_ALERT = 4;

    // IP Manager lost reachability to network neighbors
    TYPE_IP_REACHABILITY_LOST = 5;
  }

  // What event triggered WifiIsUnusableEvent.
  optional TriggerType type = 1;

  // The timestamp at which this event occurred.
  // Measured in milliseconds that have elapsed since the device booted.
  optional int64 start_time_millis = 2;

  // NetworkAgent score of connected wifi.
  // Defaults to -1 if the score was never set.
  optional int32 last_score = 3 [default = -1];

  // Delta of successfully transmitted (ACKed) unicast data packets
  // between the last two WifiLinkLayerStats.
  optional int64 tx_success_delta = 4;

  // Delta of transmitted unicast data retry packets
  // between the last two WifiLinkLayerStats.
  optional int64 tx_retries_delta = 5;

  // Delta of lost (not ACKed) transmitted unicast data packets
  // between the last two WifiLinkLayerStats.
  optional int64 tx_bad_delta = 6;

  // Delta of received unicast data packets
  // between the last two WifiLinkLayerStats.
  optional int64 rx_success_delta = 7;

  // Time in millisecond between the last two WifiLinkLayerStats.
  optional int64 packet_update_time_delta = 8;

  // The timestamp at which the last WifiLinkLayerStats was updated.
  // Measured in milliseconds that have elapsed since the device booted.
  optional int64 last_link_layer_stats_update_time = 9;

  // Firmware alert code. Only valid when the event was triggered by a firmware alert, otherwise -1.
  optional int32 firmware_alert_code = 10 [default = -1];

  // NetworkAgent wifi usability score of connected wifi.
  // Defaults to -1 if the score was never set.
  optional int32 last_wifi_usability_score = 11 [default = -1];

  // Prediction horizon (in second) of Wifi usability score provided by external
  // system app
  optional int32 last_prediction_horizon_sec = 12 [default = -1];

  // Whether screen status is on when WifiIsUnusableEvent happens.
  optional bool screen_on = 13 [default = false];

  // Number of bytes transmitted across mobile networks since device boot.
  optional int64 mobile_tx_bytes = 14 [default = -1];

  // // Number of bytes received across mobile networks since device boot.
  optional int64 mobile_rx_bytes = 15 [default = -1];

  // Number of bytes transmitted since device boot.
  optional int64 total_tx_bytes = 16 [default = -1];

  // Number of bytes received since device boot.
  optional int64 total_rx_bytes = 17 [default = -1];
}

message PasspointProfileTypeCount {
  enum EapMethod {
    // Unknown Type
    TYPE_UNKNOWN = 0;

    // EAP_TLS (13)
    TYPE_EAP_TLS = 1;

    // EAP_TTLS (21)
    TYPE_EAP_TTLS = 2;

    // EAP_SIM (18)
    TYPE_EAP_SIM = 3;

    // EAP_AKA (23)
    TYPE_EAP_AKA = 4;

    // EAP_AKA_PRIME (50)
    TYPE_EAP_AKA_PRIME = 5;
  }

  // Eap method type set in Passpoint profile
  optional EapMethod eap_method_type = 1;

  // Num of installed Passpoint profile with same eap method
  optional int32 count = 2;
}

message WifiLinkLayerUsageStats {
  // Total logging duration in ms.
  optional int64 logging_duration_ms = 1;

  // Total time the wifi radio is on in ms over the logging duration.
  optional int64 radio_on_time_ms = 2;

  // Total time the wifi radio is doing tx in ms over the logging duration.
  optional int64 radio_tx_time_ms = 3;

  // Total time the wifi radio is doing rx in ms over the logging duration.
  optional int64 radio_rx_time_ms = 4;

  // Total time the wifi radio is scanning in ms over the logging duration.
  optional int64 radio_scan_time_ms = 5;

  // Total time the wifi radio spent doing nan scans in ms over the logging duration.
  optional int64 radio_nan_scan_time_ms = 6;

  // Total time the wifi radio spent doing background scans in ms over the logging duration.
  optional int64 radio_background_scan_time_ms = 7;

  // Total time the wifi radio spent doing roam scans in ms over the logging duration.
  optional int64 radio_roam_scan_time_ms = 8;

  // Total time the wifi radio spent doing pno scans in ms over the logging duration.
  optional int64 radio_pno_scan_time_ms = 9;

  // Total time the wifi radio spent doing hotspot 2.0 scans and GAS exchange
  // in ms over the logging duration.
  optional int64 radio_hs20_scan_time_ms = 10;

  // Radio stats from all the radios
  repeated RadioStats radio_stats = 11;
}

message WifiUsabilityStatsEntry {
  // Status codes for link probe status
  enum LinkProbeStatus {
    // Link probe status is unknown
    PROBE_STATUS_UNKNOWN = 0;

    // Link probe is not triggered
    PROBE_STATUS_NO_PROBE = 1;

    // Link probe is triggered and the result is success
    PROBE_STATUS_SUCCESS = 2;

    // Link probe is triggered and the result is failure
    PROBE_STATUS_FAILURE = 3;
  }

  // Codes for cellular data network type
  enum CellularDataNetworkType {
    // Unknown network
    NETWORK_TYPE_UNKNOWN = 0;

    // GSM network
    NETWORK_TYPE_GSM = 1;

    // CDMA network
    NETWORK_TYPE_CDMA = 2;

    // CDMA EVDO network
    NETWORK_TYPE_EVDO_0 = 3;

    // WCDMA network
    NETWORK_TYPE_UMTS = 4;

    // TDSCDMA network
    NETWORK_TYPE_TD_SCDMA = 5;

    // LTE network
    NETWORK_TYPE_LTE = 6;

    // NR network
    NETWORK_TYPE_NR = 7;
  }

  // Absolute milliseconds from device boot when these stats were sampled
  optional int64 time_stamp_ms = 1;

  // The RSSI at the sample time
  optional int32 rssi = 2;

  // Link speed at the sample time in Mbps
  optional int32 link_speed_mbps = 3;

  // The total number of tx success counted from the last radio chip reset
  optional int64 total_tx_success = 4;

  // The total number of MPDU data packet retries counted from the last radio chip reset
  optional int64 total_tx_retries = 5;

  // The total number of tx bad counted from the last radio chip reset
  optional int64 total_tx_bad = 6;

  // The total number of rx success counted from the last radio chip reset
  optional int64 total_rx_success = 7;

  // The total time the wifi radio is on in ms counted from the last radio chip reset
  optional int64 total_radio_on_time_ms = 8;

  // The total time the wifi radio is doing tx in ms counted from the last radio chip reset
  optional int64 total_radio_tx_time_ms = 9;

  // The total time the wifi radio is doing rx in ms counted from the last radio chip reset
  optional int64 total_radio_rx_time_ms = 10;

  // The total time spent on all types of scans in ms counted from the last radio chip reset
  optional int64 total_scan_time_ms = 11;

  // The total time spent on nan scans in ms counted from the last radio chip reset
  optional int64 total_nan_scan_time_ms = 12;

  // The total time spent on background scans in ms counted from the last radio chip reset
  optional int64 total_background_scan_time_ms = 13;

  // The total time spent on roam scans in ms counted from the last radio chip reset
  optional int64 total_roam_scan_time_ms = 14;

  // The total time spent on pno scans in ms counted from the last radio chip reset
  optional int64 total_pno_scan_time_ms = 15;

  // The total time spent on hotspot2.0 scans and GAS exchange in ms counted from the last radio
  // chip reset
  optional int64 total_hotspot_2_scan_time_ms = 16;

  // Internal framework Wifi score
  optional int32 wifi_score = 17;

  // Wifi usability score provided by external system app
  optional int32 wifi_usability_score = 18;

  // Sequence number from external system app to framework
  optional int32 seq_num_to_framework = 19;

  // The total time CCA is on busy status on the current frequency in ms
  // counted from the last radio chip reset
  optional int64 total_cca_busy_freq_time_ms = 20;

  // The total radio on time of the current frequency from the last radio
  // chip reset
  optional int64 total_radio_on_freq_time_ms = 21;

  // The total number of beacons received from the last radio chip reset
  optional int64 total_beacon_rx = 22;

  // Prediction horizon (in second) of Wifi usability score provided by external
  // system app
  optional int32 prediction_horizon_sec = 23;

  // The link probe status since last stats update
  optional LinkProbeStatus probe_status_since_last_update = 24;

  // The elapsed time of the most recent link probe since last stats update;
  optional int32 probe_elapsed_time_since_last_update_ms = 25;

  // The MCS rate of the most recent link probe since last stats update
  optional int32 probe_mcs_rate_since_last_update = 26;

  // Rx link speed at the sample time in Mbps
  optional int32 rx_link_speed_mbps = 27;

  // Sequence number generated by framework
  optional int32 seq_num_inside_framework = 28;

  // Whether current entry is for the same BSSID on the same frequency compared
  // to last entry
  optional bool is_same_bssid_and_freq = 29;

  // Cellular data network type currently in use on the device for data transmission
  optional CellularDataNetworkType cellular_data_network_type = 30;

  // Cellular signal strength in dBm, NR: CsiRsrp, LTE: Rsrp, WCDMA/TDSCDMA: Rscp,
  // CDMA: Rssi, EVDO: Rssi, GSM: Rssi
  optional int32 cellular_signal_strength_dbm = 31;

  // Cellular signal strength in dB, NR: CsiSinr, LTE: Rsrq, WCDMA: EcNo, TDSCDMA: invalid,
  // CDMA: Ecio, EVDO: SNR, GSM: invalid */
  optional int32 cellular_signal_strength_db = 32;

  // Whether the primary registered cell of current entry is same as that of previous entry
  optional bool is_same_registered_cell = 33;

  // The device mobility state
  optional DeviceMobilityStatePnoScanStats.DeviceMobilityState
          device_mobility_state = 34;

  // Duty cycle of the connection.
  // if this connection is being served using time slicing on a radio with one or more interfaces
  // (i.e MCC), then this field contains the duty cycle assigned to this interface in percent.
  // If no concurrency or not using time slicing during concurrency (i.e SCC or DBS), set to 100.
  optional int32 time_slice_duty_cycle_in_percent = 35;

  // WME data packet contention time statistics for all four categories: BE, BK, VI, VO
  repeated ContentionTimeStats contention_time_stats = 36;

  // The channel utilization ratio (value) in the range of
  // [BssLoad.MIN_CHANNEL_UTILIZATION, BssLoad.MAX_CHANNEL_UTILIZATION], where MIN_CHANNEL_UTILIZATION
  // corresponds to ratio 0%, MAX_CHANNEL_UTILIZATION corresponds to ratio 100%,
  // see {@link com.android.server.wifi.util.InformationElementUtil}
  optional int32 channel_utilization_ratio = 37;

  // Indicate whether current link layer throughput is sufficient, see {@link WifiDataStall#isThroughputSufficient()}.
  optional bool is_throughput_sufficient = 38;

  // Indicate whether Wi-Fi scoring is enabled by the user, see {@link WifiManager#setWifiScoringEnabled(boolean)}.
  optional bool is_wifi_scoring_enabled = 39;

  // Indicate whether Cellular data is available, see {@link WifiDataStall#isCellularDataAvailable()}.
  optional bool is_cellular_data_available = 40;

  // Rate statistics, including number of successful packets, retries, etc.,
  // indexed by preamble, bandwidth, number of spatial streams, MCS.
  repeated RateStats rate_stats = 41;

  // Number of stations associated with current AP.
  optional int32 sta_count = 42;

  // Channel utilization at current AP in the range of [0, 255].
  optional int32 channel_utilization = 43;

  // Link layer radio stats for all the radios
  repeated RadioStats radio_stats = 44;
}

message ContentionTimeStats {
  enum AccessCategory {
    // WME Best Effort Access Category
    WME_ACCESS_CATEGORY_BE = 0;

    // WME Background Access Category
    WME_ACCESS_CATEGORY_BK = 1;

    // WME Video Access Category
    WME_ACCESS_CATEGORY_VI = 2;

    // WME Voice Access Category
    WME_ACCESS_CATEGORY_VO = 3;
  }

  // WME access category
  optional AccessCategory access_category = 1;

  // Data packet min contention time in microseconds
  optional int64 contention_time_min_micros = 2;

  // Data packet max contention time in microseconds
  optional int64 contention_time_max_micros = 3;

  // Data packet average contention time in microseconds
  optional int64 contention_time_avg_micros = 4;

  // Number of data packets used for contention statistics
  optional int64 contention_num_samples = 5;
}

message RateStats {
  enum WifiPreambleType {
    // Preamble type for IEEE 802.11a/g, IEEE Std 802.11-2020, Section 17
    WIFI_PREAMBLE_OFDM = 0;
    // Preamble type for IEEE 802.11b, IEEE Std 802.11-2020, Section 16
    WIFI_PREAMBLE_CCK = 1;
    // Preamble type for IEEE 802.11n, IEEE Std 802.11-2020, Section 19
    WIFI_PREAMBLE_HT = 2;
    // Preamble type for IEEE 802.11ac, IEEE Std 802.11-2020, Section 21
    WIFI_PREAMBLE_VHT = 3;
    // Preamble type for IEEE 802.11ax, IEEE Std 802.11-2020, Section 27
    WIFI_PREAMBLE_HE = 5;
    // Invalid
    WIFI_PREAMBLE_INVALID = -1;
  }

  enum WifiSpatialStreams {
    // Single stream, 1x1
    WIFI_SPATIAL_STREAMS_ONE = 0;
    // Dual streams, 2x2
    WIFI_SPATIAL_STREAMS_TWO = 1;
    // Three streams, 3x3
    WIFI_SPATIAL_STREAMS_THREE = 2;
    // Four streams, 4x4
    WIFI_SPATIAL_STREAMS_FOUR = 3;
    // Invalid
    WIFI_SPATIAL_STREAMS_INVALID = -1;
  }

  enum WifiChannelBandwidth {
    // Channel bandwidth: 20MHz
    WIFI_BANDWIDTH_20_MHZ = 0;
    // Channel bandwidth: 40MHz
    WIFI_BANDWIDTH_40_MHZ = 1;
    // Channel bandwidth: 80MHz
    WIFI_BANDWIDTH_80_MHZ = 2;
    // Channel bandwidth: 160MHz
    WIFI_BANDWIDTH_160_MHZ = 3;
    // Channel bandwidth: 80MHz + 80MHz
    WIFI_BANDWIDTH_80P80_MHZ = 4;
    // Channel bandwidth: 5MHz
    WIFI_BANDWIDTH_5_MHZ = 5;
    // Channel bandwidth: 10MHz
    WIFI_BANDWIDTH_10_MHZ = 6;
    // Invalid channel bandwidth
    WIFI_BANDWIDTH_INVALID = -1;
  }

  // Preamble information.
  optional WifiPreambleType preamble = 1;

  // Number of spatial streams.
  optional WifiSpatialStreams nss = 2;

  // Bandwidth information.
  optional WifiChannelBandwidth bw = 3;

  // MCS index. OFDM/CCK rate code would be as per IEEE std in the units of 0.5Mbps.
  // HT/VHT/HE: it would be MCS index.
  optional int32 rate_mcs_idx = 4;

  // Bitrate in units of 100 Kbps.
  optional int32 bit_rate_in_kbps = 5;

  // Number of successfully transmitted data packets (ACK received).
  optional int32 tx_mpdu = 6;

  // Number of received data packets.
  optional int32 rx_mpdu = 7;

  // Number of data packet losses (no ACK).
  optional int32 mpdu_lost = 8;

  // Number of data packet retries.
  optional int32 retries = 9;
}

message RadioStats {
  // The Radio ID
  optional int32 radio_id = 1;
  // The total time the wifi radio is on in ms counted from the last radio chip reset
  optional int64 total_radio_on_time_ms = 2;

  // The total time the wifi radio is doing tx in ms counted from the last radio chip reset
  optional int64 total_radio_tx_time_ms = 3;

  // The total time the wifi radio is doing rx in ms counted from the last radio chip reset
  optional int64 total_radio_rx_time_ms = 4;

  // The total time spent on all types of scans in ms counted from the last radio chip reset
  optional int64 total_scan_time_ms = 5;

  // The total time spent on nan scans in ms counted from the last radio chip reset
  optional int64 total_nan_scan_time_ms = 6;

  // The total time spent on background scans in ms counted from the last radio chip reset
  optional int64 total_background_scan_time_ms = 7;

  // The total time spent on roam scans in ms counted from the last radio chip reset
  optional int64 total_roam_scan_time_ms = 8;

  // The total time spent on pno scans in ms counted from the last radio chip reset
  optional int64 total_pno_scan_time_ms = 9;

  // The total time spent on hotspot2.0 scans and GAS exchange in ms counted from the last radio
  // chip reset
  optional int64 total_hotspot_2_scan_time_ms = 10;
}

message WifiUsabilityStats {
  enum Label {
    // Default label
    LABEL_UNKNOWN = 0;

    // Wifi is usable
    LABEL_GOOD = 1;

    // Wifi is unusable
    LABEL_BAD = 2;
  }

  enum UsabilityStatsTriggerType {
    // Default/Invalid event
    TYPE_UNKNOWN = 0;

    // There is a data stall from tx failures
    TYPE_DATA_STALL_BAD_TX = 1;

    // There is a data stall from rx failures
    TYPE_DATA_STALL_TX_WITHOUT_RX = 2;

    // There is a data stall from both tx and rx failures
    TYPE_DATA_STALL_BOTH = 3;

    // Firmware generated an alert
    TYPE_FIRMWARE_ALERT = 4;

    // IP Manager lost reachability to network neighbors
    TYPE_IP_REACHABILITY_LOST = 5;
  }

  // The current wifi usability state
  optional Label label = 1;

  // The list of timestamped wifi usability stats
  repeated WifiUsabilityStatsEntry stats = 2;

  // What event triggered WifiUsabilityStats.
  optional UsabilityStatsTriggerType trigger_type = 3;

  // Firmware alert code. Only valid when the stats was triggered by a firmware
  // alert, otherwise -1.
  optional int32 firmware_alert_code = 4 [default = -1];

  // Absolute milliseconds from device boot when these stats were sampled
  optional int64 time_stamp_ms = 5;
}

message DeviceMobilityStatePnoScanStats {
  // see WifiManager.DEVICE_MOBILITY_STATE_* constants
  enum DeviceMobilityState {
    // Unknown mobility
    UNKNOWN = 0;

    // High movement
    HIGH_MVMT = 1;

    // Low movement
    LOW_MVMT = 2;

    // Stationary
    STATIONARY = 3;
  }

  // The device mobility state
  optional DeviceMobilityState device_mobility_state = 1;

  // The number of times that this state was entered
  optional int32 num_times_entered_state = 2;

  // The total duration elapsed while in this mobility state, in ms
  optional int64 total_duration_ms = 3;

  // the total duration elapsed while in this mobility state with PNO scans running, in ms
  optional int64 pno_duration_ms = 4;
}

// The information about the Wifi P2p events.
message WifiP2pStats {

  // Group event list tracking sessions and client counts in tethered mode.
  repeated GroupEvent group_event = 1;

  // Session information that gets logged for every Wifi P2p connection.
  repeated P2pConnectionEvent connection_event = 2;

  // Number of persistent group in the user profile.
  optional int32 num_persistent_group = 3;

  // Number of peer scan.
  optional int32 num_total_peer_scans = 4;

  // Number of service scan.
  optional int32 num_total_service_scans = 5;
}

message P2pConnectionEvent {

  enum ConnectionType {

    // fresh new connection.
    CONNECTION_FRESH = 0;

    // reinvoke a group.
    CONNECTION_REINVOKE = 1;

    // create a group with the current device as the group owner locally.
    CONNECTION_LOCAL = 2;

    // create a group or join a group with config.
    CONNECTION_FAST = 3;
  }

  enum ConnectivityLevelFailure {

    // Failure is unknown.
    CLF_UNKNOWN = 0;

    // No failure.
    CLF_NONE = 1;

    // Timeout for current connecting request.
    CLF_TIMEOUT = 2;

    // The connecting request is canceled by the user.
    CLF_CANCEL = 3;

    // Provision discovery failure, e.g. no pin code, timeout, rejected by the peer.
    CLF_PROV_DISC_FAIL = 4;

    // Invitation failure, e.g. rejected by the peer.
    CLF_INVITATION_FAIL = 5;

    // Incoming request is rejected by the user.
    CLF_USER_REJECT = 6;

    // New connection request is issued before ending previous connecting request.
    CLF_NEW_CONNECTION_ATTEMPT = 7;
  }

  // WPS method.
  enum WpsMethod {
    // WPS is skipped for Group Reinvoke.
    WPS_NA = -1;

    // Push button configuration.
    WPS_PBC = 0;

    // Display pin method configuration - pin is generated and displayed on device.
    WPS_DISPLAY = 1;

    // Keypad pin method configuration - pin is entered on device.
    WPS_KEYPAD = 2;

    // Label pin method configuration - pin is labelled on device.
    WPS_LABEL = 3;
  }

  // Start time of the connection.
  optional int64 start_time_millis = 1;

  // Type of the connection.
  optional ConnectionType connection_type = 2;

  // WPS method.
  optional WpsMethod wps_method = 3 [default = WPS_NA];

  // Duration to connect.
  optional int32 duration_taken_to_connect_millis = 4;

  // Failures that happen at the connectivity layer.
  optional ConnectivityLevelFailure connectivity_level_failure_code = 5;

  // Group role. This could be unknown with connect() call when the WifiConfig doesn't have the
  // credential.
  optional GroupEvent.GroupRole group_role = 6;
}

// GroupEvent tracking group information from GroupStarted to GroupRemoved.
message GroupEvent {

  enum GroupRole {

    GROUP_OWNER = 0;

    GROUP_CLIENT = 1;

    GROUP_UNKNOWN = 2;
  }

  // The ID of network in supplicant for this group.
  optional int32 net_id = 1;

  // Start time of the group.
  optional int64 start_time_millis = 2;

  // Channel frequency used for Group.
  optional int32 channel_frequency = 3;

  // Is group owner or group client.
  optional GroupRole group_role = 5;

  // Number of connected clients.
  optional int32 num_connected_clients = 6;

  // Cumulative number of connected clients.
  optional int32 num_cumulative_clients = 7;

  // The session duration.
  optional int32 session_duration_millis = 8;

  // The idle duration. A group without any client is in idle.
  optional int32 idle_duration_millis = 9;
}

// Easy Connect (DPP)
message WifiDppLog {
  reserved 6;

  // Number of Configurator-Initiator requests
  optional int32 num_dpp_configurator_initiator_requests = 1;

  // Number of Enrollee-Initiator requests
  optional int32 num_dpp_enrollee_initiator_requests = 2;

  // Easy Connect (DPP) Enrollee success
  optional int32 num_dpp_enrollee_success = 3;

  // Easy Connect (DPP) Configurator success code bucket
  repeated DppConfiguratorSuccessStatusHistogramBucket dpp_configurator_success_code = 4;

  // Easy Connect (DPP) failure code bucket
  repeated DppFailureStatusHistogramBucket dpp_failure_code = 5;

  // Easy Connect (DPP) operation time bucket
  repeated HistogramBucketInt32 dpp_operation_time = 7;

  // Number of Enrollee-Responder peer devices supporting DPP protocol version 1
  optional int32 num_dpp_r1_capable_enrollee_responder_devices = 8;

  // Number of Enrollee-Responder peer devices supporting DPP protocol version 2
  optional int32 num_dpp_r2_capable_enrollee_responder_devices = 9;

  // Number of Enrollee-Responder incompatible configurations found in DPP R2 compatibility check.
  optional int32 num_dpp_r2_enrollee_responder_incompatible_configuration = 10;

  // Number of Enrollee-Responder requests
  optional int32 num_dpp_enrollee_responder_requests = 11;

  // Number of Enrollee-Responder success
  optional int32 num_dpp_enrollee_responder_success = 12;

  // Histogram bucket for Wi-Fi DPP configurator success
  message DppConfiguratorSuccessStatusHistogramBucket {
    // status type defining the bucket
    optional DppConfiguratorSuccessCode dpp_status_type = 1;

    // number of samples in the bucket
    optional int32 count = 2;
  }

  // Histogram bucket for Wi-Fi DPP failures
  message DppFailureStatusHistogramBucket {
    // status type defining the bucket
    optional DppFailureCode dpp_status_type = 1;

    // number of samples in the bucket
    optional int32 count = 2;
  }

  enum DppConfiguratorSuccessCode {
    // Unknown success code
    EASY_CONNECT_EVENT_SUCCESS_UNKNOWN = 0;

    // Easy Connect Configurator success event: Configuration sent to enrollee
    EASY_CONNECT_EVENT_SUCCESS_CONFIGURATION_SENT = 1;

    // Easy Connect Configurator success event: Configuration applied by enrollee
    EASY_CONNECT_EVENT_SUCCESS_CONFIGURATION_APPLIED = 2;
  }

  enum DppFailureCode {
    // Unknown failure
    EASY_CONNECT_EVENT_FAILURE_UNKNOWN = 0;

    // Easy Connect Failure event: Scanned QR code is either not a Easy Connect URI, or the Easy
    // Connect URI has errors.
    EASY_CONNECT_EVENT_FAILURE_INVALID_URI = 1;

    // Easy Connect Failure event: Bootstrapping/Authentication initialization process failure.
    EASY_CONNECT_EVENT_FAILURE_AUTHENTICATION = 2;

    // Easy Connect Failure event: Both devices are implementing the same role and are
    // incompatible.
    EASY_CONNECT_EVENT_FAILURE_NOT_COMPATIBLE = 3;

    // Easy Connect Failure event: Configuration process has failed due to malformed message.
    EASY_CONNECT_EVENT_FAILURE_CONFIGURATION = 4;

    // Easy Connect Failure event: Easy Connect request while in another Easy Connect exchange.
    EASY_CONNECT_EVENT_FAILURE_BUSY = 5;

    // Easy Connect Failure event: No response from the peer.
    EASY_CONNECT_EVENT_FAILURE_TIMEOUT = 6;

    // Easy Connect Failure event: General protocol failure.
    EASY_CONNECT_EVENT_FAILURE_GENERIC = 7;

    // Easy Connect Failure event: Feature or option is not supported.
    EASY_CONNECT_EVENT_FAILURE_NOT_SUPPORTED = 8;

    // Easy Connect Failure event: Invalid network provided to Easy Connect configurator.
    // Network must either be WPA3-Personal (SAE) or WPA2-Personal (PSK).
    EASY_CONNECT_EVENT_FAILURE_INVALID_NETWORK = 9;

    // Easy Connect R2 Failure event: Enrollee cannot find the network.
    EASY_CONNECT_EVENT_FAILURE_CANNOT_FIND_NETWORK = 10;

    // Easy Connect R2 Failure event: Enrollee failed to authenticate with the network.
    EASY_CONNECT_EVENT_FAILURE_ENROLLEE_AUTHENTICATION = 11;

    // Easy Connect R2 Failure event: Enrollee rejected the configuration.
    EASY_CONNECT_EVENT_FAILURE_ENROLLEE_REJECTED_CONFIGURATION = 12;

    // Easy Connect Failure event: System failed to generate DPP URI.
    EASY_CONNECT_EVENT_FAILURE_URI_GENERATION = 13;

    // Easy Connect Failure event: Enrollee didn't scan the network's operating channel.
    EASY_CONNECT_EVENT_FAILURE_ENROLLEE_FAILED_TO_SCAN_NETWORK_CHANNEL = 14;
  }
}

// WifiConfigStore read/write metrics.
message WifiConfigStoreIO {
  // Histogram of config store read durations.
  repeated DurationBucket read_durations = 1;

  // Histogram of config store write durations.
  repeated DurationBucket write_durations = 2;

  // Total Number of instances of write/read duration in this duration bucket.
  message DurationBucket {
    // Bucket covers duration : [range_start_ms, range_end_ms)
    // The (inclusive) lower bound of read/write duration represented by this bucket
    optional int32 range_start_ms = 1;

    // The (exclusive) upper bound of read/write duration represented by this bucket
    optional int32 range_end_ms = 2;

    // Number of read/write durations that fit into this bucket
    optional int32 count = 3;
  }
}

// Histogram bucket counting with int32. Range is [start, end)
message HistogramBucketInt32 {
  // lower range of the bucket (inclusive)
  optional int32 start = 1;

  // upper range of the bucket (exclusive)
  optional int32 end = 2;

  // number of samples in the bucket
  optional int32 count = 3;
}

// Counts occurrences of a int32 key
message Int32Count {
  // the key
  optional int32 key = 1;

  // the count
  optional int32 count = 2;
}

message LinkProbeStats {
  enum LinkProbeFailureReason {
    // unknown reason
    LINK_PROBE_FAILURE_REASON_UNKNOWN = 0;

    // Specified MCS rate when it is unsupported by the driver.
    LINK_PROBE_FAILURE_REASON_MCS_UNSUPPORTED = 1;

    // Driver reported that no ACK was received for the transmitted probe.
    LINK_PROBE_FAILURE_REASON_NO_ACK = 2;

    // Driver failed to report on the status of the transmitted probe within the timeout.
    LINK_PROBE_FAILURE_REASON_TIMEOUT = 3;

    // An existing link probe is in progress.
    LINK_PROBE_FAILURE_REASON_ALREADY_STARTED = 4;
  }

  // Counts the number of failures for each failure reason.
  message LinkProbeFailureReasonCount {
    // The failure reason.
    optional LinkProbeFailureReason failure_reason = 1;

    // The number of occurrences for this failure reason.
    optional int32 count = 2;
  }

  // Counts the number of link probes for each experiment.
  message ExperimentProbeCounts {
    // The experiment ID.
    optional string experiment_id = 1;

    // The number of link probes triggered for this experiment.
    optional int32 probe_count = 2;
  }

  // Counts the occurrences of RSSI values when a link probe succeeds.
  repeated Int32Count success_rssi_counts = 1;

  // Counts the occurrences of RSSI values when a link probe fails.
  repeated Int32Count failure_rssi_counts = 2;

  // Counts the occurrences of Link Speed values when a link probe succeeds.
  repeated Int32Count success_link_speed_counts = 3;

  // Counts the occurrences of Link Speed values when a link probe fails.
  repeated Int32Count failure_link_speed_counts = 4;

  // Histogram for the number of seconds since the last TX success when a link probe succeeds.
  repeated HistogramBucketInt32 success_seconds_since_last_tx_success_histogram = 5;

  // Histogram for the number of seconds since the last TX success when a link probe fails.
  repeated HistogramBucketInt32 failure_seconds_since_last_tx_success_histogram = 6;

  // Histogram for the elapsed time of successful link probes, in ms.
  repeated HistogramBucketInt32 success_elapsed_time_ms_histogram = 7;

  // Counts the occurrences of error codes for failed link probes.
  repeated LinkProbeFailureReasonCount failure_reason_counts = 8;

  // Counts the number of link probes for each experiment.
  repeated ExperimentProbeCounts experiment_probe_counts = 9;
}

// Stores the decisions that were made by a experiment when compared against another experiment
message NetworkSelectionExperimentDecisions {
  // the id of one experiment
  optional int32 experiment1_id = 1;

  // the id of the other experiment
  optional int32 experiment2_id = 2;

  // Counts occurrences of the number of network choices there were when experiment1 makes the
  // same network selection as experiment2.
  // The keys are the number of network choices, and the values are the number of occurrences of
  // this number of network choices when exp1 and exp2 make the same network selection.
  repeated Int32Count same_selection_num_choices_counter = 3;

  // Counts occurrences of the number of network choices there were when experiment1 makes the
  // same network selection as experiment2.
  // The keys are the number of network choices, and the values are the number of occurrences of
  // this number of network choices when exp1 and exp2 make different network selections.
  // Note that it is possible for the network selection to be different even when there only exists
  // a single network choice, since choosing not to connect to that network is a valid choice.
  repeated Int32Count different_selection_num_choices_counter = 4;
}

// NetworkRequest API metrics.
message WifiNetworkRequestApiLog {
  // Number of requests via this API surface.
  optional int32 num_request = 1;

  // Histogram of requests via this API surface to number of networks matched in scan results.
  repeated HistogramBucketInt32 network_match_size_histogram = 2;

  // Number of requests via this API surface that bypassed user approval.
  optional int32 num_user_approval_bypass = 4;

  // Number of requests via this API surface that was rejected by the user.
  optional int32 num_user_reject = 5;

  // Number of unique apps using this API surface.
  optional int32 num_apps = 6;

  // Number of connections on primary iface.
  optional int32 num_connect_on_primary_iface = 7;

  // Number of successful network connection from this API.
  optional int32 num_connect_success_on_primary_iface = 3;

  // Histogram of connection durations in seconds using this API surface.
  repeated HistogramBucketInt32 connection_duration_sec_on_primary_iface_histogram = 8;

  // Number of connections on secondary iface (STA + STA)
  optional int32 num_connect_on_secondary_iface = 9;

  // Number of connection success on secondary iface (STA + STA)
  optional int32 num_connect_success_on_secondary_iface = 10;

  // Histogram of connection durations in seconds on secondary iface using this API surface.
  repeated HistogramBucketInt32 connection_duration_sec_on_secondary_iface_histogram = 11;

  // Number of times there were concurrent connections (STA + STA):
  // - on a primary iface (internet) and
  // - on a secondary iface (using this API surface)
  optional int32 num_concurrent_connection = 12;

  // Histogram of concurrent connection durations in seconds using this API surface (STA + STA).
  repeated HistogramBucketInt32 concurrent_connection_duration_sec_histogram = 13;
}

// NetworkSuggestion API metrics.
message WifiNetworkSuggestionApiLog {
  enum SuggestionAppTypeCode {
    // UNKNOWN type suggestion app.
    TYPE_UNKNOWN = 0;
    // Suggestion app with carrier privilege.
    TYPE_CARRIER_PRIVILEGED = 1;
    // Suggestion app with network provisioning permission(NETWORK_CARRIER_PROVISIONING).
    TYPE_NETWORK_PROVISIONING = 2;
    // Suggestion app without special privilege.
    TYPE_NON_PRIVILEGED = 3;
  }

  message SuggestionAppCount {
    // Suggestion app type.
    optional SuggestionAppTypeCode app_type = 1;
    // Num of app in this type.
    optional int32 count = 2;
  }

  // Number of modifications to their suggestions by apps.
  optional int32 num_modification = 1;

  // Number of successful network connection from app suggestions.
  optional int32 num_connect_success = 2;

  // Number of network connection failures from app suggestions.
  optional int32 num_connect_failure = 3;

  // Histogram for size of the network lists provided by various apps on the device.
  repeated HistogramBucketInt32 network_list_size_histogram = 4;

  // Count of app using suggestion API with different privilege.
  repeated SuggestionAppCount app_count_per_type = 5;

  // Number of user revoke app's permission from settings or disallowed from UI.
  optional int32 user_revoke_app_suggestion_permission = 6;

  // Number of priority groups configured on the device, excluding the default priority group.
  optional int32 num_priority_groups = 7;

  // Number of times when a ScanResult matched more than one suggestions.
  optional int32 num_multiple_suggestions = 8;

  // Number of saved profiles which also have at least one suggestion (for the same network)
  // provisioned on the device.
  optional int32 num_saved_networks_with_configured_suggestion = 9;
}

// WifiLock metrics
message WifiLockStats {
    // Amount of time wifi is actively in HIGH_PERF mode (ms)
    // This means the lock takes effect and the device takes the actions required for this mode
    optional int64 high_perf_active_time_ms = 1;

    // Amount of time wifi is actively in LOW_LATENCY mode (ms)
    // This means the lock takes effect and the device takes the actions required for this mode
    optional int64 low_latency_active_time_ms = 2;

    // Histogram of HIGH_PERF lock acquisition duration (seconds)
    // Note that acquiring the lock does not necessarily mean that device is actively in that mode
    repeated HistogramBucketInt32 high_perf_lock_acq_duration_sec_histogram = 3;

    // Histogram of LOW_LATENCY lock acquisition duration (seconds)
    // Note that acquiring the lock does not necessarily mean that device is actively in that mode
    repeated HistogramBucketInt32 low_latency_lock_acq_duration_sec_histogram = 4;

    // Histogram of HIGH_PERF active session duration (seconds)
    // This means the lock takes effect and the device takes the actions required for this mode
    repeated HistogramBucketInt32 high_perf_active_session_duration_sec_histogram = 5;

    // Histogram of LOW_LATENCY active session duration (seconds)
    // This means the lock takes effect and the device takes the actions required for this mode
    repeated HistogramBucketInt32 low_latency_active_session_duration_sec_histogram = 6;
}

// Stats on number of times Wi-Fi is turned on/off though the WifiManager#setWifiEnabled API
message WifiToggleStats {
  // Number of time Wi-Fi is turned on by privileged apps
  optional int32 num_toggle_on_privileged = 1;

  // Number of time Wi-Fi is turned off by privileged apps
  optional int32 num_toggle_off_privileged = 2;

  // Number of time Wi-Fi is turned on by normal apps
  optional int32 num_toggle_on_normal = 3;

  // Number of time Wi-Fi is turned off by normal apps
  optional int32 num_toggle_off_normal = 4;
}

// Information about the Passpoint provision metrics.
message PasspointProvisionStats {
  enum ProvisionFailureCode {
    // provisioning failure for unknown reason.
    OSU_FAILURE_UNKNOWN = 0;

    // The reason code for Provisioning Failure due to connection failure to OSU AP.
    OSU_FAILURE_AP_CONNECTION = 1;

    // The reason code for invalid server URL address.
    OSU_FAILURE_SERVER_URL_INVALID = 2;

    // The reason code for provisioning failure due to connection failure to the server.
    OSU_FAILURE_SERVER_CONNECTION = 3;

    // The reason code for provisioning failure due to invalid server certificate.
    OSU_FAILURE_SERVER_VALIDATION = 4;

    // The reason code for provisioning failure due to invalid service provider.
    OSU_FAILURE_SERVICE_PROVIDER_VERIFICATION = 5;

    // The reason code for provisioning failure when a provisioning flow is aborted.
    OSU_FAILURE_PROVISIONING_ABORTED = 6;

    // The reason code for provisioning failure when a provisioning flow is not possible.
    OSU_FAILURE_PROVISIONING_NOT_AVAILABLE = 7;

    // The reason code for provisioning failure due to invalid web url format for an OSU web page.
    OSU_FAILURE_INVALID_URL_FORMAT_FOR_OSU = 8;

    // The reason code for provisioning failure when a command received is not the expected command
    // type.
    OSU_FAILURE_UNEXPECTED_COMMAND_TYPE = 9;

    // The reason code for provisioning failure when a SOAP message is not the expected message
    // type.
    OSU_FAILURE_UNEXPECTED_SOAP_MESSAGE_TYPE = 10;

    // The reason code for provisioning failure when a SOAP message exchange fails.
    OSU_FAILURE_SOAP_MESSAGE_EXCHANGE = 11;

    // The reason code for provisioning failure when a redirect listener fails to start.
    OSU_FAILURE_START_REDIRECT_LISTENER = 12;

    // The reason code for provisioning failure when a redirect listener timed out to receive a HTTP
    // redirect response.
    OSU_FAILURE_TIMED_OUT_REDIRECT_LISTENER = 13;

    // The reason code for provisioning failure when there is no OSU activity to listen to intent.
    OSU_FAILURE_NO_OSU_ACTIVITY_FOUND = 14;

    // The reason code for provisioning failure when the status of a SOAP message is not the
    // expected message status.
    OSU_FAILURE_UNEXPECTED_SOAP_MESSAGE_STATUS = 15;

    // The reason code for provisioning failure when there is no PPS MO.
    OSU_FAILURE_NO_PPS_MO = 16;

    // The reason code for provisioning failure when there is no AAAServerTrustRoot node in a PPS
    // MO.
    OSU_FAILURE_NO_AAA_SERVER_TRUST_ROOT_NODE = 17;

    // The reason code for provisioning failure when there is no TrustRoot node for remediation
    // server in a PPS MO.
    OSU_FAILURE_NO_REMEDIATION_SERVER_TRUST_ROOT_NODE = 18;

    // The reason code for provisioning failure when there is no TrustRoot node for policy server in
    // a PPS MO.
    OSU_FAILURE_NO_POLICY_SERVER_TRUST_ROOT_NODE = 19;

    // The reason code for provisioning failure when failing to retrieve trust root certificates
    // used for validating server certificate for AAA, Remediation and Policy server.
    OSU_FAILURE_RETRIEVE_TRUST_ROOT_CERTIFICATES = 20;

    // The reason code for provisioning failure when there is no trust root certificate for AAA
    // server.
    OSU_FAILURE_NO_AAA_TRUST_ROOT_CERTIFICATE = 21;

    // The reason code for provisioning failure when a {@link PasspointConfiguration} is failed to
    // install.
    OSU_FAILURE_ADD_PASSPOINT_CONFIGURATION = 22;

    // The reason code for provisioning failure when an {@link OsuProvider} is not found for
    // provisioning.
    OSU_FAILURE_OSU_PROVIDER_NOT_FOUND = 23;
  }

  // Number of passpoint provisioning success
  optional int32 num_provision_success = 1;

  // Count for passpoint provisioning failure
  repeated ProvisionFailureCount provision_failure_count = 2;

  // Number of occurrences of a specific passpoint provision failure code
  message ProvisionFailureCount {
    // Failure code
    optional ProvisionFailureCode failure_code = 1;

    // Number of failure for the failure_code.
    optional int32 count = 2;
  }
}

// Counts number of networks on the device that are metered.
message MeteredNetworkStats {
  // Number of networks that are set or detected as metered.
  optional int32 num_metered = 1 [default = 0];

  // Number of networks that are set or detected as unmetered.
  optional int32 num_unmetered = 2;

  // Number of networks that have meteredOverride set to metered.
  optional int32 num_override_metered = 3;

  // Number of networks that have meteredOverride set to unmetered.
  optional int32 num_override_unmetered = 4;
}

// An event capturing user action on wifi
message UserActionEvent {
  enum EventType {
    // The default and unused event
    EVENT_UNKNOWN = 0;
    // User forgets the network
    EVENT_FORGET_WIFI = 1;
    // User manually triggers disconnect
    EVENT_DISCONNECT_WIFI = 2;
    // User changes the metered setting to "metered"
    EVENT_CONFIGURE_METERED_STATUS_METERED = 3;
    // User changes the metered setting to "unmetered"
    EVENT_CONFIGURE_METERED_STATUS_UNMETERED = 4;
    // User changes the mac randomization setting to use random MAC
    EVENT_CONFIGURE_MAC_RANDOMIZATION_ON = 5;
    // User changes the mac randomization setting to use factory MAC
    EVENT_CONFIGURE_MAC_RANDOMIZATION_OFF = 6;
    // User sets auto-connect to on
    EVENT_CONFIGURE_AUTO_CONNECT_ON = 7;
    // User sets auto-connect to off
    EVENT_CONFIGURE_AUTO_CONNECT_OFF = 8;
    // User toggles wifi on
    EVENT_TOGGLE_WIFI_ON = 9;
    // User toggles wifi off
    EVENT_TOGGLE_WIFI_OFF = 10;
    // User manually connects to a network
    EVENT_MANUAL_CONNECT = 11;
    // User changes the metered setting to "detect automatically"
    EVENT_CONFIGURE_METERED_STATUS_AUTO = 12;
    // User adds a new network or updates configurations for an existing network.
    EVENT_ADD_OR_UPDATE_NETWORK = 13;
    // User sets the adaptive connectivity to on
    EVENT_CONFIGURE_ADAPTIVE_CONNECTIVITY_ON = 14;
    // User sets the adaptive connectivity to off
    EVENT_CONFIGURE_ADAPTIVE_CONNECTIVITY_OFF = 15;
    // User restarts wifi subsystem
    EVENT_RESTART_WIFI_SUB_SYSTEM = 16;
  }

  // The type of user action
  optional EventType event_type = 1;

  // The start time of the event in milliseconds since boot.
  optional int64 start_time_millis = 2;

  // Additional information on the target network for the action. This is not applicable and will
  // be null for some actions such as EVENT_TOGGLE_WIFI_ON.
  optional TargetNetworkInfo target_network_info = 3;

  // Information about the currently connected network.
  optional WifiStatus wifi_status = 4;

  // Reasons why the network applicable for this user action is disabled.
  // Normally this should be referring to the currently connected network.
  // For a manual connection, this is referring to the user selected networks.
  optional NetworkDisableReason network_disable_reason = 5;
}

message WifiStatus {
  // Wifi is connected.
  optional bool is_connected = 1;

  // Wifi is validated
  optional bool is_validated = 2;

  // The last observed RSSI
  optional sint32 last_rssi = 3;

  // Estimated TX
  optional int32 estimated_tx_kbps = 4;

  // Estimated RX
  optional int32 estimated_rx_kbps = 5;

  // There is another candidate with better score, but user connect choice is preventing the switch.
  optional bool is_stuck_due_to_user_connect_choice = 6;
}

// Additional information on a network
message TargetNetworkInfo {
  // Whether the network is an ephemeral network.
  optional bool is_ephemeral = 1;

  // Whether the target is a passpoint network.
  optional bool is_passpoint = 2;
}

// Reasons why a configuration or BSSID is disabled.
message NetworkDisableReason {
  enum DisableReason {
    // Default value, should not be used.
    REASON_UNKNOWN = 0;
    // AP unable to accept more clients, a special kind of association rejection failure.
    REASON_AP_UNABLE_TO_HANDLE_NEW_STA = 1;
    // No internet
    REASON_NETWORK_VALIDATION_FAILURE = 2;
    // Password is incorrect, a special kind of authentication failure.
    REASON_WRONG_PASSWORD = 3;
    // Incorrect EAP credentials.
    REASON_EAP_FAILURE = 4;
    // Other association rejection failures.
    REASON_ASSOCIATION_REJECTION = 5;
    // Associated timeout failures.
    REASON_ASSOCIATION_TIMEOUT = 6;
    // Other authentication failures.
    REASON_AUTHENTICATION_FAILURE = 7;
    // DHCP failures.
    REASON_DHCP_FAILURE = 8;
    // Device disconnected shortly after connection.
    REASON_ABNORMAL_DISCONNECT = 9;
    // AP initiated disconnect for a given duration.
    REASON_FRAMEWORK_DISCONNECT_MBO_OCE = 10;
    // Avoid connecting to the failed AP when trying to reconnect on other available candidates.
    REASON_FRAMEWORK_DISCONNECT_FAST_RECONNECT = 11;
    // The connected scorer has disconnected this network.
    REASON_FRAMEWORK_DISCONNECT_CONNECTED_SCORE = 12;
    // The network is disabled due to absence of user credentials
    REASON_AUTHENTICATION_NO_CREDENTIALS = 13;
    // The network is disabled because service is not subscribed, a special kind of EAP failure.
    REASON_AUTHENTICATION_NO_SUBSCRIPTION = 14;
    // User disabled auto-join for this network.
    REASON_AUTO_JOIN_DISABLED = 15;
  }

  // The reason for disabling a network.
  optional DisableReason disable_reason = 1;

  // The configuration is temporarily disabled.
  optional bool config_temporarily_disabled = 2;

  // The configuration is disabled until the user manually re-enables it.
  optional bool config_permanently_disabled = 3;

  // Reasons why 1 or more BSSIDs are temporarily disabled.
  repeated DisableReason bssid_disable_reasons = 4;
}

// Number of networks with a large change of connection/disconnection
// failure rate or high failure rate at high RSSI
message HealthMonitorFailureStats {
  // Number of networks with a large change of (or high) association rejection rate
  optional int32 cnt_assoc_rejection = 1;
  // Number of networks with a large change of (or high) association timeout rate
  optional int32 cnt_assoc_timeout = 2;
  // Number of networks with a large change of (or high) auth failure rate
  optional int32 cnt_auth_failure = 3;
  // Number of networks with a large change of (or high) connection failure rate
  optional int32 cnt_connection_failure = 4;
  // Number of networks with a large change of (or high) nonlocal disconnection rate
  optional int32 cnt_disconnection_nonlocal = 5;
  // Number of networks with a large change of (or high) short disconnection rate
  optional int32 cnt_short_connection_nonlocal = 6;
  // Number of networks with a large change of (or high) disconnection-during-connecting rate
  optional int32 cnt_disconnection_nonlocal_connecting = 7;
}

// Metrics collected by health monitor
message HealthMonitorMetrics {
  // Number of networks with a large increase (compared to stats of previous build) of
  // connection/disconnection failure rate
  optional HealthMonitorFailureStats failure_stats_increase = 1;
  // Number of networks with a large decrease (compared to stats of previous build) of
  // connection/disconnection failure rate
  optional HealthMonitorFailureStats failure_stats_decrease = 2;
  // Number of networks with high connection/disconnection failure rate for
  // current build but without sufficient connection attempts for previous build
  optional HealthMonitorFailureStats failure_stats_high = 3;
  // Number of networks with sufficient connection attempts for current build
  // but without suffcient connection attempts for previous build
  optional int32 num_network_sufficient_recent_stats_only = 4;
  // Number of networks with sufficient connection attempts for both current and previous builds
  optional int32 num_network_sufficient_recent_prev_stats = 5;
}

// Connection duration statistics collected under various health conditions
// while Wifi link layer stats report are on
message ConnectionDurationStats {
  // Total time with sufficient Wifi throughput and with cellular data on
  optional int32 total_time_sufficient_throughput_ms = 1;
  // Total time with insufficient Wifi throughput and with cellular data on
  optional int32 total_time_insufficient_throughput_ms = 2;
  // Total time with cellular data off
  optional int32 total_time_cellular_data_off_ms = 3;
  // Total time with insufficient Wifi throughput and with cellular data on
  // while wifi is the default network
  optional int32 total_time_insufficient_throughput_default_wifi_ms = 4;
}

// Wi-Fi off metrics
// Keeps track of Wi-Fi off stats
message WifiOffMetrics {
  // Total number of Wi-Fi off
  optional int32 num_wifi_off = 1;

  // Total number of Wi-Fi off with deferring
  optional int32 num_wifi_off_deferring = 2;

  // Total number of Wi-Fi off deferring timeout
  optional int32 num_wifi_off_deferring_timeout = 3;

  // Histogram of wifi off deferring time
  repeated Int32Count wifi_off_deferring_time_histogram = 4;
}

// SoftAp Config  Limitation Metrics
message SoftApConfigLimitationMetrics {
  // Total number of softap security configuration reset to default because
  // hardware limitation when restore configuration from cloud
  optional int32 num_security_type_reset_to_default = 1;

  // Total number of softap max client setting reset to default because
  // hardware limitation when restore configuration from cloud
  optional int32 num_max_client_setting_reset_to_default = 2;

  // Total number of softap client control by user reset to default because
  // hardware limitation when restore configuration from cloud
  optional int32 num_client_control_by_user_reset_to_default = 3;

  // Histogram of max client count when client connection fail because
  // setting limitation
  repeated Int32Count max_client_setting_when_reach_histogram = 4;
}

// Channel utilization histogram
// The valid utilization range is between 0 and 255 corresponding to
// utilization ratio between 0 and 1
message ChannelUtilizationHistogram {
  // Histogram at 2G
  repeated HistogramBucketInt32 utilization_2g = 1;
  // Histogram above 2G
  repeated HistogramBucketInt32 utilization_above_2g = 2;
}

// Throughput histogram
message ThroughputMbpsHistogram {
  // Tx histogram at 2G
  repeated HistogramBucketInt32 tx_2g = 1;
  // Tx histogram above 2G
  repeated HistogramBucketInt32 tx_above_2g = 2;
  // Rx histogram at 2G
  repeated HistogramBucketInt32 rx_2g = 3;
  // Rx histogram above 2G
  repeated HistogramBucketInt32 rx_above_2g = 4;
}

// Initial Partial Scan stats
message InitPartialScanStats {
  // Total number of partial scans
  optional int32 num_scans = 1;

  // Number of instances a partial scan results in finding a network
  optional int32 num_success_scans = 2;

  // Number of instances a patial scan does not result in finding a network
  // and a follow up full scan finds a network.
  optional int32 num_failure_scans = 3;

  // Histogram of number of channels used in a successful partial scan
  repeated HistogramBucketInt32 successful_scan_channel_count_histogram = 4;

  // Histogram of number of channels used in a failed partial scan
  repeated HistogramBucketInt32 failed_scan_channel_count_histogram = 5;
}

// User reaction to the carrier IMSI protection exemption UI
message UserReactionToApprovalUiEvent {
  enum UserActionCode {
    // UNKNOWN user action.
    ACTION_UNKNOWN = 0;
    // Action user allowed.
    ACTION_ALLOWED = 1;
    // Action user disallowed.
    ACTION_DISALLOWED = 2;
    // Action user dismiss.
    ACTION_DISMISS = 3;
  }
  message UserReaction {
    // User action to the UI.
    optional UserActionCode user_action = 1;
    // Is UI a dialog or notification.
    optional bool is_dialog = 2;
  }

  // Event of user reaction to the app approval UI.
  repeated UserReaction user_approval_app_ui_reaction = 1;

  // Event of user reaction to the carrier approval UI.
  repeated UserReaction user_approval_carrier_ui_reaction = 2;
}

message CarrierWifiMetrics {
  // Number of successful network connection using Carrier ID
  optional int32 num_connection_success = 1;
  // Number of failed authentication from network connection using Carrier ID
  optional int32 num_connection_auth_failure = 2;
  optional int32 num_connection_non_auth_failure = 3;
}

message FirstConnectAfterBootStats {
  message Attempt {
    // The attempt completion timestamp, in milliseconds since boot.
    optional int64 timestamp_since_boot_millis = 1;

    // whether the attempt was successful.
    optional bool is_success = 2;
  }

  // Info about whether Wifi was enabled at boot time.
  // `is_success` is true if Wifi is toggled ON at boot, false otherwise.
  // This field will never be null.
  optional Attempt wifi_enabled_at_boot = 1;

  // Info about the first network selection attempt for auto-join.
  // `is_success` is true if a network candidate was found, false otherwise.
  // This field is null if `wifi_enabled_at_boot.is_success` is false.
  optional Attempt first_network_selection = 2;

  // Info about the first successful L2 connection.
  // `is_success` is true if the L2 connection was successfully established, false otherwise.
  // This field is null if `first_network_selection.is_success` is false.
  optional Attempt first_l2_connection = 3;

  // Info about the first successful L3 connection.
  // `is_success` is true if the L3 connection was successfully established, false otherwise.
  // This field is null if `first_l2_connection.is_success` is false.
  optional Attempt first_l3_connection = 4;
}

// Stats for Autojoin switches between Wifi networks. Does not include user/app-initiated switches.
message WifiToWifiSwitchStats {
  // Whether Make Before Break is supported by the hardware and enabled.
  optional bool is_make_before_break_supported = 1;

  // Number of times Wifi to Wifi switch was triggered. This includes Make Before Break and Break
  // Before Make.
  optional int32 wifi_to_wifi_switch_trigger_count = 2;

  // Number of times Wifi to Wifi switch was triggered using Make Before Break (MBB).
  // Note that MBB may not always be used for various reasons e.g. no additional iface available due
  // to ongoing SoftAP, both old and new network have MAC randomization disabled, etc.
  // TODO(b/180974604): also add metrics for the various reasons to not use MBB even when it is
  //  supported by the device.
  optional int32 make_before_break_trigger_count = 3;

  // TODO(b/180974604): add metrics for L2 failure and L3 failure

  // Number of times Make Before Break was aborted due to the new network not having internet.
  optional int32 make_before_break_no_internet_count = 4;

  // Number of times where, for some reason, Make Before Break resulted in the loss of the primary
  // ClientModeManager, and we needed to recover by making one of the SECONDARY_TRANSIENT
  // ClientModeManagers primary.
  optional int32 make_before_break_recover_primary_count = 5;

  // Number of times the new network in Make Before Break had its internet connection validated.
  optional int32 make_before_break_internet_validated_count = 6;

  // Number of times the new network was made primary in Make Before Break.
  // TODO(b/180974604): add metrics for the various ways this could fail.
  optional int32 make_before_break_success_count = 7;

  // Number of times the old network in Make Before Break completed lingering and was disconnected.
  optional int32 make_before_break_linger_completed_count = 8;

  // Histogram of lingering duration caused by make before break in seconds.
  repeated Int32Count make_before_break_linger_duration_seconds = 9;
}

// Network layer bandwidth estimator stats
message BandwidthEstimatorStats {
  // Bandwidth stats of each signal level
  message PerLevel {
    // Signal level derived by RssiUtil.calculateSignalLevel based on RSSI
    optional uint32 signal_level = 1;
    // Accumulated bandwidth sample count
    optional uint32 count = 2;
    // Average network layer bandwidth in kbps based on TrafficStats byte count and radio on time
    // of link layer stats.
    optional uint32 avg_bandwidth_kbps = 3;
    // Error of layer 2 link bandwidth in percent
    optional uint32 l2_error_percent = 4;
    // Error of network layer bandwidth estimation in percent
    optional uint32 bandwidth_est_error_percent = 5;
  }

  // Bandwidth stats of each link
  message PerLink {
    repeated PerLevel level = 1;
  }

  // Bandwidth stats of each band
  message PerBand {
    // Tx bandwidth stats
    optional PerLink tx = 1;
    // Rx bandwidth stats
    optional PerLink rx = 2;
  }

  // Stats of 2g band
  optional PerBand stats_2g = 1;
  // Stats of above-2g band
  optional PerBand stats_above_2g = 2;
}