blob: 28bf85692a682f53b8b008ef115d065959d7534b [file] [log] [blame]
Glen Kuhne94814572016-10-25 12:40:35 -07001/*
2 * Copyright (C) 2016 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17syntax = "proto2";
18
19package clearcut.connectivity;
20
21option java_package = "com.android.server.wifi";
22option java_outer_classname = "WifiMetricsProto";
23
24// The information about the Wifi events.
25message WifiLog {
26
27 // Session information that gets logged for every Wifi connection.
28 repeated ConnectionEvent connection_event = 1;
29
30 // Number of saved networks in the user profile.
31 optional int32 num_saved_networks = 2;
32
33 // Number of open networks in the saved networks.
34 optional int32 num_open_networks = 3;
35
36 // Number of personal networks.
37 optional int32 num_personal_networks = 4;
38
39 // Number of enterprise networks.
40 optional int32 num_enterprise_networks = 5;
41
42 // Does the user have location setting enabled.
43 optional bool is_location_enabled = 6;
44
45 // Does the user have scanning enabled.
46 optional bool is_scanning_always_enabled = 7;
47
48 // Number of times user toggled wifi using the settings menu.
49 optional int32 num_wifi_toggled_via_settings = 8;
50
51 // Number of times user toggled wifi using the airplane menu.
52 optional int32 num_wifi_toggled_via_airplane = 9;
53
54 // Number of networks added by the user.
55 optional int32 num_networks_added_by_user = 10;
56
57 // Number of networks added by applications.
58 optional int32 num_networks_added_by_apps = 11;
59
60 // Number scans that returned empty results.
61 optional int32 num_empty_scan_results = 12;
62
63 // Number scans that returned at least one result.
64 optional int32 num_non_empty_scan_results = 13;
65
66 // Number of scans that were one time.
67 optional int32 num_oneshot_scans = 14;
68
69 // Number of repeated background scans that were scheduled to the chip.
70 optional int32 num_background_scans = 15;
71
72 // Error codes that a scan can result in.
73 enum ScanReturnCode {
74
75 // Return Code is unknown.
76 SCAN_UNKNOWN = 0;
77
78 // Scan was successful.
79 SCAN_SUCCESS = 1;
80
81 // Scan was successfully started, but was interrupted.
82 SCAN_FAILURE_INTERRUPTED = 2;
83
84 // Scan failed to start because of invalid configuration
85 // (bad channel, etc).
86 SCAN_FAILURE_INVALID_CONFIGURATION = 3;
87
88 // Could not start a scan because wifi is disabled.
89 FAILURE_WIFI_DISABLED = 4;
90
91 }
92
93 // Mapping of error codes to the number of times that scans resulted
94 // in that error.
95 repeated ScanReturnEntry scan_return_entries = 16;
96
97 message ScanReturnEntry {
98
99 // Return code of the scan.
100 optional ScanReturnCode scan_return_code = 1;
101
102 // Number of entries that were found in the scan.
103 optional int32 scan_results_count = 2;
104 }
105
106 // State of the Wifi.
107 enum WifiState {
108
109 // State is unknown.
110 WIFI_UNKNOWN = 0;
111
112 // Wifi is disabled.
113 WIFI_DISABLED = 1;
114
115 // Wifi is enabled.
116 WIFI_DISCONNECTED = 2;
117
118 // Wifi is enabled and associated with an AP.
119 WIFI_ASSOCIATED = 3;
120 }
121
122 // Mapping of system state to the number of times that scans were requested in
123 // that state
124 repeated WifiSystemStateEntry wifi_system_state_entries = 17;
125
126 message WifiSystemStateEntry {
127
128 // Current WiFi state.
129 optional WifiState wifi_state = 1;
130
131 // Count of scans in state.
132 optional int32 wifi_state_count = 2;
133
134 // Is screen on.
135 optional bool is_screen_on = 3;
136 }
137
138 // Mapping of Error/Success codes to the number of background scans that resulted in it
139 repeated ScanReturnEntry background_scan_return_entries = 18;
140
141 // Mapping of system state to the number of times that Background scans were requested in that
142 // state
143 repeated WifiSystemStateEntry background_scan_request_state = 19;
144
145 // Total number of times the Watchdog of Last Resort triggered, resetting the wifi stack
146 optional int32 num_last_resort_watchdog_triggers = 20;
147
148 // Total number of networks over bad association threshold when watchdog triggered
149 optional int32 num_last_resort_watchdog_bad_association_networks_total = 21;
150
151 // Total number of networks over bad authentication threshold when watchdog triggered
152 optional int32 num_last_resort_watchdog_bad_authentication_networks_total = 22;
153
154 // Total number of networks over bad dhcp threshold when watchdog triggered
155 optional int32 num_last_resort_watchdog_bad_dhcp_networks_total = 23;
156
157 // Total number of networks over bad other threshold when watchdog triggered
158 optional int32 num_last_resort_watchdog_bad_other_networks_total = 24;
159
160 // Total count of networks seen when watchdog triggered
161 optional int32 num_last_resort_watchdog_available_networks_total = 25;
162
163 // Total count of triggers with atleast one bad association network
164 optional int32 num_last_resort_watchdog_triggers_with_bad_association = 26;
165
166 // Total count of triggers with atleast one bad authentication network
167 optional int32 num_last_resort_watchdog_triggers_with_bad_authentication = 27;
168
169 // Total count of triggers with atleast one bad dhcp network
170 optional int32 num_last_resort_watchdog_triggers_with_bad_dhcp = 28;
171
172 // Total count of triggers with atleast one bad other network
173 optional int32 num_last_resort_watchdog_triggers_with_bad_other = 29;
174
175 // Count of times connectivity watchdog confirmed pno is working
176 optional int32 num_connectivity_watchdog_pno_good = 30;
177
178 // Count of times connectivity watchdog found pno not working
179 optional int32 num_connectivity_watchdog_pno_bad = 31;
180
181 // Count of times connectivity watchdog confirmed background scan is working
182 optional int32 num_connectivity_watchdog_background_good = 32;
183
184 // Count of times connectivity watchdog found background scan not working
185 optional int32 num_connectivity_watchdog_background_bad = 33;
186
187 // The time duration represented by this wifi log, from start to end of capture
188 optional int32 record_duration_sec = 34;
189
190 // Counts the occurrences of each individual RSSI poll level
191 repeated RssiPollCount rssi_poll_rssi_count = 35;
192
193 // Total number of times WiFi connected immediately after a Last Resort Watchdog trigger,
194 // without new networks becoming available.
195 optional int32 num_last_resort_watchdog_successes = 36;
196
197 // Total number of saved hidden networks
198 optional int32 num_hidden_networks = 37;
199
200 // Total number of saved passpoint / hotspot 2.0 networks
201 optional int32 num_passpoint_networks = 38;
202
203 // Total number of scan results
204 optional int32 num_total_scan_results = 39;
205
206 // Total number of scan results for open networks
207 optional int32 num_open_network_scan_results = 40;
208
209 // Total number of scan results for personal networks
210 optional int32 num_personal_network_scan_results = 41;
211
212 // Total number of scan results for enterprise networks
213 optional int32 num_enterprise_network_scan_results = 42;
214
215 // Total number of scan results for hidden networks
216 optional int32 num_hidden_network_scan_results = 43;
217
218 // Total number of scan results for hotspot 2.0 r1 networks
219 optional int32 num_hotspot2_r1_network_scan_results = 44;
220
221 // Total number of scan results for hotspot 2.0 r2 networks
222 optional int32 num_hotspot2_r2_network_scan_results = 45;
223
224 // Total number of scans handled by framework (oneshot or otherwise)
225 optional int32 num_scans = 46;
226
227 // Counts the occurrences of each alert reason.
228 repeated AlertReasonCount alert_reason_count = 47;
229
230 // Counts the occurrences of each Wifi score
231 repeated WifiScoreCount wifi_score_count = 48;
232
233 // Histogram of Soft AP Durations
234 repeated SoftApDurationBucket soft_ap_duration = 49;
235
236 // Histogram of Soft AP ReturnCode
237 repeated SoftApReturnCodeCount soft_ap_return_code = 50;
238
239 // Histogram of the delta between scan result RSSI and RSSI polls
240 repeated RssiPollCount rssi_poll_delta_count = 51;
Glen Kuhne8ce9a1c2017-03-28 14:02:48 -0700241
242 // List of events
243 repeated StaEvent sta_event_list = 52;
Roshan Pius3607a392017-05-11 09:05:58 -0700244
245 // Total number of times WiFi HAL crashed.
246 optional int32 num_hal_crashes = 53;
247
248 // Total number of times WiFicond crashed.
249 optional int32 num_wificond_crashes = 54;
250
251 // Indicates the number of times an error was encountered in
252 // Wifi HAL when wifi was turned on.
253 optional int32 num_wifi_on_failure_due_to_hal = 55;
254
255 // Indicates the number of times an error was encountered in
256 // Wificond when wifi was turned on.
257 optional int32 num_wifi_on_failure_due_to_wificond = 56;
Etan Cohen737addc2017-04-26 08:01:57 -0700258
259 // Wi-Fi Aware metrics
260 optional WifiAwareLog wifi_aware_log = 57;
Peter Qiu84243152017-06-22 13:44:04 -0700261
262 // Number of saved Passpoint providers in user profile.
263 optional int32 num_passpoint_providers = 58;
264
265 // Count of times Passpoint provider being installed.
266 optional int32 num_passpoint_provider_installation = 59;
267
268 // Count of times Passpoint provivider is installed successfully.
269 optional int32 num_passpoint_provider_install_success = 60;
270
271 // Count of times Passpoint provider is being uninstalled.
272 optional int32 num_passpoint_provider_uninstallation = 61;
273
274 // Count of times Passpoint provider is uninstalled successfully.
275 optional int32 num_passpoint_provider_uninstall_success = 62;
276
277 // Count of saved Passpoint providers device has ever connected to.
278 optional int32 num_passpoint_providers_successfully_connected = 63;
Glen Kuhnee2d67c02017-04-25 13:08:29 -0700279
280 // Histogram counting instances of scans with N many ScanResults with unique ssids
281 repeated NumConnectableNetworksBucket total_ssids_in_scan_histogram = 64;
282
283 // Histogram counting instances of scans with N many ScanResults/bssids
284 repeated NumConnectableNetworksBucket total_bssids_in_scan_histogram = 65;
285
286 // Histogram counting instances of scans with N many unique open ssids
287 repeated NumConnectableNetworksBucket available_open_ssids_in_scan_histogram = 66;
288
289 // Histogram counting instances of scans with N many bssids for open networks
290 repeated NumConnectableNetworksBucket available_open_bssids_in_scan_histogram = 67;
291
292 // Histogram counting instances of scans with N many unique ssids for saved networks
293 repeated NumConnectableNetworksBucket available_saved_ssids_in_scan_histogram = 68;
294
295 // Histogram counting instances of scans with N many bssids for saved networks
296 repeated NumConnectableNetworksBucket available_saved_bssids_in_scan_histogram = 69;
297
298 // Histogram counting instances of scans with N many unique SSIDs for open or saved networks
299 repeated NumConnectableNetworksBucket available_open_or_saved_ssids_in_scan_histogram = 70;
300
301 // Histogram counting instances of scans with N many BSSIDs for open or saved networks
302 repeated NumConnectableNetworksBucket available_open_or_saved_bssids_in_scan_histogram = 71;
303
304 // Histogram counting instances of scans with N many ScanResults matching unique saved passpoint providers
305 repeated NumConnectableNetworksBucket available_saved_passpoint_provider_profiles_in_scan_histogram = 72;
306
307 // Histogram counting instances of scans with N many ScanResults BSSIDs matching a saved passpoint provider
308 repeated NumConnectableNetworksBucket available_saved_passpoint_provider_bssids_in_scan_histogram = 73;
309
310 // Counts the number of AllSingleScanLister.onResult calls with a full band scan result
311 optional int32 full_band_all_single_scan_listener_results = 74;
312
313 // Counts the number of AllSingleScanLister.onResult calls with a partial (channels) scan result
314 optional int32 partial_all_single_scan_listener_results = 75;
Mehdi Alizadehd9163cf2017-08-10 18:20:25 -0700315
316 // Pno scan metrics
317 optional PnoScanMetrics pno_scan_metrics = 76;
Glen Kuhne94814572016-10-25 12:40:35 -0700318}
319
320// Information that gets logged for every WiFi connection.
321message RouterFingerPrint {
322
323 enum RoamType {
324
325 // Type is unknown.
326 ROAM_TYPE_UNKNOWN = 0;
327
328 // No roaming - usually happens on a single band (2.4 GHz) router.
329 ROAM_TYPE_NONE = 1;
330
331 // Enterprise router.
332 ROAM_TYPE_ENTERPRISE = 2;
333
334 // DBDC => Dual Band Dual Concurrent essentially a router that
335 // supports both 2.4 GHz and 5 GHz bands.
336 ROAM_TYPE_DBDC = 3;
337 }
338
339 enum Auth {
340
341 // Auth is unknown.
342 AUTH_UNKNOWN = 0;
343
344 // No authentication.
345 AUTH_OPEN = 1;
346
347 // If the router uses a personal authentication.
348 AUTH_PERSONAL = 2;
349
350 // If the router is setup for enterprise authentication.
351 AUTH_ENTERPRISE = 3;
352 }
353
354 enum RouterTechnology {
355
356 // Router is unknown.
357 ROUTER_TECH_UNKNOWN = 0;
358
359 // Router Channel A.
360 ROUTER_TECH_A = 1;
361
362 // Router Channel B.
363 ROUTER_TECH_B = 2;
364
365 // Router Channel G.
366 ROUTER_TECH_G = 3;
367
368 // Router Channel N.
369 ROUTER_TECH_N = 4;
370
371 // Router Channel AC.
372 ROUTER_TECH_AC = 5;
373
374 // When the channel is not one of the above.
375 ROUTER_TECH_OTHER = 6;
376 }
377
378 optional RoamType roam_type = 1;
379
380 // Channel on which the connection takes place.
381 optional int32 channel_info = 2;
382
383 // DTIM setting of the router.
384 optional int32 dtim = 3;
385
386 // Authentication scheme of the router.
387 optional Auth authentication = 4;
388
389 // If the router is hidden.
390 optional bool hidden = 5;
391
392 // Channel information.
393 optional RouterTechnology router_technology = 6;
394
395 // whether ipv6 is supported.
396 optional bool supports_ipv6 = 7;
397
398 // If the router is a passpoint / hotspot 2.0 network
399 optional bool passpoint = 8;
400}
401
402message ConnectionEvent {
403
404 // Roam Type.
405 enum RoamType {
406
407 // Type is unknown.
408 ROAM_UNKNOWN = 0;
409
410 // No roaming.
411 ROAM_NONE = 1;
412
413 // DBDC roaming.
414 ROAM_DBDC = 2;
415
416 // Enterprise roaming.
417 ROAM_ENTERPRISE = 3;
418
419 // User selected roaming.
420 ROAM_USER_SELECTED = 4;
421
422 // Unrelated.
423 ROAM_UNRELATED = 5;
424 }
425
426 // Connectivity Level Failure.
427 enum ConnectivityLevelFailure {
428
429 // Failure is unknown.
430 HLF_UNKNOWN = 0;
431
432 // No failure.
433 HLF_NONE = 1;
434
435 // DHCP failure.
436 HLF_DHCP = 2;
437
438 // No internet connection.
439 HLF_NO_INTERNET = 3;
440
441 // No internet connection.
442 HLF_UNWANTED = 4;
443 }
444
445 // Start time of the connection.
446 optional int64 start_time_millis = 1;// [(datapol.semantic_type) = ST_TIMESTAMP];
447
448 // Duration to connect.
449 optional int32 duration_taken_to_connect_millis = 2;
450
451 // Router information.
452 optional RouterFingerPrint router_fingerprint = 3;
453
454 // RSSI at the start of the connection.
455 optional int32 signal_strength = 4;
456
457 // Roam Type.
458 optional RoamType roam_type = 5;
459
460 // Result of the connection.
461 optional int32 connection_result = 6;
462
463 // Reasons for level 2 failure (needs to be coordinated with wpa-supplicant).
464 optional int32 level_2_failure_code = 7;
465
466 // Failures that happen at the connectivity layer.
467 optional ConnectivityLevelFailure connectivity_level_failure_code = 8;
468
469 // Has bug report been taken.
470 optional bool automatic_bug_report_taken = 9;
471}
472
473// Number of occurrences of a specific RSSI poll rssi value
474message RssiPollCount {
475 // RSSI
476 optional int32 rssi = 1;
477
478 // Number of RSSI polls with 'rssi'
479 optional int32 count = 2;
480}
481
482// Number of occurrences of a specific alert reason value
483message AlertReasonCount {
484 // Alert reason
485 optional int32 reason = 1;
486
487 // Number of alerts with |reason|.
488 optional int32 count = 2;
489}
490
491// Counts the number of instances of a specific Wifi Score calculated by WifiScoreReport
492message WifiScoreCount {
493 // Wifi Score
494 optional int32 score = 1;
495
496 // Number of Wifi score reports with this score
497 optional int32 count = 2;
498}
499
500// Number of occurrences of Soft AP session durations
501message SoftApDurationBucket {
502 // Bucket covers duration : [duration_sec, duration_sec + bucket_size_sec)
503 // The (inclusive) lower bound of Soft AP session duration represented by this bucket
504 optional int32 duration_sec = 1;
505
506 // The size of this bucket
507 optional int32 bucket_size_sec = 2;
508
509 // Number of soft AP session durations that fit into this bucket
510 optional int32 count = 3;
511}
512
513// Number of occurrences of a soft AP session return code
514message SoftApReturnCodeCount {
Rebecca Silberstein28d9de22017-01-24 10:42:59 -0800515
516 enum SoftApStartResult {
517
518 // SoftApManager return code unknown
519 SOFT_AP_RETURN_CODE_UNKNOWN = 0;
520
521 // SoftAp started successfully
522 SOFT_AP_STARTED_SUCCESSFULLY = 1;
523
524 // Catch all for failures with no specific failure reason
525 SOFT_AP_FAILED_GENERAL_ERROR = 2;
526
527 // SoftAp failed to start due to NO_CHANNEL error
528 SOFT_AP_FAILED_NO_CHANNEL = 3;
529 }
530
531 // Historical, no longer used for writing as of 01/2017.
532 optional int32 return_code = 1 [deprecated = true];
Glen Kuhne94814572016-10-25 12:40:35 -0700533
534 // Occurrences of this soft AP return code
535 optional int32 count = 2;
Rebecca Silberstein28d9de22017-01-24 10:42:59 -0800536
537 // Result of attempt to start SoftAp
538 optional SoftApStartResult start_result = 3;
Glen Kuhne94814572016-10-25 12:40:35 -0700539}
Glen Kuhne8ce9a1c2017-03-28 14:02:48 -0700540
541message StaEvent {
542 message ConfigInfo {
543 // The set of key management protocols supported by this configuration.
544 optional uint32 allowed_key_management = 1 [default = 0];
545
546 // The set of security protocols supported by this configuration.
547 optional uint32 allowed_protocols = 2 [default = 0];
548
549 // The set of authentication protocols supported by this configuration.
550 optional uint32 allowed_auth_algorithms = 3 [default = 0];
551
552 // The set of pairwise ciphers for WPA supported by this configuration.
553 optional uint32 allowed_pairwise_ciphers = 4 [default = 0];
554
555 // The set of group ciphers supported by this configuration.
556 optional uint32 allowed_group_ciphers = 5;
557
558 // Is this a 'hidden network'
559 optional bool hidden_ssid = 6;
560
561 // Is this a Hotspot 2.0 / passpoint network
562 optional bool is_passpoint = 7;
563
564 // Is this an 'ephemeral' network (Not in saved network list, recommended externally)
565 optional bool is_ephemeral = 8;
566
567 // Has a successful connection ever been established using this WifiConfiguration
568 optional bool has_ever_connected = 9;
569
570 // RSSI of the scan result candidate associated with this WifiConfiguration
571 optional int32 scan_rssi = 10 [default = -127];
572
573 // Frequency of the scan result candidate associated with this WifiConfiguration
574 optional int32 scan_freq = 11 [default = -1];
575 }
576
577 enum EventType {
578 // Default/Invalid event
579 TYPE_UNKNOWN = 0;
580
581 // Supplicant Association Rejection event. Code contains the 802.11
582 TYPE_ASSOCIATION_REJECTION_EVENT = 1;
583
584 // Supplicant L2 event,
585 TYPE_AUTHENTICATION_FAILURE_EVENT = 2;
586
587 // Supplicant L2 event
588 TYPE_NETWORK_CONNECTION_EVENT = 3;
589
590 // Supplicant L2 event
591 TYPE_NETWORK_DISCONNECTION_EVENT = 4;
592
593 // Supplicant L2 event
594 TYPE_SUPPLICANT_STATE_CHANGE_EVENT = 5;
595
596 // Supplicant L2 event
597 TYPE_CMD_ASSOCIATED_BSSID = 6;
598
599 // IP Manager successfully completed IP Provisioning
600 TYPE_CMD_IP_CONFIGURATION_SUCCESSFUL = 7;
601
602 // IP Manager failed to complete IP Provisioning
603 TYPE_CMD_IP_CONFIGURATION_LOST = 8;
604
605 // IP Manager lost reachability to network neighbors
606 TYPE_CMD_IP_REACHABILITY_LOST = 9;
607
608 // Indicator that Supplicant is targeting a BSSID for roam/connection
609 TYPE_CMD_TARGET_BSSID = 10;
610
611 // Wifi framework is initiating a connection attempt
612 TYPE_CMD_START_CONNECT = 11;
613
614 // Wifi framework is initiating a roaming connection attempt
615 TYPE_CMD_START_ROAM = 12;
616
617 // SystemAPI connect() command, Settings App
618 TYPE_CONNECT_NETWORK = 13;
619
620 // Network Agent has validated the internet connection (Captive Portal Check success, or user
621 // validation)
622 TYPE_NETWORK_AGENT_VALID_NETWORK = 14;
623
624 // Framework initiated disconnect. Sometimes generated to give an extra reason for a disconnect
625 // Should typically be followed by a NETWORK_DISCONNECTION_EVENT with a local_gen = true
626 TYPE_FRAMEWORK_DISCONNECT = 15;
627 }
628
629 enum FrameworkDisconnectReason {
630 // default/none/unknown value
631 DISCONNECT_UNKNOWN = 0;
632
633 // API DISCONNECT
634 DISCONNECT_API = 1;
635
636 // Some framework internal reason (generic)
637 DISCONNECT_GENERIC = 2;
638
639 // Network Agent network validation failed, user signaled network unwanted
640 DISCONNECT_UNWANTED = 3;
641
642 // Roaming timed out
643 DISCONNECT_ROAM_WATCHDOG_TIMER = 4;
644
645 // P2P service requested wifi disconnect
646 DISCONNECT_P2P_DISCONNECT_WIFI_REQUEST = 5;
647
648 // SIM was removed while using a SIM config
649 DISCONNECT_RESET_SIM_NETWORKS = 6;
650 }
651
652 // Authentication Failure reasons as reported through the API.
653 enum AuthFailureReason {
654 // Unknown default
655 AUTH_FAILURE_UNKNOWN = 0;
656
657 // The reason code if there is no error during authentication. It could also imply that there no
658 // authentication in progress,
659 AUTH_FAILURE_NONE = 1;
660
661 // The reason code if there was a timeout authenticating.
662 AUTH_FAILURE_TIMEOUT = 2;
663
664 // The reason code if there was a wrong password while authenticating.
665 AUTH_FAILURE_WRONG_PSWD = 3;
666
667 // The reason code if there was EAP failure while authenticating.
668 AUTH_FAILURE_EAP_FAILURE = 4;
669 }
670
671 // What event was this
672 optional EventType type = 1;
673
674 // 80211 death reason code, relevant to NETWORK_DISCONNECTION_EVENTs
675 optional int32 reason = 2 [default = -1];
676
677 // 80211 Association Status code, relevant to ASSOCIATION_REJECTION_EVENTs
678 optional int32 status = 3 [default = -1];
679
680 // Designates whether a NETWORK_DISCONNECT_EVENT was by the STA or AP
681 optional bool local_gen = 4 [default = false];
682
683 // Network information from the WifiConfiguration of a framework initiated connection attempt
684 optional ConfigInfo config_info = 5;
685
686 // RSSI from the last rssi poll (Only valid for active connections)
687 optional int32 last_rssi = 6 [default = -127];
688
689 // Link speed from the last rssi poll (Only valid for active connections)
690 optional int32 last_link_speed = 7 [default = -1];
691
692 // Frequency from the last rssi poll (Only valid for active connections)
693 optional int32 last_freq = 8 [default = -1];
694
695 // Enum used to define bit positions in the supplicant_state_change_bitmask
696 // See {@code frameworks/base/wifi/java/android/net/wifi/SupplicantState.java} for documentation
697 enum SupplicantState {
698 STATE_DISCONNECTED = 0;
699
700 STATE_INTERFACE_DISABLED = 1;
701
702 STATE_INACTIVE = 2;
703
704 STATE_SCANNING = 3;
705
706 STATE_AUTHENTICATING = 4;
707
708 STATE_ASSOCIATING = 5;
709
710 STATE_ASSOCIATED = 6;
711
712 STATE_FOUR_WAY_HANDSHAKE = 7;
713
714 STATE_GROUP_HANDSHAKE = 8;
715
716 STATE_COMPLETED = 9;
717
718 STATE_DORMANT = 10;
719
720 STATE_UNINITIALIZED = 11;
721
722 STATE_INVALID = 12;
723 }
724
725 // Bit mask of all supplicant state changes that occured since the last event
726 optional uint32 supplicant_state_changes_bitmask = 9 [default = 0];
727
728 // The number of milliseconds that have elapsed since the device booted
729 optional int64 start_time_millis = 10 [default = 0];
730
731 optional FrameworkDisconnectReason framework_disconnect_reason = 11 [default = DISCONNECT_UNKNOWN];
732
733 // Flag which indicates if an association rejection event occured due to a timeout
734 optional bool association_timed_out = 12 [default = false];
735
736 // Authentication failure reason, as reported by WifiManager (calculated from state & deauth code)
737 optional AuthFailureReason auth_failure_reason = 13 [default = AUTH_FAILURE_UNKNOWN];
738}
Etan Cohen737addc2017-04-26 08:01:57 -0700739
740// Wi-Fi Aware metrics
741message WifiAwareLog {
742 // total number of unique apps that used Aware (measured on attach)
743 optional int32 num_apps = 1;
744
745 // total number of unique apps that used an identity callback when attaching
746 optional int32 num_apps_using_identity_callback = 2;
747
748 // maximum number of attaches for an app
749 optional int32 max_concurrent_attach_sessions_in_app = 3;
750
751 // histogram of attach request results
752 repeated NanStatusHistogramBucket histogram_attach_session_status = 4;
753
754 // maximum number of concurrent publish sessions in a single app
755 optional int32 max_concurrent_publish_in_app = 5;
756
757 // maximum number of concurrent subscribe sessions in a single app
758 optional int32 max_concurrent_subscribe_in_app = 6;
759
760 // maximum number of concurrent discovery (publish+subscribe) sessions in a single app
761 optional int32 max_concurrent_discovery_sessions_in_app = 7;
762
763 // maximum number of concurrent publish sessions in the system
764 optional int32 max_concurrent_publish_in_system = 8;
765
766 // maximum number of concurrent subscribe sessions in the system
767 optional int32 max_concurrent_subscribe_in_system = 9;
768
769 // maximum number of concurrent discovery (publish+subscribe) sessions in the system
770 optional int32 max_concurrent_discovery_sessions_in_system = 10;
771
772 // histogram of publish request results
773 repeated NanStatusHistogramBucket histogram_publish_status = 11;
774
775 // histogram of subscribe request results
776 repeated NanStatusHistogramBucket histogram_subscribe_status = 12;
777
778 // number of unique apps which experienced a discovery session creation failure due to lack of
779 // resources
780 optional int32 num_apps_with_discovery_session_failure_out_of_resources = 13;
781
782 // histogram of create ndp request results
783 repeated NanStatusHistogramBucket histogram_request_ndp_status = 14;
784
785 // histogram of create ndp out-of-band (OOB) request results
786 repeated NanStatusHistogramBucket histogram_request_ndp_oob_status = 15;
787
788 // maximum number of concurrent active data-interfaces (NDI) in a single app
789 optional int32 max_concurrent_ndi_in_app = 19;
790
791 // maximum number of concurrent active data-interfaces (NDI) in the system
792 optional int32 max_concurrent_ndi_in_system = 20;
793
794 // maximum number of concurrent data-paths (NDP) in a single app
795 optional int32 max_concurrent_ndp_in_app = 21;
796
797 // maximum number of concurrent data-paths (NDP) in the system
798 optional int32 max_concurrent_ndp_in_system = 22;
799
800 // maximum number of concurrent secure data-paths (NDP) in a single app
801 optional int32 max_concurrent_secure_ndp_in_app = 23;
802
803 // maximum number of concurrent secure data-paths (NDP) in the system
804 optional int32 max_concurrent_secure_ndp_in_system = 24;
805
806 // maximum number of concurrent data-paths (NDP) per data-interface (NDI)
807 optional int32 max_concurrent_ndp_per_ndi = 25;
808
809 // histogram of durations of Aware being available
810 repeated HistogramBucket histogram_aware_available_duration_ms = 26;
811
812 // histogram of durations of Aware being enabled
813 repeated HistogramBucket histogram_aware_enabled_duration_ms = 27;
814
815 // histogram of duration (in ms) of attach sessions
816 repeated HistogramBucket histogram_attach_duration_ms = 28;
817
818 // histogram of duration (in ms) of publish sessions
819 repeated HistogramBucket histogram_publish_session_duration_ms = 29;
820
821 // histogram of duration (in ms) of subscribe sessions
822 repeated HistogramBucket histogram_subscribe_session_duration_ms = 30;
823
824 // histogram of duration (in ms) of data-paths (NDP)
825 repeated HistogramBucket histogram_ndp_session_duration_ms = 31;
826
827 // histogram of usage (in MB) of data-paths (NDP)
828 repeated HistogramBucket histogram_ndp_session_data_usage_mb = 32;
829
830 // histogram of usage (in MB) of data-path creation time (in ms) measured as request -> confirm
831 repeated HistogramBucket histogram_ndp_creation_time_ms = 33;
832
833 // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: minimum
834 optional int64 ndp_creation_time_ms_min = 34;
835
836 // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: maximum
837 optional int64 ndp_creation_time_ms_max = 35;
838
839 // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum
840 optional int64 ndp_creation_time_ms_sum = 36;
841
842 // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum of sq
843 optional int64 ndp_creation_time_ms_sum_of_sq = 37;
844
845 // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: number of
846 // samples
847 optional int64 ndp_creation_time_ms_num_samples = 38;
848
849 // total time within the logging window that aware was available
850 optional int64 available_time_ms = 39;
851
852 // total time within the logging window that aware was enabled
853 optional int64 enabled_time_ms = 40;
854
855 // Histogram bucket for Wi-Fi Aware logs. Range is [start, end)
856 message HistogramBucket {
857 // lower range of the bucket (inclusive)
858 optional int64 start = 1;
859
860 // upper range of the bucket (exclusive)
861 optional int64 end = 2;
862
863 // number of samples in the bucket
864 optional int32 count = 3;
865 }
866
867 // Status of various NAN operations
868 enum NanStatusTypeEnum {
869 // constant to be used by proto
870 UNKNOWN = 0;
871
872 // NAN operation succeeded
873 SUCCESS = 1;
874
875 // NAN Discovery Engine/Host driver failures
876 INTERNAL_FAILURE = 2;
877
878 // NAN OTA failures
879 PROTOCOL_FAILURE = 3;
880
881 // The publish/subscribe discovery session id is invalid
882 INVALID_SESSION_ID = 4;
883
884 // Out of resources to fufill request
885 NO_RESOURCES_AVAILABLE = 5;
886
887 // Invalid arguments passed
888 INVALID_ARGS = 6;
889
890 // Invalid peer id
891 INVALID_PEER_ID = 7;
892
893 // Invalid NAN data-path (ndp) id
894 INVALID_NDP_ID = 8;
895
896 // Attempting to enable NAN when not available, e.g. wifi is disabled
897 NAN_NOT_ALLOWED = 9;
898
899 // Over the air ACK not received
900 NO_OTA_ACK = 10;
901
902 // Attempting to enable NAN when already enabled
903 ALREADY_ENABLED = 11;
904
905 // Can't queue tx followup message foor transmission
906 FOLLOWUP_TX_QUEUE_FULL = 12;
907
908 // Unsupported concurrency of NAN and another feature - NAN disabled
909 UNSUPPORTED_CONCURRENCY_NAN_DISABLED = 13;
910
911 // Unknown NanStatusType
912 UNKNOWN_HAL_STATUS = 14;
913 }
914
915 // Histogram bucket for Wi-Fi Aware (NAN) status.
916 message NanStatusHistogramBucket {
917 // status type defining the bucket
918 optional NanStatusTypeEnum nan_status_type = 1;
919
920 // number of samples in the bucket
921 optional int32 count = 2;
922 }
923}
924
Glen Kuhnee2d67c02017-04-25 13:08:29 -0700925// Data point used to build 'Number of Connectable Network' histograms
926message NumConnectableNetworksBucket {
927 // Number of connectable networks seen in a scan result
928 optional int32 num_connectable_networks = 1 [default = 0];
929
930 // Number of scan results with num_connectable_networks
931 optional int32 count = 2 [default = 0];
932}
Mehdi Alizadehd9163cf2017-08-10 18:20:25 -0700933
934// Pno scan metrics
935// Here "Pno Scan" refers to the session of offloaded scans, these metrics count the result of a
936// single session, and not the individual scans within that session.
937message PnoScanMetrics {
938 // Total number of attempts to offload pno scans
939 optional int32 num_pno_scan_attempts = 1;
940
941 // Total number of pno scans failed
942 optional int32 num_pno_scan_failed = 2;
943
944 // Number of pno scans started successfully over offload
945 optional int32 num_pno_scan_started_over_offload = 3;
946
947 // Number of pno scans failed over offload
948 optional int32 num_pno_scan_failed_over_offload = 4;
949
950 // Total number of pno scans that found any network
951 optional int32 num_pno_found_network_events = 5;
952}