blob: b7ed6eb160135f1880d3ad61ad55a9d5a7028249 [file] [log] [blame]
/*
* Copyright (C) 2017 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 android.os.statsd;
option java_package = "com.android.os";
option java_outer_classname = "AtomsProto";
import "frameworks/base/cmds/statsd/src/atom_field_options.proto";
import "frameworks/base/core/proto/android/app/enums.proto";
import "frameworks/base/core/proto/android/app/job/enums.proto";
import "frameworks/base/core/proto/android/app/settings_enums.proto";
import "frameworks/base/core/proto/android/app/tvsettings_enums.proto";
import "frameworks/base/core/proto/android/bluetooth/a2dp/enums.proto";
import "frameworks/base/core/proto/android/bluetooth/enums.proto";
import "frameworks/base/core/proto/android/bluetooth/hci/enums.proto";
import "frameworks/base/core/proto/android/bluetooth/hfp/enums.proto";
import "frameworks/base/core/proto/android/bluetooth/smp/enums.proto";
import "frameworks/base/core/proto/android/debug/enums.proto";
import "frameworks/base/core/proto/android/hardware/biometrics/enums.proto";
import "frameworks/base/core/proto/android/hardware/sensor/assist/enums.proto";
import "frameworks/base/core/proto/android/net/networkcapabilities.proto";
import "frameworks/base/core/proto/android/os/enums.proto";
import "frameworks/base/core/proto/android/server/connectivity/data_stall_event.proto";
import "frameworks/base/core/proto/android/server/enums.proto";
import "frameworks/base/core/proto/android/server/job/enums.proto";
import "frameworks/base/core/proto/android/server/location/enums.proto";
import "frameworks/base/core/proto/android/service/procstats_enum.proto";
import "frameworks/base/core/proto/android/service/usb.proto";
import "frameworks/base/core/proto/android/stats/connectivity/network_stack.proto";
import "frameworks/base/core/proto/android/stats/dnsresolver/dns_resolver.proto";
import "frameworks/base/core/proto/android/stats/devicepolicy/device_policy.proto";
import "frameworks/base/core/proto/android/stats/devicepolicy/device_policy_enums.proto";
import "frameworks/base/core/proto/android/stats/docsui/docsui_enums.proto";
import "frameworks/base/core/proto/android/stats/enums.proto";
import "frameworks/base/core/proto/android/stats/intelligence/enums.proto";
import "frameworks/base/core/proto/android/stats/launcher/launcher.proto";
import "frameworks/base/core/proto/android/stats/location/location_enums.proto";
import "frameworks/base/core/proto/android/stats/mediametrics/mediametrics.proto";
import "frameworks/base/core/proto/android/stats/mediaprovider/mediaprovider_enums.proto";
import "frameworks/base/core/proto/android/stats/storage/storage_enums.proto";
import "frameworks/base/core/proto/android/stats/style/style_enums.proto";
import "frameworks/base/core/proto/android/stats/sysui/notification_enums.proto";
import "frameworks/base/core/proto/android/telecomm/enums.proto";
import "frameworks/base/core/proto/android/telephony/enums.proto";
import "frameworks/base/core/proto/android/view/enums.proto";
import "frameworks/base/core/proto/android/wifi/enums.proto";
import "frameworks/base/core/proto/android/stats/textclassifier/textclassifier_enums.proto";
import "frameworks/base/core/proto/android/stats/otaupdate/updateengine_enums.proto";
/**
* The master atom class. This message defines all of the available
* raw stats log events from the Android system, also known as "atoms."
*
* This field contains a single oneof with all of the available messages.
* The stats-log-api-gen tool runs as part of the Android build and
* generates the android.util.StatsLog class, which contains the constants
* and methods that Android uses to log.
*
* This Atom class is not actually built into the Android system.
* Instead, statsd on Android constructs these messages synthetically,
* in the format defined here and in stats_log.proto.
*/
message Atom {
// Pushed atoms start at 2.
oneof pushed {
// For StatsLog reasons, 1 is illegal and will not work. Must start at 2.
BleScanStateChanged ble_scan_state_changed = 2
[(module) = "bluetooth", (module) = "statsdtest"];
ProcessStateChanged process_state_changed = 3 [(module) = "framework"];
BleScanResultReceived ble_scan_result_received = 4 [(module) = "bluetooth"];
SensorStateChanged sensor_state_changed =
5 [(module) = "framework", (module) = "statsdtest"];
GpsScanStateChanged gps_scan_state_changed = 6 [(module) = "framework"];
SyncStateChanged sync_state_changed = 7 [(module) = "framework", (module) = "statsdtest"];
ScheduledJobStateChanged scheduled_job_state_changed =
8 [(module) = "framework", (module) = "statsdtest"];
ScreenBrightnessChanged screen_brightness_changed =
9 [(module) = "framework", (module) = "statsdtest"];
WakelockStateChanged wakelock_state_changed =
10 [(module) = "framework", (module) = "statsdtest"];
LongPartialWakelockStateChanged long_partial_wakelock_state_changed =
11 [(module) = "framework"];
MobileRadioPowerStateChanged mobile_radio_power_state_changed =
12 [(module) = "framework", (truncate_timestamp) = true];
WifiRadioPowerStateChanged wifi_radio_power_state_changed = 13 [(module) = "framework"];
ActivityManagerSleepStateChanged activity_manager_sleep_state_changed =
14 [(module) = "framework"];
MemoryFactorStateChanged memory_factor_state_changed = 15 [(module) = "framework"];
ExcessiveCpuUsageReported excessive_cpu_usage_reported = 16 [(module) = "framework"];
CachedKillReported cached_kill_reported = 17 [(module) = "framework"];
ProcessMemoryStatReported process_memory_stat_reported = 18 [(module) = "framework"];
LauncherUIChanged launcher_event = 19 [(module) = "sysui"];
BatterySaverModeStateChanged battery_saver_mode_state_changed =
20 [(module) = "framework", (module) = "statsdtest"];
DeviceIdleModeStateChanged device_idle_mode_state_changed = 21 [(module) = "framework"];
DeviceIdlingModeStateChanged device_idling_mode_state_changed = 22 [(module) = "framework"];
AudioStateChanged audio_state_changed =
23 [(module) = "framework", (truncate_timestamp) = true];
MediaCodecStateChanged media_codec_state_changed = 24 [(module) = "framework"];
CameraStateChanged camera_state_changed = 25 [(module) = "framework"];
FlashlightStateChanged flashlight_state_changed = 26 [(module) = "framework"];
UidProcessStateChanged uid_process_state_changed =
27 [(module) = "framework", (module) = "statsdtest"];
ProcessLifeCycleStateChanged process_life_cycle_state_changed =
28 [(module) = "framework", (module) = "statsdtest"];
ScreenStateChanged screen_state_changed =
29 [(module) = "framework", (module) = "statsdtest"];
BatteryLevelChanged battery_level_changed =
30 [(module) = "framework", (module) = "statsdtest"];
ChargingStateChanged charging_state_changed = 31 [(module) = "framework"];
PluggedStateChanged plugged_state_changed = 32
[(module) = "framework", (module) = "statsdtest"];
InteractiveStateChanged interactive_state_changed = 33 [(module) = "framework"];
TouchEventReported touch_event_reported = 34;
WakeupAlarmOccurred wakeup_alarm_occurred = 35 [(module) = "framework"];
KernelWakeupReported kernel_wakeup_reported = 36 [(module) = "framework"];
WifiLockStateChanged wifi_lock_state_changed = 37 [(module) = "wifi"];
WifiSignalStrengthChanged wifi_signal_strength_changed = 38 [(module) = "wifi"];
WifiScanStateChanged wifi_scan_state_changed = 39 [(module) = "wifi"];
PhoneSignalStrengthChanged phone_signal_strength_changed =
40 [(module) = "framework", (truncate_timestamp) = true];
SettingChanged setting_changed = 41 [(module) = "framework"];
ActivityForegroundStateChanged activity_foreground_state_changed =
42 [(module) = "framework", (module) = "statsdtest"];
IsolatedUidChanged isolated_uid_changed =
43 [(module) = "framework", (module) = "statsd", (module) = "statsdtest"];
PacketWakeupOccurred packet_wakeup_occurred = 44 [(module) = "framework"];
WallClockTimeShifted wall_clock_time_shifted = 45 [(module) = "framework"];
AnomalyDetected anomaly_detected = 46 [(module) = "statsd"];
AppBreadcrumbReported app_breadcrumb_reported =
47 [(allow_from_any_uid) = true, (module) = "statsd"];
AppStartOccurred app_start_occurred = 48 [(module) = "framework", (module) = "statsdtest"];
AppStartCanceled app_start_canceled = 49 [(module) = "framework"];
AppStartFullyDrawn app_start_fully_drawn = 50 [(module) = "framework"];
LmkKillOccurred lmk_kill_occurred = 51 [(module) = "lmkd"];
PictureInPictureStateChanged picture_in_picture_state_changed = 52 [(module) = "framework"];
WifiMulticastLockStateChanged wifi_multicast_lock_state_changed = 53 [(module) = "wifi"];
LmkStateChanged lmk_state_changed = 54 [(module) = "lmkd"];
AppStartMemoryStateCaptured app_start_memory_state_captured = 55 [(module) = "framework"];
ShutdownSequenceReported shutdown_sequence_reported = 56 [(module) = "framework"];
BootSequenceReported boot_sequence_reported = 57;
DaveyOccurred davey_occurred = 58 [(allow_from_any_uid) = true, (module) = "statsd"];
OverlayStateChanged overlay_state_changed =
59 [(module) = "framework", (module) = "statsdtest"];
ForegroundServiceStateChanged foreground_service_state_changed
= 60 [(module) = "framework"];
CallStateChanged call_state_changed =
61 [(module) = "telecom", (truncate_timestamp) = true];
KeyguardStateChanged keyguard_state_changed = 62 [(module) = "sysui"];
KeyguardBouncerStateChanged keyguard_bouncer_state_changed = 63 [(module) = "sysui"];
KeyguardBouncerPasswordEntered keyguard_bouncer_password_entered = 64 [(module) = "sysui"];
AppDied app_died = 65 [(module) = "framework"];
ResourceConfigurationChanged resource_configuration_changed = 66 [(module) = "framework"];
BluetoothEnabledStateChanged bluetooth_enabled_state_changed = 67 [(module) = "framework"];
BluetoothConnectionStateChanged bluetooth_connection_state_changed =
68 [(module) = "bluetooth"];
GpsSignalQualityChanged gps_signal_quality_changed = 69 [(module) = "framework"];
UsbConnectorStateChanged usb_connector_state_changed = 70 [(module) = "framework"];
SpeakerImpedanceReported speaker_impedance_reported = 71;
HardwareFailed hardware_failed = 72;
PhysicalDropDetected physical_drop_detected = 73;
ChargeCyclesReported charge_cycles_reported = 74;
MobileConnectionStateChanged mobile_connection_state_changed = 75 [(module) = "telephony"];
MobileRadioTechnologyChanged mobile_radio_technology_changed = 76 [(module) = "telephony"];
UsbDeviceAttached usb_device_attached = 77 [(module) = "framework"];
AppCrashOccurred app_crash_occurred = 78 [(module) = "framework", (module) = "statsdtest"];
ANROccurred anr_occurred = 79 [(module) = "framework"];
WTFOccurred wtf_occurred = 80 [(module) = "framework"];
LowMemReported low_mem_reported = 81 [(module) = "framework"];
GenericAtom generic_atom = 82;
KeyValuePairsAtom key_value_pairs_atom =
83 [(allow_from_any_uid) = true, (module) = "framework", (module) = "statsd"];
VibratorStateChanged vibrator_state_changed = 84 [(module) = "framework"];
DeferredJobStatsReported deferred_job_stats_reported = 85 [(module) = "framework"];
ThermalThrottlingStateChanged thermal_throttling = 86 [deprecated=true];
BiometricAcquired biometric_acquired = 87 [(module) = "framework"];
BiometricAuthenticated biometric_authenticated = 88 [(module) = "framework"];
BiometricErrorOccurred biometric_error_occurred = 89 [(module) = "framework"];
UiEventReported ui_event_reported = 90 [(module) = "framework"];
BatteryHealthSnapshot battery_health_snapshot = 91;
SlowIo slow_io = 92;
BatteryCausedShutdown battery_caused_shutdown = 93;
PhoneServiceStateChanged phone_service_state_changed = 94 [(module) = "framework"];
PhoneStateChanged phone_state_changed = 95 [(module) = "framework"];
UserRestrictionChanged user_restriction_changed = 96;
SettingsUIChanged settings_ui_changed = 97 [(module) = "settings"];
ConnectivityStateChanged connectivity_state_changed = 98 [(module) = "framework"];
// TODO: service state change is very noisy shortly after boot, as well
// as at other transitions - coming out of doze, device plugged in, etc.
// Consider removing this if it becomes a problem
ServiceStateChanged service_state_changed = 99 [(module) = "framework"];
ServiceLaunchReported service_launch_reported = 100 [(module) = "framework"];
FlagFlipUpdateOccurred flag_flip_update_occurred = 101 [(module) = "framework"];
BinaryPushStateChanged binary_push_state_changed = 102 [(module) = "statsd"];
DevicePolicyEvent device_policy_event = 103 [(module) = "framework"];
DocsUIFileOperationCanceledReported docs_ui_file_op_canceled = 104 [(module) = "docsui"];
DocsUIFileOperationCopyMoveModeReported docs_ui_file_op_copy_move_mode_reported =
105 [(module) = "docsui"];
DocsUIFileOperationFailureReported docs_ui_file_op_failure = 106 [(module) = "docsui"];
DocsUIFileOperationReported docs_ui_provider_file_op = 107 [(module) = "docsui"];
DocsUIInvalidScopedAccessRequestReported docs_ui_invalid_scoped_access_request =
108 [(module) = "docsui"];
DocsUILaunchReported docs_ui_launch_reported = 109 [(module) = "docsui"];
DocsUIRootVisitedReported docs_ui_root_visited = 110 [(module) = "docsui"];
DocsUIStartupMsReported docs_ui_startup_ms = 111 [(module) = "docsui"];
DocsUIUserActionReported docs_ui_user_action_reported = 112 [(module) = "docsui"];
WifiEnabledStateChanged wifi_enabled_state_changed = 113 [(module) = "framework"];
WifiRunningStateChanged wifi_running_state_changed = 114
[(module) = "framework", deprecated = true];
AppCompacted app_compacted = 115 [(module) = "framework"];
NetworkDnsEventReported network_dns_event_reported = 116 [(module) = "resolv"];
DocsUIPickerLaunchedFromReported docs_ui_picker_launched_from_reported =
117 [(module) = "docsui"];
DocsUIPickResultReported docs_ui_pick_result_reported = 118 [(module) = "docsui"];
DocsUISearchModeReported docs_ui_search_mode_reported = 119 [(module) = "docsui"];
DocsUISearchTypeReported docs_ui_search_type_reported = 120 [(module) = "docsui"];
DataStallEvent data_stall_event = 121 [(module) = "network_stack"];
RescuePartyResetReported rescue_party_reset_reported = 122 [(module) = "framework"];
SignedConfigReported signed_config_reported = 123 [(module) = "framework"];
GnssNiEventReported gnss_ni_event_reported = 124 [(module) = "framework"];
BluetoothLinkLayerConnectionEvent bluetooth_link_layer_connection_event =
125 [(module) = "bluetooth"];
BluetoothAclConnectionStateChanged bluetooth_acl_connection_state_changed =
126 [(module) = "bluetooth"];
BluetoothScoConnectionStateChanged bluetooth_sco_connection_state_changed =
127 [(module) = "bluetooth"];
AppDowngraded app_downgraded = 128 [(module) = "framework"];
AppOptimizedAfterDowngraded app_optimized_after_downgraded = 129;
LowStorageStateChanged low_storage_state_changed = 130 [(module) = "framework"];
GnssNfwNotificationReported gnss_nfw_notification_reported = 131 [(module) = "framework"];
GnssConfigurationReported gnss_configuration_reported = 132 [(module) = "framework"];
UsbPortOverheatEvent usb_port_overheat_event_reported = 133;
NfcErrorOccurred nfc_error_occurred = 134 [(module) = "nfc"];
NfcStateChanged nfc_state_changed = 135 [(module) = "nfc"];
NfcBeamOccurred nfc_beam_occurred = 136 [(module) = "nfc"];
NfcCardemulationOccurred nfc_cardemulation_occurred = 137 [(module) = "nfc"];
NfcTagOccurred nfc_tag_occurred = 138 [(module) = "nfc"];
NfcHceTransactionOccurred nfc_hce_transaction_occurred = 139 [(module) = "nfc"];
SeStateChanged se_state_changed = 140 [(module) = "secure_element"];
SeOmapiReported se_omapi_reported = 141 [(module) = "secure_element"];
BroadcastDispatchLatencyReported broadcast_dispatch_latency_reported =
142 [(module) = "framework"];
AttentionManagerServiceResultReported attention_manager_service_result_reported =
143 [(module) = "framework"];
AdbConnectionChanged adb_connection_changed = 144 [(module) = "framework"];
SpeechDspStatReported speech_dsp_stat_reported = 145;
UsbContaminantReported usb_contaminant_reported = 146 [(module) = "framework"];
WatchdogRollbackOccurred watchdog_rollback_occurred =
147 [(module) = "framework", (module) = "statsd"];
BiometricSystemHealthIssueDetected biometric_system_health_issue_detected =
148 [(module) = "framework"];
BubbleUIChanged bubble_ui_changed = 149 [(module) = "sysui"];
ScheduledJobConstraintChanged scheduled_job_constraint_changed =
150 [(module) = "framework"];
BluetoothActiveDeviceChanged bluetooth_active_device_changed =
151 [(module) = "bluetooth"];
BluetoothA2dpPlaybackStateChanged bluetooth_a2dp_playback_state_changed =
152 [(module) = "bluetooth"];
BluetoothA2dpCodecConfigChanged bluetooth_a2dp_codec_config_changed =
153 [(module) = "bluetooth"];
BluetoothA2dpCodecCapabilityChanged bluetooth_a2dp_codec_capability_changed =
154 [(module) = "bluetooth"];
BluetoothA2dpAudioUnderrunReported bluetooth_a2dp_audio_underrun_reported =
155 [(module) = "bluetooth"];
BluetoothA2dpAudioOverrunReported bluetooth_a2dp_audio_overrun_reported =
156 [(module) = "bluetooth"];
BluetoothDeviceRssiReported bluetooth_device_rssi_reported =
157 [(module) = "bluetooth"];
BluetoothDeviceFailedContactCounterReported
bluetooth_device_failed_contact_counter_reported = 158 [(module) = "bluetooth"];
BluetoothDeviceTxPowerLevelReported bluetooth_device_tx_power_level_reported =
159 [(module) = "bluetooth"];
BluetoothHciTimeoutReported bluetooth_hci_timeout_reported =
160 [(module) = "bluetooth"];
BluetoothQualityReportReported bluetooth_quality_report_reported =
161 [(module) = "bluetooth"];
BluetoothDeviceInfoReported bluetooth_device_info_reported =
162 [(module) = "bluetooth"];
BluetoothRemoteVersionInfoReported bluetooth_remote_version_info_reported =
163 [(module) = "bluetooth"];
BluetoothSdpAttributeReported bluetooth_sdp_attribute_reported =
164 [(module) = "bluetooth"];
BluetoothBondStateChanged bluetooth_bond_state_changed =
165 [(module) = "bluetooth"];
BluetoothClassicPairingEventReported bluetooth_classic_pairing_event_reported =
166 [(module) = "bluetooth"];
BluetoothSmpPairingEventReported bluetooth_smp_pairing_event_reported =
167 [(module) = "bluetooth"];
ScreenTimeoutExtensionReported screen_timeout_extension_reported =
168 [(module) = "framework"];
ProcessStartTime process_start_time = 169 [(module) = "framework"];
PermissionGrantRequestResultReported permission_grant_request_result_reported =
170 [(module) = "permissioncontroller"];
BluetoothSocketConnectionStateChanged bluetooth_socket_connection_state_changed = 171;
DeviceIdentifierAccessDenied device_identifier_access_denied =
172 [(module) = "telephony_common"];
BubbleDeveloperErrorReported bubble_developer_error_reported = 173 [(module) = "framework"];
AssistGestureStageReported assist_gesture_stage_reported = 174 [(module) = "sysui"];
AssistGestureFeedbackReported assist_gesture_feedback_reported = 175 [(module) = "sysui"];
AssistGestureProgressReported assist_gesture_progress_reported = 176 [(module) = "sysui"];
TouchGestureClassified touch_gesture_classified = 177 [(module) = "framework"];
HiddenApiUsed hidden_api_used = 178 [(allow_from_any_uid) = true, (module) = "framework"];
StyleUIChanged style_ui_changed = 179 [(module) = "sysui"];
PrivacyIndicatorsInteracted privacy_indicators_interacted =
180 [(module) = "permissioncontroller"];
AppInstallOnExternalStorageReported app_install_on_external_storage_reported =
181 [(module) = "framework"];
NetworkStackReported network_stack_reported = 182 [(module) = "network_stack"];
AppMovedStorageReported app_moved_storage_reported = 183 [(module) = "framework"];
BiometricEnrolled biometric_enrolled = 184 [(module) = "framework"];
SystemServerWatchdogOccurred system_server_watchdog_occurred = 185 [(module) = "framework"];
TombStoneOccurred tomb_stone_occurred = 186 [(module) = "framework"];
BluetoothClassOfDeviceReported bluetooth_class_of_device_reported =
187 [(module) = "bluetooth"];
IntelligenceEventReported intelligence_event_reported =
188 [(module) = "intelligence"];
ThermalThrottlingSeverityStateChanged thermal_throttling_severity_state_changed =
189 [(module) = "framework"];
RoleRequestResultReported role_request_result_reported =
190 [(module) = "permissioncontroller"];
MediametricsAudiopolicyReported mediametrics_audiopolicy_reported = 191;
MediametricsAudiorecordReported mediametrics_audiorecord_reported = 192;
MediametricsAudiothreadReported mediametrics_audiothread_reported = 193;
MediametricsAudiotrackReported mediametrics_audiotrack_reported = 194;
MediametricsCodecReported mediametrics_codec_reported = 195;
MediametricsDrmWidevineReported mediametrics_drm_widevine_reported = 196;
MediametricsExtractorReported mediametrics_extractor_reported = 197;
MediametricsMediadrmReported mediametrics_mediadrm_reported = 198;
MediametricsNuPlayerReported mediametrics_nuplayer_reported = 199;
MediametricsRecorderReported mediametrics_recorder_reported = 200;
MediametricsDrmManagerReported mediametrics_drmmanager_reported = 201;
CarPowerStateChanged car_power_state_changed = 203 [(module) = "car"];
GarageModeInfo garage_mode_info = 204 [(module) = "car"];
TestAtomReported test_atom_reported = 205 [(module) = "cts"];
ContentCaptureCallerMismatchReported content_capture_caller_mismatch_reported =
206 [(module) = "framework"];
ContentCaptureServiceEvents content_capture_service_events = 207 [(module) = "framework"];
ContentCaptureSessionEvents content_capture_session_events = 208 [(module) = "framework"];
ContentCaptureFlushed content_capture_flushed = 209 [(module) = "framework"];
LocationManagerApiUsageReported location_manager_api_usage_reported =
210 [(module) = "framework"];
ReviewPermissionsFragmentResultReported review_permissions_fragment_result_reported =
211 [(module) = "permissioncontroller"];
RuntimePermissionsUpgradeResult runtime_permissions_upgrade_result =
212 [(module) = "permissioncontroller"];
GrantPermissionsActivityButtonActions grant_permissions_activity_button_actions =
213 [(module) = "permissioncontroller"];
LocationAccessCheckNotificationAction location_access_check_notification_action =
214 [(module) = "permissioncontroller"];
AppPermissionFragmentActionReported app_permission_fragment_action_reported =
215 [(module) = "permissioncontroller"];
AppPermissionFragmentViewed app_permission_fragment_viewed =
216 [(module) = "permissioncontroller"];
AppPermissionsFragmentViewed app_permissions_fragment_viewed =
217 [(module) = "permissioncontroller"];
PermissionAppsFragmentViewed permission_apps_fragment_viewed =
218 [(module) = "permissioncontroller"];
TextSelectionEvent text_selection_event = 219 [(module) = "textclassifier"];
TextLinkifyEvent text_linkify_event = 220 [(module) = "textclassifier"];
ConversationActionsEvent conversation_actions_event = 221 [(module) = "textclassifier"];
LanguageDetectionEvent language_detection_event = 222 [(module) = "textclassifier"];
ExclusionRectStateChanged exclusion_rect_state_changed = 223 [(module) = "framework"];
BackGesture back_gesture_reported_reported = 224 [(module) = "sysui"];
UpdateEngineUpdateAttemptReported update_engine_update_attempt_reported = 225;
UpdateEngineSuccessfulUpdateReported update_engine_successful_update_reported = 226;
CameraActionEvent camera_action_event = 227 [(module) = "framework"];
AppCompatibilityChangeReported app_compatibility_change_reported =
228 [(allow_from_any_uid) = true, (module) = "framework"];
PerfettoUploaded perfetto_uploaded = 229 [(module) = "perfetto"];
VmsClientConnectionStateChanged vms_client_connection_state_changed =
230 [(module) = "car"];
MediaProviderScanOccurred media_provider_scan_occurred = 233 [(module) = "mediaprovider"];
MediaContentDeleted media_content_deleted = 234 [(module) = "mediaprovider"];
MediaProviderPermissionRequested media_provider_permission_requested =
235 [(module) = "mediaprovider"];
MediaProviderSchemaChanged media_provider_schema_changed = 236 [(module) = "mediaprovider"];
MediaProviderIdleMaintenanceFinished media_provider_idle_maintenance_finished =
237 [(module) = "mediaprovider"];
RebootEscrowRecoveryReported reboot_escrow_recovery_reported = 238 [(module) = "framework"];
BootTimeEventDuration boot_time_event_duration_reported = 239 [(module) = "framework"];
BootTimeEventElapsedTime boot_time_event_elapsed_time_reported =
240 [(module) = "framework"];
BootTimeEventUtcTime boot_time_event_utc_time_reported = 241;
BootTimeEventErrorCode boot_time_event_error_code_reported = 242 [(module) = "framework"];
UserspaceRebootReported userspace_reboot_reported = 243 [(module) = "framework"];
NotificationReported notification_reported = 244 [(module) = "framework"];
NotificationPanelReported notification_panel_reported = 245 [(module) = "sysui"];
NotificationChannelModified notification_channel_modified = 246 [(module) = "framework"];
IntegrityCheckResultReported integrity_check_result_reported = 247 [(module) = "framework"];
IntegrityRulesPushed integrity_rules_pushed = 248 [(module) = "framework"];
CellBroadcastMessageReported cb_message_reported =
249 [(module) = "cellbroadcast"];
CellBroadcastMessageError cb_message_error =
250 [(module) = "cellbroadcast"];
WifiHealthStatReported wifi_health_stat_reported = 251 [(module) = "wifi"];
WifiFailureStatReported wifi_failure_stat_reported = 252 [(module) = "wifi"];
WifiConnectionResultReported wifi_connection_result_reported = 253 [(module) = "wifi"];
AppFreezeChanged app_freeze_changed = 254 [(module) = "framework"];
SnapshotMergeReported snapshot_merge_reported = 255;
ForegroundServiceAppOpSessionEnded foreground_service_app_op_session_ended =
256 [(module) = "framework"];
DisplayJankReported display_jank_reported = 257;
AppStandbyBucketChanged app_standby_bucket_changed = 258 [(module) = "framework"];
SharesheetStarted sharesheet_started = 259 [(module) = "framework"];
RankingSelected ranking_selected = 260 [(module) = "framework"];
TvSettingsUIInteracted tvsettings_ui_interacted = 261 [(module) = "tv_settings"];
LauncherStaticLayout launcher_snapshot = 262 [(module) = "sysui"];
PackageInstallerV2Reported package_installer_v2_reported = 263 [(module) = "framework"];
UserLifecycleJourneyReported user_lifecycle_journey_reported = 264 [(module) = "framework"];
UserLifecycleEventOccurred user_lifecycle_event_occurred = 265 [(module) = "framework"];
SdkExtensionStatus sdk_extension_status = 354;
}
// Pulled events will start at field 10000.
// Next: 10080
oneof pulled {
WifiBytesTransfer wifi_bytes_transfer = 10000 [(module) = "framework"];
WifiBytesTransferByFgBg wifi_bytes_transfer_by_fg_bg = 10001 [(module) = "framework"];
MobileBytesTransfer mobile_bytes_transfer =
10002 [(module) = "framework", (truncate_timestamp) = true];
MobileBytesTransferByFgBg mobile_bytes_transfer_by_fg_bg =
10003 [(module) = "framework", (truncate_timestamp) = true];
BluetoothBytesTransfer bluetooth_bytes_transfer = 10006 [(module) = "framework"];
KernelWakelock kernel_wakelock = 10004 [(module) = "framework"];
SubsystemSleepState subsystem_sleep_state = 10005 [(module) = "statsdtest"];
CpuTimePerFreq cpu_time_per_freq = 10008 [(module) = "framework"];
CpuTimePerUid cpu_time_per_uid = 10009 [(module) = "framework", (module) = "statsdtest"];
CpuTimePerUidFreq cpu_time_per_uid_freq =
10010 [(module) = "framework", (module) = "statsd"];
WifiActivityInfo wifi_activity_info = 10011 [(module) = "framework"];
ModemActivityInfo modem_activity_info = 10012 [(module) = "framework"];
BluetoothActivityInfo bluetooth_activity_info = 10007 [(module) = "framework"];
ProcessMemoryState process_memory_state = 10013 [(module) = "framework"];
SystemElapsedRealtime system_elapsed_realtime = 10014 [(module) = "framework"];
SystemUptime system_uptime = 10015 [(module) = "framework", (module) = "statsdtest"];
CpuActiveTime cpu_active_time = 10016 [(module) = "framework", (module) = "statsdtest"];
CpuClusterTime cpu_cluster_time = 10017 [(module) = "framework", (module) = "statsdtest"];
DiskSpace disk_space = 10018 [deprecated=true, (module) = "statsdtest"];
RemainingBatteryCapacity remaining_battery_capacity = 10019 [(module) = "framework"];
FullBatteryCapacity full_battery_capacity = 10020 [(module) = "framework"];
Temperature temperature = 10021 [(module) = "framework", (module) = "statsdtest"];
BinderCalls binder_calls = 10022 [(module) = "framework", (module) = "statsd"];
BinderCallsExceptions binder_calls_exceptions = 10023 [(module) = "framework"];
LooperStats looper_stats = 10024 [(module) = "framework", (module) = "statsd"];
DiskStats disk_stats = 10025 [(module) = "framework"];
DirectoryUsage directory_usage = 10026 [(module) = "framework"];
AppSize app_size = 10027 [(module) = "framework"];
CategorySize category_size = 10028 [(module) = "framework"];
ProcStats proc_stats = 10029 [(module) = "framework"];
BatteryVoltage battery_voltage = 10030 [(module) = "framework"];
NumFingerprintsEnrolled num_fingerprints_enrolled = 10031 [(module) = "framework"];
DiskIo disk_io = 10032 [(module) = "framework"];
PowerProfile power_profile = 10033 [(module) = "framework"];
ProcStatsPkgProc proc_stats_pkg_proc = 10034 [(module) = "framework"];
ProcessCpuTime process_cpu_time = 10035 [(module) = "framework"];
CpuTimePerThreadFreq cpu_time_per_thread_freq = 10037 [(module) = "framework"];
OnDevicePowerMeasurement on_device_power_measurement = 10038;
DeviceCalculatedPowerUse device_calculated_power_use = 10039 [(module) = "framework"];
DeviceCalculatedPowerBlameUid device_calculated_power_blame_uid =
10040 [(module) = "framework"];
DeviceCalculatedPowerBlameOther device_calculated_power_blame_other =
10041 [(module) = "framework"];
ProcessMemoryHighWaterMark process_memory_high_water_mark = 10042 [(module) = "framework"];
BatteryLevel battery_level = 10043 [(module) = "framework"];
BuildInformation build_information = 10044 [(module) = "framework"];
BatteryCycleCount battery_cycle_count = 10045 [(module) = "framework"];
DebugElapsedClock debug_elapsed_clock = 10046 [(module) = "framework"];
DebugFailingElapsedClock debug_failing_elapsed_clock = 10047 [(module) = "framework"];
NumFacesEnrolled num_faces_enrolled = 10048 [(module) = "framework"];
RoleHolder role_holder = 10049 [(module) = "framework"];
DangerousPermissionState dangerous_permission_state = 10050 [(module) = "framework"];
TrainInfo train_info = 10051 [(module) = "statsd"];
TimeZoneDataInfo time_zone_data_info = 10052 [(module) = "framework"];
ExternalStorageInfo external_storage_info = 10053 [(module) = "framework"];
GpuStatsGlobalInfo gpu_stats_global_info = 10054;
GpuStatsAppInfo gpu_stats_app_info = 10055;
SystemIonHeapSize system_ion_heap_size = 10056 [deprecated = true, (module) = "framework"];
AppsOnExternalStorageInfo apps_on_external_storage_info = 10057 [(module) = "framework"];
FaceSettings face_settings = 10058 [(module) = "framework"];
CoolingDevice cooling_device = 10059 [(module) = "framework"];
AppOps app_ops = 10060 [(module) = "framework"];
ProcessSystemIonHeapSize process_system_ion_heap_size = 10061 [(module) = "framework"];
SurfaceflingerStatsGlobalInfo surfaceflinger_stats_global_info = 10062;
SurfaceflingerStatsLayerInfo surfaceflinger_stats_layer_info = 10063;
ProcessMemorySnapshot process_memory_snapshot = 10064 [(module) = "framework"];
VmsClientStats vms_client_stats = 10065 [(module) = "car"];
NotificationRemoteViews notification_remote_views = 10066 [(module) = "framework"];
DangerousPermissionStateSampled dangerous_permission_state_sampled =
10067 [(module) = "framework"];
GraphicsStats graphics_stats = 10068;
RuntimeAppOpAccess runtime_app_op_access = 10069 [(module) = "framework"];
IonHeapSize ion_heap_size = 10070 [(module) = "framework"];
PackageNotificationPreferences package_notification_preferences =
10071 [(module) = "framework"];
PackageNotificationChannelPreferences package_notification_channel_preferences =
10072 [(module) = "framework"];
PackageNotificationChannelGroupPreferences package_notification_channel_group_preferences =
10073 [(module) = "framework"];
GnssStats gnss_stats = 10074 [(module) = "framework"];
AttributedAppOps attributed_app_ops = 10075 [(module) = "framework"];
VoiceCallSession voice_call_session = 10076 [(module) = "telephony"];
VoiceCallRatUsage voice_call_rat_usage = 10077 [(module) = "telephony"];
SimSlotState sim_slot_state = 10078 [(module) = "telephony"];
SupportedRadioAccessFamily supported_radio_access_family = 10079 [(module) = "telephony"];
SettingSnapshot setting_snapshot = 10080 [(module) = "framework"];
}
// DO NOT USE field numbers above 100,000 in AOSP.
// Field numbers 100,000 - 199,999 are reserved for non-AOSP (e.g. OEMs) to use.
// Field numbers 200,000 and above are reserved for future use; do not use them at all.
reserved 10036;
}
/**
* This proto represents a node of an attribution chain.
* Note: All attribution chains are represented as a repeated field of type
* AttributionNode. It is understood that in such arrays, the order is that
* of calls, that is [A, B, C] if A calls B that calls C.
*/
message AttributionNode {
// The uid for a given element in the attribution chain.
optional int32 uid = 1;
// The (optional) string tag for an element in the attribution chain. If the
// element has no tag, it is encoded as an empty string.
optional string tag = 2;
}
message KeyValuePair {
optional int32 key = 1;
oneof value {
int32 value_int = 2;
int64 value_long = 3;
string value_str = 4;
float value_float = 5;
}
}
message KeyValuePairsAtom {
optional int32 uid = 1;
repeated KeyValuePair pairs = 2;
}
/*
* *****************************************************************************
* Below are all of the individual atoms that are logged by Android via statsd.
*
* RULES:
* - The field ids for each atom must start at 1, and count upwards by 1.
* Skipping field ids is not allowed.
* - These form an API, so renaming, renumbering or removing fields is
* not allowed between android releases. (This is not currently enforced,
* but there will be a tool to enforce this restriction).
* - The types must be built-in protocol buffer types, namely, no sub-messages
* are allowed (yet). The bytes type is also not allowed.
* - The CamelCase name of the message type should match the
* underscore_separated name as defined in Atom.
* - If an atom represents work that can be attributed to an app, there can
* be exactly one AttributionChain field. It must be field number 1.
* - A field that is a uid should be a string field, tagged with the [xxx]
* annotation. The generated code on android will be represented by UIDs,
* and those UIDs will be translated in xxx to those strings.
*
* CONVENTIONS:
* - Events are past tense. e.g. ScreenStateChanged, not ScreenStateChange.
* - If there is a UID, it goes first. Think in an object-oriented fashion.
* *****************************************************************************
*/
/**
* This atom is deprecated starting in Q. Please use ThermalThrottlingSeverityStateChanged.
* Logs when the Thermal service HAL notifies the throttling start/stop events.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/stats/StatsCompanionService.java
*/
message ThermalThrottlingStateChanged {
// The type of temperature being reported (CPU, GPU, SKIN, etc)
optional android.os.TemperatureTypeEnum sensor_type = 1;
// Throttling state, this field is DEPRECATED
enum State {
UNKNOWN = 0;
START = 1; // START indicated that throttling was triggered.
STOP = 2; // STOP indicates that throttling was cleared.
}
optional State state = 2;
optional float temperature = 3;
}
/**
* Logs when the screen state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message ScreenStateChanged {
// New screen state, from frameworks/base/core/proto/android/view/enums.proto.
optional android.view.DisplayStateEnum state = 1
[(state_field_option).exclusive_state = true, (state_field_option).nested = false];
}
/**
* Logs that the process state of the uid, as determined by ActivityManager
* (i.e. the highest process state of that uid's processes) has changed.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message UidProcessStateChanged {
optional int32 uid = 1 [(state_field_option).primary_field = true, (is_uid) = true];
// The state, from frameworks/base/core/proto/android/app/enums.proto.
optional android.app.ProcessStateEnum state = 2
[(state_field_option).exclusive_state = true, (state_field_option).nested = false];
}
/**
* Logs process state change of a process, as per the activity manager.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ProcessRecord.java
*/
message ProcessStateChanged {
optional int32 uid = 1;
optional string process_name = 2;
optional string package_name = 3;
// TODO: remove this when validation is done
optional int64 version = 5;
// The state, from frameworks/base/core/proto/android/app/enums.proto.
optional android.app.ProcessStateEnum state = 4;
}
/**
* Logs when ActivityManagerService sleep state is changed.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityTaskManagerService.java
*/
message ActivityManagerSleepStateChanged {
// TODO: import frameworks proto
enum State {
UNKNOWN = 0;
ASLEEP = 1;
AWAKE = 2;
}
optional State state = 1 [(state_field_option).exclusive_state = true];
}
/**
* Logs when system memory state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message MemoryFactorStateChanged {
// TODO: import frameworks proto
enum State {
MEMORY_UNKNOWN = 0;
NORMAL = 1; // normal.
MODERATE = 2; // moderate memory pressure.
LOW = 3; // low memory.
CRITICAL = 4; // critical memory.
}
optional State factor = 1 [(state_field_option).exclusive_state = true];
}
/**
* Logs when app is using too much cpu, according to ActivityManagerService.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message ExcessiveCpuUsageReported {
optional int32 uid = 1;
optional string process_name = 2;
optional string package_name = 3;
// package version. TODO: remove this when validation is done
optional int64 version = 4;
}
/**
* Logs when a cached process is killed, along with its pss.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message CachedKillReported {
optional int32 uid = 1;
optional string process_name = 2;
optional string package_name = 3;
// TODO: remove this when validation is done
optional int64 version = 5;
optional int64 pss = 4;
}
/**
* Logs the change in wifi health.
*
* Logged from:
* frameworks/opt/net/wifi/service/java/com/android/server/wifi/WifiDataStall.java
*/
message WifiHealthStatReported {
enum Band {
UNKNOWN = 0;
// All of 2.4GHz band
BAND_2G = 1;
// Frequencies in the range of [5150, 5250) GHz
BAND_5G_LOW = 2;
// Frequencies in the range of [5250, 5725) GHz
BAND_5G_MIDDLE = 3;
// Frequencies in the range of [5725, 5850) GHz
BAND_5G_HIGH = 4;
// Frequencies in the range of [5925, 6425) GHz
BAND_6G_LOW = 5;
// Frequencies in the range of [6425, 6875) GHz
BAND_6G_MIDDLE = 6;
// Frequencies in the range of [6875, 7125) GHz
BAND_6G_HIGH = 7;
}
// duration this stat is obtained over in milliseconds
optional int32 duration_millis = 1;
// whether wifi is classified as sufficient for the user's data traffic, determined
// by whether the calculated throughput exceeds the average demand within |duration_millis|
optional bool is_sufficient = 2;
// whether cellular data is available
optional bool is_cell_data_available = 3;
// the Band bucket the connected network is on
optional Band band = 4;
}
/**
* Logged when wifi detects a significant change in connection failure rate.
*
* Logged from: frameworks/opt/net/wifi/service/java/com/android/server/wifi/WifiHealthMonitor.java
*
*/
message WifiFailureStatReported {
enum AbnormalityType {
UNKNOWN = 0;
SIGNIFICANT_INCREASE = 1;
SIGNIFICANT_DECREASE = 2;
SIMPLY_HIGH = 3;
}
enum FailureType {
FAILURE_UNKNOWN = 0;
FAILURE_CONNECTION = 1;
FAILURE_ASSOCIATION_REJECTION = 2;
FAILURE_ASSOCIATION_TIMEOUT = 3;
FAILURE_AUTHENTICATION = 4;
FAILURE_NON_LOCAL_DISCONNECTION = 5;
FAILURE_SHORT_CONNECTION_DUE_TO_NON_LOCAL_DISCONNECTION = 6;
}
// Reason for uploading this stat
optional AbnormalityType abnormality_type = 1;
// The particular type of failure
optional FailureType failure_type = 2;
// How many times we have encountered this combination of AbnormalityType and FailureType
optional int32 failure_count = 3;
}
/**
* Logs whether a wifi connection is successful and reasons for failure if it isn't.
*
* Logged from:
* frameworks/opt/net/wifi/service/java/com/android/server/wifi/ClientModeImpl.java
*/
message WifiConnectionResultReported {
enum FailureCode {
FAILURE_UNKNOWN = 0;
FAILURE_ASSOCIATION_TIMEOUT = 1;
FAILURE_ASSOCIATION_REJECTION = 2;
FAILURE_AUTHENTICATION_GENERAL = 3;
FAILURE_AUTHENTICATION_EAP = 4;
FAILURE_DHCP = 5;
FAILURE_NETWORK_DISCONNECTION = 6;
FAILURE_ROAM_TIMEOUT = 7;
}
// true represents a successful connection
optional bool connection_result = 1;
// reason for the connection failure
optional FailureCode failure_code = 2;
// scan rssi before the connection attempt
optional int32 rssi = 3;
}
/**
* Logs when memory stats of a process is reported.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ProcessRecord.java
*/
message ProcessMemoryStatReported {
optional int32 uid = 1;
optional string process_name = 2;
optional string package_name = 3;
//TODO: remove this when validation is done
optional int64 version = 9;
optional int64 pss = 4;
optional int64 uss = 5;
optional int64 rss = 6;
enum Type {
ADD_PSS_INTERNAL_SINGLE = 0;
ADD_PSS_INTERNAL_ALL_MEM = 1;
ADD_PSS_INTERNAL_ALL_POLL = 2;
ADD_PSS_EXTERNAL = 3;
ADD_PSS_EXTERNAL_SLOW = 4;
}
optional Type type = 7;
optional int64 duration_millis = 8;
}
/**
* Logs that a process started, finished, crashed, or ANRed.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message ProcessLifeCycleStateChanged {
optional int32 uid = 1 [(is_uid) = true];
// The process name (usually same as the app name).
optional string process_name = 2;
// What lifecycle state the process changed to.
// This enum is specific to atoms.proto.
enum State {
FINISHED = 0;
STARTED = 1;
CRASHED = 2;
}
optional State state = 3;
}
/**
* Logs when the ble scan state changes.
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/gatt/AppScanStats.java
*/
message BleScanStateChanged {
repeated AttributionNode attribution_node = 1
[(state_field_option).primary_field_first_uid = true];
enum State {
OFF = 0;
ON = 1;
// RESET indicates all ble stopped. Used when it (re)starts (e.g. after it crashes).
RESET = 2;
}
optional State state = 2 [
(state_field_option).exclusive_state = true,
(state_field_option).default_state_value = 0 /* State.OFF */,
(state_field_option).trigger_state_reset_value = 2 /* State.RESET */,
(state_field_option).nested = true
];
// Does the scan have a filter.
optional bool is_filtered = 3 [(state_field_option).primary_field = true];
// Whether the scan is a CALLBACK_TYPE_FIRST_MATCH scan. Called 'background' scan internally.
optional bool is_first_match = 4 [(state_field_option).primary_field = true];
// Whether the scan set to piggy-back off the results of other scans (SCAN_MODE_OPPORTUNISTIC).
optional bool is_opportunistic = 5 [(state_field_option).primary_field = true];
}
/**
* Logs reporting of a ble scan finding results.
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/gatt/AppScanStats.java
*/
// TODO: Consider also tracking per-scanner-id.
message BleScanResultReceived {
repeated AttributionNode attribution_node = 1;
// Number of ble scan results returned.
optional int32 num_results = 2;
}
/**
* Logs when a sensor state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message SensorStateChanged {
repeated AttributionNode attribution_node = 1;
// The id (int) of the sensor.
optional int32 sensor_id = 2;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 3;
}
/**
* Logs when GPS state changes.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message GpsScanStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
}
/**
* Logs when GPS signal quality.
*
* Logged from:
* /frameworks/base/location/java/com/android/internal/location/gnssmetrics/GnssMetrics.java
*/
message GpsSignalQualityChanged {
optional android.server.location.GpsSignalQualityEnum level = 1;
}
/**
* Logs when a sync manager sync state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message SyncStateChanged {
repeated AttributionNode attribution_node = 1;
// Name of the sync (as named in the app). Can be chosen at run-time.
optional string sync_name = 2;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 3;
}
/*
* Deferred job stats.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/job/JobSchedulerService.java
*/
message DeferredJobStatsReported {
repeated AttributionNode attribution_node = 1;
// Number of jobs deferred.
optional int32 num_jobs_deferred = 2;
// Time since the last job runs.
optional int64 time_since_last_job_millis = 3;
}
/**
* Logs when a job scheduler job state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message ScheduledJobStateChanged {
repeated AttributionNode attribution_node = 1;
// Name of the job (as named in the app)
optional string job_name = 2;
enum State {
FINISHED = 0;
STARTED = 1;
SCHEDULED = 2;
}
optional State state = 3;
// The reason a job has stopped.
// This is only applicable when the state is FINISHED.
// The default value is STOP_REASON_UNKNOWN.
optional android.app.job.StopReasonEnum stop_reason = 4;
// The standby bucket of the app that scheduled the job. These match the framework constants
// defined in JobSchedulerService.java with the addition of UNKNOWN using -1, as ACTIVE is
// already assigned 0.
enum Bucket {
UNKNOWN = -1;
ACTIVE = 0;
WORKING_SET = 1;
FREQUENT = 2;
RARE = 3;
NEVER = 4;
RESTRICTED = 5;
}
optional Bucket standby_bucket = 5 [default = UNKNOWN];
// The job id (as assigned by the app).
optional int32 job_id = 6;
// One flag for each of the API constraints defined by Jobscheduler. Does not include implcit
// constraints as they are always assumed to be set.
optional bool has_charging_constraint = 7;
optional bool has_battery_not_low_constraint = 8;
optional bool has_storage_not_low_constraint = 9;
optional bool has_timing_delay_constraint = 10;
optional bool has_deadline_constraint = 11;
optional bool has_idle_constraint = 12;
optional bool has_connectivity_constraint = 13;
optional bool has_content_trigger_constraint = 14;
}
/**
* Logs when the audio state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message AudioStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
// RESET indicates all audio stopped. Used when it (re)starts (e.g. after it crashes).
RESET = 2;
}
optional State state = 2;
}
/**
* Logs when the video codec state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message MediaCodecStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
// RESET indicates all mediaCodec stopped. Used when it (re)starts (e.g. after it crashes).
RESET = 2;
}
optional State state = 2;
}
/**
* Logs when the flashlight state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message FlashlightStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
// RESET indicates all flashlight stopped. Used when it (re)starts (e.g. after it crashes).
RESET = 2;
}
optional State state = 2;
}
/**
* Logs when the camera state changes.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message CameraStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
// RESET indicates all camera stopped. Used when it (re)starts (e.g. after it crashes).
RESET = 2;
}
optional State state = 2;
}
/**
* Logs that the state of a wakelock (per app and per wakelock name) has changed.
*
* Logged from:
* TODO
*/
message WakelockStateChanged {
repeated AttributionNode attribution_node = 1
[(state_field_option).primary_field_first_uid = true];
// The type (level) of the wakelock; e.g. a partial wakelock or a full wakelock.
// From frameworks/base/core/proto/android/os/enums.proto.
optional android.os.WakeLockLevelEnum type = 2 [(state_field_option).primary_field = true];
// The wakelock tag (Called tag in the Java API, sometimes name elsewhere).
optional string tag = 3 [(state_field_option).primary_field = true];
enum State {
RELEASE = 0;
ACQUIRE = 1;
CHANGE_RELEASE = 2;
CHANGE_ACQUIRE = 3;
}
optional State state = 4 [
(state_field_option).exclusive_state = true,
(state_field_option).default_state_value = 0,
(state_field_option).nested = true
];
}
/**
* Logs when a partial wakelock is considered 'long' (over 1 min).
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message LongPartialWakelockStateChanged {
repeated AttributionNode attribution_node = 1;
// The wakelock tag (Called tag in the Java API, sometimes name elsewhere).
optional string tag = 2;
// TODO: I have no idea what this is.
optional string history_tag = 3;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 4;
}
/**
* Logs when the device is interactive, according to the PowerManager Notifier.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/power/Notifier.java
*/
message InteractiveStateChanged {
enum State {
OFF = 0;
ON = 1;
}
optional State state = 1;
}
/**
* Logs Battery Saver state change.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message BatterySaverModeStateChanged {
enum State {
OFF = 0;
ON = 1;
}
optional State state = 1;
}
/**
* Logs Doze mode state change.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message DeviceIdleModeStateChanged {
optional android.server.DeviceIdleModeEnum state = 1;
}
/**
* Logs state change of Doze mode including maintenance windows.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message DeviceIdlingModeStateChanged {
optional android.server.DeviceIdleModeEnum state = 1;
}
/**
* Logs screen brightness level.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message ScreenBrightnessChanged {
// Screen brightness level. Should be in [-1, 255] according to PowerManager.java.
optional int32 level = 1;
}
/**
* Logs battery level (percent full, from 0 to 100).
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message BatteryLevelChanged {
// Battery level. Should be in [0, 100].
optional int32 battery_level = 1;
}
/**
* Logs change in charging status of the device.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message ChargingStateChanged {
// State of the battery, from frameworks/base/core/proto/android/os/enums.proto.
optional android.os.BatteryStatusEnum state = 1;
}
/**
* Logs whether the device is plugged in, and what power source it is using.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message PluggedStateChanged {
// Whether the device is plugged in, from frameworks/base/core/proto/android/os/enums.proto.
optional android.os.BatteryPluggedStateEnum state = 1;
}
/**
* Logs when an app's wakeup alarm fires.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message WakeupAlarmOccurred {
repeated AttributionNode attribution_node = 1;
// Name of the wakeup alarm.
optional string tag = 2;
// Name of source package (for historical reasons, since BatteryStats tracked it).
optional string package_name = 3;
// The App Standby bucket of the app that scheduled the alarm at the time the alarm fired.
optional AppStandbyBucketChanged.Bucket app_standby_bucket = 4;
}
/**
* Logs when an an app causes the mobile radio to change state.
* Changing from LOW to MEDIUM or HIGH can be considered the app waking the mobile radio.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/NetworkManagementService.java
*/
message MobileRadioPowerStateChanged {
repeated AttributionNode attribution_node = 1;
// Power state, from frameworks/base/core/proto/android/telephony/enums.proto.
optional android.telephony.DataConnectionPowerStateEnum state = 2;
}
/**
* Logs when an an app causes the wifi radio to change state.
* Changing from LOW to MEDIUM or HIGH can be considered the app waking the wifi radio.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/NetworkManagementService.java
*/
message WifiRadioPowerStateChanged {
repeated AttributionNode attribution_node = 1;
// Power state, from frameworks/base/core/proto/android/telephony/enums.proto.
optional android.telephony.DataConnectionPowerStateEnum state = 2;
}
/**
* Logs kernel wakeup reasons and aborts.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message KernelWakeupReported {
// Name of the kernel wakeup reason (or abort).
optional string wakeup_reason_name = 1;
// Duration (in microseconds) for the wake-up interrupt to be serviced.
optional int64 duration_micros = 2;
}
/**
* Logs when Wifi is toggled on/off.
* Note that Wifi may still perform certain functions (e.g. location scanning) even when disabled.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message WifiEnabledStateChanged {
enum State {
OFF = 0;
ON = 1;
}
optional State state = 1;
}
/**
* This atom is deprecated starting in R.
*
* Logs when an app causes Wifi to run. In this context, 'to run' means to use Wifi Client Mode.
* TODO: Include support for Hotspot, perhaps by using an extra field to denote 'mode'.
* Note that Wifi Scanning is monitored separately in WifiScanStateChanged.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BatteryStatsService.java
*/
message WifiRunningStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
}
/**
* Logs wifi locks held by an app.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message WifiLockStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
// WifiLock type, from frameworks/base/core/proto/android/wifi/enums.proto.
optional android.net.wifi.WifiModeEnum mode = 3;
}
/**
* Logs wifi signal strength changes.
*
* Logged from:
* frameworks/opt/net/wifi/service/java/com/android/server/wifi/ClientModeImpl.java
*/
message WifiSignalStrengthChanged {
// Signal strength, from frameworks/base/core/proto/android/telephony/enums.proto.
optional android.telephony.SignalStrengthEnum signal_strength = 1;
}
/**
* Logs wifi scans performed by an app.
*
* Logged from:
* frameworks/opt/net/wifi/service/java/com/android/server/wifi/scanner/WifiScanningServiceImpl.java
*/
message WifiScanStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
}
/**
* Logs wifi multicast locks held by an app
*
* Logged from:
* frameworks/opt/net/wifi/service/java/com/android/server/wifi/WifiMulticastLockManager.java
*/
message WifiMulticastLockStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
optional string tag = 3;
}
/**
* Logs shutdown reason and duration on next boot.
*
* Logged from:
* frameworks/base/core/java/com/android/server/BootReceiver.java
*/
message ShutdownSequenceReported {
// True if shutdown is for a reboot. Default: false if we do not know.
optional bool reboot = 1;
// Reason for shutdown. Eg: userrequested. Default: "<EMPTY>".
optional string reason = 2;
// Beginning of shutdown time in ms using wall clock time since unix epoch.
// Default: 0 if no start time received.
optional int64 start_time_millis = 3;
// Duration of shutdown in ms. Default: 0 if no duration received.
optional int64 duration_millis = 4;
}
/**
* Logs boot reason and duration.
*
* Logged from:
* system/core/bootstat/bootstat.cpp
*/
message BootSequenceReported {
// Reason for bootloader boot. Eg. reboot. See bootstat.cpp for larger list
// Default: "<EMPTY>" if not available.
optional string bootloader_reason = 1;
// Reason for system boot. Eg. bootloader, reboot,userrequested
// Default: "<EMPTY>" if not available.
optional string system_reason = 2;
// End of boot time in ms from unix epoch using system wall clock.
optional int64 end_time_millis = 3;
// Total boot duration in ms.
optional int64 total_duration_millis = 4;
// Bootloader duration in ms.
optional int64 bootloader_duration_millis = 5;
// Time since last boot in ms. Default: 0 if not available.
optional int64 time_since_last_boot = 6;
}
/**
* Logs call state and disconnect cause (if applicable).
*
* Logged from:
* packages/services/Telecomm/src/com/android/server/telecom/Call.java
*/
message CallStateChanged {
// The state of the call. Eg. DIALING, ACTIVE, ON_HOLD, DISCONNECTED.
// From frameworks/base/core/proto/android/telecomm/enums.proto.
optional android.telecom.CallStateEnum call_state = 1;
// The reason the call disconnected. Eg. ERROR, MISSED, REJECTED, BUSY.
// This value is only applicable when the call_state is DISCONNECTED, and
// should always be UNKNOWN if the call_state is not DISCONNECTED.
// From frameworks/base/core/proto/android/telecomm/enums.proto.
optional android.telecom.DisconnectCauseEnum disconnect_cause = 2;
// True if the call is self-managed, which are apps that use the
// telecom infrastructure to make their own calls.
optional bool self_managed = 3;
// True if call is external. External calls are calls on connected Wear
// devices but show up in Telecom so the user can pull them onto the device.
optional bool external_call = 4;
}
/**
* Logs keyguard state. The keyguard is the lock screen.
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/StatusBarKeyguardViewManager.java
*/
message KeyguardStateChanged {
enum State {
UNKNOWN = 0;
// The keyguard is hidden when the phone is unlocked.
HIDDEN = 1;
// The keyguard is shown when the phone is locked (screen turns off).
SHOWN= 2;
// The keyguard is occluded when something is overlaying the keyguard.
// Eg. Opening the camera while on the lock screen.
OCCLUDED = 3;
}
optional State state = 1;
}
/**
* Logs keyguard bouncer state. The bouncer is a part of the keyguard, and
* prompts the user to enter a password (pattern, pin, etc).
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/KeyguardBouncer.java
*/
message KeyguardBouncerStateChanged {
enum State {
UNKNOWN = 0;
// Bouncer is hidden, either as a result of successfully entering the
// password, screen timing out, or user going back to lock screen.
HIDDEN = 1;
// This is when the user is being prompted to enter the password.
SHOWN = 2;
}
optional State state = 1;
}
/**
* Logs the result of entering a password into the keyguard bouncer.
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/keyguard/KeyguardSecurityContainer.java
*/
message KeyguardBouncerPasswordEntered {
enum BouncerResult {
UNKNOWN = 0;
// The password entered was incorrect.
FAILURE = 1;
// The password entered was correct.
SUCCESS = 2;
}
optional BouncerResult result = 1;
}
/*
* Logs changes to the configuration of the device. The configuration is defined
* in frameworks/base/core/java/android/content/res/Configuration.java
* More documentation is at https://d.android.com/reference/android/content/res/Configuration.html
* Please go there to interpret the possible values each field can be.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message ResourceConfigurationChanged {
// Bit mask of color capabilities of the screen.
// Contains information about the color gamut and hdr mode of the screen.
// See: https://d.android.com/reference/android/content/res/Configuration.html#colorMode
optional int32 color_mode = 1;
// The target screen density being rendered to.
// See: https://d.android.com/reference/android/content/res/Configuration.html#densityDpi
optional int32 density_dpi = 2;
// Current user preference for the scaling factor for fonts,
// relative to the base density scaling.
// See: https://d.android.com/reference/android/content/res/Configuration.html#fontScale
optional float font_scale = 3;
// Flag indicating whether the hard keyboard is hidden.
// See: https://d.android.com/reference/android/content/res/Configuration.html#hardKeyboardHidden
optional int32 hard_keyboard_hidden = 4;
// The type of keyboard attached to the device.
// See: https://d.android.com/reference/android/content/res/Configuration.html#keyboard
optional int32 keyboard = 5;
// Flag indicating whether any keyboard is available. Takes soft keyboards into account.
// See: https://d.android.com/reference/android/content/res/Configuration.html#keyboardHidden
optional int32 keyboard_hidden = 6;
// IMSI MCC (Mobile Country Code), corresponding to mcc resource qualifier.
// 0 if undefined.
// See: https://d.android.com/reference/android/content/res/Configuration.html#mcc
optional int32 mcc = 7;
// IMSI MNC (Mobile Network Code), corresponding to mnc resource qualifier.
// 0 if undefined. Note: the actual MNC may be 0, to check for this use the
// MNC_ZERO symbol defined in Configuration.java.
// See: https://d.android.com/reference/android/content/res/Configuration.html#mnc
optional int32 mnc = 8;
// The kind of navigation available on the device.
// See: https://developer.android.com/reference/android/content/res/Configuration.html#navigation
optional int32 navigation = 9;
// Flag indicating whether the navigation is available.
// See: https://d.android.com/reference/android/content/res/Configuration.html#navigationHidden
optional int32 navigation_hidden = 10;
// Overall orientation of the screen.
// See: https://d.android.com/reference/android/content/res/Configuration.html#orientation
optional int32 orientation = 11;
// The current height of the available screen space, in dp units.
// See: https://d.android.com/reference/android/content/res/Configuration.html#screenHeightDp
optional int32 screen_height_dp = 12;
// Bit mask of overall layout of the screen.
// Contains information about screen size, whether the screen is wider/taller
// than normal, whether the screen layout is right-tl-left or left-to-right,
// and whether the screen has a rounded shape.
// See: https://d.android.com/reference/android/content/res/Configuration.html#screenLayout
optional int32 screen_layout = 13;
// Current width of the available screen space, in dp units.
// See: https://d.android.com/reference/android/content/res/Configuration.html#screenWidthDp
optional int32 screen_width_dp = 14;
// The smallest screen size an application will see in normal operation.
// This is the smallest value of both screenWidthDp and screenHeightDp
// in portrait and landscape.
// See: https://d.android.com/reference/android/content/res/Configuration.html#smallestScreenWidthDp
optional int32 smallest_screen_width_dp = 15;
// The type of touch screen attached to the device.
// See: https://d.android.com/reference/android/content/res/Configuration.html#touchscreen
optional int32 touchscreen = 16;
// Bit mask of the ui mode.
// Contains information about the overall ui mode of the device.
// Eg: NORMAL, DESK, CAR, TELEVISION, WATCH, VR_HEADSET
// Also contains information about whether the device is in night mode.
// See: https://d.android.com/reference/android/content/res/Configuration.html#uiMode
optional int32 ui_mode = 17;
}
/**
* Logs changes in the connection state of the mobile radio.
*
* Logged from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/dataconnection/DataConnection.java
*/
message MobileConnectionStateChanged {
// States are from the state machine DataConnection.java.
enum State {
UNKNOWN = 0;
// The connection is inactive, or disconnected.
INACTIVE = 1;
// The connection is being activated, or connecting.
ACTIVATING = 2;
// The connection is active, or connected.
ACTIVE = 3;
// The connection is disconnecting.
DISCONNECTING = 4;
// The connection is disconnecting after creating a connection.
DISCONNECTION_ERROR_CREATING_CONNECTION = 5;
}
optional State state = 1;
// For multi-sim phones, this distinguishes between the sim cards.
optional int32 sim_slot_index = 2;
// Used to identify the connection. Starts at 0 and increments by 1 for
// every new network created. Resets whenever the device reboots.
optional int32 data_connection_id = 3;
// A bitmask for the capabilities of this connection.
// Eg. DEFAULT (internet), MMS, SUPL, DUN, IMS.
// Default value (if we have no information): 0
optional int64 capabilities = 4;
// If this connection has internet.
// This just checks if the DEFAULT bit of capabilities is set.
optional bool has_internet = 5;
}
/**
* Logs changes in mobile radio technology. eg: LTE, EDGE, CDMA.
*
* Logged from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/ServiceStateTracker.java
*/
message MobileRadioTechnologyChanged {
optional android.telephony.NetworkTypeEnum state = 1;
// For multi-sim phones, this distinguishes between the sim cards.
optional int32 sim_slot_index = 2;
}
/**
* Logs the VID and PID of any connected USB devices.
*
* Notes if any Audio, HID (input buttons/mouse/keyboard), or Storage interfaces are present.
*
* Logged by Vendor.
*/
message UsbDeviceAttached {
optional int32 vid = 1;
optional int32 pid = 2;
optional bool has_audio = 3;
optional bool has_hid = 4;
optional bool has_storage = 5;
enum State {
STATE_DISCONNECTED = 0;
STATE_CONNECTED = 1;
}
optional State state = 6;
optional int64 last_connect_duration_millis = 7;
}
/**
* Logs when Bluetooth is enabled and disabled.
*
* Logged from:
* services/core/java/com/android/server/BluetoothManagerService.java
*/
message BluetoothEnabledStateChanged {
repeated AttributionNode attribution_node = 1;
// Whether or not bluetooth is enabled on the device.
enum State {
UNKNOWN = 0;
ENABLED = 1;
DISABLED = 2;
}
optional State state = 2;
// The reason for being enabled/disabled.
// Eg. Airplane mode, crash, application request.
optional android.bluetooth.EnableDisableReasonEnum reason = 3;
// If the reason is an application request, this will be the package name.
optional string pkg_name = 4;
}
/**
* Logs when profiles on a Bluetooth device connects and disconnects.
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/RemoteDevices.java
*
* Next Tag: 6
*/
message BluetoothConnectionStateChanged {
// The state of the connection.
// Eg: CONNECTING, CONNECTED, DISCONNECTING, DISCONNECTED.
optional android.bluetooth.ConnectionStateEnum state = 1;
// An identifier that can be used to match connect and disconnect events.
// Currently is last two bytes of a hash of a device level ID and
// the mac address of the bluetooth device that is connected.
// Deprecated: use obfuscated_id instead, this one is always 0 for Q+
optional int32 obfuscated_id = 2 [deprecated = true];
// The profile that is connected. Eg. GATT, A2DP, HEADSET.
// From android.bluetooth.BluetoothAdapter.java
// Default: 0 when not used
optional int32 bt_profile = 3;
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes new_obfuscated_id = 4 [(android.os.statsd.log_mode) = MODE_BYTES];
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when a Bluetooth device connects and disconnects over ACL
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/AdapterProperties.java
*
* Next Tag: 4
*/
message BluetoothAclConnectionStateChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// The state of the connection.
// Eg: CONNECTING, CONNECTED, DISCONNECTING, DISCONNECTED.
optional android.bluetooth.ConnectionStateEnum state = 2;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 3;
}
/**
* Logs when a Bluetooth device connects and disconnects over SCO
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/hfp/HeadsetStateMachine.java
* packages/apps/Bluetooth/src/com/android/bluetooth/hfp/HeadsetClientStateMachine.java
*
* Next Tag: 5
*/
message BluetoothScoConnectionStateChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// The state of the connection.
// Eg: CONNECTING, CONNECTED, DISCONNECTING, DISCONNECTED.
optional android.bluetooth.ConnectionStateEnum state = 2;
// Codec used for this SCO connection
// Default: UNKNOWN
optional android.bluetooth.hfp.ScoCodec codec = 3;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 4;
}
/**
* Logged when active device of a profile changes
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/A2dpService.java
* packages/apps/Bluetooth/src/com/android/bluetooth/hfp/HeadsetService.java
* packages/apps/Bluetooth/src/com/android/bluetooth/hearingaid/HearingAidService.java
*/
message BluetoothActiveDeviceChanged {
// The profile whose active device has changed. Eg. A2DP, HEADSET, HEARING_AID
// From android.bluetooth.BluetoothProfile
optional int32 bt_profile = 1;
// An identifier that can be used to match events for this new active device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if there is no active device for this profile
optional bytes obfuscated_id = 2 [(android.os.statsd.log_mode) = MODE_BYTES];
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 3;
}
// Logs when there is an event affecting Bluetooth device's link layer connection.
// - This event is triggered when there is a related HCI command or event
// - Users of this metrics can deduce Bluetooth device's connection state from these events
// - HCI commands are logged before the command is sent, after receiving command status, and after
// receiving command complete
// - HCI events are logged when they arrive
//
// Low level log from system/bt
//
// Bluetooth classic commands:
// - CMD_CREATE_CONNECTION
// - CMD_DISCONNECT
// - CMD_CREATE_CONNECTION_CANCEL
// - CMD_ACCEPT_CONNECTION_REQUEST
// - CMD_REJECT_CONNECTION_REQUEST
// - CMD_SETUP_ESCO_CONNECTION
// - CMD_ACCEPT_ESCO_CONNECTION
// - CMD_REJECT_ESCO_CONNECTION
// - CMD_ENH_SETUP_ESCO_CONNECTION
// - CMD_ENH_ACCEPT_ESCO_CONNECTION
//
// Bluetooth low energy commands:
// - CMD_BLE_CREATE_LL_CONN [Only logged on error or when initiator filter policy is 0x00]
// - CMD_BLE_CREATE_CONN_CANCEL [Only logged when there is an error]
// - CMD_BLE_EXTENDED_CREATE_CONNECTION [Only logged on error or when initiator filter policy is 0x00]
// - CMD_BLE_CLEAR_WHITE_LIST
// - CMD_BLE_ADD_WHITE_LIST
// - CMD_BLE_REMOVE_WHITE_LIST
//
// Bluetooth classic events:
// - EVT_CONNECTION_COMP
// - EVT_CONNECTION_REQUEST
// - EVT_DISCONNECTION_COMP
// - EVT_ESCO_CONNECTION_COMP
// - EVT_ESCO_CONNECTION_CHANGED
//
// Bluetooth low energy meta events:
// - BLE_EVT_CONN_COMPLETE_EVT
// - BLE_EVT_ENHANCED_CONN_COMPLETE_EVT
//
// Next tag: 10
message BluetoothLinkLayerConnectionEvent {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Connection handle of this connection if available
// Range: 0x0000 - 0x0EFF (12 bits)
// Default: 0xFFFF if the handle is unknown
optional int32 connection_handle = 2;
// Direction of the link
// Default: DIRECTION_UNKNOWN
optional android.bluetooth.DirectionEnum direction = 3;
// Type of this link
// Default: LINK_TYPE_UNKNOWN
optional android.bluetooth.LinkTypeEnum type = 4;
// Reason metadata for this link layer connection event, rules for interpretation:
// 1. If hci_cmd is set and valid, hci_event can be either EVT_COMMAND_STATUS or
// EVT_COMMAND_COMPLETE, ignore hci_ble_event in this case
// 2. If hci_event is set to EVT_BLE_META, look at hci_ble_event; otherwise, if hci_event is
// set and valid, ignore hci_ble_event
// HCI command associated with this event
// Default: CMD_UNKNOWN
optional android.bluetooth.hci.CommandEnum hci_cmd = 5;
// HCI event associated with this event
// Default: EVT_UNKNOWN
optional android.bluetooth.hci.EventEnum hci_event = 6;
// HCI BLE meta event associated with this event
// Default: BLE_EVT_UNKNOWN
optional android.bluetooth.hci.BleMetaEventEnum hci_ble_event = 7;
// HCI command status code if this is triggerred by hci_cmd
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum cmd_status = 8;
// HCI reason code associated with this event
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum reason_code = 9;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 10;
}
/**
* Logs when a module is rolled back by Watchdog.
*
* Logged from: Rollback Manager
*/
message WatchdogRollbackOccurred {
enum RollbackType {
UNKNOWN = 0;
ROLLBACK_INITIATE = 1;
ROLLBACK_SUCCESS = 2;
ROLLBACK_FAILURE = 3;
ROLLBACK_BOOT_TRIGGERED = 4;
}
optional RollbackType rollback_type = 1;
optional string package_name = 2;
optional int32 package_version_code = 3;
enum RollbackReasonType {
REASON_UNKNOWN = 0;
REASON_NATIVE_CRASH = 1;
REASON_EXPLICIT_HEALTH_CHECK = 2;
REASON_APP_CRASH = 3;
REASON_APP_NOT_RESPONDING = 4;
REASON_NATIVE_CRASH_DURING_BOOT = 5;
}
optional RollbackReasonType rollback_reason = 4;
// Set by RollbackPackageHealthObserver to be the package that is failing when a rollback
// is initiated. Empty if the package is unknown.
optional string failing_package_name = 5;
optional TrainExperimentIds experiment_ids = 6 [(log_mode) = MODE_BYTES];
}
/**
* Logs when there is a change in Bluetooth A2DP playback state
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/A2dpService.java
*/
message BluetoothA2dpPlaybackStateChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Current playback state
// Default: PLAYBACK_STATE_UNKNOWN
optional android.bluetooth.a2dp.PlaybackStateEnum playback_state = 2;
// Current audio coding mode
// Default: AUDIO_CODING_MODE_UNKNOWN
optional android.bluetooth.a2dp.AudioCodingModeEnum audio_coding_mode = 3;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 4;
}
/**
* Logs when there is a change in A2DP codec config for a particular remote device
*
* Logged from:
* frameworks/base/core/java/android/bluetooth/BluetoothCodecConfig.java
* packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/A2dpService.java
*/
message BluetoothA2dpCodecConfigChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Type of codec as defined by various SOURCE_CODEC_TYPE_* constants in BluetoothCodecConfig
// Default SOURCE_CODEC_TYPE_INVALID
optional int32 codec_type = 2;
// Codec priroity, the higher the more preferred, -1 for disabled
// Default: CODEC_PRIORITY_DEFAULT
optional int32 codec_priority = 3;
// Sample rate in Hz as defined by various SAMPLE_RATE_* constants in BluetoothCodecConfig
// Default: SAMPLE_RATE_NONE
optional int32 sample_rate = 4;
// Bits per sample as defined by various BITS_PER_SAMPLE_* constants in BluetoothCodecConfig
// Default: BITS_PER_SAMPLE_NONE
optional int32 bits_per_sample = 5;
// Channel mode as defined by various CHANNEL_MODE_* constants in BluetoothCodecConfig
// Default: CHANNEL_MODE_NONE
optional int32 channel_mode = 6;
// Codec specific values
// Default 0
optional int64 codec_specific_1 = 7;
optional int64 codec_specific_2 = 8;
optional int64 codec_specific_3 = 9;
optional int64 codec_specific_4 = 10;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 11;
}
/**
* Logs when there is a change in selectable A2DP codec capability for a paricular remote device
* Each codec's capability is logged separately due to statsd restriction
*
* Logged from:
* frameworks/base/core/java/android/bluetooth/BluetoothCodecConfig.java
* packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/A2dpService.java
*/
message BluetoothA2dpCodecCapabilityChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Type of codec as defined by various SOURCE_CODEC_TYPE_* constants in BluetoothCodecConfig
// Default SOURCE_CODEC_TYPE_INVALID
optional int32 codec_type = 2;
// Codec priroity, the higher the more preferred, -1 for disabled
// Default: CODEC_PRIORITY_DEFAULT
optional int32 codec_priority = 3;
// A bit field of supported sample rates as defined by various SAMPLE_RATE_* constants
// in BluetoothCodecConfig
// Default: empty and SAMPLE_RATE_NONE for individual item
optional int32 sample_rate = 4;
// A bit field of supported bits per sample as defined by various BITS_PER_SAMPLE_* constants
// in BluetoothCodecConfig
// Default: empty and BITS_PER_SAMPLE_NONE for individual item
optional int32 bits_per_sample = 5;
// A bit field of supported channel mode as defined by various CHANNEL_MODE_* constants in
// BluetoothCodecConfig
// Default: empty and CHANNEL_MODE_NONE for individual item
optional int32 channel_mode = 6;
// Codec specific values
// Default 0
optional int64 codec_specific_1 = 7;
optional int64 codec_specific_2 = 8;
optional int64 codec_specific_3 = 9;
optional int64 codec_specific_4 = 10;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 11;
}
/**
* Logs when A2DP failed to read from PCM source.
* This typically happens when audio HAL cannot supply A2DP with data fast enough for encoding.
*
* Logged from:
* system/bt
*/
message BluetoothA2dpAudioUnderrunReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Encoding interval in nanoseconds
// Default: 0
optional int64 encoding_interval_nanos = 2;
// Number of bytes of PCM data that could not be read from the source
// Default: 0
optional int32 num_missing_pcm_bytes = 3;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 4;
}
/**
* Logs when A2DP failed send encoded data to the remote device fast enough such that the transmit
* buffer queue is full and we have to drop data
*
* Logged from:
* system/bt
*/
message BluetoothA2dpAudioOverrunReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Encoding interval in nanoseconds
// Default: 0
optional int64 encoding_interval_nanos = 2;
// Number of buffers dropped in this event
// Each buffer is encoded in one encoding interval and consists of multiple encoded frames
// Default: 0
optional int32 num_dropped_buffers = 3;
// Number of encoded buffers dropped in this event
// Default 0
optional int32 num_dropped_encoded_frames = 4;
// Number of encoded bytes dropped in this event
// Default: 0
optional int32 num_dropped_encoded_bytes = 5;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 6;
}
/**
* Logs when we receive reports regarding a device's RSSI value
*
* Logged from:
* system/bt
*/
message BluetoothDeviceRssiReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Connection handle of this connection if available
// Range: 0x0000 - 0x0EFF (12 bits)
// Default: 0xFFFF if the handle is unknown
optional int32 connection_handle = 2;
// HCI command status code if this is triggerred by hci_cmd
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum hci_status = 3;
// BR/EDR
// Range: -128 ≤ N ≤ 127 (signed integer)
// Units: dB
// LE:
// Range: -127 to 20, 127 (signed integer)
// Units: dBm
// Invalid when an out of range value is reported
optional int32 rssi = 4;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when we receive reports regarding how many consecutive failed contacts for a connection
*
* Logged from:
* system/bt
*/
message BluetoothDeviceFailedContactCounterReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Connection handle of this connection if available
// Range: 0x0000 - 0x0EFF (12 bits)
// Default: 0xFFFF if the handle is unknown
optional int32 connection_handle = 2;
// HCI command status code if this is triggerred by hci_cmd
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum cmd_status = 3;
// Number of consecutive failed contacts for a connection corresponding to the Handle
// Range: uint16_t, 0-0xFFFF
// Default: 0xFFFFF
optional int32 failed_contact_counter = 4;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when we receive reports regarding the tranmit power level used for a specific connection
*
* Logged from:
* system/bt
*/
message BluetoothDeviceTxPowerLevelReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Connection handle of this connection if available
// Range: 0x0000 - 0x0EFF (12 bits)
// Default: 0xFFFF if the handle is unknown
optional int32 connection_handle = 2;
// HCI command status code if this is triggered by hci_cmd
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum hci_status = 3;
// Range: -30 ≤ N ≤ 20
// Units: dBm
// Invalid when an out of range value is reported
optional int32 transmit_power_level = 4;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when Bluetooth controller failed to reply with command status within a timeout period after
* receiving an HCI command from the host
*
* Logged from: system/bt
*/
message BluetoothHciTimeoutReported {
// HCI command associated with this event
// Default: CMD_UNKNOWN
optional android.bluetooth.hci.CommandEnum hci_command = 1;
}
/**
* Logs when we receive Bluetooth Link Quality Report event from the controller
* See Android Bluetooth HCI specification for more details
*
* Note: all count and bytes field are counted since last event
*
* Logged from: system/bt
*/
message BluetoothQualityReportReported {
// Quality report ID
// Original type: uint8_t
// Default: BQR_ID_UNKNOWN
optional android.bluetooth.hci.BqrIdEnum quality_report_id = 1;
// Packet type of the connection
// Original type: uint8_t
// Default: BQR_PACKET_TYPE_UNKNOWN
optional android.bluetooth.hci.BqrPacketTypeEnum packet_types = 2;
// Connection handle of the connection
// Original type: uint16_t
optional int32 connection_handle = 3;
// Performing Role for the connection
// Original type: uint8_t
optional int32 connection_role = 4;
// Current Transmit Power Level for the connection. This value is the same as the controller's
// response to the HCI_Read_Transmit_Power_Level HCI command
// Original type: uint8_t
optional int32 tx_power_level = 5;
// Received Signal Strength Indication (RSSI) value for the connection. This value is an
// absolute receiver signal strength value
// Original type: int8_t
optional int32 rssi = 6;
// Signal-to-Noise Ratio (SNR) value for the connection. It is the average SNR of all the
// channels used by the link currently
// Original type: uint8_t
optional int32 snr = 7;
// Indicates the number of unused channels in AFH_channel_map
// Original type: uint8_t
optional int32 unused_afh_channel_count = 8;
// Indicates the number of the channels which are interfered and quality is bad but are still
// selected for AFH
// Original type: uint8_t
optional int32 afh_select_unideal_channel_count = 9;
// Current Link Supervision Timeout Setting
// Unit: N * 0.3125 ms (1 Bluetooth Clock)
// Original type: uint16_t
optional int32 lsto = 10;
// Piconet Clock for the specified Connection_Handle. This value is the same as the controller's
// response to HCI_Read_Clock HCI command with the parameter "Which_Clock" of
// 0x01 (Piconet Clock)
// Unit: N * 0.3125 ms (1 Bluetooth Clock)
// Original type: uint32_t
optional int64 connection_piconet_clock = 11;
// The count of retransmission
// Original type: uint32_t
optional int64 retransmission_count = 12;
// The count of no RX
// Original type: uint32_t
optional int64 no_rx_count = 13;
// The count of NAK (Negative Acknowledge)
// Original type: uint32_t
optional int64 nak_count = 14;
// Controller timestamp of last TX ACK
// Unit: N * 0.3125 ms (1 Bluetooth Clock)
// Original type: uint32_t
optional int64 last_tx_ack_timestamp = 15;
// The count of Flow-off (STOP)
// Original type: uint32_t
optional int64 flow_off_count = 16;
// Controller timestamp of last Flow-on (GO)
// Unit: N * 0.3125 ms (1 Bluetooth Clock)
// Original type: uint32_t
optional int64 last_flow_on_timestamp = 17;
// Buffer overflow count (how many bytes of TX data are dropped) since the last event
// Original type: uint32_t
optional int64 buffer_overflow_bytes = 18;
// Buffer underflow count (in byte) since last event
// Original type: uint32_t
optional int64 buffer_underflow_bytes = 19;
}
/**
* Logs when a Bluetooth device's manufacturer information is learnt by the Bluetooth stack
*
* Notes:
* - Each event can be partially filled as we might learn different pieces of device
* information at different time
* - Multiple device info events can be combined to give more complete picture
* - When multiple device info events tries to describe the same information, the
* later one wins
*
* Logged from:
* packages/apps/Bluetooth
*/
message BluetoothDeviceInfoReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Where is this device info obtained from
optional android.bluetooth.DeviceInfoSrcEnum source_type = 2;
// Name of the data source
// For EXTERNAL: package name of the data source
// For INTERNAL: null for general case, component name otherwise
optional string source_name = 3;
// Name of the manufacturer of this device
optional string manufacturer = 4;
// Model of this device
optional string model = 5;
// Hardware version of this device
optional string hardware_version = 6;
// Software version of this device
optional string software_version = 7;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 8;
}
/**
* Logs when we receive Bluetooth Read Remote Version Information Complete Event from the remote
* device, as documented by the Bluetooth Core HCI specification
* Reference: https://www.bluetooth.com/specifications/bluetooth-core-specification
* Vol 2, Part E, Page 1118
*
* Logged from:
* system/bt
*/
message BluetoothRemoteVersionInfoReported {
// Connection handle of the connection
// Original type: uint16_t
optional int32 connection_handle = 1;
// HCI command status code
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum hci_status = 2;
// 1 byte Version of current LMP in the remote controller
optional int32 lmp_version = 3;
// 2 bytes LMP manufacturer code of the remote controller
// https://www.bluetooth.com/specifications/assigned-numbers/company-identifiers
optional int32 lmp_manufacturer_code = 4;
// 4 bytes subversion of the LMP in the remote controller
optional int32 lmp_subversion = 5;
}
/**
* Logs when certain Bluetooth SDP attributes are discovered
* Constant definitions are from:
* https://www.bluetooth.com/specifications/assigned-numbers/service-discovery
*
* Current logged attributes:
* - BluetoothProfileDescriptorList
* - Supported Features Bitmask
*
* Logged from:
* system/bt
*/
message BluetoothSdpAttributeReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Short form UUIDs used to identify Bluetooth protocols, profiles, and service classes
// Original type: uint16_t
optional int32 protocol_uuid = 2;
// Short form UUIDs used to identify Bluetooth SDP attribute types
// Original type: uint16_t
optional int32 attribute_id = 3;
// Attribute value for the particular attribute
optional bytes attribute_value = 4 [(android.os.statsd.log_mode) = MODE_BYTES];
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when bond state of a Bluetooth device changes
*
* Logged from:
* frameworks/base/core/java/android/bluetooth/BluetoothDevice.java
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/BondStateMachine.java
*/
message BluetoothBondStateChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Preferred transport type to remote dual mode device
// Default: TRANSPORT_AUTO means no preference
optional android.bluetooth.TransportTypeEnum transport = 2;
// The type of this Bluetooth device (Classic, LE, or Dual mode)
// Default: UNKNOWN
optional android.bluetooth.DeviceTypeEnum type = 3;
// Current bond state (NONE, BONDING, BONDED)
// Default: BOND_STATE_UNKNOWN
optional android.bluetooth.BondStateEnum bond_state = 4;
// Bonding sub state
// Default: BOND_SUB_STATE_UNKNOWN
optional android.bluetooth.BondSubStateEnum bonding_sub_state = 5;
// Unbond Reason
// Default: UNBOND_REASON_UNKNOWN
optional android.bluetooth.UnbondReasonEnum unbond_reason = 6;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 7;
}
/**
* Logs there is an event related Bluetooth classic pairing
*
* Logged from:
* system/bt
*/
message BluetoothClassicPairingEventReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Connection handle of this connection if available
// Range: 0x0000 - 0x0EFF (12 bits)
// Default: 0xFFFF if the handle is unknown
optional int32 connection_handle = 2;
// HCI command associated with this event
// Default: CMD_UNKNOWN
optional android.bluetooth.hci.CommandEnum hci_cmd = 3;
// HCI event associated with this event
// Default: EVT_UNKNOWN
optional android.bluetooth.hci.EventEnum hci_event = 4;
// HCI command status code if this is triggerred by hci_cmd
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum cmd_status = 5;
// HCI reason code associated with this event
// Default: STATUS_UNKNOWN
optional android.bluetooth.hci.StatusEnum reason_code = 6;
// A status value related to this specific event
// Default: 0
optional int64 event_value = 7;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 8;
}
/**
* Logs when there is an event related to Bluetooth Security Manager Protocol (SMP)
*
* Logged from:
* system/bt
*/
message BluetoothSmpPairingEventReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if the device identifier is not known
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// SMP command sent or received over L2CAP
// Default: CMD_UNKNOWN
optional android.bluetooth.smp.CommandEnum smp_command = 2;
// Whether this command is sent or received
// Default: DIRECTION_UNKNOWN
optional android.bluetooth.DirectionEnum direction = 3;
// SMP failure reason code
// Default: PAIRING_FAIL_REASON_DEFAULT
optional android.bluetooth.smp.PairingFailReasonEnum smp_fail_reason = 4;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 5;
}
/**
* Logs when a Bluetooth socket’s connection state changed
*
* Logged from:
* system/bt
*/
message BluetoothSocketConnectionStateChanged {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if this is a server listener socket
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Temporary port of this socket for the current connection or session only
// Default 0 when unknown or don't care
optional int32 port = 2;
// Socket type as mentioned in
// frameworks/base/core/java/android/bluetooth/BluetoothSocket.java
// Default: SOCKET_TYPE_UNKNOWN
optional android.bluetooth.SocketTypeEnum type = 3;
// Socket connection state
// Default: SOCKET_CONNECTION_STATE_UNKNOWN
optional android.bluetooth.SocketConnectionstateEnum state = 4;
// Number of bytes sent to remote device during this connection
optional int64 tx_bytes = 5;
// Number of bytes received from remote device during this connection
optional int64 rx_bytes = 6;
// Socket owner's UID
optional int32 uid = 7 [(is_uid) = true];
// Server port of this socket, if any. When both |server_port| and |port| fields are populated,
// |port| must be spawned by |server_port|
// Default 0 when unknown or don't care
optional int32 server_port = 8;
// Whether this is a server listener socket
optional android.bluetooth.SocketRoleEnum is_server = 9;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 10;
}
/**
* Logs when Class of Device (CoD) value is learnt for a device during pairing or connection
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/BondStateMachine.java
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/RemoteDevices.java
*
*/
message BluetoothClassOfDeviceReported {
// An identifier that can be used to match events for this device.
// Currently, this is a salted hash of the MAC address of this Bluetooth device.
// Salt: Randomly generated 256 bit value
// Hash algorithm: HMAC-SHA256
// Size: 32 byte
// Default: null or empty if this is a server listener socket
optional bytes obfuscated_id = 1 [(android.os.statsd.log_mode) = MODE_BYTES];
// Class of Device (CoD) value including both Major, Minor device class and service class
// Defined in: https://www.bluetooth.com/specifications/assigned-numbers/baseband
// Also defined in: https://developer.android.com/reference/android/bluetooth/BluetoothClass
// Default: 0
optional int32 class_of_device = 2;
// An identifier that can be used to match events for this device.
// The incremental identifier is locally generated and guaranteed not derived
// from any globally unique hardware id.
// For paired devices, it stays consistent between Bluetooth toggling for the
// same remote device.
// For unpaired devices, it stays consistent within the same Bluetooth adapter
// session for the same remote device.
// Default: 0 if the device's metric id is unknown.
optional int32 metric_id = 3;
}
/**
* Logs when something is plugged into or removed from the USB-C connector.
*
* Logged from:
* UsbService
*/
message UsbConnectorStateChanged {
enum State {
STATE_DISCONNECTED = 0;
STATE_CONNECTED = 1;
}
optional State state = 1;
optional string id = 2;
// Last active session in ms.
// 0 when the port is in connected state.
optional int64 last_connect_duration_millis = 3;
}
/**
* Logs the reported speaker impedance.
*
* Logged from:
* Vendor audio implementation.
*/
message SpeakerImpedanceReported {
optional int32 speaker_location = 1;
optional int32 impedance = 2;
}
/**
* Logs the report of a failed hardware.
*
* Logged from:
* Vendor HALs.
*
*/
message HardwareFailed {
enum HardwareType {
HARDWARE_FAILED_UNKNOWN = 0;
HARDWARE_FAILED_MICROPHONE = 1;
HARDWARE_FAILED_CODEC = 2;
HARDWARE_FAILED_SPEAKER = 3;
HARDWARE_FAILED_FINGERPRINT = 4;
}
optional HardwareType hardware_type = 1;
/**
* hardware_location allows vendors to differentiate between multiple instances of
* the same hardware_type. The specific locations are vendor defined integers,
* referring to board-specific numbering schemes.
*/
optional int32 hardware_location = 2;
/**
* failure_code is specific to the HardwareType of the failed hardware.
* It should use one of the enum values defined below.
*/
enum HardwareErrorCode {
UNKNOWN = 0;
COMPLETE = 1;
SPEAKER_HIGH_Z = 2;
SPEAKER_SHORT = 3;
FINGERPRINT_SENSOR_BROKEN = 4;
FINGERPRINT_TOO_MANY_DEAD_PIXELS = 5;
DEGRADE = 6;
}
optional int32 failure_code = 3;
}
/**
* Log an event when the device has been physically dropped.
* Reported from the /vendor partition.
*/
message PhysicalDropDetected {
// Confidence that the event was actually a drop, 0 -> 100
optional int32 confidence_pctg = 1;
// Peak acceleration of the drop, in 1/1000s of a g.
optional int32 accel_peak_thousandths_g = 2;
// Duration of freefall in ms
optional int32 freefall_time_millis = 3;
}
/**
* Log bucketed battery charge cycles.
*
* Each bucket represents cycles of the battery past
* a given charge point. For example, if 10 cycle buckets are
* initialized, bucket 1 is the lowest 1/10th of the battery,
* and bucket 10 is 100%.
*
* Logged from:
* /sys/class/power_supply/bms/cycle_count, via Vendor.
*/
message ChargeCyclesReported {
optional int32 cycle_bucket_1 = 1;
optional int32 cycle_bucket_2 = 2;
optional int32 cycle_bucket_3 = 3;
optional int32 cycle_bucket_4 = 4;
optional int32 cycle_bucket_5 = 5;
optional int32 cycle_bucket_6 = 6;
optional int32 cycle_bucket_7 = 7;
optional int32 cycle_bucket_8 = 8;
optional int32 cycle_bucket_9 = 9;
optional int32 cycle_bucket_10 = 10;
}
/**
* Log battery health snapshot.
*
* Resistance, Voltage, Open Circuit Voltage, Temperature, and Charge Level
* are snapshotted periodically over 24hrs.
*/
message BatteryHealthSnapshot {
enum BatterySnapshotType {
UNKNOWN = 0;
MIN_TEMP = 1; // Snapshot at min batt temp over 24hrs.
MAX_TEMP = 2; // Snapshot at max batt temp over 24hrs.
MIN_RESISTANCE = 3; // Snapshot at min batt resistance over 24hrs.
MAX_RESISTANCE = 4; // Snapshot at max batt resistance over 24hrs.
MIN_VOLTAGE = 5; // Snapshot at min batt voltage over 24hrs.
MAX_VOLTAGE = 6; // Snapshot at max batt voltage over 24hrs.
MIN_CURRENT = 7; // Snapshot at min batt current over 24hrs.
MAX_CURRENT = 8; // Snapshot at max batt current over 24hrs.
MIN_BATT_LEVEL = 9; // Snapshot at min battery level (SoC) over 24hrs.
MAX_BATT_LEVEL = 10; // Snapshot at max battery level (SoC) over 24hrs.
AVG_RESISTANCE = 11; // Snapshot at average battery resistance over 24hrs.
}
optional BatterySnapshotType type = 1;
// Temperature, in 1/10ths of degree C.
optional int32 temperature_deci_celsius = 2;
// Voltage Battery Voltage, in microVolts.
optional int32 voltage_micro_volt = 3;
// Current Battery current, in microAmps.
optional int32 current_micro_amps = 4;
// OpenCircuitVoltage Battery Open Circuit Voltage, in microVolts.
optional int32 open_circuit_micro_volt = 5;
// Resistance Battery Resistance, in microOhms.
optional int32 resistance_micro_ohm = 6;
// Level Battery Level, as % of full.
optional int32 level_percent = 7;
}
/**
* Log slow I/O operations on the primary storage.
*/
message SlowIo {
// Classifications of IO Operations.
enum IoOperation {
UNKNOWN = 0;
READ = 1;
WRITE = 2;
UNMAP = 3;
SYNC = 4;
}
optional IoOperation operation = 1;
// The number of slow IO operations of this type over 24 hours.
optional int32 count = 2;
}
/**
* Log battery caused shutdown with the last recorded voltage.
*/
message BatteryCausedShutdown {
// The last recorded battery voltage prior to shutdown.
optional int32 last_recorded_micro_volt = 1;
}
/**
* Logs when ThermalService receives throttling events.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/stats/StatsCompanionService.java
*/
message ThermalThrottlingSeverityStateChanged {
// The type of temperature being reported (CPU, GPU, SKIN, etc)
optional android.os.TemperatureTypeEnum sensor_type = 1;
// The name of the temperature source. Eg. CPU0
optional string sensor_name = 2;
// Temperature in tenths of a degree C.
// For BCL, it is decimillivolt, decimilliamps, and percentage * 10.
optional int32 temperature_deci_celsius = 3;
// Relative severity of the throttling, see enum definition.
optional android.os.ThrottlingSeverityEnum severity = 4;
}
/**
* Logs the duration of a davey (jank of >=700ms) when it occurs
*
* Logged from:
* frameworks/base/libs/hwui/JankTracker.cpp
*/
message DaveyOccurred {
// The UID that logged this atom.
optional int32 uid = 1 [(is_uid) = true];
// Amount of time it took to render the frame. Should be >=700ms.
optional int64 jank_duration_millis = 2;
}
/**
* Logs phone signal strength changes.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message PhoneSignalStrengthChanged {
// Signal strength, from frameworks/base/core/proto/android/telephony/enums.proto.
optional android.telephony.SignalStrengthEnum signal_strength = 1;
}
/**
* Logs when the phone state, sim state or signal strength changes
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message PhoneServiceStateChanged {
optional android.telephony.ServiceStateEnum state = 1;
optional android.telephony.SimStateEnum sim_state = 2;
optional android.telephony.SignalStrengthEnum signal_strength = 3;
}
/**
* Logs when the phone becomes on or off.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/TelephonyRegistry.java
*/
message PhoneStateChanged {
enum State {
OFF = 0;
ON = 1;
}
optional State state = 1;
}
message BackGesture {
enum BackType {
DEFAULT_BACK_TYPE = 0;
COMPLETED = 1;
COMPLETED_REJECTED = 2; // successful because coming from rejected area
INCOMPLETE_EXCLUDED = 3; // would have been successful but in the exclusion area
INCOMPLETE = 4; // Unsuccessful, for reasons other than below.
INCOMPLETE_FAR_FROM_EDGE = 5; // Unsuccessful, far from the edge.
INCOMPLETE_MULTI_TOUCH = 6; // Unsuccessful, multi touch.
INCOMPLETE_LONG_PRESS = 7; // Unsuccessful, long press.
INCOMPLETE_VERTICAL_MOVE = 8; // Unsuccessful, move vertically.
}
optional BackType type = 1;
optional int32 y_coordinate = 2 [deprecated = true]; // y coordinate for ACTION_DOWN event
optional int32 start_x = 4; // X coordinate for ACTION_DOWN event.
optional int32 start_y = 5; // Y coordinate for ACTION_DOWN event.
optional int32 end_x = 6; // X coordinate for ACTION_MOVE event.
optional int32 end_y = 7; // Y coordinate for ACTION_MOVE event.
optional int32 left_boundary = 8; // left edge width + left inset
optional int32 right_boundary = 9; // screen width - (right edge width + right inset)
enum WindowHorizontalLocation {
DEFAULT_LOCATION = 0;
LEFT = 1;
RIGHT = 2;
}
optional WindowHorizontalLocation x_location = 3 [deprecated = true];
}
message ExclusionRectStateChanged {
optional string component_name = 1; // if not available, simply packageName
optional int32 requested_height = 2; // px
optional int32 rejected_height = 3; // px
enum WindowHorizontalLocation {
DEFAULT_LOCATION = 0;
LEFT = 1;
RIGHT = 2;
}
optional WindowHorizontalLocation x_location = 4;
optional bool landscape = 5;
optional bool splitscreen = 6;
optional int32 duration_millis = 7;
}
/**
* Logs when Launcher (HomeScreen) UI has changed or was interacted.
*
* Logged from:
* packages/apps/Launcher3
*/
message LauncherUIChanged {
optional android.stats.launcher.LauncherAction action = 1 [deprecated = true];
optional android.stats.launcher.LauncherState src_state = 2;
optional android.stats.launcher.LauncherState dst_state = 3;
optional android.stats.launcher.LauncherExtension extension = 4 [(log_mode) = MODE_BYTES, deprecated = true];
optional bool is_swipe_up_enabled = 5 [deprecated = true];
// The event id (e.g., app launch, drag and drop, long press)
optional int32 event_id = 6;
// The event's source or target id (e.g., icon, task, button)
optional int32 target_id = 7;
// If the target needs to be tracked, use this id field
optional int32 instance_id = 8;
optional int32 uid = 9 [(is_uid) = true];
optional string package_name = 10;
optional string component_name = 11;
// (x, y) coordinate and the index information of the target on the container
optional int32 grid_x = 12;
optional int32 grid_y = 13;
optional int32 page_id = 14;
// e.g., folder icon's (x, y) location and index information on the workspace
optional int32 grid_x_parent = 15;
optional int32 grid_y_parent = 16;
optional int32 page_id_parent = 17;
// e.g., SEARCHBOX_ALLAPPS, FOLDER_WORKSPACE
optional int32 hierarchy = 18;
optional bool is_work_profile = 19;
// Used to store the predicted rank of the target
optional int32 rank = 20;
// e.g., folderLabelState can be captured in the following two fields
optional int32 from_state = 21;
optional int32 to_state = 22;
// e.g., autofilled or suggested texts that are not user entered
optional string edittext = 23;
}
/**
* Used for snapshot of the HomeScreen UI elements
*
* Logged from:
* packages/apps/Launcher3
*/
message LauncherStaticLayout {
// The event id (e.g., snapshot, drag and drop)
optional int32 event_id = 1;
// The event's source or target id (e.g., icon, shortcut, widget)
optional int32 target_id = 2;
// If the target needs to be tracked, use this id field
optional int32 instance_id = 3;
optional int32 uid = 4 [(is_uid) = true];
optional string package_name = 5;
optional string component_name = 6;
// (x, y) coordinate and the index information of the target on the container
optional int32 grid_x = 7;
optional int32 grid_y = 8;
optional int32 page_id = 9;
// e.g., folder icon's (x, y) location and index information on the workspace
optional int32 grid_x_parent = 10;
optional int32 grid_y_parent = 11;
optional int32 page_id_parent = 12;
// e.g., WORKSPACE, HOTSEAT, FOLDER_WORKSPACE, FOLDER_HOTSEAT
optional int32 hierarchy = 13;
optional bool is_work_profile = 14;
// e.g., PIN, WIDGET TRAY, APPS TRAY, PREDICTION
optional int32 origin = 15;
}
/**
* Logs when Wallpaper or ThemePicker UI has changed.
*
* Logged from:
* packages/apps/ThemePicker
* packages/apps/WallpaperPicker2
*/
message StyleUIChanged {
optional android.stats.style.Action action = 1;
optional int32 color_package_hash = 2;
optional int32 font_package_hash = 3;
optional int32 shape_package_hash = 4;
optional int32 clock_package_hash = 5;
optional int32 launcher_grid = 6;
optional int32 wallpaper_category_hash = 7;
optional int32 wallpaper_id_hash = 8;
optional int32 color_preference = 9;
optional android.stats.style.LocationPreference location_preference = 10;
}
/**
* Logs when Settings UI has changed.
*
* Logged from:
* packages/apps/Settings
*/
message SettingsUIChanged {
/**
* Where this SettingsUIChange event comes from. For example, if
* it's a PAGE_VISIBLE event, where the page is opened from.
*/
optional android.app.settings.PageId attribution = 1;
/**
* What the UI action is.
*/
optional android.app.settings.Action action = 2;
/**
* Where the action is happening
*/
optional android.app.settings.PageId page_id = 3;
/**
* What preference changed in this event.
*/
optional string changed_preference_key = 4;
/**
* The new value of the changed preference.
*/
optional int64 changed_preference_int_value = 5;
}
/**
* Logs basic timing information about touch events.
* Reported at most every 5 minutes while device is being interacted with.
*
* Logged from:
* frameworks/native/services/inputflinger
*/
message TouchEventReported {
/**
* The fields latency_{min|max|mean|stdev} represent minimum, maximum, mean,
* and the standard deviation of the time spent processing touchscreen events
* in the kernel and inputflinger. The units are microseconds.
*
* On supported devices, the starting point is taken during the hard interrupt inside the
* kernel touch driver. On all other devices, the starting point is taken inside
* the kernel's input event subsystem upon receipt of the input event.
* The ending point is taken inside InputDispatcher, just after the input event
* is sent to the app.
*/
// Minimum value
optional float latency_min_micros = 1;
// Maximum value
optional float latency_max_micros = 2;
// Average value
optional float latency_mean_micros = 3;
// Standard deviation
optional float latency_stdev_micros = 4;
// Number of touch events (input_event) in this report
optional int32 count = 5;
}
/**
* Logs gesture classification and timing information for touch events.
*
* Logged from:
* frameworks/base/core/java/android/view/GestureDetector.java
* frameworks/base/core/java/android/view/View.java
*/
message TouchGestureClassified {
// The source of the classification (e.g. Java class name).
optional string source = 1;
enum Classification {
UNKNOWN_CLASSIFICATION = 0;
SINGLE_TAP = 1;
DOUBLE_TAP = 2;
LONG_PRESS = 3;
DEEP_PRESS = 4;
SCROLL = 5;
}
// The classification of the gesture.
optional Classification classification = 2;
// The interval from the start of a touch event stream until the
// classification was made.
optional int32 latency_millis = 3;
// The distance from the location of the first touch event to the
// location of the touch event when the classification was made.
optional float displacement_px = 4;
}
/**
* Logs that a setting was updated.
* Logged from:
* frameworks/base/packages/SettingsProvider/src/com/android/providers/settings/SettingsState.java
* The tag and is_default allow resetting of settings to default values based on the specified
* tag. See Settings#putString(ContentResolver, String, String, String, boolean) for more details.
*/
message SettingChanged {
// The name of the setting.
optional string setting = 1;
// The change being imposed on this setting. May represent a number, eg "3".
optional string value = 2;
// The new value of this setting. For most settings, this is same as value. For some settings,
// value is +X or -X where X represents an element in a set. For example, if the previous value
// is A,B,C and value is -B, then new_value is A,C and prev_value is A,B,C.
// The +/- feature is currently only used for location_providers_allowed.
optional string new_value = 3;
// The previous value of this setting.
optional string prev_value = 4;
// The tag used with the is_default for resetting sets of settings. This is generally null.
optional string tag = 5;
// True if this setting with tag should be resettable.
optional bool is_default = 6;
// The associated user (for multi-user feature). Defined in android/os/UserHandle.java
optional int32 user = 7;
enum ChangeReason {
UPDATED = 1; // Updated can be an insertion or an update.
DELETED = 2;
}
optional ChangeReason reason = 8;
}
/**
* Logs activity going to foreground or background
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityRecord.java
*/
message ActivityForegroundStateChanged {
optional int32 uid = 1 [(is_uid) = true];
optional string pkg_name = 2;
optional string class_name = 3;
enum State {
BACKGROUND = 0;
FOREGROUND = 1;
}
optional State state = 4;
}
/**
* Logs when a volume entered low Storage state.
* Logged from:
* frameworks/base/services/core/java/com/android/server/storage/DeviceStorageMonitorService.java
*/
message LowStorageStateChanged {
// Volume that ran out of storage.
optional string volume_description = 1;
enum State {
UNKNOWN = 0;
OFF = 1;
ON = 2;
}
optional State state = 2;
}
/**
* Logs when an app is downgraded.
* Logged from:
* frameworks/base/services/core/java/com/android/server/pm/BackgroundDexOptService.java
*/
message AppDowngraded {
optional string package_name = 1;
// Size of the package (all data) before being downgraded.
optional int64 size_in_bytes_before = 2;
// Size of the package (all data) after being downgraded.
optional int64 size_in_bytes_after = 3;
optional bool aggressive = 4;
}
/**
* Logs when an app is optimized after being downgraded.
* Logged from:
* frameworks/base/services/core/java/com/android/server/pm/BackgroundDexOptService.java
*/
message AppOptimizedAfterDowngraded {
optional string package_name = 1;
}
/**
* Logs whenever an app is installed on external storage.
* Logged from:
frameworks/base/services/core/java/com/android/server/pm/PackageManagerService.java
*/
message AppInstallOnExternalStorageReported {
// The type of external storage.
optional android.stats.storage.ExternalStorageType storage_type = 1;
// The name of the package that is installed on the sd card.
optional string package_name = 2;
}
/**
* Logs when an app crashes.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message AppCrashOccurred {
optional int32 uid = 1 [(is_uid) = true];
optional string event_type = 2;
// The name of the process.
// system_server if it is not by an app
optional string process_name = 3;
// The pid if available. -1 means not available.
optional int32 pid = 4;
optional string package_name = 5;
enum InstantApp {
UNAVAILABLE = 0;
FALSE = 1;
TRUE = 2;
}
optional InstantApp is_instant_app = 6;
enum ForegroundState {
UNKNOWN = 0;
BACKGROUND = 1;
FOREGROUND = 2;
}
optional ForegroundState foreground_state = 7;
optional android.server.ErrorSource error_source = 8;
}
/**
* Logs when a WTF (What a Terrible Failure) happened.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message WTFOccurred {
optional int32 uid = 1 [(is_uid) = true];
optional string tag = 2;
// The name of the process.
// system_server if it is not by an app
optional string process_name = 3;
// The pid if available. -1 means not available.
optional int32 pid = 4;
optional android.server.ErrorSource error_source = 5;
}
/**
* Logs when system server reports low memory.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message LowMemReported {
}
/**
* Logs when an app ANR (App Not Responding) occurs.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/AppErrors.java
*/
message ANROccurred {
optional int32 uid = 1 [(is_uid) = true];
optional string process_name = 2;
optional string short_component_name = 3;
optional string reason = 4;
enum InstantApp {
UNAVAILABLE = 0;
FALSE = 1;
TRUE = 2;
}
optional InstantApp is_instant_app = 5;
enum ForegroundState {
UNKNOWN = 0;
BACKGROUND = 1;
FOREGROUND = 2;
}
optional ForegroundState foreground_state = 6;
optional android.server.ErrorSource error_source = 7;
optional string package_name = 8;
}
/**
* Logs when the vibrator state changes.
* Logged from:
* frameworks/base/services/core/java/com/android/server/VibratorService.java
*/
message VibratorStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
// Duration (in milliseconds) requested to keep the vibrator on.
// Only applicable for State == ON.
optional int64 duration_millis = 3;
}
/*
* Allows other apps to push events into statsd.
* Logged from:
* frameworks/base/core/java/android/util/StatsLog.java
*/
message AppBreadcrumbReported {
// The uid of the application that sent this custom atom.
optional int32 uid = 1 [(is_uid) = true];
// An arbitrary label chosen by the developer. For Android P, the label should be in [0, 16).
optional int32 label = 2;
// Allows applications to easily use a custom event as start/stop boundaries (ie, define custom
// predicates for the metrics).
enum State {
UNKNOWN = 0;
UNSPECIFIED = 1; // For events that are known to not represent START/STOP.
STOP = 2;
START = 3;
}
optional State state = 3;
}
/**
* Logs the wall-clock time when a significant wall-clock time shift occurs.
* For example, this could be due to the user manually changing the time.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/AlarmManagerService.java
*/
message WallClockTimeShifted {
// New wall-clock time in milliseconds, according to System.currentTimeMillis().
optional int64 wall_clock_timestamp_millis = 1;
}
/**
* Logs when statsd detects an anomaly.
*
* Logged from:
* frameworks/base/cmds/statsd/src/anomaly/AnomalyTracker.cpp
*/
message AnomalyDetected {
// Uid that owns the config whose anomaly detection alert fired.
optional int32 config_uid = 1 [(is_uid) = true];
// Id of the config whose anomaly detection alert fired.
optional int64 config_id = 2;
// Id of the alert (i.e. name of the anomaly that was detected).
optional int64 alert_id = 3;
}
message AppStartOccurred {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The app package name.
optional string pkg_name = 2;
enum TransitionType {
UNKNOWN = 0;
WARM = 1;
HOT = 2;
COLD = 3;
}
// The transition type.
optional TransitionType type = 3;
// The activity name.
optional string activity_name = 4;
// The name of the calling app. Empty if not set.
optional string calling_pkg_name = 5;
// Whether the app is an instant app.
optional bool is_instant_app = 6;
// Device uptime when activity started.
optional int64 activity_start_millis = 7;
optional android.app.AppTransitionReasonEnum reason = 8;
optional int32 transition_delay_millis = 9;
// -1 if not set.
optional int32 starting_window_delay_millis = 10;
// -1 if not set.
optional int32 bind_application_delay_millis = 11;
optional int32 windows_drawn_delay_millis = 12;
// Empty if not set.
optional string launch_token = 13;
// The compiler filter used when when the package was optimized.
optional int32 package_optimization_compilation_filter = 14;
// The reason why the package was optimized.
optional int32 package_optimization_compilation_reason = 15;
}
message AppStartCanceled {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The app package name.
optional string pkg_name = 2;
enum TransitionType {
UNKNOWN = 0;
WARM = 1;
HOT = 2;
COLD = 3;
}
// The transition type.
optional TransitionType type = 3;
// The activity name.
optional string activity_name = 4;
}
message AppStartFullyDrawn {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The app package name.
optional string pkg_name = 2;
enum TransitionType {
UNKNOWN = 0;
WITH_BUNDLE = 1;
WITHOUT_BUNDLE = 2;
}
// The transition type.
optional TransitionType type = 3;
// The activity name.
optional string activity_name = 4;
optional bool transition_process_running = 5;
// App startup time (until call to Activity#reportFullyDrawn()).
optional int64 app_startup_time_millis = 6;
}
/**
* Logs a picture-in-picture action
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
* frameworks/base/services/core/java/com/android/server/am/ActivityStackSupervisor.java
* frameworks/base/packages/SystemUI/src/com/android/systemui/pip/phone/PipTouchHandler.java
*/
message PictureInPictureStateChanged {
// -1 if it is not available
optional int32 uid = 1 [(is_uid) = true];
optional string short_name = 2;
enum State {
ENTERED = 1;
EXPANDED_TO_FULL_SCREEN = 2;
MINIMIZED = 3;
DISMISSED = 4;
}
optional State state = 3;
}
/**
* Logs overlay action
* Logged from:
* services/core/java/com/android/server/wm/Session.java
*/
message OverlayStateChanged {
optional int32 uid = 1 [(state_field_option).primary_field = true, (is_uid) = true];
optional string package_name = 2 [(state_field_option).primary_field = true];
optional bool using_alert_window = 3;
enum State {
ENTERED = 1;
EXITED = 2;
}
optional State state = 4 [
(state_field_option).exclusive_state = true,
(state_field_option).nested = false,
(state_field_option).default_state_value = 2
];
}
/**
* Logs foreground service starts and stops.
* Note that this is not when a service starts or stops, but when it is
* considered foreground.
* Logged from
* frameworks/base/services/core/java/com/android/server/am/ActiveServices.java
*/
message ForegroundServiceStateChanged {
optional int32 uid = 1 [(is_uid) = true];
// package_name + "/" + class_name
optional string short_name = 2;
enum State {
ENTER = 1;
EXIT = 2;
}
optional State state = 3;
// Whether the fgs is allowed while-in-use permissions, i.e. is considered 'in-use' to the user.
// (If the fgs was started while the app wasn't TOP it usually will be denied these permissions)
optional bool allow_while_in_use_permission = 4;
}
/**
* Logs the number of times a uid accesses a sensitive AppOp during a foreground service session.
* A foreground service session is any continuous period during which the uid holds at least one
* foreground service; the atom will be pushed when the uid no longer holds any foreground services.
* Accesses initiated while the uid is in the TOP state are ignored.
* Sessions with no attempted accesses are not logged.
* Logged from
* frameworks/base/services/core/java/com/android/server/am/ActiveServices.java
*/
message ForegroundServiceAppOpSessionEnded {
optional int32 uid = 1 [(is_uid) = true];
// The operation's name.
// Only following four ops are logged
// COARSE_LOCATION = 0
// FINE_LOCATION = 1
// CAMERA = 26
// RECORD_AUDIO = 27
optional android.app.AppOpEnum app_op_name = 2 [default = APP_OP_NONE];
// The uid's permission mode for accessing the AppOp during this fgs session.
enum Mode {
MODE_UNKNOWN = 0;
MODE_ALLOWED = 1; // Always allowed
MODE_IGNORED = 2; // Denied
MODE_FOREGROUND = 3; // Allow-while-in-use (or allowed-one-time)
}
optional Mode app_op_mode = 3;
// Number of times this AppOp was requested and allowed.
optional int32 count_ops_accepted = 4;
// Number of times this AppOp was requested but denied.
optional int32 count_ops_rejected = 5;
}
/**
* Logs creation or removal of an isolated uid. Isolated uid's are temporary uid's to sandbox risky
* behavior in its own uid. However, the metrics of these isolated uid's almost always should be
* attributed back to the parent (host) uid. One example is Chrome.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message IsolatedUidChanged {
// The host UID. Generally, we should attribute metrics from the isolated uid to the host uid.
// NOTE: DO NOT annotate uid field in this atom. This atom is specially handled in statsd.
// This field is ignored when event == REMOVED.
optional int32 parent_uid = 1;
optional int32 isolated_uid = 2;
// We expect an isolated uid to be removed before if it's used for another parent uid.
enum Event {
REMOVED = 0;
CREATED = 1;
}
optional Event event = 3;
}
/*
* Logs the reception of an incoming network packet causing the main system to wake up for
* processing that packet. These events are notified by the kernel via Netlink NFLOG to Netd
* and processed by WakeupController.cpp.
*/
message PacketWakeupOccurred {
// The uid owning the socket into which the packet was delivered, or -1 if the packet was
// delivered nowhere.
optional int32 uid = 1 [(is_uid) = true];
// The interface name on which the packet was received.
optional string iface = 2;
// The ethertype value of the packet.
optional int32 ethertype = 3;
// String representation of the destination MAC address of the packet.
optional string destination_hardware_address = 4;
// String representation of the source address of the packet if this was an IP packet.
optional string source_ip = 5;
// String representation of the destination address of the packet if this was an IP packet.
optional string destination_ip = 6;
// The value of the protocol field if this was an IPv4 packet or the value of the Next Header
// field if this was an IPv6 packet. The range of possible values is the same for both IP
// families.
optional int32 ip_next_header = 7;
// The source port if this was a TCP or UDP packet.
optional int32 source_port = 8;
// The destination port if this was a TCP or UDP packet.
optional int32 destination_port = 9;
}
/*
* Logs the memory stats for an app on startup.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message AppStartMemoryStateCaptured {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
optional string process_name = 2;
// The activity name.
optional string activity_name = 3;
// # of page-faults
optional int64 page_fault = 4;
// # of major page-faults
optional int64 page_major_fault = 5;
// RSS
optional int64 rss_in_bytes = 6;
// CACHE
optional int64 cache_in_bytes = 7;
// SWAP
optional int64 swap_in_bytes = 8;
}
/*
* Logs the change in Low Memory Killer Daemon (LMKD) state which is used as start/stop boundaries
* for LMK event.
* Logged from:
* system/core/lmkd/lmkd.c
*/
message LmkStateChanged {
enum State {
UNKNOWN = 0;
START = 1;
STOP = 2;
}
optional State state = 1;
}
/*
* Logs the event when Low Memory Killer Daemon (LMKD) kills a process to reduce memory pressure.
* Logged from:
* system/core/lmkd/lmkd.c
*/
message LmkKillOccurred {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
optional string process_name = 2;
// oom adj score.
optional int32 oom_adj_score = 3;
// # of page-faults
optional int64 page_fault = 4;
// # of major page-faults
optional int64 page_major_fault = 5;
// RSS
optional int64 rss_in_bytes = 6;
// CACHE
optional int64 cache_in_bytes = 7;
// SWAP
optional int64 swap_in_bytes = 8;
// The elapsed real time of start of the process.
optional int64 process_start_time_nanos = 9;
// Min oom adj score considered by lmkd.
optional int32 min_oom_score = 10;
}
/*
* Logs when the ActivityManagerService detects that an app died.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message AppDied {
// timestamp(elapsedRealtime) of record creation
optional uint64 timestamp_millis = 1 [(state_field_option).exclusive_state = true];
}
/**
* An atom for generic metrics logging. Available from Android Q.
*/
message GenericAtom {
// The uid of the application that sent this custom atom.
optional int32 uid = 1 [(is_uid) = true];
// An event_id indicates the type of event.
optional android.stats.EventType event_id = 2;
}
/**
* Atom for simple logging of user interaction and impression events, such as "the user touched
* this button" or "this dialog was displayed".
* Keep the UI event stream clean: don't use for system or background events.
* Log using the UiEventLogger wrapper - don't write with the StatsLog API directly.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/
* frameworks/base/packages/SystemUI/src/com/android/systemui/
*/
message UiEventReported {
// The event_id.
optional int32 event_id = 1;
// The event's source or target uid and package, if applicable.
// For example, the package posting a notification, or the destination package of a share.
optional int32 uid = 2 [(is_uid) = true];
optional string package_name = 3;
// An identifier used to disambiguate which logs refer to a particular instance of some
// UI element. Useful when there might be multiple instances simultaneously active.
optional int32 instance_id = 4;
}
/**
* Reports a notification was created or updated.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/notification/
*/
message NotificationReported {
// The event_id (as for UiEventReported).
optional int32 event_id = 1;
// The notifying app's uid and package.
optional int32 uid = 2 [(is_uid) = true];
optional string package_name = 3;
// A small system-assigned identifier for the notification.
// Locally probably-unique, but expect collisions across users and/or days.
optional int32 instance_id = 4;
optional int32 notification_id_hash = 5; // Small hash of the app-assigned notif ID + tag
optional int32 channel_id_hash = 6; // Small hash of app-assigned channel ID
// Grouping information
optional int32 group_id_hash = 7; // Small hash of the group ID of the notification
optional int32 group_instance_id = 8; // Instance_id of the group-summary notification
optional bool is_group_summary = 9; // Tags the group-summary notification
// Attributes
optional string category = 10; // App-assigned notification category (API-defined strings)
optional int32 style = 11; // App-assigned notification style
optional int32 num_people = 12; // Number of Person records attached to the notification
// Ordering, importance and interruptiveness
optional int32 position = 13; // Position in NotificationManager's list
optional android.stats.sysui.NotificationImportance importance = 14;
optional int32 alerting = 15; // Bitfield, 1=buzz 2=beep 4=blink
enum NotificationImportanceExplanation {
IMPORTANCE_EXPLANATION_UNKNOWN = 0;
IMPORTANCE_EXPLANATION_APP = 1; // App-specified channel importance.
IMPORTANCE_EXPLANATION_USER = 2; // User-specified channel importance.
IMPORTANCE_EXPLANATION_ASST = 3; // Notification Assistant override.
IMPORTANCE_EXPLANATION_SYSTEM = 4; // System override.
// Like _APP, but based on pre-channels priority signal.
IMPORTANCE_EXPLANATION_APP_PRE_CHANNELS = 5;
}
optional NotificationImportanceExplanation importance_source = 16;
optional android.stats.sysui.NotificationImportance importance_initial = 17;
optional NotificationImportanceExplanation importance_initial_source = 18;
optional android.stats.sysui.NotificationImportance importance_asst = 19;
optional int32 assistant_hash = 20;
optional float assistant_ranking_score = 21;
}
message Notification {
// The notifying app's uid and package.
optional int32 uid = 1 [(is_uid) = true];
optional string package_name = 2;
// A small system-assigned identifier for the notification.
optional int32 instance_id = 3;
// Grouping information.
optional int32 group_instance_id = 4;
optional bool is_group_summary = 5;
// The section of the shade that the notification is in.
// See NotificationSectionsManager.PriorityBucket.
enum NotificationSection {
SECTION_UNKNOWN = 0;
SECTION_HEADS_UP = 1;
SECTION_PEOPLE = 2;
SECTION_ALERTING = 3;
SECTION_SILENT = 4;
}
optional NotificationSection section = 6;
}
message NotificationList {
repeated Notification notifications = 1; // An ordered sequence of notifications.
}
/**
* Reports a notification panel was displayed, e.g. from the lockscreen or status bar.
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/notification/
*/
message NotificationPanelReported {
// The event_id (as for UiEventReported).
optional int32 event_id = 1;
optional int32 num_notifications = 2;
// The notifications in the panel, in the order that they appear there.
optional NotificationList notifications = 3 [(log_mode) = MODE_BYTES];
}
/**
* Reports a notification channel, or channel group, was created, updated, or deleted.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/notification/
*/
message NotificationChannelModified {
// The event_id (as for UiEventReported).
optional int32 event_id = 1;
// The notifying app's uid and package.
optional int32 uid = 2 [(is_uid) = true];
optional string package_name = 3;
// Hash of app-assigned notification channel ID or channel-group ID
optional int32 channel_id_hash = 4;
// Previous importance setting, if applicable
optional android.stats.sysui.NotificationImportance old_importance = 5;
// New importance setting
optional android.stats.sysui.NotificationImportance importance = 6;
}
/**
* Logs when a biometric acquire event occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics
*/
message BiometricAcquired {
// Biometric modality that was acquired.
optional android.hardware.biometrics.ModalityEnum modality = 1;
// The associated user. Eg: 0 for owners, 10+ for others. Defined in android/os/UserHandle.java.
optional int32 user = 2;
// If this acquire is for a crypto operation. e.g. Secure purchases, unlock password storage.
optional bool is_crypto = 3;
// Action that the device is performing. Acquired messages are only expected for enroll and
// authenticate. Other actions may indicate an error.
optional android.hardware.biometrics.ActionEnum action = 4;
// The client that this acquisition was received for.
optional android.hardware.biometrics.ClientEnum client = 5;
// Acquired constants, e.g. ACQUIRED_GOOD. See constants defined by <Biometric>Manager.
optional int32 acquire_info = 6;
// Vendor-specific acquire info. Valid only if acquire_info == ACQUIRED_VENDOR.
optional int32 acquire_info_vendor = 7;
// Dictates if this message should trigger additional debugging.
optional bool debug = 8;
}
/**
* Logs when a biometric authentication event occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics
*/
message BiometricAuthenticated {
// Biometric modality that was used.
optional android.hardware.biometrics.ModalityEnum modality = 1;
// The associated user. Eg: 0 for owners, 10+ for others. Defined in android/os/UserHandle.java
optional int32 user = 2;
// If this authentication is for a crypto operation. e.g. Secure purchases, unlock password
// storage.
optional bool is_crypto = 3;
// The client that this acquisition was received for.
optional android.hardware.biometrics.ClientEnum client = 4;
// If authentication requires user confirmation. See BiometricPrompt's
// setRequireConfirmation(bool) method.
optional bool require_confirmation = 5;
enum State {
UNKNOWN = 0;
REJECTED = 1;
PENDING_CONFIRMATION = 2;
CONFIRMED = 3;
}
// State of the current auth attempt.
optional State state = 6;
// Time it took to authenticate. For BiometricPrompt where setRequireConfirmation(false) is
// specified and supported by the biometric modality, this is from the first ACQUIRED_GOOD to
// AUTHENTICATED. for setRequireConfirmation(true), this is from PENDING_CONFIRMATION to
// CONFIRMED.
optional int64 latency_millis = 7;
// Dictates if this message should trigger additional debugging.
optional bool debug = 8;
}
/**
* Logs when a biometric error occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics
*/
message BiometricErrorOccurred {
// Biometric modality that was used.
optional android.hardware.biometrics.ModalityEnum modality = 1;
// The associated user. Eg: 0 for owners, 10+ for others. Defined in android/os/UserHandle.java
optional int32 user = 2;
// If this error is for a crypto operation. e.g. Secure purchases, unlock password storage.
optional bool is_crypto = 3;
// Action that the device is performing.
optional android.hardware.biometrics.ActionEnum action = 4;
// The client that this acquisition was received for.
optional android.hardware.biometrics.ClientEnum client = 5;
// Error constants. See constants defined by <Biometric>Manager. Enums won't work since errors
// are unique to modality.
optional int32 error_info = 6;
// Vendor-specific error info. Valid only if acquire_info == ACQUIRED_VENDOR. These are defined
// by the vendor and not specified by the HIDL interface.
optional int32 error_info_vendor = 7;
// Dictates if this message should trigger additional debugging.
optional bool debug = 8;
// Time spent during the authentication attempt.
optional int64 latency_millis = 9;
}
/**
* Logs when a system health issue is detected.
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics
*/
message BiometricSystemHealthIssueDetected {
// Biometric modality.
optional android.hardware.biometrics.ModalityEnum modality = 1;
// Type of issue detected.
optional android.hardware.biometrics.IssueEnum issue = 2;
// Dictates if this message should trigger additional debugging.
optional bool debug = 3;
}
/**
* Logs when a biometric enrollment occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics
*/
message BiometricEnrolled {
// Biometric modality that was used.
optional android.hardware.biometrics.ModalityEnum modality = 1;
// The associated user. Eg: 0 for owners, 10+ for others. Defined in android/os/UserHandle.java
optional int32 user = 2;
// The amount of time the enrollment took in milliseconds.
optional int64 latency_millis = 3;
// Whether or not the enrollment was successful.
optional bool success = 4;
}
/*
* Logs when a flag flip update occurrs. Used for mainline modules that update via flag flips.
*/
message FlagFlipUpdateOccurred {
// If the event is from a flag config package, specify the package name.
optional string flag_flip_package_name = 1;
// The order id of the package
optional int64 order_id = 2;
}
/**
* Potential experiment ids that goes with a train install.
* Should be kept in sync with experiment_ids.proto.
*/
message TrainExperimentIds {
repeated int64 experiment_id = 1;
}
/*
* Logs when a binary push state changes.
* Logged by the installer via public api.
*/
message BinaryPushStateChanged {
// Name of the train.
optional string train_name = 1;
// Version code for a "train" of packages that need to be installed atomically
optional int64 train_version_code = 2;
// After installation of this package, device requires a restart.
optional bool requires_staging = 3;
// Rollback should be enabled for this install.
optional bool rollback_enabled = 4;
// Requires low latency monitoring if possible.
optional bool requires_low_latency_monitor = 5;
enum State {
UNKNOWN = 0;
INSTALL_REQUESTED = 1;
INSTALL_STARTED = 2;
INSTALL_STAGED_NOT_READY = 3;
INSTALL_STAGED_READY = 4;
INSTALL_SUCCESS = 5;
// Replaced by INSTALL_FAILURE_DOWNLOAD, INSTALL_FAILURE_STATE_MISMATCH,
// and INSTALL_FAILURE_COMMIT.
INSTALL_FAILURE = 6 [deprecated = true];
// This enum is for installs that are manually cancelled via the Manual Update UI.
INSTALL_CANCELLED = 7;
INSTALLER_ROLLBACK_REQUESTED = 8;
INSTALLER_ROLLBACK_INITIATED = 9;
INSTALLER_ROLLBACK_INITIATED_FAILURE = 10;
INSTALLER_ROLLBACK_STAGED = 11;
INSTALLER_ROLLBACK_STAGED_FAILURE = 12;
INSTALLER_ROLLBACK_BOOT_TRIGGERED = 13;
INSTALLER_ROLLBACK_BOOT_TRIGGERED_FAILURE = 14;
INSTALLER_ROLLBACK_SUCCESS = 15;
INSTALLER_ROLLBACK_FAILURE = 16;
INSTALLER_ROLLBACK_STAGED_CANCEL_REQUESTED = 17;
INSTALLER_ROLLBACK_STAGED_CANCEL_SUCCESS = 18;
INSTALLER_ROLLBACK_STAGED_CANCEL_FAILURE = 19;
INSTALL_STAGED_CANCEL_REQUESTED = 20;
INSTALL_STAGED_CANCEL_SUCCESS = 21;
INSTALL_STAGED_CANCEL_FAILURE = 22;
INSTALL_FAILURE_DOWNLOAD = 23;
INSTALL_FAILURE_STATE_MISMATCH = 24;
INSTALL_FAILURE_COMMIT = 25;
REBOOT_TRIGGERED = 26;
}
optional State state = 6;
// Possible experiment ids for monitoring this push.
optional TrainExperimentIds experiment_ids = 7 [(log_mode) = MODE_BYTES];
// user id
optional int32 user_id = 8;
optional int32 reason = 9;
// Whether or not this is a rollback event
optional bool is_rollback = 10;
}
/* Test atom, is not logged anywhere */
message TestAtomReported {
repeated AttributionNode attribution_node = 1;
optional int32 int_field = 2;
optional int64 long_field = 3;
optional float float_field = 4;
optional string string_field = 5;
optional bool boolean_field = 6;
enum State {
UNKNOWN = 0;
OFF = 1;
ON = 2;
}
optional State state = 7;
optional TrainExperimentIds bytes_field = 8 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/** Represents USB port overheat event. */
message UsbPortOverheatEvent {
/* Temperature of USB port at USB plug event, in 1/10ths of degree C. */
optional int32 plug_temperature_deci_c = 1;
/* Maximum temperature of USB port during overheat event, in 1/10ths of degree C. */
optional int32 max_temperature_deci_c = 2;
/* Time between USB plug event and overheat threshold trip, in seconds. */
optional int32 time_to_overheat_secs = 3;
/* Time between overheat threshold trip and hysteresis, in seconds. */
optional int32 time_to_hysteresis_secs = 4;
/* Time between hysteresis and active mitigation ending, in seconds. */
optional int32 time_to_inactive_secs = 5;
};
/**
* Logs total effective full charge and discharge cycles on a battery.
* Here are some examples of one effective cycle:
* 1) the battery charges from 0% to 100% and drains back to 0%,
* 2) charging from 50% to 100% and draining back to 50% twice.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message BatteryCycleCount {
/* Number of total charge and discharge cycles on the system battery. */
optional int32 cycle_count = 1;
}
/**
* Logs that external storage is mounted and information about it, the storage type (sd card/usb/
* others), its type (public or private) and the size in bytes.
* Pulled from:
* StatsCompanionService
*/
message ExternalStorageInfo {
enum VolumeType {
UNKNOWN = 0;
PUBLIC = 1;
PRIVATE = 2;
OTHER = 3;
}
// The type of external storage.
optional android.stats.storage.ExternalStorageType storage_type = 1;
// Type of the volume: TYPE_PUBLIC if portable and TYPE_PRIVATE if internal.
optional VolumeType volume_type = 2;
// Total size of the sd card in bytes.
optional int64 size_bytes = 3;
}
/*
* Logs when a connection becomes available and lost.
* Logged in StatsCompanionService.java
*/
message ConnectivityStateChanged {
// Id of the network.
optional int32 net_id = 1;
enum State {
UNKNOWN = 0;
CONNECTED = 1;
DISCONNECTED = 2;
}
// Connected state of a network.
optional State state = 2;
}
/**
* Logs when a service starts and stops.
* Logged from:
* services/core/java/com/android/server/am/ActiveServices.java
*/
message ServiceStateChanged {
optional int32 uid = 1 [(is_uid) = true];
optional string package_name = 2;
optional string service_name = 3;
enum State {
START = 1;
STOP = 2;
}
optional State state = 4;
}
/**
* Logs when a service is launched.
* Logged from:
* services/core/java/com/android/server/am/ActiveServices.java
*/
message ServiceLaunchReported {
optional int32 uid = 1 [(is_uid) = true];
optional string package_name = 2;
optional string service_name = 3;
}
/**
* Logs when a hidden API is used.
*
* Logged from:
* libcore/libart/src/main/java/dalvik/system/VMRuntime.java
*/
message HiddenApiUsed {
// The uid of the app making the hidden access.
optional int32 uid = 1 [(is_uid) = true];
// Signature of the method or field accessed.
optional string signature = 2;
enum AccessMethod {
NONE = 0;
REFLECTION = 1;
JNI = 2;
LINKING = 3;
}
// Type of access.
optional AccessMethod access_method = 3;
// Whether the access was prevented or not.
optional bool access_denied = 4;
}
/**
* Logs user interaction with the Privacy Indicators added in Q. In particular:
* - When user sees privacy chip
* - When user clicks privacy chip
* - How does the user exit the Privacy Dialog
* Logged from:
* packages/SystemUI/src/com/android/systemui/qs/QuickStatusBarHeader.java
*/
message PrivacyIndicatorsInteracted {
enum Type {
UNKNOWN = 0;
CHIP_VIEWED = 1;
CHIP_CLICKED = 2;
DIALOG_PRIVACY_SETTINGS = 3;
DIALOG_DISMISS = 4;
DIALOG_LINE_ITEM = 5;
}
optional Type type = 1 [(state_field_option).exclusive_state = true];
// Used if the type is LINE_ITEM
optional string package_name = 2;
}
/**
* Logs information about a package that is moved from the internal to external storage and vice
* versa.
* It logs the package name, the type of the external storage where the package is installed
* (if moved to external storage, or UNKNOWN if moved to internal storage),
* and the move type: if it's from internal to external or the other way around.
*
* Logged from:
frameworks/base/services/core/java/com/android/server/pm/PackageManagerService.java
*/
message AppMovedStorageReported {
enum MoveType {
UNKNOWN = 0;
TO_EXTERNAL = 1;
TO_INTERNAL = 2;
}
// The type of the external storage.
optional android.stats.storage.ExternalStorageType external_storage_type = 1;
// The type of move.
optional MoveType move_type = 2;
// The name of the package that was moved.
optional string package_name = 3;
}
/**
* Logs when system server watchdog occurs.
* Logged from:
* frameworks/base/services/core/java/com/android/server/Watchdog.java
*/
message SystemServerWatchdogOccurred {
optional string subject = 1;
}
/**
* Logs when new file added to tombstones.
* Logged from:
* frameworks/base/core/java/com/android/server/BootReceiver.java
*/
message TombStoneOccurred {
}
/*
* Information about a role request
*
* Logged from:
* packages/apps/PermissionController/src/com/android/packageinstaller/role/ui/RequestRoleFragment.java
*/
message RoleRequestResultReported {
// UID of application requesting the role
optional int32 requesting_uid = 1;
// Package name of application requesting the role
optional string requesting_package_name = 2;
// The role to be granted
optional string role_name = 3;
// The count of applications qualifying for the role
optional int32 qualifying_count = 4;
// UID of application current granted the role
optional int32 current_uid = 5;
// Package name of application current granted the role
optional string current_package_name = 6;
// UID of another application that user chose to grant the role to, instead of the requesting
// application
optional int32 granted_another_uid = 7;
// Package name of another application that user chose to grant the role to, instead of the
// requesting application
optional string granted_another_package_name = 8;
enum Result {
UNDEFINED = 0;
// role request was ignored
IGNORED = 1;
// role request was ignored because it's already granted
IGNORED_ALREADY_GRANTED = 2;
// role request was ignored because the application isn't qualified
IGNORED_NOT_QUALIFIED = 3;
// role request was ignored because user said it should be always denied
IGNORED_USER_ALWAYS_DENIED = 4;
// role was granted by user action
USER_GRANTED = 5;
// role was denied by user action
USER_DENIED = 6;
// role was denied by user granting another application the role
USER_DENIED_GRANTED_ANOTHER = 7;
// role was denied and set to be always denied by the user
USER_DENIED_WITH_ALWAYS = 8;
}
// The result of the role request
optional Result result = 9;
}
/**
* Logs when a Vehicle Maps Service client's connection state has changed
*
* Logged from:
* packages/services/Car/service/src/com/android/car/stats/VmsClientLog.java
*/
message VmsClientConnectionStateChanged {
// The UID of the VMS client app
optional int32 uid = 1 [(is_uid) = true];
enum State {
UNKNOWN = 0;
// Attempting to connect to the client
CONNECTING = 1;
// Client connection established
CONNECTED = 2;
// Client connection closed unexpectedly
DISCONNECTED = 3;
// Client connection closed by VMS
TERMINATED = 4;
// Error establishing the client connection
CONNECTION_ERROR = 5;
}
optional State state = 2;
}
/**
* Logs when MediaProvider has successfully finished scanning a storage volume.
*
* Logged from:
* packages/providers/MediaProvider/src/com/android/providers/media/scan/ModernMediaScanner.java
*/
message MediaProviderScanOccurred {
enum Reason {
// Scan triggered due to unknown reason
UNKNOWN = 0;
// Scan triggered due to storage volume being mounted
MOUNTED = 1;
// Scan triggered due to explicit user action or app request
DEMAND = 2;
// Scan triggered due to idle maintenance
IDLE = 3;
}
// Volume type that this event pertains to
optional android.stats.mediaprovider.VolumeType volume_type = 1;
// Reason why this scan was triggered
optional Reason reason = 2;
// Total number of files scanned
optional int64 item_count = 3;
// Duration of scan, normalized per file
optional float normalized_duration_millis = 4;
// Number of database inserts, normalized per file
optional float normalized_insert_count = 5;
// Number of database updates, normalized per file
optional float normalized_update_count = 6;
// Number of database deletes, normalized per file
optional float normalized_delete_count = 7;
}
/**
* Logs when an app has asked MediaProvider to delete media belonging to the user.
*
* Logged from:
* packages/providers/MediaProvider/src/com/android/providers/media/MediaProvider.java
*/
message MediaContentDeleted {
// Volume type that this event pertains to
optional android.stats.mediaprovider.VolumeType volume_type = 1;
// UID of app that requested deletion
optional int32 uid = 2 [(is_uid) = true];
// Number of items that were deleted
optional int32 item_count = 3;
}
/**
* Logs when an app has asked MediaProvider to grant them access to media belonging to the user.
*
* Logged from:
* packages/providers/MediaProvider/src/com/android/providers/media/PermissionActivity.java
*/
message MediaProviderPermissionRequested {
enum Result {
UNKNOWN = 0;
USER_GRANTED = 1;
AUTO_GRANTED = 2;
USER_DENIED = 3;
USER_DENIED_WITH_PREJUDICE = 4;
AUTO_DENIED = 5;
}
// Volume type that this event pertains to
optional android.stats.mediaprovider.VolumeType volume_type = 1;
// UID of app that requested permission
optional int32 uid = 2 [(is_uid) = true];
// Number of items that were requested
optional int32 item_count = 3;
// Result of this request
optional Result result = 4;
}
/**
* Logs when MediaProvider has finished upgrading or downgrading its database schema.
*
* Logged from:
* packages/providers/MediaProvider/src/com/android/providers/media/DatabaseHelper.java
*/
message MediaProviderSchemaChanged {
// Volume type that this event pertains to
optional android.stats.mediaprovider.VolumeType volume_type = 1;
// Old database version code
optional int32 version_from = 2;
// New database version code
optional int32 version_to = 3;
// Total number of files in database
optional int64 item_count = 4;
// Duration of schema change, normalized per file
optional float normalized_duration_millis = 5;
}
/**
* Logs when MediaProvider has finished an idle maintenance job.
*
* Logged from:
* packages/providers/MediaProvider/src/com/android/providers/media/MediaProvider.java
*/
message MediaProviderIdleMaintenanceFinished {
// Volume type that this event pertains to
optional android.stats.mediaprovider.VolumeType volume_type = 1;
// Total number of files in database
optional int64 item_count = 2;
// Duration of idle maintenance, normalized per file
optional float normalized_duration_millis = 3;
// Number of thumbnails found to be stale, normalized per file
optional float normalized_stale_thumbnails = 4;
// Number of items found to be expired, normalized per file
optional float normalized_expired_media = 5;
}
/**
* Represents boot time event with duration in ms.
*
* Logged from: bootstat and various system server components. Check each enums for details.
*/
message BootTimeEventDuration {
enum DurationEvent {
UNKNOWN = 0;
// Bootloader time excluding BOOTLOADER_UI_WAIT + boot complete time. Logged from bootstat.
ABSOLUTE_BOOT_TIME = 1;
// Bootloader's 1st stage execution time.
// Logged from bootstat.
BOOTLOADER_FIRST_STAGE_EXEC = 2;
// Bootloader's 1st stage loading time.
// Logged from bootstat.
BOOTLOADER_FIRST_STAGE_LOAD = 3;
// Bootloader's kernel loading time.
// Logged from bootstat.
BOOTLOADER_KERNEL_LOAD = 4;
// Bootloader's 2nd stage execution time.
// Logged from bootstat.
BOOTLOADER_SECOND_STAGE_EXEC = 5;
// Bootloader's 2nd stage loading time.
// Logged from bootstat.
BOOTLOADER_SECOND_STAGE_LOAD = 6;
// Duration for Bootloader to show unlocked device's warning UI. This should not happen
// for locked device.
// Logged from bootstat.
BOOTLOADER_UI_WAIT = 7;
// Total time spend in bootloader. This is the sum of all BOOTLOADER_* listed above.
// Logged from bootstat.
BOOTLOADER_TOTAL = 8;
// Shutdown duration inside init for the reboot before the current boot up.
// Logged from f/b/services/.../BootReceiver.java.
SHUTDOWN_DURATION = 9;
// Total time for mounting of disk devices during bootup.
// Logged from f/b/services/.../BootReceiver.java.
MOUNT_DEFAULT_DURATION = 10;
// Total time for early stage mounting of disk devices during bootup.
// Logged from f/b/services/.../BootReceiver.java.
MOUNT_EARLY_DURATION = 11;
// Total time for late stage mounting of disk devices during bootup.
// Logged from f/b/services/.../BootReceiver.java.
MOUNT_LATE_DURATION = 12;
// Average time to scan non-system app after OTA
// Logged from f/b/services/.../PackageManagerService.java
OTA_PACKAGE_MANAGER_INIT_TIME = 13;
// Time to initialize Package manager after OTA
// Logged from f/b/services/.../PackageManagerService.java
OTA_PACKAGE_MANAGER_DATA_APP_AVG_SCAN_TIME = 14;
// Time to scan all system app from Package manager after OTA
// Logged from f/b/services/.../PackageManagerService.java
OTA_PACKAGE_MANAGER_SYSTEM_APP_AVG_SCAN_TIME = 15;
// Init's total time for cold boot stage.
// Logged from bootstat.
COLDBOOT_WAIT = 16;
// Init's total time for initializing selinux.
// Logged from bootstat.
SELINUX_INIT = 17;
// Time since last factory reset.
// Logged from bootstat.
FACTORY_RESET_TIME_SINCE_RESET = 18;
// Init's total time spent for completing the 1st stage.
// Logged from bootstat.
ANDROID_INIT_STAGE_1 = 19;
}
// Type of the event.
optional DurationEvent event = 1;
// Duration of the event in ms.
optional int64 duration_millis = 2;
}
/**
* Represents the start of specific boot time event during bootup in ms. This is usually a time
* since boot-up.
*
* Logged from: bootstat and various system server components. Check each enums for details.
*/
message BootTimeEventElapsedTime {
enum ElapsedTimeEvent {
UNKNOWN = 0;
// Time when init starts 1st stage. Logged from bootstat.
ANDROID_INIT_STAGE_1 = 1;
// Time when sys.boot_completed prop is set.
// Logged from bootstat.
BOOT_COMPLETE = 2;
// BOOT_COMPLETE for encrypted device.
BOOT_COMPLETE_ENCRYPTION = 3;
// BOOT_COMPLETE for device with no encryption.
BOOT_COMPLETE_NO_ENCRYPTION = 4;
// Adjusted BOOT_COMPLETE for encrypted device extracting decryption time.
BOOT_COMPLETE_POST_DECRYPT = 5;
// BOOT_COMPLETE after factory reset.
FACTORY_RESET_BOOT_COMPLETE = 6;
// BOOT_COMPLETE_NO_ENCRYPTION after factory reset.
FACTORY_RESET_BOOT_COMPLETE_NO_ENCRYPTION = 7;
// BOOT_COMPLETE_POST_DECRYPT after factory reset.
FACTORY_RESET_BOOT_COMPLETE_POST_DECRYPT = 8;
// BOOT_COMPLETE after OTA.
OTA_BOOT_COMPLETE = 9;
// BOOT_COMPLETE_NO_ENCRYPTION after OTA.
OTA_BOOT_COMPLETE_NO_ENCRYPTION = 10;
// BOOT_COMPLETE_POST_DECRYPT after OTA.
OTA_BOOT_COMPLETE_POST_DECRYPT = 11;
// Time when the system starts sending LOCKED_BOOT_COMPLETED broadcast.
// Logged from f/b/services/.../UserController.java
FRAMEWORK_LOCKED_BOOT_COMPLETED = 12;
// Time when the system starts sending BOOT_COMPLETED broadcast.
// Logged from f/b/services/.../UserController.java
FRAMEWORK_BOOT_COMPLETED = 13;
// Time when the package manager starts init.
// Logged from f/b/services/.../SystemServer.java
PACKAGE_MANAGER_INIT_START = 14;
// Time when package manager is ready
// Logged from f/b/services/.../SystemServer.java
PACKAGE_MANAGER_INIT_READY = 15;
// Represents the time when user has entered unlock credential for system with user pin.
// Logged from bootstat.
POST_DECRYPT = 16;
// Represents the start of zygote's init.
// Logged from zygote itself.
ZYGOTE_INIT_START = 17;
// Represents the start of secondary zygote's init.
// TODO: add logging to zygote
SECONDARY_ZYGOTE_INIT_START = 18;
// Represents the start of system server's init.
// Logged from f/b/services/.../SystemServer.java
SYSTEM_SERVER_INIT_START = 19;
// Represents the completion of system server's init.
// Logged from f/b/services/.../SystemServer.java
SYSTEM_SERVER_READY = 20;
// Represents the start of launcher during boot-up.
// TODO: add logging
LAUNCHER_START = 21;
// Represents the completion of launcher's initial rendering. User can use other apps from
// launcher from this point.
// TODO: add logging
LAUNCHER_SHOWN = 22;
}
// Type of the event.
optional ElapsedTimeEvent event = 1;
// Time since bootup for the event.
// It should be acquired from SystemClock elapsedRealtime() call or equivalent.
optional int64 time_millis = 2;
}
/**
* Boot time events with UTC time.
*
* Logged from: bootstat and various system server components. Check each enums for details.
*/
message BootTimeEventUtcTime {
enum UtcTimeEvent {
UNKNOWN = 0;
// Time of the bootstat's marking of 1st boot after the last factory reset.
// Logged from bootstat.
FACTORY_RESET_RESET_TIME = 1;
// The time when bootstat records FACTORY_RESET_* events. This is close to
// BOOT_COMPLETE time for the current bootup.
// Logged from bootstat.
FACTORY_RESET_CURRENT_TIME = 2;
// DUplicate of FACTORY_RESET_RESET_TIME added for debugging purpose.
// Logged from bootstat.
FACTORY_RESET_RECORD_VALUE = 3;
}
// Type of the event.
optional UtcTimeEvent event = 1;
// UTC time for the event.
optional int64 utc_time_secs = 2;
}
/**
* Boot time events representing specific error code during bootup.
* Meaning of error code can be different per each event type.
*
* Logged from: bootstat and various system server components. Check each enums for details.
*/
message BootTimeEventErrorCode {
enum ErrorCodeEvent {
UNKNOWN = 0;
// Linux error code for time() call to get the current UTC time.
// Logged from bootstat.
FACTORY_RESET_CURRENT_TIME_FAILURE = 1;
// Represents UmountStat before the reboot for the current boot up. Error codes defined
// as UMOUNT_STAT_* from init/reboot.cpp.
// Logged from f/b/services/.../BootReceiver.java.
SHUTDOWN_UMOUNT_STAT = 2;
// Reprepsents fie system mounting error code of /data partition for the current boot.
// Error codes defined as combination of FsStatFlags from system/core/fs_mgr/fs_mgr.cpp.
// Logged from f/b/services/.../BootReceiver.java.
FS_MGR_FS_STAT_DATA_PARTITION = 3;
}
// Type of the event.
optional ErrorCodeEvent event = 1;
// error code defined per each event type.
// For example, this can have a value of FsStatFlags.FS_STAT_FULL_MOUNT_FAILED for the event of
// FS_MGR_FS_STAT.
optional int32 error_code = 2;
}
/**
* Collects Virtual A/B statistics related to the use of dm-snapshot performed
* after an OTA.
*
* Logged from:
* - system/update_engine/cleanup_previous_update_action.cc
*/
message SnapshotMergeReported {
// Keep in sync with
// system/core/fs_mgr/libsnapshot/android/snapshot/snapshot.proto
enum UpdateState {
// No update or merge is in progress.
NONE = 0;
// An update is applying; snapshots may already exist.
INITIATED = 1;
// An update is pending, but has not been successfully booted yet.
UNVERIFIED = 2;
// The kernel is merging in the background.
MERGING = 3;
// Post-merge cleanup steps could not be completed due to a transient
// error, but the next reboot will finish any pending operations.
MERGE_NEEDS_REBOOT = 4;
// Merging is complete, and needs to be acknowledged.
MERGE_COMPLETED = 5;
// Merging failed due to an unrecoverable error.
MERGE_FAILED = 6;
// The update was implicitly cancelled, either by a rollback or a flash
// operation via fastboot. This state can only be returned by WaitForMerge.
CANCELLED = 7;
};
// Status of the update after the merge attempts.
optional UpdateState final_state = 1;
// Time to complete a merge operation in milliseconds.
// A negative value corresponds to the case in which the merge operation
// was interrupted and resumed (e.g. in case of a system reboot during the
// merge).
optional int64 duration_millis = 2;
// Number of reboots that occurred after issuing and before completing the
// merge of all the snapshot devices.
optional int32 intermediate_reboots = 3;
}
//////////////////////////////////////////////////////////////////////
// Pulled atoms below this line //
//////////////////////////////////////////////////////////////////////
/**
* Pulls bytes transferred via wifi (Sum of foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are wifi)
*/
message WifiBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 rx_packets = 3;
optional int64 tx_bytes = 4;
optional int64 tx_packets = 5;
}
/**
* Pulls bytes transferred via wifi (separated by foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are wifi)
*/
message WifiBytesTransferByFgBg {
optional int32 uid = 1 [(is_uid) = true];
// 1 denotes foreground and 0 denotes background. This is called Set in NetworkStats.
optional bool is_foreground = 2;
optional int64 rx_bytes = 3;
optional int64 rx_packets = 4;
optional int64 tx_bytes = 5;
optional int64 tx_packets = 6;
}
/**
* Pulls bytes transferred via mobile networks (Sum of foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are mobile data)
*/
message MobileBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 rx_packets = 3;
optional int64 tx_bytes = 4;
optional int64 tx_packets = 5;
optional int32 rat_type = 6;
}
/**
* Pulls bytes transferred via mobile networks (separated by foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are mobile data)
*/
message MobileBytesTransferByFgBg {
optional int32 uid = 1 [(is_uid) = true];
// 1 denotes foreground and 0 denotes background. This is called Set in
// NetworkStats.
optional bool is_foreground = 2;
optional int64 rx_bytes = 3;
optional int64 rx_packets = 4;
optional int64 tx_bytes = 5;
optional int64 tx_packets = 6;
optional int32 rat_type = 7;
}
/**
* Pulls bytes transferred via bluetooth. It is pulled from Bluetooth controller.
*
* Pulled from:
* StatsCompanionService
*/
message BluetoothBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 tx_bytes = 3;
}
/**
* Pulls the kernel wakelock durations. This atom is adapted from
* android/internal/os/KernelWakelockStats.java
*
* Pulled from:
* StatsCompanionService using KernelWakelockReader.
*/
message KernelWakelock {
optional string name = 1;
optional int32 count = 2;
optional int32 version = 3;
optional int64 time_micros = 4;
}
/**
* Pulls low power state information. If power.stats HAL is not available, this
* includes platform and subsystem sleep state information,
* PowerStatePlatformSleepState, PowerStateVoter or PowerStateSubsystemSleepState
* as defined in:
* hardware/interfaces/power/1.0/types.hal
* hardware/interfaces/power/1.1/types.hal
* If power.stats HAL is available, this includes PowerEntityStateResidencyResult
* as defined in:
* hardware/interfaces/power/stats/1.0/types.hal
*/
message SubsystemSleepState {
// Subsystem name
optional string subsystem_name = 1;
// For PlatformLowPowerStats (hal 1.0), this is the voter name, which could be empty.
// For SubsystemLowPowerStats (hal 1.1), this is the sleep state name.
// For PowerEntityStateResidencyResult (hal power/stats/1.0) this is the
// powerEntityStateName from the corresponding PowerEntityStateInfo.
optional string subname = 2;
// The number of times it entered, or voted for entering the sleep state
optional uint64 count = 3;
// The length of time spent in, or spent voting for, the sleep state
optional uint64 time_millis = 4;
}
/**
* Pulls on-device power measurement information.
* Data defined by hardware/interfaces/power/stats/1.0/types.hal.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/PowerStatsPuller.cpp
*/
message OnDevicePowerMeasurement {
// Name of the subsystem (to which the rail belongs).
optional string subsystem_name = 1;
// Rail name. The rail lies within the subsystem.
optional string rail_name = 2;
// Time (in ms since boot) at which the rail energy value was measured.
// This may differ slightly from the time that statsd logs this information.
optional uint64 measurement_timestamp_millis = 3;
// Accumulated energy used via the rail since device boot in uWs.
optional uint64 energy_microwatt_secs = 4;
}
/**
* Pulls Cpu time per frequency.
* Pulls the time the cpu spend on the frequency index. Frequency index
* starts from highest to lowest. The value should be monotonically
* increasing since boot. However, if there is a cpu
* hotplug event, the value would be reset as well.
*/
message CpuTimePerFreq {
optional uint32 cluster = 1;
optional uint32 freq_index = 2;
optional uint64 time_millis = 3;
}
/**
* Pulls Cpu Time Per Uid.
* Note that isolated process uid time should be attributed to host uids.
*/
message CpuTimePerUid {
optional int32 uid = 1 [(is_uid) = true];
optional uint64 user_time_micros = 2;
optional uint64 sys_time_micros = 3;
}
/**
* Pulls Cpu Time Per Uid per frequency.
* Note that isolated process uid time should be attributed to host uids.
* For each uid, we order the time by descending frequencies.
*/
message CpuTimePerUidFreq {
optional int32 uid = 1 [(is_uid) = true];
optional uint32 freq_index = 2;
optional uint64 time_millis = 3;
}
/**
* Pulls Wifi Controller Activity Energy Info
*/
message WifiActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// stack reported state
// TODO: replace this with proto enum
optional int32 stack_state = 2;
// tx time in millis
optional uint64 controller_tx_time_millis = 3;
// rx time in millis
optional uint64 controller_rx_time_millis = 4;
// idle time in millis
optional uint64 controller_idle_time_millis = 5;
// product of current(mA), voltage(V) and time(ms)
optional uint64 controller_energy_used = 6;
}
/**
* Pulls Modem Activity Energy Info
*/
message ModemActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// sleep time in millis.
optional uint64 sleep_time_millis = 2;
// idle time in millis
optional uint64 controller_idle_time_millis = 3;
/**
* Tx power index
* index 0 = tx_power < 0dBm
* index 1 = 0dBm < tx_power < 5dBm
* index 2 = 5dBm < tx_power < 15dBm
* index 3 = 15dBm < tx_power < 20dBm
* index 4 = tx_power > 20dBm
*/
// tx time in ms at power level 0
optional uint64 controller_tx_time_pl0_millis = 4;
// tx time in ms at power level 1
optional uint64 controller_tx_time_pl1_millis = 5;
// tx time in ms at power level 2
optional uint64 controller_tx_time_pl2_millis = 6;
// tx time in ms at power level 3
optional uint64 controller_tx_time_pl3_millis = 7;
// tx time in ms at power level 4
optional uint64 controller_tx_time_pl4_millis = 8;
// rx time in ms at power level 5
optional uint64 controller_rx_time_millis = 9;
// product of current(mA), voltage(V) and time(ms)
optional uint64 energy_used = 10 [deprecated=true];
}
/**
* Pulls Bluetooth Activity Energy Info
* Note: BluetoothBytesTransfer is pulled at the same time from the controller.
*/
message BluetoothActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// bluetooth stack state
optional int32 bluetooth_stack_state = 2;
// tx time in millis
optional uint64 controller_tx_time_millis = 3;
// rx time in millis
optional uint64 controller_rx_time_millis = 4;
// idle time in millis
optional uint64 controller_idle_time_millis = 5;
// product of current(mA), voltage(V) and time(ms)
optional uint64 energy_used = 6;
}
/*
* Logs the memory stats for a process.
*
* Pulled from StatsCompanionService for all managed processes (from ActivityManagerService).
*/
message ProcessMemoryState {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Usually package name, "system" for system server.
// Provided by ActivityManagerService.
optional string process_name = 2;
// Current OOM score adjustment. Value read from ProcessRecord.
optional int32 oom_adj_score = 3;
// # of page-faults
optional int64 page_fault = 4;
// # of major page-faults
optional int64 page_major_fault = 5;
// RSS
// Value is read from memory.stat, field total_rss if per-app memory
// cgroups are enabled. Otherwise, value from /proc/pid/stat.
optional int64 rss_in_bytes = 6;
// CACHE
// Value is read from memory.stat, field total_cache if per-app memory
// cgroups are enabled. Otherwise, 0.
optional int64 cache_in_bytes = 7;
// SWAP
// Value is read from memory.stat, field total_swap if per-app memory
// cgroups are enabled. Otherwise, 0.
optional int64 swap_in_bytes = 8;
// Deprecated: use ProcessMemoryHighWaterMark atom instead. Always -1.
optional int64 rss_high_watermark_in_bytes = 9 [deprecated = true];
// Deprecated: use ProcessMemorySnapshot atom instead. Always -1.
optional int64 start_time_nanos = 10 [deprecated = true];
// Deprecated: use ProcessMemorySnapshot atom instead. Always -1.
optional int32 anon_rss_and_swap_in_kilobytes = 11 [deprecated = true];
}
/*
* Logs the memory high-water mark for a process.
*
* Pulled from StatsCompanionService for all managed processes (from ActivityManagerServie)
* and for selected native processes.
*
* Pulling this atom resets high-water mark counters for all processes.
*/
message ProcessMemoryHighWaterMark {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Usually package name or process cmdline.
// Provided by ActivityManagerService or read from /proc/PID/cmdline.
optional string process_name = 2;
// Deprecated: use rss_high_water_mark_in_kilobytes instead. This field is
// computed by converting kilobytes to bytes.
optional int64 rss_high_water_mark_in_bytes = 3 [deprecated = true];
// RSS high-water mark. Peak RSS usage of the process. Read from the VmHWM field in
// /proc/PID/status.
optional int32 rss_high_water_mark_in_kilobytes = 4;
}
/*
* Logs the memory stats for a process.
*
* Pulled from StatsCompanionService for all managed processes (from ActivityManagerService)
* and for selected native processes.
*/
message ProcessMemorySnapshot {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Usually package name or process cmdline.
// Provided by ActivityManagerService or read from /proc/PID/cmdline.
optional string process_name = 2;
// The pid of the process.
// Allows to disambiguate instances of the process.
optional int32 pid = 3;
// The current OOM score adjustment value.
// Read from ProcessRecord for managed processes.
// Placeholder -1001 (OOM_SCORE_ADJ_MIN - 1, outside of allowed range) for native ones.
optional int32 oom_score_adj = 4;
// The current RSS of the process.
// VmRSS from /proc/pid/status.
optional int32 rss_in_kilobytes = 5;
// The current anon RSS of the process.
// RssAnon from /proc/pid/status.
optional int32 anon_rss_in_kilobytes = 6;
// The current swap size of the process.
// VmSwap from /proc/pid/status.
optional int32 swap_in_kilobytes = 7;
// The sum of rss_in_kilobytes and swap_in_kilobytes.
optional int32 anon_rss_and_swap_in_kilobytes = 8;
}
/*
* Elapsed real time from SystemClock.
*/
message SystemElapsedRealtime {
optional uint64 time_millis = 1;
}
/*
* Up time from SystemClock.
*/
message SystemUptime {
// Milliseconds since the system was booted.
// This clock stops when the system enters deep sleep (CPU off, display dark, device waiting
// for external input).
// It is not affected by clock scaling, idle, or other power saving mechanisms.
optional uint64 uptime_millis = 1;
}
/*
* Reads from /proc/uid_concurrent_active_time which has the format:
* active: X (X is # cores)
* [uid0]: [time-0] [time-1] [time-2] ... (# entries = # cores)
* [uid1]: [time-0] [time-1] [time-2] ... ...
* ...
* Time-N means the CPU time a UID spent running concurrently with N other processes.
* The file contains a monotonically increasing count of time for a single boot.
*/
message CpuActiveTime {
optional int32 uid = 1 [(is_uid) = true];
optional uint64 time_millis = 2;
}
/**
* Reads from /proc/uid_concurrent_policy_time which has the format:
* policy0: X policy4: Y (there are X cores on policy0, Y cores on policy4)
* [uid0]: [time-0-0] [time-0-1] ... [time-1-0] [time-1-1] ...
* [uid1]: [time-0-0] [time-0-1] ... [time-1-0] [time-1-1] ...
* ...
* Time-X-Y means the time a UID spent on clusterX running concurrently with Y other processes.
* The file contains a monotonically increasing count of time for a single boot.
*/
message CpuClusterTime {
optional int32 uid = 1 [(is_uid) = true];
optional int32 cluster_index = 2;
optional uint64 time_millis = 3;
}
/*
* Pulls free disk space, for data, system partition and temporary directory.
*/
message DiskSpace {
// available bytes in data partition
optional uint64 data_available_bytes = 1;
// available bytes in system partition
optional uint64 system_available_bytes = 2;
// available bytes in download cache or temp directories
optional uint64 temp_available_bytes = 3;
}
/**
* Pulls battery coulomb counter, which is the remaining battery charge in uAh.
*
* Pulled from StatsCompanionService.java
*/
message RemainingBatteryCapacity {
optional int32 charge_micro_ampere_hour = 1;
}
/**
* Pulls battery capacity, which is the battery capacity when full in uAh.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message FullBatteryCapacity {
optional int32 capacity_micro_ampere_hour = 1;
}
/**
* Pulls battery voltage.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message BatteryVoltage {
// The voltage of the battery, in millivolts.
optional int32 voltage_millivolt = 1;
}
/**
* Pulls battery level (percent full, from 0 to 100).
*
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message BatteryLevel {
// Battery level. Should be in [0, 100].
optional int32 battery_level = 1;
}
/**
* Pulls the temperature of various parts of the device.
* The units are tenths of a degree Celsius. Eg: 30.3C is reported as 303.
*
* Pulled from StatsCompanionService.java
*/
message Temperature {
// The type of temperature being reported. Eg. CPU, GPU, SKIN, BATTERY, BCL_.
optional android.os.TemperatureTypeEnum sensor_location = 1;
// The name of the temperature source. Eg. CPU0
optional string sensor_name = 2;
// Temperature in tenths of a degree C.
// For BCL, it is decimillivolt, decimilliamps, and percentage * 10.
optional int32 temperature_deci_celsius = 3;
// Relative severity of the throttling, see enum definition.
optional android.os.ThrottlingSeverityEnum severity = 4;
}
/**
* Pulls the statistics of calls to Binder.
*
* Binder stats will be reset every time the data is pulled. It means it can only be pulled by one
* config on the device.
*
* Next tag: 15
*/
message BinderCalls {
// UID of the process responsible for the binder transaction. It will be set if the process
// executing the binder transaction attribute the transaction to another uid using
// Binder.setThreadWorkSource().
//
// If not set, the value will be -1.
optional int32 uid = 1 [(is_uid) = true];
// UID of the process executing the binder transaction.
optional int32 direct_caller_uid = 14;
// Fully qualified class name of the API call.
//
// This is a system server class name.
//
// TODO(gaillard): figure out if binder call stats includes data from isolated uids, if a uid
// gets recycled and we have isolated uids, we might attribute the data incorrectly.
// TODO(gaillard): there is a high dimensions cardinality, figure out if we should drop the less
// commonly used APIs.
optional string service_class_name = 2;
// Method name of the API call. It can also be a transaction code if we cannot
// resolve it to a name. See Binder#getTransactionName.
//
// This is a system server method name.
optional string service_method_name = 3;
// Total number of API calls.
optional int64 call_count = 4;
// True if the screen was interactive PowerManager#isInteractive at the end of the call.
optional bool screen_interactive = 13;
// Total number of API calls we have data recorded for. If we collected data for all the calls,
// call_count will be equal to recorded_call_count.
//
// If recorded_call_count is different than call_count, it means data collection has been
// sampled. All the fields below will be sampled in this case.
optional int64 recorded_call_count = 12;
// Number of exceptions thrown by the API.
optional int64 recorded_exception_count = 5;
// Total latency of all API calls.
// Average can be computed using total_latency_micros / recorded_call_count.
optional int64 recorded_total_latency_micros = 6;
// Maximum latency of one API call.
optional int64 recorded_max_latency_micros = 7;
// Total CPU usage of all API calls.
// Average can be computed using total_cpu_micros / recorded_call_count.
// Total can be computed using total_cpu_micros / recorded_call_count * call_count.
optional int64 recorded_total_cpu_micros = 8;
// Maximum CPU usage of one API call.
optional int64 recorded_max_cpu_micros = 9;
// Maximum parcel reply size of one API call.
optional int64 recorded_max_reply_size_bytes = 10;
// Maximum parcel request size of one API call.
optional int64 recorded_max_request_size_bytes = 11;
}
/**
* Pulls the statistics of exceptions during calls to Binder.
*
* Binder stats are cumulative from boot unless somebody reset the data using
* > adb shell dumpsys binder_calls_stats --reset
*/
message BinderCallsExceptions {
// Exception class name, e.g. java.lang.IllegalArgumentException.
//
// This is an exception class name thrown by the system server.
optional string exception_class_name = 1;
// Total number of exceptions.
optional int64 exception_count = 2;
}
/**
* Pulls the statistics of message dispatching on HandlerThreads.
*
* Looper stats will be reset every time the data is pulled. It means it can only be pulled by one
* config on the device.
*
* Next tag: 11
*/
message LooperStats {
// The uid that made a call to the System Server and caused the message to be enqueued.
optional int32 uid = 1 [(is_uid) = true];
// Fully qualified class name of the handler target class.
//
// This field does not contain PII. This is a system server class name.
optional string handler_class_name = 2;
// The name of the thread that runs the Looper.
//
// This field does not contain PII. This is a system server thread name.
optional string looper_thread_name = 3;
// The name of the dispatched message.
//
// This field does not contain PII. This is a system server constant or class
// name.
optional string message_name = 4;
// Total number of successfully dispatched messages.
optional int64 message_count = 5;
// Total number of messages that failed dispatching.
optional int64 exception_count = 6;
// Total number of processed messages we have data recorded for. If we
// collected data for all the messages, message_count will be equal to
// recorded_message_count.
//
// If recorded_message_count is different than message_count, it means data
// collection has been sampled. The fields below will be sampled in this case.
optional int64 recorded_message_count = 7;
// Total latency of all processed messages.
// Average can be computed using recorded_total_latency_micros /
// recorded_message_count.
optional int64 recorded_total_latency_micros = 8;
// Total CPU usage of all processed message.
// Average can be computed using recorded_total_cpu_micros /
// recorded_message_count. Total can be computed using
// recorded_total_cpu_micros / recorded_message_count * message_count.
optional int64 recorded_total_cpu_micros = 9;
// True if the screen was interactive PowerManager#isInteractive at the end of the call.
optional bool screen_interactive = 10;
// Max recorded CPU usage of all processed messages.
optional int64 recorded_max_cpu_micros = 11;
// Max recorded latency of all processed messages.
optional int64 recorded_max_latency_micros = 12;
// Total number of messages we tracked the dispatching delay for. If we
// collected data for all the messages, message_count will be equal to
// recorded_delay_message_count.
//
// If recorded_delay_message_count is different than message_count, it means data
// collection has been sampled or/and not all messages specified the target dispatch time.
// The fields below will be sampled in this case.
optional int64 recorded_delay_message_count = 13;
// Total dispatching delay of all processed messages.
// Calculated as a difference between the target dispatching time (Message.when)
// and the actual dispatching time.
// Average can be computed using recorded_total_delay_millis / recorded_delay_message_count.
optional int64 recorded_total_delay_millis = 14;
// Max dispatching delay of all processed messages.
// Calculated as a difference between the target dispatching time (Message.when)
// and the actual dispatching time.
optional int64 recorded_max_delay_millis = 15;
}
/**
* Pulls disk information, such as write speed and latency.
*/
message DiskStats {
// Time taken to open, write 512B to, and close a file.
// -1 if error performing the check.
optional int64 data_write_latency_millis = 1;
optional bool file_based_encryption = 2;
// Recent disk write speed in kB/s.
// -1 if error querying storageed.
// 0 if data is unavailable.
optional int32 recent_disk_write_speed = 3;
}
/**
* Free and total bytes of the Data, Cache, and System partition.
*/
message DirectoryUsage {
enum Directory {
UNKNOWN = 0;
DATA = 1;
CACHE = 2;
SYSTEM = 3;
}
optional Directory directory = 1;
optional int64 free_bytes = 2;
optional int64 total_bytes = 3;
}
/**
* Size of an application: apk size, data size, and cache size.
* Reads from a cached file produced daily by DiskStatsLoggingService.java.
* Information is only reported for apps with the primary user (user 0).
* Sizes are aggregated by package name.
*/
message AppSize {
// Including uids will involve modifying diskstats logic.
optional string package_name = 1;
// App size in bytes. -1 if unavailable.
optional int64 app_size_bytes = 2;
// App data size in bytes. -1 if unavailable.
optional int64 app_data_size_bytes = 3;
// App cache size in bytes. -1 if unavailable.
optional int64 app_cache_size_bytes = 4;
// Time that the cache file was produced.
// Uses System.currentTimeMillis(), which is wall clock time.
optional int64 cache_time_millis = 5;
}
/**
* Size of a particular category. Eg: photos, videos.
* Reads from a cached file produced daily by DiskStatsLoggingService.java.
*/
message CategorySize {
enum Category {
UNKNOWN = 0;
APP_SIZE = 1;
APP_DATA_SIZE = 2;
APP_CACHE_SIZE = 3;
PHOTOS = 4;
VIDEOS = 5;
AUDIO = 6;
DOWNLOADS = 7;
SYSTEM = 8;
OTHER = 9;
}
optional Category category = 1;
// Category size in bytes.
optional int64 size_bytes = 2;
// Time that the cache file was produced.
// Uses System.currentTimeMillis(), which is wall clock time.
optional int64 cache_time_millis = 3;
}
/**
* Pulls per uid I/O stats. The stats are cumulative since boot.
*
* Read/write bytes are I/O events from a storage device
* Read/write chars are data requested by read/write syscalls, and can be
* satisfied by caching.
*
* Pulled from StatsCompanionService, which reads proc/uid_io/stats.
*/
message DiskIo {
optional int32 uid = 1 [(is_uid) = true];
optional int64 fg_chars_read = 2;
optional int64 fg_chars_write = 3;
optional int64 fg_bytes_read = 4;
optional int64 fg_bytes_write = 5;
optional int64 bg_chars_read = 6;
optional int64 bg_chars_write = 7;
optional int64 bg_bytes_read = 8;
optional int64 bg_bytes_write = 9;
optional int64 fg_fsync = 10;
optional int64 bg_fsync= 11;
}
/**
* Pulls the number of fingerprints for each user.
*
* Pulled from StatsCompanionService, which queries <Biometric>Manager.
*/
message NumFingerprintsEnrolled {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// Number of fingerprints registered to that user.
optional int32 num_fingerprints_enrolled = 2;
}
/**
* Pulls the number of faces for each user.
*
* Pulled from StatsCompanionService, which queries <Biometric>Manager.
*/
message NumFacesEnrolled {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// Number of faces registered to that user.
optional int32 num_faces_enrolled = 2;
}
/**
* A mapping of role holder -> role
*/
message RoleHolder {
// uid of the role holder
optional int32 uid = 1 [(is_uid) = true];
// package name of the role holder
optional string package_name = 2;
// the role held
optional string role = 3;
}
message AggStats {
// These are all in byte resolution.
optional int64 min = 1 [deprecated = true];
optional int64 average = 2 [deprecated = true];
optional int64 max = 3 [deprecated = true];
// These are all in kilobyte resolution. Can fit in int32, so smaller on the wire than the above
// int64 fields.
optional int32 mean_kb = 4;
optional int32 max_kb = 5;
}
// A reduced subset of process states; reducing the number of possible states allows more
// aggressive device-side aggregation of statistics and hence reduces metric upload size.
enum ProcessStateAggregated {
PROCESS_STATE_UNKNOWN = 0;
// Persistent system process.
PROCESS_STATE_PERSISTENT = 1;
// Top activity; actually any visible activity.
PROCESS_STATE_TOP = 2;
// Process binding to top or a foreground service.
PROCESS_STATE_BOUND_TOP_OR_FGS = 3;
// Processing running a foreground service.
PROCESS_STATE_FGS = 4;
// Important foreground process (ime, wallpaper, etc).
PROCESS_STATE_IMPORTANT_FOREGROUND = 5;
// Important background process.
PROCESS_STATE_BACKGROUND = 6;
// Process running a receiver.
PROCESS_STATE_RECEIVER = 7;
// All kinds of cached processes.
PROCESS_STATE_CACHED = 8;
}
// Next tag: 13
message ProcessStatsStateProto {
optional android.service.procstats.ScreenState screen_state = 1;
optional android.service.procstats.MemoryState memory_state = 2 [deprecated = true];
// this enum list is from frameworks/base/core/java/com/android/internal/app/procstats/ProcessStats.java
// and not frameworks/base/core/java/android/app/ActivityManager.java
optional android.service.procstats.ProcessState process_state = 3 [deprecated = true];
optional ProcessStateAggregated process_state_aggregated = 10;
// Millisecond uptime duration spent in this state
optional int64 duration_millis = 4 [deprecated = true];
// Same as above, but with minute resolution so it fits into an int32.
optional int32 duration_minutes = 11;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_millis = 9 [deprecated = true];
// Same as above, but with minute resolution so it fits into an int32.
optional int32 realtime_duration_minutes = 12;
// # of samples taken
optional int32 sample_size = 5;
// PSS is memory reserved for this process
optional AggStats pss = 6 [deprecated = true];
// USS is memory shared between processes, divided evenly for accounting
optional AggStats uss = 7 [deprecated = true];
// RSS is memory resident for this process
optional AggStats rss = 8;
}
// Next Tag: 7
message ProcessStatsProto {
// Name of process.
optional string process = 1;
// Uid of the process.
optional int32 uid = 2;
// Information about how often kills occurred
message Kill {
// Count of excessive CPU kills
optional int32 cpu = 1;
// Count of kills when cached
optional int32 cached = 2;
// PSS stats during cached kill
optional AggStats cached_pss = 3;
}
optional Kill kill = 3 [deprecated = true];
// Time and memory spent in various states.
repeated ProcessStatsStateProto states = 5;
// Total time process has been running... screen_state, memory_state, and process_state
// will not be set.
optional ProcessStatsStateProto total_running_state = 6;
}
message PackageServiceOperationStatsProto {
// Operate enum: Started, Foreground, Bound, Executing
optional android.service.procstats.ServiceOperationState operation = 1;
// Number of times the service was in this operation.
optional int32 count = 2;
// Information about a state the service can be in.
message StateStats {
// Screen state enum.
optional android.service.procstats.ScreenState screen_state = 1;
// Memory state enum.
optional android.service.procstats.MemoryState memory_state = 2;
// duration in milliseconds.
optional int64 duration_millis = 3;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_millis = 4;
}
repeated StateStats state_stats = 3;
}
message PackageServiceStatsProto {
// Name of service component.
optional string service_name = 1;
// The operation stats.
// The package_name, package_uid, package_version, service_name will not be set to save space.
repeated PackageServiceOperationStatsProto operation_stats = 2;
}
message PackageAssociationSourceProcessStatsProto {
// Uid of the process.
optional int32 process_uid = 1;
// Process name.
optional string process_name = 2;
// Package name.
optional string package_name = 7;
// Total count of the times this association appeared.
optional int32 total_count = 3;
// Millisecond uptime total duration this association was around.
optional int64 total_duration_millis = 4;
// Total count of the times this association became actively impacting its target process.
optional int32 active_count = 5;
// Information on one source in this association.
message StateStats {
// Process state enum.
optional android.service.procstats.ProcessState process_state = 1;
// Millisecond uptime duration spent in this state
optional int64 duration_millis = 2;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_mmillis = 3;
}
repeated StateStats active_state_stats = 6;
}
message PackageAssociationProcessStatsProto {
// Name of the target component.
optional string component_name = 1;
// Information on one source in this association.
repeated PackageAssociationSourceProcessStatsProto sources = 2;
}
message ProcessStatsPackageProto {
// Name of package.
optional string package = 1;
// Uid of the package.
optional int32 uid = 2;
// Version of the package.
optional int64 version = 3;
// Stats for each process running with the package loaded in to it.
repeated ProcessStatsProto process_stats = 4;
// Stats for each of the package's services.
repeated PackageServiceStatsProto service_stats = 5;
// Stats for each association with the package.
repeated PackageAssociationProcessStatsProto association_stats = 6;
}
message ProcessStatsSectionProto {
// Elapsed realtime at start of report.
optional int64 start_realtime_millis = 1;
// Elapsed realtime at end of report.
optional int64 end_realtime_millis = 2;
// CPU uptime at start of report.
optional int64 start_uptime_millis = 3;
// CPU uptime at end of report.
optional int64 end_uptime_millis = 4;
// System runtime library. e.g. "libdvm.so", "libart.so".
optional string runtime = 5;
// whether kernel reports swapped pss.
optional bool has_swapped_pss = 6;
// Data completeness. e.g. "complete", "partial", shutdown", or "sysprops".
enum Status {
STATUS_UNKNOWN = 0;
STATUS_COMPLETE = 1;
STATUS_PARTIAL = 2;
STATUS_SHUTDOWN = 3;
STATUS_SYSPROPS = 4;
}
repeated Status status = 7;
// Number of pages available of various types and sizes, representation fragmentation.
repeated ProcessStatsAvailablePagesProto available_pages = 10;
// Stats for each process.
repeated ProcessStatsProto process_stats = 8;
// Stats for each package.
repeated ProcessStatsPackageProto package_stats = 9;
}
message ProcessStatsAvailablePagesProto {
// Node these pages are in (as per /proc/pagetypeinfo)
optional int32 node = 1;
// Zone these pages are in (as per /proc/pagetypeinfo)
optional string zone = 2;
// Label for the type of these pages (as per /proc/pagetypeinfo)
optional string label = 3;
// Distribution of number of pages available by order size. First entry in array is
// order 0, second is order 1, etc. Each order increase is a doubling of page size.
repeated int32 pages_per_order = 4;
}
/**
* Pulled from ProcessStatsService.java
*/
message ProcStats {
optional ProcessStatsSectionProto proc_stats_section = 1;
}
/**
* Pulled from ProcessStatsService.java
*/
message ProcStatsPkgProc {
optional ProcessStatsSectionProto proc_stats_section = 1;
}
// Next Tag: 2
message PackageRemoteViewInfoProto {
optional string package_name = 1;
// add per-package additional info here (like channels)
}
// Next Tag: 2
message NotificationRemoteViewsProto {
repeated PackageRemoteViewInfoProto package_remote_view_info = 1;
}
/**
* Pulled from NotificationManagerService.java
*/
message NotificationRemoteViews {
optional NotificationRemoteViewsProto notification_remote_views = 1;
}
/**
* Atom that contains a list of a package's preferences, pulled from NotificationManagerService.java
*/
message PackageNotificationPreferences {
// Uid under which the package is installed.
optional int32 uid = 1 [(is_uid) = true];
// Notification importance, which specifies when and how a notification is displayed.
// Specified under core/java/android/app/NotificationManager.java.
optional int32 importance = 2;
// Lockscreen visibility as set by the user.
optional int32 visibility = 3;
// Bitfield mask indicating what fields were locked by the user (see LockableAppfields in
// PreferencesHelper.java)
optional int32 user_locked_fields = 4;
}
/**
* Atom that contains a list of a package's channel preferences, pulled from
* NotificationManagerService.java.
*/
message PackageNotificationChannelPreferences {
// Uid under which the package is installed.
optional int32 uid = 1 [(is_uid) = true];
// Channel's ID. Should always be available.
optional string channel_id = 2;
// Channel's name. Should always be available.
optional string channel_name = 3;
// Channel's description. Optionally set by the channel creator.
optional string description = 4;
// Notification importance, which specifies when and how a notification is displayed. Specified
// under core/java/android/app/NotificationManager.java.
optional int32 importance = 5;
// Bitmask representing which fields have been set by the user. See field bitmask descriptions
// at core/java/android/app/NotificationChannel.java
optional int32 user_locked_fields = 6;
// Indicates if the channel was deleted by the app.
optional bool is_deleted = 7;
}
/**
* Atom that contains a list of a package's channel group preferences, pulled from
* NotificationManagerService.java.
*/
message PackageNotificationChannelGroupPreferences {
// Uid under which the package is installed.
optional int32 uid = 1 [(is_uid) = true];
// Channel Group's ID. Should always be available.
optional string group_id = 2;
// Channel Group's name. Should always be available.
optional string group_name = 3;
// Channel Group's description. Optionally set by group creator.
optional string description = 4;
// Indicates if notifications from this channel group are blocked.
optional bool is_blocked = 5;
// Bitmask representing which fields have been set by the user. See field bitmask descriptions
// at core/java/android/app/NotificationChannelGroup.java
optional int32 user_locked_fields = 6;
}
message PowerProfileProto {
optional double cpu_suspend = 1;
optional double cpu_idle = 2;
optional double cpu_active = 3;
message CpuCluster {
optional int32 id = 1;
optional double cluster_power = 2;
optional int32 cores = 3;
repeated int64 speed = 4;
repeated double core_power = 5;
}
repeated CpuCluster cpu_cluster = 40;
optional double wifi_scan = 4;
optional double wifi_on = 5;
optional double wifi_active = 6;
optional double wifi_controller_idle = 7;
optional double wifi_controller_rx = 8;
optional double wifi_controller_tx = 9;
repeated double wifi_controller_tx_levels = 10;
optional double wifi_controller_operating_voltage = 11;
optional double bluetooth_controller_idle = 12;
optional double bluetooth_controller_rx = 13;
optional double bluetooth_controller_tx = 14;
optional double bluetooth_controller_operating_voltage = 15;
optional double modem_controller_sleep = 16;
optional double modem_controller_idle = 17;
optional double modem_controller_rx = 18;
repeated double modem_controller_tx = 19;
optional double modem_controller_operating_voltage = 20;
optional double gps_on = 21;
repeated double gps_signal_quality_based = 22;
optional double gps_operating_voltage = 23;
optional double bluetooth_on = 24;
optional double bluetooth_active = 25;
optional double bluetooth_at_cmd = 26;
optional double ambient_display = 27;
optional double screen_on = 28;
optional double radio_on = 29;
optional double radio_scanning = 30;
optional double radio_active = 31;
optional double screen_full = 32;
optional double audio = 33;
optional double video = 34;
optional double flashlight = 35;
optional double memory = 36;
optional double camera = 37;
optional double wifi_batched_scan = 38;
optional double battery_capacity = 39;
}
/**
* power_profile.xml and other constants for power model calculations.
* Pulled from PowerProfile.java
*/
message PowerProfile {
optional PowerProfileProto power_profile = 1;
}
/**
* Logs when a user restriction was added or removed.
*
* Logged from:
* frameworks/base/services/devicepolicy/java/com/android/server/devicepolicy/DevicePolicyManagerService.java
*/
message UserRestrictionChanged {
// The raw string of the user restriction as defined in UserManager.
// Allowed values are defined in UserRestrictionsUtils#USER_RESTRICTIONS.
optional string restriction = 1;
// Whether the restriction is enabled or disabled.
optional bool enabled = 2;
}
/**
* Pulls process user time and system time. Puller takes a snapshot of all pids
* in the system and returns cpu stats for those that are working at the time.
* Dead pids will be dropped. Kernel processes are excluded.
* Min cool-down is 5 sec.
*/
message ProcessCpuTime {
optional int32 uid = 1 [(is_uid) = true];
optional string process_name = 2;
// Process cpu time in user space, cumulative from boot/process start
optional int64 user_time_millis = 3;
// Process cpu time in system space, cumulative from boot/process start
optional int64 system_time_millis = 4;
}
/**
* Pulls the CPU usage for each thread.
*
* Read from /proc/$PID/task/$TID/time_in_state files.
*
* TODO(mishaw): This is an experimental atom. Issues with big/little CPU frequencies, and
* time_in_state files not being present on some phones, have not been addressed. These should be
* considered before a public release.
*/
message CpuTimePerThreadFreq {
// UID that owns the process.
optional int32 uid = 1 [(is_uid) = true];
// ID of the process.
optional int32 process_id = 2;
// ID of the thread.
optional int32 thread_id = 3;
// Name of the process taken from `/proc/$PID/cmdline`.
optional string process_name = 4;
// Name of the thread taken from `/proc/$PID/task/$TID/comm`
optional string thread_name = 5;
// Report eight different frequencies, and how much time is spent in each frequency. Frequencies
// are given in KHz, and time is given in milliseconds since the thread started. All eight
// frequencies are given here as the alternative is sending eight separate atoms. This method
// significantly reduces the amount of data created
optional int32 frequency1_khz = 6;
optional int32 time1_millis = 7;
optional int32 frequency2_khz = 8;
optional int32 time2_millis = 9;
optional int32 frequency3_khz = 10;
optional int32 time3_millis = 11;
optional int32 frequency4_khz = 12;
optional int32 time4_millis = 13;
optional int32 frequency5_khz = 14;
optional int32 time5_millis = 15;
optional int32 frequency6_khz = 16;
optional int32 time6_millis = 17;
optional int32 frequency7_khz = 18;
optional int32 time7_millis = 19;
optional int32 frequency8_khz = 20;
optional int32 time8_millis = 21;
}
/**
* Pulls information about the device's build.
*/
message BuildInformation {
// Build.FINGERPRINT. A string that uniquely identifies this build. Do not parse.
// E.g. may be composed of the brand, product, device, release, id, incremental, type, and tags.
optional string fingerprint = 1;
// Build.BRAND. The consumer-visible brand with which the product/hardware will be associated.
optional string brand = 2;
// Build.PRODUCT. The name of the overall product.
optional string product = 3;
// Build.DEVICE. The name of the industrial design.
optional string device = 4;
// Build.VERSION.RELEASE. The user-visible version string. E.g., "1.0" or "3.4b5" or "bananas".
optional string version_release = 5;
// Build.ID. E.g. a label like "M4-rc20".
optional string id = 6;
// Build.VERSION.INCREMENTAL. The internal value used by the underlying source control to
// represent this build.
optional string version_incremental = 7;
// Build.TYPE. The type of build, like "user" or "eng".
optional string type = 8;
// Build.TAGS. Comma-separated tags describing the build, like "unsigned,debug".
optional string tags = 9;
}
/**
* Logs information about mismatched caller for content capture.
*
* Logged from:
* frameworks/base/core/java/android/service/contentcapture/ContentCaptureService.java
*/
message ContentCaptureCallerMismatchReported {
optional string intended_package = 1;
optional string calling_package = 2;
}
/**
* Logs information about content capture service events.
*
* Logged from:
* frameworks/base/services/contentcapture/java/com/android/server/contentcapture/ContentCaptureMetricsLogger.java
*/
message ContentCaptureServiceEvents {
// The type of event.
enum Event {
UNKNOWN = 0;
ON_CONNECTED = 1;
ON_DISCONNECTED = 2;
SET_WHITELIST = 3;
SET_DISABLED = 4;
ON_USER_DATA_REMOVED = 5;
}
optional Event event = 1;
// component/package of content capture service.
optional string service_info = 2;
// component/package of target.
// it's a concatenated list of component/package for SET_WHITELIST event
// separated by " ".
optional string target_info = 3;
}
/**
* Logs information about content capture session events.
*
* Logged from:
* frameworks/base/services/contentcapture/java/com/android/server/contentcapture/ContentCaptureMetricsLogger.java
*/
message ContentCaptureSessionEvents {
// The type of event.
enum Event {
UNKNOWN = 0;
ON_SESSION_STARTED = 1;
ON_SESSION_FINISHED = 2;
SESSION_NOT_CREATED = 3;
}
optional int32 session_id = 1;
optional Event event = 2;
// (n/a on session finished)
optional int32 state_flags = 3;
// component/package of content capture service.
optional string service_info = 4;
// component/package of app.
// (n/a on session finished)
optional string app_info = 5;
optional bool is_child_session = 6;
}
/**
* Logs information about session being flushed.
*
* Logged from:
* frameworks/base/services/contentcapture/java/com/android/server/contentcapture/ContentCaptureMetricsLogger.java
*/
message ContentCaptureFlushed {
optional int32 session_id = 1;
// component/package of content capture service.
optional string service_info = 2;
// component/package of app.
optional string app_info = 3;
// session start/finish events
optional int32 child_session_started = 4;
optional int32 child_session_finished = 5;
// count of view events.
optional int32 view_appeared_count = 6;
optional int32 view_disappeared_count = 7;
optional int32 view_text_changed_count = 8;
// Flush stats.
optional int32 max_events = 9;
optional int32 idle_flush_freq = 10;
optional int32 text_flush_freq = 11;
optional int32 flush_reason = 12;
}
/**
* Pulls on-device BatteryStats power use calculations for the overall device.
*/
message DeviceCalculatedPowerUse {
// Power used by the device in nAs (i.e. nanocoulombs (nC)), as computed by BatteryStats, since
// BatteryStats last reset (i.e. roughly since device was last significantly charged).
// Currently, this is from BatteryStatsHelper.getComputedPower() (not getTotalPower()).
optional int64 computed_power_nano_amp_secs = 1;
}
/**
* Pulls on-device BatteryStats power use calculations broken down by uid.
* This atom should be complemented by DeviceCalculatedPowerBlameOther, which contains the power use
* that is attributed to non-uid items. They must all be included to get the total power use.
*/
message DeviceCalculatedPowerBlameUid {
// Uid being blamed. Note: isolated uids have already been mapped to host uid.
optional int32 uid = 1 [(is_uid) = true];
// Power used by this uid in nAs (i.e. nanocoulombs (nC)), as computed by BatteryStats, since
// BatteryStats last reset (i.e. roughly since device was last significantly charged).
optional int64 power_nano_amp_secs = 2;
}
/**
* Pulls on-device BatteryStats power use calculations that are not due to a uid, broken down by
* drain type.
* This atom should be complemented by DeviceCalculatedPowerBlameUid, which contains the blame that
* is attributed uids. They must all be included to get the total power use.
*/
message DeviceCalculatedPowerBlameOther {
// The type of item whose power use is being reported.
enum DrainType {
AMBIENT_DISPLAY = 0;
// reserved 1; reserved "APP"; // Logged instead in DeviceCalculatedPowerBlameUid.
BLUETOOTH = 2;
CAMERA = 3;
// Cell-standby
CELL = 4;
FLASHLIGHT = 5;
IDLE = 6;
MEMORY = 7;
// Amount that total computed drain exceeded the drain estimated using the
// battery level changes and capacity.
OVERCOUNTED = 8;
PHONE = 9;
SCREEN = 10;
// Amount that total computed drain was below the drain estimated using the
// battery level changes and capacity.
UNACCOUNTED = 11;
// reserved 12; reserved "USER"; // Entire drain for a user. This is NOT supported.
WIFI = 13;
}
optional DrainType drain_type = 1;
// Power used by this item in nAs (i.e. nanocoulombs (nC)), as computed by BatteryStats, since
// BatteryStats last reset (i.e. roughly since device was last significantly charged).
optional int64 power_nano_amp_secs = 2;
}
/**
* Logs device policy features.
*
* Logged from:
* frameworks/base/services/devicepolicy/java/com/android/server/devicepolicy/DevicePolicyManagerService.java
* packages/apps/ManagedProvisioning/src/com/android/managedprovisioning/
*/
message DevicePolicyEvent {
// The event id - unique for each event.
optional android.stats.devicepolicy.EventId event_id = 1;
// The admin package name.
optional string admin_package_name = 2;
// A generic integer parameter.
optional int32 integer_value = 3;
// A generic boolean parameter.
optional bool boolean_value = 4;
// A parameter specifying a time period in milliseconds.
optional uint64 time_period_millis = 5;
// A parameter specifying a list of package names, bundle extras or string parameters.
optional android.stats.devicepolicy.StringList string_list_value = 6 [(log_mode) = MODE_BYTES];
}
/**
* Logs when DocumentsUI is started, and how. Call this when DocumentsUI first starts up.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUILaunchReported {
optional android.stats.docsui.LaunchAction launch_action = 1;
optional bool has_initial_uri = 2;
optional android.stats.docsui.MimeType mime_type = 3;
optional android.stats.docsui.Root initial_root = 4;
}
/**
* Logs root/app visited event in file managers/picker. Call this when the user
* taps on root/app in hamburger menu.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIRootVisitedReported {
optional android.stats.docsui.ContextScope scope = 1;
optional android.stats.docsui.Root root = 2;
}
/**
* Logs file operation stats. Call this when a file operation has completed.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationReported {
optional android.stats.docsui.Provider provider = 1;
optional android.stats.docsui.FileOperation file_op = 2;
}
/**
* Logs file operation stats. Call this when a copy/move operation has completed with a specific
* mode.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationCopyMoveModeReported {
optional android.stats.docsui.FileOperation file_op = 1;
optional android.stats.docsui.CopyMoveOpMode mode = 2;
}
/**
* Logs file sub operation stats. Call this when a file operation has failed.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationFailureReported {
optional android.stats.docsui.Authority authority = 1;
optional android.stats.docsui.SubFileOperation sub_op = 2;
}
/**
* Logs the cancellation of a file operation. Call this when a job is canceled
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationCanceledReported {
optional android.stats.docsui.FileOperation file_op = 1;
}
/**
* Logs startup time in milliseconds.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIStartupMsReported {
optional int32 startup_millis = 1;
}
/**
* Logs the action that was started by user.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIUserActionReported {
optional android.stats.docsui.UserAction action = 1;
}
/**
* Logs the invalid type when invalid scoped access is requested.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/ScopedAccessMetrics.java
*/
message DocsUIInvalidScopedAccessRequestReported {
optional android.stats.docsui.InvalidScopedAccess type = 1;
}
/**
* Logs the package name that launches docsui picker mode.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIPickerLaunchedFromReported {
optional string package_name = 1;
}
/**
* Logs the search type.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUISearchTypeReported {
optional android.stats.docsui.SearchType search_type = 1;
}
/**
* Logs the search mode.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUISearchModeReported {
optional android.stats.docsui.SearchMode search_mode = 1;
}
/**
* Logs the pick result information.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIPickResultReported {
optional int32 total_action_count = 1;
optional int64 duration_millis = 2;
optional int32 file_count= 3;
optional bool is_searching = 4;
optional android.stats.docsui.Root picked_from = 5;
optional android.stats.docsui.MimeType mime_type = 6;
optional int32 repeatedly_pick_times = 7;
}
/**
* Logs when an app's memory is compacted.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message AppCompacted {
// The pid of the process being compacted.
optional int32 pid = 1;
// The name of the process being compacted.
optional string process_name = 2;
// The type of compaction.
enum Action {
UNKNOWN = 0;
SOME = 1;
FULL = 2;
PERSISTENT = 3;
BFGS = 4;
}
optional Action action = 3;
// Total RSS in kilobytes consumed by the process prior to compaction.
optional int64 before_rss_total_kilobytes = 4;
// File RSS in kilobytes consumed by the process prior to compaction.
optional int64 before_rss_file_kilobytes = 5;
// Anonymous RSS in kilobytes consumed by the process prior to compaction.
optional int64 before_rss_anon_kilobytes = 6;
// Swap in kilobytes consumed by the process prior to compaction.
optional int64 before_swap_kilobytes = 7;
// Total RSS in kilobytes consumed by the process after compaction.
optional int64 after_rss_total_kilobytes = 8;
// File RSS in kilobytes consumed by the process after compaction.
optional int64 after_rss_file_kilobytes = 9;
// Anonymous RSS in kilobytes consumed by the process after compaction.
optional int64 after_rss_anon_kilobytes = 10;
// Swap in kilobytes consumed by the process after compaction.
optional int64 after_swap_kilobytes = 11;
// The time taken to perform compaction in milliseconds.
optional int64 time_to_compact_millis = 12;
// The last compaction action performed for this app.
optional Action last_action = 13;
// The last time that compaction was attempted on this process in milliseconds
// since boot, not including sleep (see SystemClock.uptimeMillis()).
optional int64 last_compact_timestamp_ms_since_boot = 14;
// The "setAdj" (i.e. previous) oom_score_adj at the time of compaction.
optional int32 oom_score_adj = 15;
// The process state at the time of compaction.
optional android.app.ProcessStateEnum process_state = 16 [default = PROCESS_STATE_UNKNOWN];
// Free ZRAM in kilobytes before compaction.
optional int64 before_zram_free_kilobytes = 17;
// Free ZRAM in kilobytes after compaction.
optional int64 after_zram_free_kilobytes = 18;
}
/**
* Logs a DNS lookup operation initiated by the system resolver on behalf of an application
* invoking native APIs such as getaddrinfo() or Java APIs such as Network#getAllByName().
*
* The NetworkDnsEventReported message represents the entire lookup operation, which may
* result one or more queries to the recursive DNS resolvers. Those are individually logged
* in DnsQueryEvents to enable computing error rates and network latency and timeouts
* broken up by query type, transport, network interface, etc.
*/
message NetworkDnsEventReported {
optional android.stats.dnsresolver.EventType event_type = 1;
optional android.stats.dnsresolver.ReturnCode return_code = 2;
// The latency in microseconds of the entire DNS lookup operation.
optional int32 latency_micros = 3;
// Only valid for event_type = EVENT_GETADDRINFO.
optional int32 hints_ai_flags = 4;
// Flags passed to android_res_nsend() defined in multinetwork.h
// Only valid for event_type = EVENT_RESNSEND.
optional int32 res_nsend_flags = 5;
optional android.stats.dnsresolver.NetworkType network_type = 6;
// The DNS over TLS mode on a specific netId.
optional android.stats.dnsresolver.PrivateDnsModes private_dns_modes = 7;
// Additional pass-through fields opaque to statsd.
// The DNS resolver Mainline module can add new fields here without requiring an OS update.
optional android.stats.dnsresolver.DnsQueryEvents dns_query_events = 8 [(log_mode) = MODE_BYTES];
// The sample rate of DNS stats (to statsd) is 1/sampling_rate_denom.
optional int32 sampling_rate_denom = 9;
}
/**
* Logs when a data stall event occurs.
*
* Log from:
* frameworks/base/services/core/java/com/android/server/connectivity/NetworkMonitor.java
*/
message DataStallEvent {
// Data stall evaluation type.
// See frameworks/base/services/core/java/com/android/server/connectivity/NetworkMonitor.java
// Refer to the definition of DATA_STALL_EVALUATION_TYPE_*.
optional int32 evaluation_type = 1;
// See definition in data_stall_event.proto.
optional com.android.server.connectivity.ProbeResult validation_result = 2;
// See definition in data_stall_event.proto.
optional android.net.NetworkCapabilitiesProto.Transport network_type = 3;
// See definition in data_stall_event.proto.
optional com.android.server.connectivity.WifiData wifi_info = 4 [(log_mode) = MODE_BYTES];
// See definition in data_stall_event.proto.
optional com.android.server.connectivity.CellularData cell_info = 5 [(log_mode) = MODE_BYTES];
// See definition in data_stall_event.proto.
optional com.android.server.connectivity.DnsEvent dns_event = 6 [(log_mode) = MODE_BYTES];
}
/*
* Logs when RescueParty resets some set of experiment flags.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/RescueParty.java
*/
message RescuePartyResetReported {
// The rescue level of this reset. A value of 0 indicates missing or unknown level information.
optional int32 rescue_level = 1;
}
/**
* Logs when signed config is received from an APK, and if that config was applied successfully.
* Logged from:
* frameworks/base/services/core/java/com/android/server/signedconfig/SignedConfigService.java
*/
message SignedConfigReported {
enum Type {
UNKNOWN_TYPE = 0;
GLOBAL_SETTINGS = 1;
}
optional Type type = 1;
// The final status of the signed config received.
enum Status {
UNKNOWN_STATUS = 0;
APPLIED = 1;
BASE64_FAILURE_CONFIG = 2;
BASE64_FAILURE_SIGNATURE = 3;
SECURITY_EXCEPTION = 4;
INVALID_CONFIG = 5;
OLD_CONFIG = 6;
SIGNATURE_CHECK_FAILED = 7;
NOT_APPLICABLE = 8;
SIGNATURE_CHECK_FAILED_PROD_KEY_ABSENT = 9;
}
optional Status status = 2;
// The version of the signed config processed.
optional int32 version = 3;
// The package name that the config was extracted from.
optional string from_package = 4;
enum Key {
NO_KEY = 0;
DEBUG = 1;
PRODUCTION = 2;
}
// Which key was used to verify the config.
optional Key verified_with = 5;
}
/*
* Logs GNSS Network-Initiated (NI) location events.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/location/GnssLocationProvider.java
*/
message GnssNiEventReported {
// The type of GnssNiEvent.
enum EventType {
UNKNOWN = 0;
NI_REQUEST = 1;
NI_RESPONSE = 2;
}
optional EventType event_type = 1;
// An ID generated by HAL to associate NI notifications and UI responses.
optional int32 notification_id = 2;
// A type which distinguishes different categories of NI request, such as VOICE, UMTS_SUPL etc.
optional android.server.location.GnssNiType ni_type = 3;
// NI requires notification.
optional bool need_notify = 4;
// NI requires verification.
optional bool need_verify = 5;
// NI requires privacy override, no notification/minimal trace.
optional bool privacy_override = 6;
// Timeout period to wait for user response. Set to 0 for no timeout limit. Specified in
// seconds.
optional int32 timeout = 7;
// Default response when timeout.
optional android.server.location.GnssUserResponseType default_response = 8;
// String representing the requester of the network inititated location request.
optional string requestor_id = 9;
// Notification message text string representing the service(for eg. SUPL-service) who sent the
// network initiated location request.
optional string text = 10;
// requestorId decoding scheme.
optional android.server.location.GnssNiEncodingType requestor_id_encoding = 11;
// Notification message text decoding scheme.
optional android.server.location.GnssNiEncodingType text_encoding = 12;
// True if SUPL ES is enabled.
optional bool is_supl_es_enabled = 13;
// True if GNSS location is enabled.
optional bool is_location_enabled = 14;
// GNSS NI responses which define the response in NI structures.
optional android.server.location.GnssUserResponseType user_response = 15;
}
/**
* Logs GNSS non-framework (NFW) location notification.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/location/GnssLocationProvider.java
*/
message GnssNfwNotificationReported {
// Package name of the Android proxy application representing the non-framework entity that
// requested location. Set to empty string if unknown.
optional string proxy_app_package_name = 1;
// Protocol stack that initiated the non-framework location request.
optional android.server.location.NfwProtocolStack protocol_stack = 2;
// Name of the protocol stack if protocol_stack field is set to OTHER_PROTOCOL_STACK. Otherwise,
// set to empty string. This field is opaque to the framework and used for logging purposes.
optional string other_protocol_stack_name = 3;
// Source initiating/receiving the location information.
optional android.server.location.NfwRequestor requestor = 4;
// Identity of the endpoint receiving the location information. For example, carrier name, OEM
// name, SUPL SLP/E-SLP FQDN, chipset vendor name, etc. This field is opaque to the framework
// and used for logging purposes.
optional string requestor_id = 5;
// Indicates whether location information was provided for this request.
optional android.server.location.NfwResponseType response_type = 6;
// True if the device is in user initiated emergency session.
optional bool in_emergency_mode = 7;
// True if cached location is provided.
optional bool is_cached_location = 8;
// True if proxy app permission mismatch between framework and GNSS HAL.
optional bool is_permission_mismatched = 9;
}
/**
* Logs GNSS configuration as defined in IGnssConfiguration.hal.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/location/GnssConfiguration.java
*/
message GnssConfigurationReported {
// SUPL host name.
optional string supl_host = 1;
// SUPL port number.
optional int32 supl_port = 2;
// C2K host name.
optional string c2k_host = 3;
// C2K port number.
optional int32 c2k_port = 4;
// The SUPL version requested by Carrier.
optional int32 supl_ver = 5;
// The SUPL mode.
optional android.server.location.SuplMode supl_mode = 6;
// True if NI emergency SUPL restrictions is enabled.
optional bool supl_es = 7;
// LTE Positioning Profile settings
optional android.server.location.LppProfile lpp_profile = 8;
// Positioning protocol on A-Glonass system.
optional android.server.location.GlonassPosProtocol a_glonass_pos_protocol_select = 9;
// True if emergency PDN is used. Otherwise, regular PDN is used.
optional bool use_emergency_pdn_for_emergency_supl= 10;
// Configurations of how GPS functionalities should be locked when user turns off GPS On setting.
optional android.server.location.GpsLock gps_lock = 11;
// Number of seconds to extend the emergency session duration post emergency call.
optional int32 es_extension_sec = 12;
// The full list of package names of proxy Android applications representing the non-framework
// location access entities (on/off the device) for which the framework user has granted
// non-framework location access permission. The package names are concatenated in one string
// with spaces as separators.
optional string enabled_proxy_app_package_name_list = 13;
}
/**
* Logs when a NFC device's error occurred.
* Logged from:
* system/nfc/src/nfc/nfc/nfc_ncif.cc
* packages/apps/Nfc/src/com/android/nfc/cardemulation/AidRoutingManager.java
*/
message NfcErrorOccurred {
enum Type {
UNKNOWN = 0;
CMD_TIMEOUT = 1;
ERROR_NOTIFICATION = 2;
AID_OVERFLOW = 3;
}
optional Type type = 1;
// If it's nci cmd timeout, log the timeout command.
optional uint32 nci_cmd = 2;
optional uint32 error_ntf_status_code = 3;
}
/**
* Logs when a NFC device's state changed event
* Logged from:
* packages/apps/Nfc/src/com/android/nfc/NfcService.java
*/
message NfcStateChanged {
enum State {
UNKNOWN = 0;
OFF = 1;
ON = 2;
ON_LOCKED = 3; // Secure Nfc enabled.
CRASH_RESTART = 4; // NfcService watchdog timeout restart.
}
optional State state = 1;
}
/**
* Logs when a NFC Beam Transaction occurred.
* Logged from:
* packages/apps/Nfc/src/com/android/nfc/P2pLinkManager.java
*/
message NfcBeamOccurred {
enum Operation {
UNKNOWN = 0;
SEND = 1;
RECEIVE = 2;
}
optional Operation operation = 1;
}
/**
* Logs when a NFC Card Emulation Transaction occurred.
* Logged from:
* packages/apps/Nfc/src/com/android/nfc/cardemulation/HostEmulationManager.java
* packages/apps/Nfc/src/com/android/nfc/cardemulation/HostNfcFEmulationManager.java
*/
message NfcCardemulationOccurred {
enum Category {
UNKNOWN = 0;
HCE_PAYMENT = 1;
HCE_OTHER = 2;
OFFHOST = 3;
}
// Transaction belongs to HCE payment or HCE other category, or offhost.
optional Category category = 1;
// SeName from transaction: SIMx, eSEx, HCE, HCEF.
optional string se_name = 2;
}
/**
* Logs when a NFC Tag event occurred.
* Logged from:
* packages/apps/Nfc/src/com/android/nfc/NfcDispatcher.java
*/
message NfcTagOccurred {
enum Type {
UNKNOWN = 0;
URL = 1;
BT_PAIRING = 2;
PROVISION = 3;
WIFI_CONNECT = 4;
APP_LAUNCH = 5;
OTHERS = 6;
}
optional Type type = 1;
}
/**
* Logs when Hce transaction triggered
* Logged from:
* system/nfc/src/nfc/nfc/nfc_ncif.cc
*/
message NfcHceTransactionOccurred {
// The latency period(in microseconds) it took for the first HCE data
// exchange.
optional uint32 latency_micros = 1;
}
/**
* Logs when SecureElement state event changed
* Logged from:
* packages/apps/SecureElement/src/com/android/se/Terminal.java
*/
message SeStateChanged {
enum State {
UNKNOWN = 0;
INITIALIZED = 1;
DISCONNECTED = 2;
CONNECTED = 3;
HALCRASH = 4;
}
optional State state = 1;
optional string state_change_reason = 2;
// SIMx or eSEx.
optional string terminal = 3;
}
/**
* Information about a permission grant request
*/
message PermissionGrantRequestResultReported {
// unique value identifying an API call. A API call might result in multiple of these atoms
optional int64 request_id = 1;
// UID of package requesting the permission grant
optional int32 uid = 2 [(is_uid) = true];
// Name of package requesting the permission grant
optional string package_name = 3;
// The permission to be granted
optional string permission_name = 4;
// If the permission was explicitly requested via the API or added by the system
optional bool is_implicit = 5;
enum Result {
UNDEFINED = 0;
// permission request was ignored
IGNORED = 1;
// permission request was ignored because it was user fixed
IGNORED_USER_FIXED = 2;
// permission request was ignored because it was policy fixed
IGNORED_POLICY_FIXED = 3;
// permission was granted by user action
USER_GRANTED = 4;
// permission was automatically granted
AUTO_GRANTED = 5;
// permission was denied by user action
USER_DENIED = 6;
// permission was denied with prejudice by the user
USER_DENIED_WITH_PREJUDICE = 7;
// permission was automatically denied
AUTO_DENIED = 8;
// permission request was ignored because permission is restricted
IGNORED_RESTRICTED_PERMISSION = 9;
// one time permission was granted by user action
USER_GRANTED_ONE_TIME = 10;
// user ignored request by leaving the request screen without choosing any option
USER_IGNORED = 11;
// user granted the permission after being linked to settings
USER_GRANTED_IN_SETTINGS = 12;
// user denied the permission after being linked to settings
USER_DENIED_IN_SETTINGS = 13;
// user denied the permission with prejudice after being linked to settings
USER_DENIED_WITH_PREJUDICE_IN_SETTINGS = 14;
// permission was automatically revoked after one-time permission expired
AUTO_ONE_TIME_PERMISSION_REVOKED = 15;
// permission was automatically revoked for unused app
AUTO_UNUSED_APP_PERMISSION_REVOKED = 16;
}
// The result of the permission grant
optional Result result = 6;
}
/**
* Logs when Omapi API used
* Logged from:
* packages/apps/SecureElement/src/com/android/se/Terminal.java
*/
message SeOmapiReported {
enum Operation {
UNKNOWN = 0;
OPEN_CHANNEL = 1;
}
optional Operation operation = 1;
// SIMx or eSEx.
optional string terminal = 2;
optional string package_name = 3;
}
/**
* Logs the dispatch latency of a broadcast during processing of BOOT_COMPLETED.
* The dispatch latency is the dispatchClockTime - enqueueClockTime.
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/BroadcastQueue.java
*/
message BroadcastDispatchLatencyReported {
optional int64 dispatch_latency_millis = 1;
}
/**
* Logs AttentionManagerService attention check result.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/attention/AttentionManagerService.java
*/
message AttentionManagerServiceResultReported {
// See core/java/android/service/attention/AttentionService.java
enum AttentionCheckResult {
UNKNOWN = 20;
ATTENTION_SUCCESS_ABSENT = 0;
ATTENTION_SUCCESS_PRESENT = 1;
ATTENTION_FAILURE_UNKNOWN = 2;
ATTENTION_FAILURE_CANCELLED = 3;
ATTENTION_FAILURE_PREEMPTED = 4;
ATTENTION_FAILURE_TIMED_OUT = 5;
ATTENTION_FAILURE_CAMERA_PERMISSION_ABSENT = 6;
}
optional AttentionCheckResult attention_check_result = 1 [default = UNKNOWN];
}
/**
* Logs when an adb connection changes state.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/adb/AdbDebuggingManager.java
*/
message AdbConnectionChanged {
// The last time this system connected via adb, or 0 if the 'always allow' option was not
// previously selected for this system.
optional int64 last_connection_time_millis = 1;
// The time in ms within which a subsequent connection from an 'always allow' system is allowed
// to reconnect via adb without user interaction.
optional int64 auth_window_millis = 2;
// The state of the adb connection from frameworks/base/core/proto/android/debug/enums.proto.
optional android.debug.AdbConnectionStateEnum state = 3;
// True if the 'always allow' option was selected for this system.
optional bool always_allow = 4;
}
/*
* Logs the reported speech DSP status.
*
* Logged from:
* Vendor audio implementation.
*/
message SpeechDspStatReported {
// The total Speech DSP uptime in milliseconds.
optional int32 total_uptime_millis = 1;
// The total Speech DSP downtime in milliseconds.
optional int32 total_downtime_millis = 2;
optional int32 total_crash_count = 3;
optional int32 total_recover_count = 4;
}
/**
* Logs USB connector contaminant status.
*
* Logged from: USB Service.
*/
message UsbContaminantReported {
optional string id = 1;
optional android.service.usb.ContaminantPresenceStatus status = 2;
}
/**
* This atom is for debugging purpose.
*/
message DebugElapsedClock {
// Monotically increasing value for each pull.
optional int64 pull_count = 1;
// Time from System.elapsedRealtime.
optional int64 elapsed_clock_millis = 2;
// Time from System.elapsedRealtime.
optional int64 same_elapsed_clock_millis = 3;
// Diff between current elapsed time and elapsed time from previous pull.
optional int64 elapsed_clock_diff_millis = 4;
enum Type {
TYPE_UNKNOWN = 0;
ALWAYS_PRESENT = 1;
PRESENT_ON_ODD_PULLS = 2;
}
// Type of behavior for the pulled data.
optional Type type = 5;
}
/**
* This atom is for debugging purpose.
*/
message DebugFailingElapsedClock {
// Monotically increasing value for each pull.
optional int64 pull_count = 1;
// Time from System.elapsedRealtime.
optional int64 elapsed_clock_millis = 2;
// Time from System.elapsedRealtime.
optional int64 same_elapsed_clock_millis = 3;
// Diff between current elapsed time and elapsed time from previous pull.
optional int64 elapsed_clock_diff_millis = 4;
}
/** Logs System UI bubbles event changed.
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/systemui/bubbles
*/
message BubbleUIChanged {
// The app package that is posting the bubble.
optional string package_name = 1;
// The notification channel that is posting the bubble.
optional string notification_channel = 2;
// The notification id associated with the posted bubble.
optional int32 notification_id = 3;
// The position of the bubble within the bubble stack.
optional int32 position = 4;
// The total number of bubbles within the bubble stack.
optional int32 total_number = 5;
// User interactions with the bubble.
enum Action {
UNKNOWN = 0;
POSTED = 1;
UPDATED = 2;
EXPANDED = 3;
COLLAPSED = 4;
DISMISSED = 5;
STACK_DISMISSED = 6;
STACK_MOVED = 7;
HEADER_GO_TO_APP = 8;
HEADER_GO_TO_SETTINGS = 9;
PERMISSION_OPT_IN = 10;
PERMISSION_OPT_OUT = 11;
PERMISSION_DIALOG_SHOWN = 12;
SWIPE_LEFT = 13;
SWIPE_RIGHT = 14;
STACK_EXPANDED = 15;
FLYOUT = 16;
}
optional Action action = 6;
// Normalized screen position of the bubble stack. The range is between 0 and 1.
optional float normalized_x_position = 7;
optional float normalized_y_position = 8;
// Whether the bubble is unread. If it is unread, a dot is shown in the bubble stack icon.
optional bool is_unread = 9;
// Whether the bubble is an on-going one.
optional bool is_ongoing = 10;
// Whether the bubble is produced by an app running in foreground.
// This is deprecated and the value should be ignored.
optional bool is_foreground = 11 [deprecated = true];
}
/**
* Logs System UI bubbles developer errors.
*
* Logged from:
* frameworks/base/packages/SystemUI/src/com/android/systemui/bubbles/BubbleController.java
*/
message BubbleDeveloperErrorReported {
// The app package that is posting the bubble.
optional string package_name = 1;
// Bubble developer error type enums.
enum Error {
UNKNOWN = 0;
ACTIVITY_INFO_MISSING = 1;
ACTIVITY_INFO_NOT_RESIZABLE = 2;
DOCUMENT_LAUNCH_NOT_ALWAYS = 3;
}
optional Error error = 2 [default = UNKNOWN];
}
/**
* Logs that a constraint for a scheduled job has changed.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/job/controllers/JobStatus.java
*/
message ScheduledJobConstraintChanged {
repeated AttributionNode attribution_node = 1;
// Name of the job.
optional string job_name = 2;
optional com.android.server.job.ConstraintEnum constraint = 3;
enum State {
UNKNOWN = 0;
UNSATISFIED = 1;
SATISFIED = 2;
}
optional State state = 4;
}
/**
* Logs PowerManagerService screen timeout resets (extensions) that happen when an attention check
* returns true.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/power/PowerManagerService.java
*/
message ScreenTimeoutExtensionReported {
// Describes how many times in a row did the power manager reset the screen off timeout.
optional uint32 consecutive_timeout_extended_count = 1;
}
/*
* Logs number of milliseconds it takes to start a process.
* The definition of app process start time is from the app launch time to
* the time that Zygote finished forking the app process and loaded the
* application package's java classes.
* This metric is different from AppStartOccurred which is for foreground
* activity only.
* ProcessStartTime can report all processes (both foreground and background)
* start time.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
*/
message ProcessStartTime {
// The uid of the ProcessRecord.
optional int32 uid = 1 [(is_uid) = true];
// The process pid.
optional int32 pid = 2;
// The process name.
// Usually package name, "system" for system server.
// Provided by ActivityManagerService.
optional string process_name = 3;
enum StartType {
UNKNOWN = 0;
WARM = 1;
HOT = 2;
COLD = 3;
}
// The start type.
optional StartType type = 4;
// The elapsed realtime at the start of the process.
optional int64 process_start_time_millis = 5;
// Number of milliseconds it takes to reach bind application.
optional int32 bind_application_delay_millis = 6;
// Number of milliseconds it takes to finish start of the process.
optional int32 process_start_delay_millis = 7;
// hostingType field in ProcessRecord, the component type such as "activity",
// "service", "content provider", "broadcast" or other strings.
optional string hosting_type = 8;
// hostingNameStr field in ProcessRecord. The component class name that runs
// in this process.
optional string hosting_name = 9;
}
/**
* Track Media Codec usage
* Logged from:
* frameworks/av/media/libstagefright/MediaCodec.cpp
* frameworks/av/services/mediaanalytics/statsd_codec.cpp
*/
message MediametricsCodecReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.CodecData codec_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track Media Extractor (pulling video/audio streams out of containers) usage
* Logged from:
* frameworks/av/media/libstagefright/RemoteMediaExtractor.cpp
* frameworks/av/services/mediaanalytics/statsd_extractor.cpp
*/
message MediametricsExtractorReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.ExtractorData extractor_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track how we arbitrate between microphone/input requests.
* Logged from
* frameworks/av/services/audiopolicy/service/AudioPolicyInterfaceImpl.cpp
* frameworks/av/services/mediaanalytics/statsd_audiopolicy.cpp
*/
message MediametricsAudiopolicyReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.AudioPolicyData audiopolicy_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track how we arbitrate between microphone requests.
* Logged from
* frameworks/av/media/libaudioclient/AudioRecord.cpp
* frameworks/av/services/mediaanalytics/statsd_audiorecord.cpp
*/
message MediametricsAudiorecordReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.AudioRecordData audiorecord_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track how we arbitrate between microphone/input requests.
* Logged from
* frameworks/av/media/libnblog/ReportPerformance.cpp
* frameworks/av/services/mediaanalytics/statsd_audiothread.cpp
*/
message MediametricsAudiothreadReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.AudioThreadData audiothread_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track how we arbitrate between microphone/input requests.
* Logged from
* frameworks/av/media/libaudioclient/AudioTrack.cpp
* frameworks/av/services/mediaanalytics/statsd_audiotrack.cpp
*/
message MediametricsAudiotrackReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.AudioTrackData audiotrack_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track information about DRM framework performance
* Logged from
* frameworks/av/drm/libmediadrm/DrmHal.cpp
* frameworks/av/services/mediaanalytics/statsd_drm.cpp
*/
message MediametricsMediadrmReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
// vendor+description tell about which DRM plugin is in use on this device
optional string vendor = 5;
optional string description = 6;
// from frameworks/av/drm/libmediadrm/protos/metrics.proto
optional bytes framework_stats = 7 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track information about the widevine DRM plugin performance
* Logged from
* vendor/widevine/libwvdrmengine/cdm/metrics
* frameworks/av/services/mediaanalytics/statsd_drm.cpp
*/
message MediametricsDrmWidevineReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional bytes vendor_specific_stats = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track information about recordings (e.g. camcorder)
* Logged from
* frameworks/av/media/libmediaplayerservice/StagefrightRecorder.cpp
* frameworks/av/services/mediaanalytics/statsd_recorder.cpp
*/
message MediametricsRecorderReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.RecorderData recorder_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track Media Player usage
* Logged from:
* frameworks/av/media/libmediaplayerservice/nuplayer/NuPlayerDriver.cpp
* frameworks/av/services/mediaanalytics/statsd_nuplayer.cpp
*/
message MediametricsNuPlayerReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
optional android.stats.mediametrics.NuPlayerData nuplayer_data = 5 [(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Track Legacy DRM usage
* Logged from
* frameworks/av/drm/drmserver/DrmManager.cpp
*/
message MediametricsDrmManagerReported {
optional int64 timestamp_nanos = 1;
optional string package_name = 2;
optional int64 package_version_code = 3;
optional int64 media_apex_version = 4;
enum Method {
METHOD_NOT_FOUND = -1;
GET_CONSTRAINTS = 0;
GET_METADATA = 1;
CAN_HANDLE = 2;
PROCESS_DRM_INFO = 3;
ACQUIRE_DRM_INFO = 4;
SAVE_RIGHTS = 5;
GET_ORIGINAL_MIME_TYPE = 6;
GET_DRM_OBJECT_TYPE = 7;
CHECK_RIGHTS_STATUS = 8;
REMOVE_RIGHTS = 9;
REMOVE_ALL_RIGHTS = 10;
OPEN_CONVERT_SESSION = 11;
OPEN_DECRYPT_SESSION = 12;
}
// plugin_id+description inform which Legacy DRM plugins are still in use on device
optional string plugin_id = 5;
optional string description = 6;
optional Method method = 7;
optional string mime_types = 8;
optional int64 get_constraints_count = 9;
optional int64 get_metadata_count = 10;
optional int64 can_handle_count = 11;
optional int64 process_drm_info_count = 12;
optional int64 acquire_drm_info_count = 13;
optional int64 save_rights_count = 14;
optional int64 get_original_mime_type_count = 15;
optional int64 get_drm_object_type_count = 16;
optional int64 check_rights_status_count = 17;
optional int64 remove_rights_count = 18;
optional int64 remove_all_rights_count = 19;
optional int64 open_convert_session_count = 20;
optional int64 open_decrypt_session_count = 21;
}
/**
* State of a dangerous permission requested by a package
* Pulled from: StatsCompanionService
*/
message DangerousPermissionState {
// Name of the permission
optional string permission_name = 1;
// Uid of the package
optional int32 uid = 2 [(is_uid) = true];
// Package requesting the permission
optional string package_name = 3;
// If the permission is granted to the uid
optional bool is_granted = 4;
// Permission flags as per android.content.pm.PermissionFlags
optional int32 permission_flags = 5;
}
/**
* Logs when a package is denied access to a device identifier based on the new access requirements.
*
* Logged from:
* frameworks/base/telephony/java/com/android/internal/telephony/TelephonyPermissions.java
*/
message DeviceIdentifierAccessDenied {
// The name of the package denied access to the requested device identifier.
optional string package_name = 1;
// The name of the device identifier method the package attempted to invoke.
optional string method_name = 2;
// True if the package is preinstalled.
// Starting from Android 11, this boolean is not set and will always be false.
optional bool is_preinstalled = 3 [deprecated = true];
// True if the package is privileged.
// Starting from Android 11, this boolean is not set and will always be false.
optional bool is_priv_app = 4 [deprecated = true];
}
/**
* Pulls the ongoing mainline install train version code.
* Pulled from StatsCompanionService
*/
message TrainInfo {
optional int64 train_version_code = 1;
optional TrainExperimentIds train_experiment_id = 2;
optional string train_name = 3;
enum Status {
UNKNOWN = 0;
INSTALL_REQUESTED = 1;
INSTALL_STARTED = 2;
INSTALL_STAGED_NOT_READY = 3;
INSTALL_STAGED_READY = 4;
INSTALL_SUCCESS = 5;
// Replaced by INSTALL_FAILURE_DOWNLOAD, INSTALL_FAILURE_STATE_MISMATCH,
// and INSTALL_FAILURE_COMMIT.
INSTALL_FAILURE = 6 [deprecated = true];
// This enum is for installs that are manually cancelled via the Manual Update UI.
INSTALL_CANCELLED = 7;
INSTALLER_ROLLBACK_REQUESTED = 8;
INSTALLER_ROLLBACK_INITIATED = 9;
INSTALLER_ROLLBACK_INITIATED_FAILURE = 10;
INSTALLER_ROLLBACK_STAGED = 11;
INSTALLER_ROLLBACK_STAGED_FAILURE = 12;
INSTALLER_ROLLBACK_BOOT_TRIGGERED = 13;
INSTALLER_ROLLBACK_BOOT_TRIGGERED_FAILURE = 14;
INSTALLER_ROLLBACK_SUCCESS = 15;
INSTALLER_ROLLBACK_FAILURE = 16;
INSTALLER_ROLLBACK_STAGED_CANCEL_REQUESTED = 17;
INSTALLER_ROLLBACK_STAGED_CANCEL_SUCCESS = 18;
INSTALLER_ROLLBACK_STAGED_CANCEL_FAILURE = 19;
INSTALL_STAGED_CANCEL_REQUESTED = 20;
INSTALL_STAGED_CANCEL_SUCCESS = 21;
INSTALL_STAGED_CANCEL_FAILURE = 22;
INSTALL_FAILURE_DOWNLOAD = 23;
INSTALL_FAILURE_STATE_MISMATCH = 24;
INSTALL_FAILURE_COMMIT = 25;
REBOOT_TRIGGERED = 26;
}
optional Status status = 4;
}
/**
* Logs the gesture stage changed event.
*
* Logged from:
* frameworks/base/packages/SystemUI/
*/
message AssistGestureStageReported {
optional android.hardware.sensor.assist.AssistGestureStageEnum gesture_stage = 1;
}
/**
* Logs the feedback type.
*
* Logged from:
* frameworks/base/packages/SystemUI/
*/
message AssistGestureFeedbackReported {
// Whether or not the gesture was used.
optional android.hardware.sensor.assist.AssistGestureFeedbackEnum feedback_type = 1;
}
/**
* Logs the progress.
*
* Logged from:
* frameworks/base/packages/SystemUI/
*/
message AssistGestureProgressReported {
// [0,100] progress for the assist gesture.
optional int32 progress = 1;
}
/*
* Information about the time zone data on a device.
*/
message TimeZoneDataInfo {
// A version identifier for the data set on device. e.g. "2018i"
optional string tzdb_version = 1;
}
/**
* Logs the GPU stats global health information.
*
* Logged from:
* frameworks/native/services/gpuservice/gpustats/
*/
message GpuStatsGlobalInfo {
// Package name of the gpu driver.
optional string driver_package_name = 1;
// Version name of the gpu driver.
optional string driver_version_name = 2;
// Version code of the gpu driver.
optional int64 driver_version_code = 3;
// Build time of the gpu driver in UTC as seconds since January 1, 1970.
optional int64 driver_build_time = 4;
// Total count of the gl driver gets loaded.
optional int64 gl_loading_count = 5;
// Total count of the gl driver fails to be loaded.
optional int64 gl_loading_failure_count = 6;
// Total count of the Vulkan driver gets loaded.
optional int64 vk_loading_count = 7;
// Total count of the Vulkan driver fails to be loaded.
optional int64 vk_loading_failure_count = 8;
// Api version of the system Vulkan driver.
optional int32 vulkan_version = 9;
// Api version of the system CPU Vulkan driver.
optional int32 cpu_vulkan_version = 10;
// Api version of the system GLES driver.
optional int32 gles_version = 11;
// Total count of the angle driver gets loaded.
optional int64 angle_loading_count = 12;
// Total count of the angle driver fails to be loaded.
optional int64 angle_loading_failure_count = 13;
}
/**
* GPU driver loading time info.
*/
message GpuDriverLoadingTime {
// List of all the driver loading times for this app. The list size is
// capped at 50.
repeated int64 driver_loading_time = 1;
}
/**
* Logs the GPU stats per app health information.
*
* Logged from:
* frameworks/native/services/gpuservice/gpustats/
*/
message GpuStatsAppInfo {
// Package name of the application that loads the gpu driver. Total number
// of different packages is capped at 100.
optional string app_package_name = 1;
// Version code of the gpu driver this app loads.
optional int64 driver_version_code = 2;
// gl driver loading time info.
optional GpuDriverLoadingTime gl_driver_loading_time = 3
[(android.os.statsd.log_mode) = MODE_BYTES];
// Vulkan driver loading time info.
optional GpuDriverLoadingTime vk_driver_loading_time = 4
[(android.os.statsd.log_mode) = MODE_BYTES];
// Angle driver loading time info.
optional GpuDriverLoadingTime angle_driver_loading_time = 5
[(android.os.statsd.log_mode) = MODE_BYTES];
// CPU Vulkan implementation is in use.
optional bool cpu_vulkan_in_use = 6;
// App is not doing pre-rotation correctly.
optional bool false_prerotation = 7;
// App creates GLESv1 context.
optional bool gles_1_in_use = 8;
}
/*
* Logs the size of the system ion heap.
*
* Pulled from StatsCompanionService.
*/
message SystemIonHeapSize {
// Deprecated due to limited support of ion stats in debugfs.
// Use `IonHeapSize` instead.
option deprecated = true;
// Size of the system ion heap in bytes.
// Read from debugfs.
optional int64 size_in_bytes = 1;
}
/*
* Logs the total size of the ion heap.
*
* Pulled from StatsCompanionService.
*/
message IonHeapSize {
// Total size of all ion heaps in kilobytes.
// Read from: /sys/kernel/ion/total_heaps_kb.
optional int32 total_size_kb = 1;
}
/*
* Logs the per-process size of the system ion heap.
*
* Pulled from StatsCompanionService.
*/
message ProcessSystemIonHeapSize {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name (from /proc/PID/cmdline).
optional string process_name = 2;
// Sum of sizes of all allocations.
optional int32 total_size_in_kilobytes = 3;
// Number of allocations.
optional int32 allocation_count = 4;
// Size of the largest allocation.
optional int32 max_size_in_kilobytes = 5;
}
/**
* Push network stack events.
*
* Log from:
* frameworks/base/packages/NetworkStack/
*/
message NetworkStackReported {
// The id that indicates the event reported from NetworkStack.
optional int32 event_id = 1;
// The data for the reported events.
optional android.stats.connectivity.NetworkStackEventData network_stack_event = 2 [(log_mode) = MODE_BYTES];
}
/**
* Logs the apps that are installed on the external storage.
* Pulled from:
* StatsCompanionService
*/
message AppsOnExternalStorageInfo {
// The type of the external storage.
optional android.stats.storage.ExternalStorageType external_storage_type = 1;
// The name of the package that is installed on the external storage.
optional string package_name = 2;
}
/**
* Logs the settings related to Face.
* Logged from:
* frameworks/base/services/core/java/com/android/server/stats
*/
message FaceSettings {
// Whether or not face unlock is allowed on Keyguard.
optional bool unlock_keyguard_enabled = 1;
// Whether or not face unlock dismisses the Keyguard.
optional bool unlock_dismisses_keyguard = 2;
// Whether or not face unlock requires attention.
optional bool unlock_attention_required = 3;
// Whether or not face unlock is allowed for apps (through BiometricPrompt).
optional bool unlock_app_enabled = 4;
// Whether or not face unlock always requires user confirmation.
optional bool unlock_always_require_confirmation = 5;
// Whether or not a diverse set of poses are required during enrollment.
optional bool unlock_diversity_required = 6;
}
/**
* Logs cooling devices maintained by the kernel.
*
* Pulled from StatsCompanionService.java
*/
message CoolingDevice {
// The type of cooling device being reported. Eg. CPU, GPU...
optional android.os.CoolingTypeEnum device_location = 1;
// The name of the cooling device source. Eg. CPU0
optional string device_name = 2;
// Current throttle state of the cooling device. The value can any unsigned
// integer between 0 and max_state defined in its driver. 0 means device is
// not in throttling, higher value means deeper throttling.
optional int32 state = 3;
}
/**
* Intelligence has several counter-type events that don't warrant a
* full separate atom. These are primarily API call counters but also include
* counters for feature usage and specific failure modes.
*
* Logged from the Intelligence mainline module.
*/
message IntelligenceEventReported {
// The event type.
optional android.stats.intelligence.EventType event_id = 1;
// Success, failure.
optional android.stats.intelligence.Status status = 2;
// How many times the event occured (to report a batch of high frequency events).
optional int32 count = 3;
// How long the event took (sum of durations if count > 1)
optional int64 duration_millis = 4;
}
/**
* Logs when Car Power state changed.
*
* Logged from:
* packages/services/Car/service/src/com/android/car/CarStatsLog.java
*/
message CarPowerStateChanged {
// States come from CpmsState in CarPowerManagementService.java.
enum State {
WAIT_FOR_VHAL = 0;
ON = 1;
SHUTDOWN_PREPARE = 2;
WAIT_FOR_FINISH = 3;
SUSPEND = 4;
SIMULATE_SLEEP = 5;
}
optional State state = 1;
}
/**
* Logs whether GarageMode is entered.
*
* Logged from:
* packages/services/Car/service/src/com/android/car/CarStatsLog.java
*/
message GarageModeInfo {
// Whether GarageMode is entered.
optional bool is_garage_mode = 1;
}
/**
* Historical app ops data per package.
*/
message AppOps {
// Uid of the package requesting the op
optional int32 uid = 1 [(is_uid) = true];
// Name of the package performing the op
optional string package_name = 2;
// operation id
optional android.app.AppOpEnum op_id = 3 [default = APP_OP_NONE];
// The number of times the op was granted while the app was in the
// foreground (only for trusted requests)
optional int64 trusted_foreground_granted_count = 4;
// The number of times the op was granted while the app was in the
// background (only for trusted requests)
optional int64 trusted_background_granted_count = 5;
// The number of times the op was rejected while the app was in the
// foreground (only for trusted requests)
optional int64 trusted_foreground_rejected_count = 6;
// The number of times the op was rejected while the app was in the
// background (only for trusted requests)
optional int64 trusted_background_rejected_count = 7;
// For long-running operations, total duration of the operation
// while the app was in the foreground (only for trusted requests)
optional int64 trusted_foreground_duration_millis = 8;
// For long-running operations, total duration of the operation
// while the app was in the background (only for trusted requests)
optional int64 trusted_background_duration_millis = 9;
// Whether AppOps is guarded by Runtime permission
optional bool is_runtime_permission = 10;
}
/**
* Historical app ops data per package and attribution tag.
*/
message AttributedAppOps {
// Uid of the package requesting the op
optional int32 uid = 1 [(is_uid) = true];
// Name of the package performing the op
optional string package_name = 2;
// tag; provided by developer when accessing related API, limited at 50 chars by API.
// Attributions must be provided through manifest using <attribution> tag available in R and
// above.
optional string tag = 3;
// operation id
optional android.app.AppOpEnum op = 4 [default = APP_OP_NONE];
// The number of times the op was granted while the app was in the
// foreground (only for trusted requests)
optional int64 trusted_foreground_granted_count = 5;
// The number of times the op was granted while the app was in the
// background (only for trusted requests)
optional int64 trusted_background_granted_count = 6;
// The number of times the op was rejected while the app was in the
// foreground (only for trusted requests)
optional int64 trusted_foreground_rejected_count = 7;
// The number of times the op was rejected while the app was in the
// background (only for trusted requests)
optional int64 trusted_background_rejected_count = 8;
// For long-running operations, total duration of the operation
// while the app was in the foreground (only for trusted requests)
optional int64 trusted_foreground_duration_millis = 9;
// For long-running operations, total duration of the operation
// while the app was in the background (only for trusted requests)
optional int64 trusted_background_duration_millis = 10;
// Whether AppOps is guarded by Runtime permission
optional bool is_runtime_permission = 11;
// Sampling rate used on device, from 0 to 100
optional int32 sampling_rate = 12;
}
/**
* Location Manager API Usage information(e.g. API under usage,
* API call's parameters).
* Logged from:
* frameworks/base/services/core/java/com/android/server/LocationManagerService.java
*/
message LocationManagerApiUsageReported {
// Indicating if usage starts or usage ends.
optional android.stats.location.UsageState state = 1;
// LocationManagerService's API in use.
// We can identify which API from LocationManager is
// invoking current LMS API by the combination of
// API parameter(e.g. is_listener_null, is_intent_null,
// is_location_request_null)
optional android.stats.location.LocationManagerServiceApi api_in_use = 2;
// Name of the package calling the API.
optional string calling_package_name = 3;
// Type of the location provider.
optional android.stats.location.ProviderType provider = 4;
// Quality of the location request
optional android.stats.location.LocationRequestQuality quality = 5;
// The desired interval for active location updates, in milliseconds.
// Bucketized to reduce cardinality.
optional android.stats.location.LocationRequestIntervalBucket bucketized_interval = 6;
// Minimum distance between location updates, in meters.
// Bucketized to reduce cardinality.
optional android.stats.location.SmallestDisplacementBucket
bucketized_smallest_displacement = 7;
// The number of location updates.
optional int64 num_updates = 8;
// The request expiration time, in millisecond since boot.
// Bucketized to reduce cardinality.
optional android.stats.location.ExpirationBucket
bucketized_expire_in = 9;
// Type of Callback passed in for this API.
optional android.stats.location.CallbackType callback_type = 10;
// The radius of the central point of the alert
// region, in meters. Only for API REQUEST_GEOFENCE.
// Bucketized to reduce cardinality.
optional android.stats.location.GeofenceRadiusBucket bucketized_radius = 11;
// Activity Importance of API caller.
// Categorized to 3 types that are interesting from location's perspective.
optional android.stats.location.ActivityImportance activiy_importance = 12;
}
/**
* Information about a permission grant or denial made by user inside ReviewPermissionsFragment
*/
message ReviewPermissionsFragmentResultReported {
// unique value identifying a permission group change. A permission group change might result
// in multiple of these atoms
optional int64 change_id = 1;
// UID of package the permission belongs to
optional int32 uid = 2 [(is_uid) = true];
// Name of package the permission belongs to
optional string package_name = 3;
// The permission to be granted
optional string permission_name = 4;
// The result of the permission grant
optional bool permission_granted = 5;
}
/**
* Information about results of permission upgrade by RuntimePermissionsUpgradeController
* Logged from: RuntimePermissionUpdgradeController
*/
message RuntimePermissionsUpgradeResult {
// Permission granted as result of upgrade
optional string permission_name = 1;
// UID of package granted permission
optional int32 uid = 2 [(is_uid) = true];
// Name of package granted permission
optional string package_name = 3;
}
/**
* Information about a buttons presented in GrantPermissionsActivty and choice made by user
*/
message GrantPermissionsActivityButtonActions {
// Permission granted as result of upgrade
optional string permission_group_name = 1;
// UID of package granted permission
optional int32 uid = 2 [(is_uid) = true];
// Name of package requesting permission
optional string package_name = 3;
// Buttons presented in the dialog - bit flags, bit numbers are in accordance with
// LABEL_ constants in GrantPermissionActivity.java
optional int32 buttons_presented = 4;
// Button clicked by user - same as bit flags in buttons_presented with only single bit set
optional int32 button_clicked = 5;
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 6;
}
/**
* Information about LocationAccessCheck notification presented to user
*/
message LocationAccessCheckNotificationAction {
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 1;
// Uid of package for which location access check is presented
optional int32 package_uid = 2;
// Name of package for which location access check is presented
optional string package_name = 3;
enum Result {
UNDEFINED = 0;
// notification was presented to the user
NOTIFICATION_PRESENTED = 1;
// notification was declined by the user
NOTIFICATION_DECLINED = 2;
// notification was clicked by the user
NOTIFICATION_CLICKED = 3;
}
// View / interaction recorded
optional Result result = 4;
}
/**
* Information about a permission grant or revoke made by user inside AppPermissionFragment
*/
message AppPermissionFragmentActionReported {
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 1;
// unique value identifying a permission group change. A permission group change might result
// in multiple of these atoms
optional int64 change_id = 2;
// UID of package the permission belongs to
optional int32 uid = 3 [(is_uid) = true];
// Name of package the permission belongs to
optional string package_name = 4;
// The permission to be granted
optional string permission_name = 5;
// The result of the permission grant
optional bool permission_granted = 6;
// State of Permission Flags after grant as per android.content.pm.PermissionFlags
optional int32 permission_flags = 7;
enum Button {
UNDEFINED = 0;
// Allow button
ALLOW = 1;
// Deny button
DENY = 2;
// Ask every time button
ASK_EVERY_TIME = 3;
// Allow all the time button
ALLOW_ALWAYS = 4;
// Allow only while using the app button
ALLOW_FOREGROUND = 5;
// Same is Deny button but shown in while in use dialog
DENY_FOREGROUND = 6;
}
// Button pressed in the dialog
optional Button button_pressed = 8;
}
/**
* Information about a AppPermissionFragment viewed by user
*/
message AppPermissionFragmentViewed {
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 1;
// UID of package for which permissions are viewed
optional int32 uid = 2 [(is_uid) = true];
// Name of package for which permissions are viewed
optional string package_name = 3;
// Permission group viewed
optional string permission_group_name = 4;
}
/**
* Information about a AppPermissionsFragment viewed by user
*/
message AppPermissionsFragmentViewed {
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 1;
// id which identifies single view as every view might have several logging records
// with different package information attached
optional int64 view_id = 2;
// Permission group viewed
optional string permission_group_name = 3;
// UID of package for which permissions are viewed
optional int32 uid = 4 [(is_uid) = true];
// Name of package for which permissions are viewed
optional string package_name = 5;
// Category in which permission is included
enum Category {
UNDEFINED = 0;
ALLOWED = 1;
ALLOWED_FOREGROUND = 2;
DENIED = 3;
}
optional Category category = 6;
}
/**
* Information about a PermissionAppsFragment viewed by user.
* Logged from ui/handheld/PermissionAppsFragment.java
*/
message PermissionAppsFragmentViewed {
// id which identifies single session of user interacting with permission controller
optional int64 session_id = 1;
// id which identifies single view as every view might have several logging records
// with different package information attached
optional int64 view_id = 2;
// Permission group viewed
optional string permission_group_name = 3;
// UID of package for which permissions are viewed
optional int32 uid = 4 [(is_uid) = true];
// Name of package for which permissions are viewed
optional string package_name = 5;
// Category in which app is included
enum Category {
UNDEFINED = 0;
ALLOWED = 1;
ALLOWED_FOREGROUND = 2;
DENIED = 3;
}
optional Category category = 6;
}
/**
* Logs when there is a smart selection related event.
* See frameworks/base/core/java/android/view/textclassifier/TextClassifierEvent.java
* Logged from: TextClassifierEventLogger.java
*/
message TextSelectionEvent {
// A session ID.
optional string session_id = 1;
// Event type of this event.
optional android.stats.textclassifier.EventType event_type = 2;
// Name of the annotator model that is involved in this event.
optional string model_name = 3;
// Type of widget that was involved in triggering this event.
optional android.stats.textclassifier.WidgetType widget_type = 4;
// Index of this event in a session.
optional int32 event_index = 5;
// Entity type that is involved.
optional string entity_type = 6;
// Relative word index of the start of the selection.
optional int32 relative_word_start_index = 7;
// Relative word (exclusive) index of the end of the selection.
optional int32 relative_word_end_index = 8;
// Relative word index of the start of the smart selection.
optional int32 relative_suggested_word_start_index = 9;
// Relative word (exclusive) index of the end of the smart selection.
optional int32 relative_suggested_word_end_index = 10;
// Name of source package.
optional string package_name = 11;
// Name of the LangID model that is involved in this event.
optional string langid_model_name = 12;
}
/**
* Logs when there is a smart linkify related event.
* See frameworks/base/core/java/android/view/textclassifier/TextClassifierEvent.java
* Logged from: TextClassifierEventLogger.java
*/
message TextLinkifyEvent {
// A session ID.
optional string session_id = 1;
// Event type of this event.
optional android.stats.textclassifier.EventType event_type = 2;
// Name of the annotator model that is involved in this event.
optional string model_name = 3;
// Type of widget that was involved in triggering this event.
optional android.stats.textclassifier.WidgetType widget_type = 4;
// Index of this event in a session.
optional int32 event_index = 5;
// Entity type that is involved.
optional string entity_type = 6;
// Number of links detected.
optional int32 num_links = 7;
// The total length of all links.
optional int32 linked_text_length = 8;
// Length of input text.
optional int32 text_length = 9;
// Time spent on generating links in ms.
optional int64 latency_millis = 10;
// Name of source package.
optional string package_name = 11;
// Name of the LangID model that is involved in this event.
optional string langid_model_name = 12;
}
/**
* Logs when there is a conversation actions related event.
* See frameworks/base/core/java/android/view/textclassifier/TextClassifierEvent.java
* Logged from: TextClassifierEventLogger.java
*/
message ConversationActionsEvent {
// A session ID.
optional string session_id = 1;
// Event type of this event.
optional android.stats.textclassifier.EventType event_type = 2;
// Name of the actions model that is involved in this event.
optional string model_name = 3;
// Type of widget that was involved in triggering this event.
optional android.stats.textclassifier.WidgetType widget_type = 4;
// The first entity type that is involved.
optional string first_entity_type = 5;
// The second entity type that is involved.
optional string second_entity_type = 6;
// The third entity type that is involved.
optional string third_entity_type = 7;
// The score of the first entity type.
optional float score = 8;
// Name of source package.
optional string package_name = 9;
// Name of the annotator model that is involved in this event.
optional string annotator_model_name = 10;
// Name of the LangID model that is involved in this event.
optional string langid_model_name = 11;
}
/**
* Logs when there is a language detection related event.
* See frameworks/base/core/java/android/view/textclassifier/TextClassifierEvent.java
* Logged from: TextClassifierEventLogger.java
*/
message LanguageDetectionEvent {
// A session ID.
optional string session_id = 1;
// Event type of this event.
optional android.stats.textclassifier.EventType event_type = 2;
// Name of the language detection model that is involved in this event.
optional string model_name = 3;
// Type of widget that was involved in triggering this event.
optional android.stats.textclassifier.WidgetType widget_type = 4;
// Detected language.
optional string language_tag = 5;
// Score of the detected language.
optional float score = 6;
// Position of this action.
optional int32 action_index = 7;
// Name of source package.
optional string package_name = 8;
}
/**
* Information about an OTA update attempt by update_engine.
* Logged from platform/system/update_engine/metrics_reporter_android.cc
*/
message UpdateEngineUpdateAttemptReported {
// The number of attempts for the update engine to apply a given payload.
optional int32 attempt_number = 1;
optional android.stats.otaupdate.PayloadType payload_type = 2;
// The total time in minutes for the update engine to apply a given payload.
// The time is calculated by calling clock_gettime() / CLOCK_BOOTTIME; and
// it's increased when the system is sleeping.
optional int32 duration_boottime_in_minutes = 3;
// The total time in minutes for the update engine to apply a given payload.
// The time is calculated by calling clock_gettime() / CLOCK_MONOTONIC_RAW;
// and it's not increased when the system is sleeping.
optional int32 duration_monotonic_in_minutes = 4;
// The size of the payload in MiBs.
optional int32 payload_size_mib = 5;
// The attempt result reported by the update engine for an OTA update.
optional android.stats.otaupdate.AttemptResult attempt_result = 6;
// The error code reported by the update engine after an OTA update attempt
// on A/B devices.
optional android.stats.otaupdate.ErrorCode error_code = 7;
// The build fingerprint of the source system. The value is read from a
// system property when the device takes the update. e.g.
// Android/aosp_sailfish/sailfish:10/QP1A.190425.004/5507117:userdebug/test-keys
optional string source_fingerprint = 8;
}
/**
* Information about all the attempts the device make before finishing the
* successful update.
* Logged from platform/system/update_engine/metrics_reporter_android.cc
*/
message UpdateEngineSuccessfulUpdateReported {
// The number of attempts for the update engine to apply the payload for a
// successful update.
optional int32 attempt_count = 1;
optional android.stats.otaupdate.PayloadType payload_type = 2;
optional int32 payload_size_mib = 3;
// The total number of bytes downloaded by update_engine since the last
// successful update.
optional int32 total_bytes_downloaded_mib = 4;
// The ratio in percentage of the over-downloaded bytes compared to the
// total bytes needed to successfully install the update. e.g. 200 if we
// download 200MiB in total for a 100MiB package.
optional int32 download_overhead_percentage = 5;
// The total time in minutes for the update engine to apply the payload for a
// successful update.
optional int32 total_duration_minutes = 6;
// The number of reboot of the device during a successful update.
optional int32 reboot_count = 7;
}
/**
* Reported when the RebootEscrow HAL has attempted to recover the escrowed
* key to indicate whether it was successful or not.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/locksettings/RebootEscrowManager.java
*/
message RebootEscrowRecoveryReported {
optional bool successful = 1;
}
/**
* Global display pipeline metrics reported by SurfaceFlinger.
* Pulled from:
* frameworks/native/services/surfaceflinger/TimeStats/TimeStats.cpp
*/
message SurfaceflingerStatsGlobalInfo {
// Total number of frames presented during the tracing period
optional int64 total_frames = 1;
// Total number of frames missed
optional int64 missed_frames = 2;
// Total number of frames that fell back to client composition
optional int64 client_composition_frames = 3;
// Total time the display was turned on
optional int64 display_on_millis = 4;
// Total time that was spent performing animations.
// This is derived from the present-to-present layer histogram
optional int64 animation_millis = 5;
// Total number of event connections tracked by SurfaceFlinger at the time
// of this pull. If this number grows prohibitively large, then this can
// cause jank due to resource contention.
optional int32 event_connection_count = 6;
// Set of timings measured from when SurfaceFlinger began compositing a
// frame, until the frame was requested to be presented to the display. This
// measures SurfaceFlinger's total CPU walltime on the critical path per
// frame.
optional FrameTimingHistogram frame_duration = 7
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from when SurfaceFlinger first began using the
// GPU to composite a frame, until the GPU has finished compositing that
// frame. This measures the total additional time SurfaceFlinger needed to
// perform due to falling back into GPU composition.
optional FrameTimingHistogram render_engine_timing = 8
[(android.os.statsd.log_mode) = MODE_BYTES];
}
/**
* Per-layer display pipeline metrics reported by SurfaceFlinger.
* The number of layers uploaded will be restricted due to size limitations.
* Pulled from:
* frameworks/native/services/surfaceflinger/TimeStats/TimeStats.cpp
*/
message SurfaceflingerStatsLayerInfo {
// The layer for this set of metrics
// For now we can infer that the package name is included in the layer
// name.
optional string layer_name = 1;
// Total number of frames presented
optional int64 total_frames = 2;
// Total number of dropped frames while latching a buffer for this layer.
optional int64 dropped_frames = 3;
// Set of timings measured between successive presentation timestamps.
optional FrameTimingHistogram present_to_present = 4
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from when an app queued a buffer for
// presentation, until the buffer was actually presented to the
// display.
optional FrameTimingHistogram post_to_present = 5
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from when a buffer is ready to be presented,
// until the buffer was actually presented to the display.
optional FrameTimingHistogram acquire_to_present = 6
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from when a buffer was latched by
// SurfaceFlinger, until the buffer was presented to the display
optional FrameTimingHistogram latch_to_present = 7
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from the desired presentation to the actual
// presentation time
optional FrameTimingHistogram desired_to_present = 8
[(android.os.statsd.log_mode) = MODE_BYTES];
// Set of timings measured from when an app queued a buffer for
// presentation, until the buffer was ready to be presented.
optional FrameTimingHistogram post_to_acquire = 9
[(android.os.statsd.log_mode) = MODE_BYTES];
// Frames missed latch because the acquire fence didn't fire
optional int64 late_acquire_frames = 10;
// Frames latched early because the desired present time was bad
optional int64 bad_desired_present_frames = 11;
}
/**
* Histogram of frame counts bucketed by time in milliseconds.
* Because of size limitations, we hard-cap the number of buckets, with
* buckets for corresponding to larger milliseconds being less precise.
*/
message FrameTimingHistogram {
// Timings in milliseconds that describes a set of histogram buckets
repeated int32 time_millis_buckets = 1;
// Number of frames that match to each time_millis, i.e. the bucket
// contents
// It's required that len(time_millis) == len(frame_count)
repeated int64 frame_counts = 2;
}
/**
* Janky event as reported by SurfaceFlinger.
* This event is intended to be consumed by a Perfetto subscriber for
* automated trace collection.
*
* Logged from:
* frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
*/
message DisplayJankReported {
// Informational field for how long the janky event lasted in milliseconds
optional int64 event_duration_millis = 1;
// Number of frame deadlines missed, where SurfaceFlinger failed to update
// the display on time.
optional int32 present_deadlines_missed = 2;
}
/**
* Information about camera facing and API level usage.
* Logged from:
* frameworks/base/services/core/java/com/android/server/camera/CameraServiceProxy.java
*/
message CameraActionEvent {
// Camera session duration
optional int64 duration_millis = 1;
// Camera API level used
optional int32 api_level = 2;
// Name of client package
optional string package_name = 3;
// Camera facing
enum Facing {
UNKNOWN = 0;
BACK = 1;
FRONT = 2;
EXTERNAL = 3;
}
optional Facing facing = 4;
}
/**
* Logs when a compatibility change is affecting an app.
*
* Logged from:
* frameworks/base/core/java/android/app/AppCompatCallbacks.java and
* frameworks/base/services/core/java/com/android/server/compat/PlatformCompat.java
*/
message AppCompatibilityChangeReported {
// The UID of the app being affected by the compatibilty change.
optional int32 uid = 1 [(is_uid) = true];
// The ID of the change affecting the app.
optional int64 change_id = 2;
enum State {
UNKNOWN_STATE = 0;
ENABLED = 1;
DISABLED = 2;
LOGGED = 3;
}
// The state of the change - if logged from gating whether it was enabled or disabled, or just
// logged otherwise.
optional State state = 3;
enum Source {
UNKNOWN_SOURCE = 0;
APP_PROCESS = 1;
SYSTEM_SERVER = 2;
}
// Where it was logged from.
optional Source source = 4;
}
/**
* Logged from
* external/perfetto/src/perfetto_cmd/perfetto_cmd.cc
*/
message PerfettoUploaded {
enum Event {
PERFETTO_UNDEFINED = 0;
PERFETTO_TRACE_BEGIN = 1;
PERFETTO_BACKGROUND_TRACE_BEGIN = 2;
PERFETTO_ON_CONNECT = 3;
PERFETTO_ON_TRACING_DISABLED = 4;
PERFETTO_UPLOAD_DROPBOX_BEGIN = 5;
PERFETTO_UPLOAD_DROPBOX_SUCCESS = 6;
PERFETTO_UPLOAD_DROPBOX_FAILURE = 7;
PERFETTO_UPLOAD_INCIDENT_BEGIN = 8;
PERFETTO_UPLOAD_INCIDENT_SUCCESS = 9;
PERFETTO_UPLOAD_INCIDENT_FAILURE = 10;
PERFETTO_FINALIZE_TRACE_AND_EXIT = 11;
PERFETTO_TRIGGER_BEGIN = 12;
PERFETTO_TRIGGER_SUCCESS = 13;
PERFETTO_TRIGGER_FAILURE = 14;
PERFETTO_HIT_GUARDRAILS = 15;
PERFETTO_ON_TIMEOUT = 16;
PERFETTO_NOT_UPLOADING_EMPTY_TRACE = 17;
}
// Which stage of the pipeline we are reporting from.
optional Event event = 1;
// UUID matching the one set inside the SystemInfo trace packet.
optional int64 trace_uuid_lsb = 2;
optional int64 trace_uuid_msb = 3;
}
/**
* Pulls client metrics on data transferred via Vehicle Maps Service.
* Metrics are keyed by uid + layer.
*
* Pulled from:
* packages/services/Car/service/src/com/android/car/stats/CarStatsService.java
*/
message VmsClientStats {
// UID of the VMS client app
optional int32 uid = 1 [(is_uid) = true];
// VMS layer definition
optional int32 layer_type = 2;
optional int32 layer_channel = 3;
optional int32 layer_version = 4;
// Bytes and packets sent by the client for the layer
optional int64 tx_bytes = 5;
optional int64 tx_packets = 6;
// Bytes and packets received by the client for the layer
optional int64 rx_bytes = 7;
optional int64 rx_packets = 8;
// Bytes and packets dropped due to client error
optional int64 dropped_bytes = 9;
optional int64 dropped_packets = 10;
}
/**
* State of a dangerous permission requested by a package - sampled
* Pulled from: StatsCompanionService.java with data obtained from PackageManager API
*/
message DangerousPermissionStateSampled {
// Name of the permission
optional string permission_name = 1;
// Uid of the package
optional int32 uid = 2 [(is_uid) = true];
// If the permission is granted to the uid
optional bool is_granted = 3;
// Permission flags as per android.content.pm.PermissionFlags
optional int32 permission_flags = 4;
}
/**
* HWUI stats for a given app.
*/
message GraphicsStats {
// The package name of the app
optional string package_name = 1;
// The version code of the app
optional int64 version_code = 2;
// The start & end timestamps in UTC as
// milliseconds since January 1, 1970
// Compatible with java.util.Date#setTime()
optional int64 start_millis = 3;
optional int64 end_millis = 4;
// HWUI renders pipeline type: GL (1) or Vulkan (2).
enum PipelineType {
UNKNOWN = 0;
GL = 1;
VULKAN = 2;
}
// HWUI renders pipeline type: GL or Vulkan.
optional PipelineType pipeline = 5;
// Distinct frame count.
optional int32 total_frames = 6;
// Number of "missed vsync" events.
optional int32 missed_vsync_count = 7;
// Number of frames in triple-buffering scenario (high input latency)
optional int32 high_input_latency_count = 8;
// Number of "slow UI thread" events.
optional int32 slow_ui_thread_count = 9;
// Number of "slow bitmap upload" events.
optional int32 slow_bitmap_upload_count = 10;
// Number of "slow draw" events.
optional int32 slow_draw_count = 11;
// Number of frames that missed their deadline (aka, visibly janked)
optional int32 missed_deadline_count = 12;
// The frame time histogram for the package
optional FrameTimingHistogram cpu_histogram = 13
[(android.os.statsd.log_mode) = MODE_BYTES];
// The gpu frame time histogram for the package
optional FrameTimingHistogram gpu_histogram = 14
[(android.os.statsd.log_mode) = MODE_BYTES];
// UI mainline module version.
optional int64 version_ui_module = 15;
// If true, these are HWUI stats for up to a 24h period for a given app from today.
// If false, these are HWUI stats for a 24h period for a given app from the last complete
// day (yesterday). Stats from yesterday stay constant, while stats from today may change as
// more apps are running / rendering.
optional bool is_today = 16;
}
/**
* Message related to dangerous (runtime) app ops access
*/
message RuntimeAppOpAccess {
// Uid of the package accessing app op
optional int32 uid = 1 [(is_uid) = true];
// Name of the package accessing app op
optional string package_name = 2;
// deprecated - set to empty string
optional string op_deprecated = 3 [deprecated = true];
// attribution_tag; provided by developer when accessing related API, limited at 50 chars by
// API. Attributions must be provided through manifest using <attribution> tag available in R
// and above.
optional string attribution_tag = 4;
// message related to app op access, limited to 600 chars by API
optional string message = 5;
enum SamplingStrategy {
DEFAULT = 0;
UNIFORM = 1;
RARELY_USED = 2;
BOOT_TIME_SAMPLING = 3;
}
// sampling strategy used to collect this message
optional SamplingStrategy sampling_strategy = 6;
// operation id
optional android.app.AppOpEnum op = 7 [default = APP_OP_NONE];
}
/*
* Logs userspace reboot outcome and duration.
*
* Logged from:
* frameworks/base/core/java/com/android/server/BootReceiver.java
*/
message UserspaceRebootReported {
// Possible outcomes of userspace reboot.
enum Outcome {
// Default value in case platform failed to determine the outcome.
OUTCOME_UNKNOWN = 0;
// Userspace reboot succeeded (i.e. boot completed without a fall back to hard reboot).
SUCCESS = 1;
// Userspace reboot shutdown sequence was aborted.
FAILED_SHUTDOWN_SEQUENCE_ABORTED = 2;
// Remounting userdata into checkpointing mode failed.
FAILED_USERDATA_REMOUNT = 3;
// Device didn't finish booting before timeout and userspace reboot watchdog issued a hard
// reboot.
FAILED_USERSPACE_REBOOT_WATCHDOG_TRIGGERED = 4;
}
// Outcome of userspace reboot. Always set.
optional Outcome outcome = 1;
// Duration of userspace reboot in case it has a successful outcome.
// Duration is measured as time between userspace reboot was initiated and until boot completed
// (e.g. sys.boot_completed=1).
optional int64 duration_millis = 2;
// State of primary user's (user0) credential encryption storage.
enum UserEncryptionState {
// Default value.
USER_ENCRYPTION_STATE_UNKNOWN = 0;
// Credential encrypted storage is unlocked.
UNLOCKED = 1;
// Credential encrypted storage is locked.
LOCKED = 2;
}
// State of primary user's encryption storage at the moment boot completed. Always set.
optional UserEncryptionState user_encryption_state = 3;
}
/*
* Logs integrity check information during each install.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/integrity/AppIntegrityManagerServiceImpl.java
*/
message IntegrityCheckResultReported {
optional string package_name = 1;
optional string app_certificate_hash = 2;
optional int64 version_code = 3;
optional string installer_package_name = 4;
enum Response {
UNKNOWN = 0;
ALLOWED = 1;
REJECTED = 2;
FORCE_ALLOWED = 3;
}
optional Response response = 5;
// An estimate on the cause of the response. This will only be populated for
// REJECTED and FORCE_ALLOWED
optional bool caused_by_app_cert_rule = 6;
optional bool caused_by_installer_rule = 7;
}
/**
* Logs the information about the rules and the provider whenever rules are
* pushed into AppIntegrityManager.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/integrity/AppIntegrityManagerServiceImpl.java
*/
message IntegrityRulesPushed {
optional bool success = 1;
// Package name of the app that pushed the rules.
optional string rule_provider = 2;
// Version string of arbitrary format provided by the rule provider to
// identify the rules.
optional string rule_version = 3;
}
/**
* Logs when a cell broadcast message is received on the device.
*
* Logged from CellBroadcastService module:
* packages/modules/CellBroadcastService/src/com/android/cellbroadcastservice/
*/
message CellBroadcastMessageReported {
// The type of Cell Broadcast message
enum CbType {
UNKNOWN_TYPE = 0;
GSM = 1;
CDMA = 2;
CDMA_SPC = 3;
}
// GSM, CDMA, CDMA-SCP
optional CbType type = 1;
}
/**
* Logs when an error occurs while handling a cell broadcast message;
*
* Logged from CellBroadcastService module:
* packages/modules/CellBroadcastService/src/com/android/cellbroadcastservice/
*/
message CellBroadcastMessageError {
// The type of error raised when trying to handle a cell broadcast message
enum ErrorType {
UNKNOWN_TYPE = 0;
CDMA_DECODING_ERROR = 1;
CDMA_SCP_EMPTY = 2;
CDMA_SCP_HANDLING_ERROR = 3;
GSM_INVALID_HEADER_LENGTH = 4;
GSM_UNSUPPORTED_HEADER_MESSAGE_TYPE = 5;
GSM_UNSUPPORTED_HEADER_DATA_CODING_SCHEME = 6;
GSM_INVALID_PDU = 7;
GSM_INVALID_GEO_FENCING_DATA = 8;
GSM_UMTS_INVALID_WAC = 9;
FAILED_TO_INSERT_TO_DB = 10;
UNEXPECTED_GEOMETRY_FROM_FWK = 11;
UNEXPECTED_GSM_MESSAGE_TYPE_FROM_FWK = 12;
UNEXPECTED_CDMA_MESSAGE_TYPE_FROM_FWK = 13;
UNEXPECTED_CDMA_SCP_MESSAGE_TYPE_FROM_FWK = 14;
}
// What kind of error occurred
optional ErrorType type = 1;
// Exception message (or log message) associated with the error (max 1000 chars)
optional string exception_message = 2;
}
/**
* Logs when the SDK Extensions test app has polled the current version.
* This is atom ID 354.
*
* Logged from:
* vendor/google_testing/integration/packages/apps/SdkExtensionsTestApp/
*/
message SdkExtensionStatus {
enum ApiCallStatus {
CALL_NOT_ATTEMPTED = 0;
CALL_SUCCESSFUL = 1;
CALL_FAILED = 2;
}
optional ApiCallStatus result = 1;
// The R extension version, i.e. android.os.ext.SdkExtension.getExtensionVersion(R).
optional int32 r_extension_version = 2;
// A number identifying which particular symbol's call failed, if any. 0 means no missing symbol.
// "Failed" here can mean a symbol that wasn't meant to be visible was, or the other way around.
optional int32 failed_call_symbol = 3;
}
/**
* Logs when an app is frozen or unfrozen.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/CachedAppOptimizer.java
*/
message AppFreezeChanged {
// The type of event.
enum Action {
UNKNOWN = 0;
FREEZE_APP = 1;
UNFREEZE_APP = 2;
}
optional Action action = 1;
// Pid of the process being frozen.
optional int32 pid = 2;
// Name of the process being frozen.
optional string process_name = 3;
// Time since last unfrozen.
optional int64 time_unfrozen_millis = 4;
}
/**
* Pulls information for a single voice call.
*
* Each pull creates multiple atoms, one for each call. The sequence is randomized when pulled.
*
* Pulled from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/metrics/PersistPullers.java
*/
message VoiceCallSession {
// Bearer (IMS or CS) when the call started.
optional android.telephony.CallBearerEnum bearer_at_start = 1;
// Bearer (IMS or CS) when the call ended.
// The bearer may change during the call, e.g. due to SRVCC.
optional android.telephony.CallBearerEnum bearer_at_end = 2;
// Direction of the call (incoming or outgoing).
optional android.telephony.CallDirectionEnum direction = 3;
// Time spent setting up the call.
optional android.telephony.CallSetupDurationEnum setup_duration = 4;
// Whether the call ended before the setup was completed.
optional bool setup_failed = 5;
// IMS reason code or CS disconnect cause.
// For IMS, see: frameworks/base/telephony/java/android/telephony/ims/ImsReasonInfo.java
// For CS, see: frameworks/base/telephony/java/android/telephony/DisconnectCause.java
optional int32 disconnect_reason_code = 6;
// IMS extra code or CS precise disconnect cause.
// For IMS, this code is vendor-specific
// For CS, see: frameworks/base/telephony/java/android/telephony/PreciseDisconnectCause.java
optional int32 disconnect_extra_code = 7;
// IMS extra message or CS vendor cause.
optional string disconnect_extra_message = 8;
// Radio access technology (RAT) used when call started.
optional android.telephony.NetworkTypeEnum rat_at_start = 9;
// Radio access technology (RAT) used when call terminated.
optional android.telephony.NetworkTypeEnum rat_at_end = 10;
// Number of times RAT changed during the call.
optional int64 rat_switch_count = 11;
// A bitmask of all codecs used during the call.
// See: frameworks/opt/telephony/src/java/com/android/internal/telephony/metrics/VoiceCallSessionStats.java
optional int64 codec_bitmask = 12;
// Number of other calls going on during call setup, for the same SIM slot.
optional int32 concurrent_call_count_at_start = 13;
// Number of other calls going on during call termination, for the same SIM slot.
optional int32 concurrent_call_count_at_end = 14;
// Index of the SIM is used, 0 for single-SIM devices.
optional int32 sim_slot_index = 15;
// Whether the device was in multi-SIM mode (with multiple active SIM profiles).
optional bool is_multi_sim = 16;
// Whether the call was made with an eSIM profile.
optional bool is_esim = 17;
// Carrier ID of the SIM card.
// See https://source.android.com/devices/tech/config/carrierid.
optional int32 carrier_id = 18;
// Whether an SRVCC has been completed successfully.
// SRVCC (CS fallback) should be recorded in the IMS call since there will be no more SRVCC
// events once the call is switched to CS.
optional bool srvcc_completed = 19;
// Number of SRVCC failures.
optional int64 srvcc_failure_count = 20;
// Number of SRVCC cancellations.
optional int64 srvcc_cancellation_count = 21;
// Whether the Real-Time Text (RTT) was ever used in the call.
optional bool rtt_enabled = 22;
// Whether this was an emergency call.
optional bool is_emergency = 23;
// Whether the call was performed while roaming.
optional bool is_roaming = 24;
}
/**
* Pulls voice call radio access technology (RAT) usage.
*
* Each pull creates multiple atoms, one for each carrier/RAT, the order of which is irrelevant to
* time. The atom will be skipped if not enough data is available.
*
* Pulled from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/metrics/PersistPullers.java
*/
message VoiceCallRatUsage {
// Carrier ID (https://source.android.com/devices/tech/config/carrierid).
optional int32 carrier_id = 1;
// Radio access technology.
optional android.telephony.NetworkTypeEnum rat = 2;
// Total duration that voice calls spent on this carrier and RAT.
optional int64 total_duration_seconds = 3;
// Total number of calls using this carrier and RAT.
// A call is counted once even if it used the RAT multiple times.
optional int64 call_count = 4;
}
/**
* Pulls the number of active SIM slots and SIMs/eSIM profiles.
*
* Pulled from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/metrics/NonPersistPullers.java
*/
message SimSlotState {
// Number of active SIM slots (both physical and eSIM profiles) in the device.
optional int32 active_slot_count = 1;
// Number of SIM cards (both physical and active eSIM profiles).
// This number is always equal to or less than the number of active SIM slots.
optional int32 sim_count = 2;
// Number of active eSIM profiles.
// This number is always equal to or less than the number of SIMs.
optional int32 esim_count = 3;
}
/**
* Pulls supported cellular radio access technologies.
*
* This atom reports the capabilities of the device, rather than the network it has access to.
*
* Pulled from:
* frameworks/opt/telephony/src/java/com/android/internal/telephony/metrics/NonPersistPullers.java
*/
message SupportedRadioAccessFamily {
// A bitmask of supported radio technologies.
// See android.telephony.TelephonyManager.NetworkTypeBitMask.
optional int64 network_type_bitmask = 1;
}
/**
* Logs gnss stats from location service provider
*
* Pulled from:
* frameworks/base/location/java/com/android/internal/location/gnssmetrics/GnssMetrics.java
*/
message GnssStats {
// Number of location reports since boot
optional int64 location_reports = 1;
// Total pulled reports of Location failures since boot
optional int64 location_failure_reports = 2;
// Number of time to first fix reports since boot
optional int64 time_to_first_fix_reports = 3;
// Total pulled reported time to first fix (in milli-seconds) since boot
optional int64 time_to_first_fix_milli_s = 4;
// Number of position accuracy reports since boot
optional int64 position_accuracy_reports = 5;
// Total pulled reported position accuracy (in meters) since boot
optional int64 position_accuracy_meters = 6;
// Number of top 4 average CN0 reports since boot
optional int64 top_four_average_cn0_reports = 7;
// Total pulled reported of top 4 average CN0 (dB-mHz) since boot
optional int64 top_four_average_cn0_db_mhz = 8;
// Number of l5 top 4 average CN0 reports since boot
optional int64 l5_top_four_average_cn0_reports = 9;
// Total pulled reported of l5 top 4 average CN0 (dB-mHz) since boot
optional int64 l5_top_four_average_cn0_db_mhz = 10;
// Total number of sv status messages reports since boot
optional int64 sv_status_reports = 11;
// Total number of sv status messages reports, where sv is used in fix since boot
optional int64 sv_status_reports_used_in_fix = 12;
// Total number of L5 sv status messages reports since boot
optional int64 l5_sv_status_reports = 13;
// Total number of L5 sv status messages reports, where sv is used in fix since boot
optional int64 l5_sv_status_reports_used_in_fix = 14;
}
/**
* Logs when an app is moved to a different standby bucket.
*
* Logged from:
* frameworks/base/apex/jobscheduler/service/java/com/android/server/usage/AppIdleHistory.java
*/
message AppStandbyBucketChanged {
optional string package_name = 1;
// Should be 0, 10, 11, 12, etc. where 0 is the owner. See UserHandle for more documentation.
optional int32 user_id = 2;
// These enum values match the constants defined in UsageStatsManager.java.
enum Bucket {
BUCKET_UNKNOWN = 0;
BUCKET_EXEMPTED = 5;
BUCKET_ACTIVE = 10;
BUCKET_WORKING_SET = 20;
BUCKET_FREQUENT = 30;
BUCKET_RARE = 40;
BUCKET_RESTRICTED = 45;
BUCKET_NEVER = 50;
}
optional Bucket bucket = 3;
enum MainReason {
MAIN_UNKNOWN = 0;
MAIN_DEFAULT = 0x0100;
MAIN_TIMEOUT = 0x0200;
MAIN_USAGE = 0x0300;
MAIN_FORCED_BY_USER = 0x0400;
MAIN_PREDICTED = 0x0500;
MAIN_FORCED_BY_SYSTEM = 0x0600;
}
optional MainReason main_reason = 4;
// A more detailed reason for the standby bucket change. The sub reason name is dependent on
// the main reason. Values are one of the REASON_SUB_XXX constants defined in
// UsageStatsManager.java.
optional int32 sub_reason = 5;
}
/**
* Reports a started sharesheet transaction.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/app/ChooserActivity.java
*/
message SharesheetStarted {
// The event_id (as for UiEventReported).
optional int32 event_id = 1;
// The calling app's package name.
optional string package_name = 2;
// An identifier to tie together multiple logs relating to the same share event
optional int32 instance_id = 3;
// The mime type of the share
optional string mime_type = 4;
// The number of direct targets the calling app is providing that will be shown.
optional int32 num_app_provided_direct_targets = 5;
// The number of app targets the calling app is providing that will be shown.
optional int32 num_app_provided_app_targets = 6;
// True if the share originates from the workprofile
optional bool is_workprofile = 7;
enum SharesheetPreviewType { // Constants from ChooserActivity.java
CONTENT_PREVIEW_TYPE_UNKNOWN = 0; // Default for proto 2 / 3 compatibility.
CONTENT_PREVIEW_IMAGE = 1; // The preview shown in the sharesheet is an image.
CONTENT_PREVIEW_FILE = 2; // The preview shown in the sharesheet is a file.
CONTENT_PREVIEW_TEXT = 3; // The preview shown in the sharesheet is text.
}
// How the sharesheet preview is presented.
optional SharesheetPreviewType preview_type = 8;
enum ResolverActivityIntent { // Intents handled by ResolverActivity.java
INTENT_DEFAULT = 0;
INTENT_ACTION_VIEW = 1;
INTENT_ACTION_EDIT = 2;
INTENT_ACTION_SEND = 3;
INTENT_ACTION_SENDTO = 4;
INTENT_ACTION_SEND_MULTIPLE = 5;
INTENT_ACTION_IMAGE_CAPTURE = 6;
INTENT_ACTION_MAIN = 7;
}
// The intent being processed (only SEND and SEND_MULTIPLE are system sharesheet)
optional ResolverActivityIntent intent_type = 9;
}
/**
* Reports a ranking selection event.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/app/ChooserActivity.java (sharesheet)
*/
message RankingSelected {
// The event_id (as for UiEventReported).
optional int32 event_id = 1;
// The relevant app's package name (can be source or picked package).
optional string package_name = 2;
// An identifier to tie together multiple logs relating to the same share event.
optional int32 instance_id = 3;
// Which of the ranked targets got picked, default starting position 0.
optional int32 position_picked = 4;
}
/**
* Logs when TvSettings UI is interacted at.
*
* Logged from: packages/apps/TvSettings
*/
message TvSettingsUIInteracted {
/** The UI action category */
optional android.app.tvsettings.Action action = 1;
/** The ID of the entry that the users actioned on */
optional android.app.tvsettings.ItemId item_id = 2;
/** Additional information (e.g., navigation direction on page focused) */
optional string additional_info = 3;
}
/**
* Logs information about a package installation using package installer V2 APIs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/pm/PackageInstallerSession.java
*/
message PackageInstallerV2Reported {
// Whether this installation uses Incremental File System
optional bool is_incremental = 1;
// Name of the package that is intended to be installed
optional string package_name = 2;
// The duration between when the install was requested to when the install has completed
optional int64 duration_millis = 3;
// Installation result in final integer, which are SystemApi's.
// Return_code 1 indicates success.
// For full list, see frameworks/base/core/java/android/content/pm/PackageManager.java
optional int32 return_code = 4;
}
/**
* Logs settings provider values.
*
* Use DeviceConfig.getProperties to get a list Setting key, query the data from content provider,
* then write the value to proto.
*
*/
message SettingSnapshot {
// Setting key
optional string name = 1;
enum SettingsValueType {
NOTASSIGNED = 0;
ASSIGNED_BOOL_TYPE = 1;
ASSIGNED_INT_TYPE = 2;
ASSIGNED_FLOAT_TYPE = 3;
ASSIGNED_STRING_TYPE = 4;
};
// Setting value type
optional SettingsValueType type = 2;
optional bool bool_value = 3;
optional int32 int_value = 4;
optional float float_value = 5;
optional string str_value = 6;
// Android user index. 0 for primary user, 10, 11 for secondary or profile user
optional int32 user_id = 7;
}
/**
* An event logged to indicate that a user journey is about to be performed. This atom includes
* relevant information about the users involved in the journey. A UserLifecycleEventOccurred event
* will immediately follow this atom which will describe the event(s) and its state.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/UserController.java
* frameworks/base/services/core/java/com/android/server/pm/UserManagerService.java
*/
message UserLifecycleJourneyReported {
// An identifier to track a chain of user lifecycle events occurring (referenced in the
// UserLifecycleEventOccurred atom)
optional int64 session_id = 1;
// Indicates what type of user journey this session is related to
enum Journey {
UNKNOWN = 0; // Undefined user lifecycle journey
USER_SWITCH_UI = 1; // A user switch journey where a UI is shown
USER_SWITCH_FG = 2; // A user switch journey without a UI shown
USER_START = 3; // A user start journey
USER_CREATE = 4; // A user creation journey
}
optional Journey journey = 2;
// Which user the journey is originating from - could be -1 for certain phases (eg USER_CREATE)
// This integer is a UserIdInt (eg 0 for the system user, 10 for secondary/guest)
optional int32 origin_user = 3;
// Which user the journey is targeting
// This integer is a UserIdInt (eg 0 for the system user, 10 for secondary/guest)
optional int32 target_user = 4;
// What is the user type of the target user
// These should be in sync with USER_TYPE_* flags defined in UserManager.java
enum UserType {
TYPE_UNKNOWN = 0;
FULL_SYSTEM = 1;
FULL_SECONDARY = 2;
FULL_GUEST = 3;
FULL_DEMO = 4;
FULL_RESTRICTED = 5;
PROFILE_MANAGED = 6;
SYSTEM_HEADLESS = 7;
}
optional UserType user_type = 5;
// What are the flags attached to the target user
optional int32 user_flags = 6;
}
/**
* An event logged when a specific user lifecycle event is performed. These events should be
* correlated with a UserLifecycleJourneyReported atom via the session_id.
* Note: journeys can span over multiple events, hence some events may share a single session id.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/am/UserController.java
* frameworks/base/services/core/java/com/android/server/pm/UserManagerService.java
*/
message UserLifecycleEventOccurred {
// An id which links back to user details (reported in the UserLifecycleJourneyReported atom)
optional int64 session_id = 1;
// The target user for this event (same as target_user in the UserLifecycleJourneyReported atom)
// This integer is a UserIdInt (eg 0 for the system user, 10 for secondary/guest)
optional int32 user_id = 2;
enum Event {
UNKNOWN = 0; // Indicates that the associated user journey timed-out or resulted in an error
SWITCH_USER = 1; // Indicates that this is a user switch event
START_USER = 2; // Indicates that this is a user start event
CREATE_USER = 3; // Indicates that this is a user create event
}
optional Event event = 3;
enum State {
NONE = 0; // Indicates the associated event has no start/end defined
BEGIN = 1;
FINISH = 2;
}
optional State state = 4; // Represents the state of an event (beginning/ending)
}