blob: 72f11e0a63c1b6876e31ab0177c9ed36a646709b [file] [log] [blame]
/*
* 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 clearcut.connectivity;
option java_package = "com.android.server.wifi";
option java_outer_classname = "WifiMetricsProto";
// The information about the Wifi events.
message WifiLog {
// 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 personal networks.
optional int32 num_personal_networks = 4;
// Number of enterprise networks.
optional int32 num_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 personal networks
optional int32 num_personal_network_scan_results = 41;
// Total number of scan results for enterprise networks
optional int32 num_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 blacklisted from recommendation by the open network
// notification recommender
optional int32 open_network_recommender_blacklist_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
optional WpsMetrics wps_metrics = 91;
// 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;
}
// 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;
}
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;
}
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;
}
// Start time of the connection.
optional int64 start_time_millis = 1;// [(datapol.semantic_type) = ST_TIMESTAMP];
// 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;
}
// 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;
}
// 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;
}
// 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;
}
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;
}
// 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 occured 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 occured 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];
}
// 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;
// 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;
}
}
// 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 is Up and ready for use
SOFT_AP_UP = 0;
// Soft AP is Down
SOFT_AP_DOWN = 1;
// Number of connected soft AP clients has changed
NUM_CLIENTS_CHANGED = 2;
}
// 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;
}
// 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;
}
// Wps connection metrics
// Keeps track of Wi-Fi Protected Setup usage
message WpsMetrics {
// Total number of wps connection attempts
optional int32 num_wps_attempts = 1;
// Total number of wps connection successes
optional int32 num_wps_success = 2;
// Total number of wps failures on start
optional int32 num_wps_start_failure = 3;
// Total number of wps overlap failure
optional int32 num_wps_overlap_failure = 4;
// Total number of wps timeout failure
optional int32 num_wps_timeout_failure = 5;
// Total number of other wps failure during connection
optional int32 num_wps_other_connection_failure = 6;
// Total number of supplicant failure after wps
optional int32 num_wps_supplicant_failure = 7;
// Total number of wps cancellation
optional int32 num_wps_cancellation = 8;
}
// 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;
}
// 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;
// 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;
}
}