Google Git
Sign in
android / platform / frameworks / base / 8d0ae5c65cbcd72a820215eaeb50fcbc0dc531a8 / . / cmds / statsd / src / atoms.proto
blob: 1b502e2f9eb13198aa8827f266598ab0e51fb032 [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/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/storage/storage_enums.proto";
import "frameworks/base/core/proto/android/stats/style/style_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";
/**
* 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;
ProcessStateChanged process_state_changed = 3;
BleScanResultReceived ble_scan_result_received = 4;
SensorStateChanged sensor_state_changed = 5;
GpsScanStateChanged gps_scan_state_changed = 6;
SyncStateChanged sync_state_changed = 7;
ScheduledJobStateChanged scheduled_job_state_changed = 8;
ScreenBrightnessChanged screen_brightness_changed = 9;
WakelockStateChanged wakelock_state_changed = 10;
LongPartialWakelockStateChanged long_partial_wakelock_state_changed = 11;
MobileRadioPowerStateChanged mobile_radio_power_state_changed = 12;
WifiRadioPowerStateChanged wifi_radio_power_state_changed = 13;
ActivityManagerSleepStateChanged activity_manager_sleep_state_changed = 14;
MemoryFactorStateChanged memory_factor_state_changed = 15;
ExcessiveCpuUsageReported excessive_cpu_usage_reported = 16;
CachedKillReported cached_kill_reported = 17;
ProcessMemoryStatReported process_memory_stat_reported = 18;
LauncherUIChanged launcher_event = 19;
BatterySaverModeStateChanged battery_saver_mode_state_changed = 20;
DeviceIdleModeStateChanged device_idle_mode_state_changed = 21;
DeviceIdlingModeStateChanged device_idling_mode_state_changed = 22;
AudioStateChanged audio_state_changed = 23;
MediaCodecStateChanged media_codec_state_changed = 24;
CameraStateChanged camera_state_changed = 25;
FlashlightStateChanged flashlight_state_changed = 26;
UidProcessStateChanged uid_process_state_changed = 27;
ProcessLifeCycleStateChanged process_life_cycle_state_changed = 28;
ScreenStateChanged screen_state_changed = 29;
BatteryLevelChanged battery_level_changed = 30;
ChargingStateChanged charging_state_changed = 31;
PluggedStateChanged plugged_state_changed = 32;
InteractiveStateChanged interactive_state_changed = 33;
TouchEventReported touch_event_reported = 34;
WakeupAlarmOccurred wakeup_alarm_occurred = 35;
KernelWakeupReported kernel_wakeup_reported = 36;
WifiLockStateChanged wifi_lock_state_changed = 37;
WifiSignalStrengthChanged wifi_signal_strength_changed = 38;
WifiScanStateChanged wifi_scan_state_changed = 39;
PhoneSignalStrengthChanged phone_signal_strength_changed = 40;
SettingChanged setting_changed = 41;
ActivityForegroundStateChanged activity_foreground_state_changed = 42;
IsolatedUidChanged isolated_uid_changed = 43;
PacketWakeupOccurred packet_wakeup_occurred = 44;
WallClockTimeShifted wall_clock_time_shifted = 45;
AnomalyDetected anomaly_detected = 46;
AppBreadcrumbReported app_breadcrumb_reported = 47 [(allow_from_any_uid) = true];
AppStartOccurred app_start_occurred = 48;
AppStartCanceled app_start_canceled = 49;
AppStartFullyDrawn app_start_fully_drawn = 50;
LmkKillOccurred lmk_kill_occurred = 51;
PictureInPictureStateChanged picture_in_picture_state_changed = 52;
WifiMulticastLockStateChanged wifi_multicast_lock_state_changed = 53;
LmkStateChanged lmk_state_changed = 54;
AppStartMemoryStateCaptured app_start_memory_state_captured = 55;
ShutdownSequenceReported shutdown_sequence_reported = 56;
BootSequenceReported boot_sequence_reported = 57;
DaveyOccurred davey_occurred = 58 [(allow_from_any_uid) = true];
OverlayStateChanged overlay_state_changed = 59;
ForegroundServiceStateChanged foreground_service_state_changed = 60;
CallStateChanged call_state_changed = 61;
KeyguardStateChanged keyguard_state_changed = 62;
KeyguardBouncerStateChanged keyguard_bouncer_state_changed = 63;
KeyguardBouncerPasswordEntered keyguard_bouncer_password_entered = 64;
AppDied app_died = 65;
ResourceConfigurationChanged resource_configuration_changed = 66;
BluetoothEnabledStateChanged bluetooth_enabled_state_changed = 67;
BluetoothConnectionStateChanged bluetooth_connection_state_changed = 68;
GpsSignalQualityChanged gps_signal_quality_changed = 69;
UsbConnectorStateChanged usb_connector_state_changed = 70;
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;
MobileRadioTechnologyChanged mobile_radio_technology_changed = 76;
UsbDeviceAttached usb_device_attached = 77;
AppCrashOccurred app_crash_occurred = 78;
ANROccurred anr_occurred = 79;
WTFOccurred wtf_occurred = 80;
LowMemReported low_mem_reported = 81;
GenericAtom generic_atom = 82;
KeyValuePairsAtom key_value_pairs_atom = 83 [(allow_from_any_uid) = true];
VibratorStateChanged vibrator_state_changed = 84;
DeferredJobStatsReported deferred_job_stats_reported = 85;
ThermalThrottlingStateChanged thermal_throttling = 86 [deprecated=true];
BiometricAcquired biometric_acquired = 87;
BiometricAuthenticated biometric_authenticated = 88;
BiometricErrorOccurred biometric_error_occurred = 89;
// Atom number 90 is available for use.
BatteryHealthSnapshot battery_health_snapshot = 91;
SlowIo slow_io = 92;
BatteryCausedShutdown battery_caused_shutdown = 93;
PhoneServiceStateChanged phone_service_state_changed = 94;
PhoneStateChanged phone_state_changed = 95;
UserRestrictionChanged user_restriction_changed = 96;
SettingsUIChanged settings_ui_changed = 97;
ConnectivityStateChanged connectivity_state_changed = 98;
// 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;
ServiceLaunchReported service_launch_reported = 100;
FlagFlipUpdateOccurred flag_flip_update_occurred = 101;
BinaryPushStateChanged binary_push_state_changed = 102;
DevicePolicyEvent device_policy_event = 103;
DocsUIFileOperationCanceledReported docs_ui_file_op_canceled =
104 [(log_from_module) = "docsui"];
DocsUIFileOperationCopyMoveModeReported
docs_ui_file_op_copy_move_mode_reported =
105 [(log_from_module) = "docsui"];
DocsUIFileOperationFailureReported docs_ui_file_op_failure =
106 [(log_from_module) = "docsui"];
DocsUIFileOperationReported docs_ui_provider_file_op =
107 [(log_from_module) = "docsui"];
DocsUIInvalidScopedAccessRequestReported
docs_ui_invalid_scoped_access_request =
108 [(log_from_module) = "docsui"];
DocsUILaunchReported docs_ui_launch_reported =
109 [(log_from_module) = "docsui"];
DocsUIRootVisitedReported docs_ui_root_visited =
110 [(log_from_module) = "docsui"];
DocsUIStartupMsReported docs_ui_startup_ms =
111 [(log_from_module) = "docsui"];
DocsUIUserActionReported docs_ui_user_action_reported =
112 [(log_from_module) = "docsui"];
WifiEnabledStateChanged wifi_enabled_state_changed = 113;
WifiRunningStateChanged wifi_running_state_changed = 114;
AppCompacted app_compacted = 115;
NetworkDnsEventReported network_dns_event_reported = 116 [(log_from_module) = "resolv"];
DocsUIPickerLaunchedFromReported docs_ui_picker_launched_from_reported =
117 [(log_from_module) = "docsui"];
DocsUIPickResultReported docs_ui_pick_result_reported =
118 [(log_from_module) = "docsui"];
DocsUISearchModeReported docs_ui_search_mode_reported =
119 [(log_from_module) = "docsui"];
DocsUISearchTypeReported docs_ui_search_type_reported =
120 [(log_from_module) = "docsui"];
DataStallEvent data_stall_event = 121 [(log_from_module) = "network_stack"];
RescuePartyResetReported rescue_party_reset_reported = 122;
SignedConfigReported signed_config_reported = 123;
GnssNiEventReported gnss_ni_event_reported = 124;
BluetoothLinkLayerConnectionEvent bluetooth_link_layer_connection_event = 125;
BluetoothAclConnectionStateChanged bluetooth_acl_connection_state_changed = 126;
BluetoothScoConnectionStateChanged bluetooth_sco_connection_state_changed = 127;
AppDowngraded app_downgraded = 128;
AppOptimizedAfterDowngraded app_optimized_after_downgraded = 129;
LowStorageStateChanged low_storage_state_changed = 130;
GnssNfwNotificationReported gnss_nfw_notification_reported = 131;
GnssConfigurationReported gnss_configuration_reported = 132;
UsbPortOverheatEvent usb_port_overheat_event_reported = 133;
NfcErrorOccurred nfc_error_occurred = 134;
NfcStateChanged nfc_state_changed = 135;
NfcBeamOccurred nfc_beam_occurred = 136;
NfcCardemulationOccurred nfc_cardemulation_occurred = 137;
NfcTagOccurred nfc_tag_occurred = 138;
NfcHceTransactionOccurred nfc_hce_transaction_occurred = 139;
SeStateChanged se_state_changed = 140;
SeOmapiReported se_omapi_reported = 141;
BroadcastDispatchLatencyReported broadcast_dispatch_latency_reported = 142;
AttentionManagerServiceResultReported attention_manager_service_result_reported = 143;
AdbConnectionChanged adb_connection_changed = 144;
SpeechDspStatReported speech_dsp_stat_reported = 145;
UsbContaminantReported usb_contaminant_reported = 146;
WatchdogRollbackOccurred watchdog_rollback_occurred = 147;
BiometricSystemHealthIssueDetected biometric_system_health_issue_detected = 148;
BubbleUIChanged bubble_ui_changed = 149;
ScheduledJobConstraintChanged scheduled_job_constraint_changed = 150;
BluetoothActiveDeviceChanged bluetooth_active_device_changed = 151;
BluetoothA2dpPlaybackStateChanged bluetooth_a2dp_playback_state_changed = 152;
BluetoothA2dpCodecConfigChanged bluetooth_a2dp_codec_config_changed = 153;
BluetoothA2dpCodecCapabilityChanged bluetooth_a2dp_codec_capability_changed = 154;
BluetoothA2dpAudioUnderrunReported bluetooth_a2dp_audio_underrun_reported = 155;
BluetoothA2dpAudioOverrunReported bluetooth_a2dp_audio_overrun_reported = 156;
BluetoothDeviceRssiReported bluetooth_device_rssi_reported = 157;
BluetoothDeviceFailedContactCounterReported bluetooth_device_failed_contact_counter_reported = 158;
BluetoothDeviceTxPowerLevelReported bluetooth_device_tx_power_level_reported = 159;
BluetoothHciTimeoutReported bluetooth_hci_timeout_reported = 160;
BluetoothQualityReportReported bluetooth_quality_report_reported = 161;
BluetoothDeviceInfoReported bluetooth_device_info_reported = 162;
BluetoothRemoteVersionInfoReported bluetooth_remote_version_info_reported = 163;
BluetoothSdpAttributeReported bluetooth_sdp_attribute_reported = 164;
BluetoothBondStateChanged bluetooth_bond_state_changed = 165;
BluetoothClassicPairingEventReported bluetooth_classic_pairing_event_reported = 166;
BluetoothSmpPairingEventReported bluetooth_smp_pairing_event_reported = 167;
ScreenTimeoutExtensionReported screen_timeout_extension_reported = 168;
ProcessStartTime process_start_time = 169;
PermissionGrantRequestResultReported permission_grant_request_result_reported =
170 [(log_from_module) = "permissioncontroller"];
BluetoothSocketConnectionStateChanged bluetooth_socket_connection_state_changed = 171;
DeviceIdentifierAccessDenied device_identifier_access_denied = 172;
BubbleDeveloperErrorReported bubble_developer_error_reported = 173;
AssistGestureStageReported assist_gesture_stage_reported = 174;
AssistGestureFeedbackReported assist_gesture_feedback_reported = 175;
AssistGestureProgressReported assist_gesture_progress_reported = 176;
TouchGestureClassified touch_gesture_classified = 177;
HiddenApiUsed hidden_api_used = 178 [(allow_from_any_uid) = true];
StyleUIChanged style_ui_changed = 179 [(log_from_module) = "style"];
PrivacyIndicatorsInteracted privacy_indicators_interacted =
180 [(log_from_module) = "permissioncontroller"];
AppInstallOnExternalStorageReported app_install_on_external_storage_reported = 181;
NetworkStackReported network_stack_reported = 182 [(log_from_module) = "network_stack"];
AppMovedStorageReported app_moved_storage_reported = 183;
BiometricEnrolled biometric_enrolled = 184;
SystemServerWatchdogOccurred system_server_watchdog_occurred = 185;
TombStoneOccurred tomb_stone_occurred = 186;
BluetoothClassOfDeviceReported bluetooth_class_of_device_reported = 187;
IntelligenceEventReported intelligence_event_reported =
188 [(log_from_module) = "intelligence"];
ThermalThrottlingSeverityStateChanged thermal_throttling_severity_state_changed = 189;
RoleRequestResultReported role_request_result_reported =
190 [(log_from_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;
CarPowerStateChanged car_power_state_changed = 203;
GarageModeInfo garage_mode_info = 204;
TestAtomReported test_atom_reported = 205 [(log_from_module) = "cts"];
ContentCaptureCallerMismatchReported content_capture_caller_mismatch_reported = 206;
ContentCaptureServiceEvents content_capture_service_events = 207;
ContentCaptureSessionEvents content_capture_session_events = 208;
ContentCaptureFlushed content_capture_flushed = 209;
LocationManagerApiUsageReported location_manager_api_usage_reported = 210;
ReviewPermissionsFragmentResultReported review_permissions_fragment_result_reported =
211 [(log_from_module) = "permissioncontroller"];
RuntimePermissionsUpgradeResult runtime_permissions_upgrade_result =
212 [(log_from_module) = "permissioncontroller"];
GrantPermissionsActivityButtonActions grant_permissions_activity_button_actions =
213 [(log_from_module) = "permissioncontroller"];
LocationAccessCheckNotificationAction location_access_check_notification_action =
214 [(log_from_module) = "permissioncontroller"];
AppPermissionFragmentActionReported app_permission_fragment_action_reported =
215 [(log_from_module) = "permissioncontroller"];
AppPermissionFragmentViewed app_permission_fragment_viewed =
216 [(log_from_module) = "permissioncontroller"];
AppPermissionsFragmentViewed app_permissions_fragment_viewed =
217 [(log_from_module) = "permissioncontroller"];
PermissionAppsFragmentViewed permission_apps_fragment_viewed =
218 [(log_from_module) = "permissioncontroller"];
ExclusionRectStateChanged exclusion_rect_state_changed = 223;
BackGesture back_gesture_reported_reported = 224;
VmsClientConnectionStateChanged vms_client_connection_state_changed = 230;
}
// Pulled events will start at field 10000.
// Next: 10067
oneof pulled {
WifiBytesTransfer wifi_bytes_transfer = 10000;
WifiBytesTransferByFgBg wifi_bytes_transfer_by_fg_bg = 10001;
MobileBytesTransfer mobile_bytes_transfer = 10002;
MobileBytesTransferByFgBg mobile_bytes_transfer_by_fg_bg = 10003;
BluetoothBytesTransfer bluetooth_bytes_transfer = 10006;
KernelWakelock kernel_wakelock = 10004;
SubsystemSleepState subsystem_sleep_state = 10005;
CpuTimePerFreq cpu_time_per_freq = 10008;
CpuTimePerUid cpu_time_per_uid = 10009;
CpuTimePerUidFreq cpu_time_per_uid_freq = 10010;
WifiActivityInfo wifi_activity_info = 10011;
ModemActivityInfo modem_activity_info = 10012;
BluetoothActivityInfo bluetooth_activity_info = 10007;
ProcessMemoryState process_memory_state = 10013;
SystemElapsedRealtime system_elapsed_realtime = 10014;
SystemUptime system_uptime = 10015;
CpuActiveTime cpu_active_time = 10016;
CpuClusterTime cpu_cluster_time = 10017;
DiskSpace disk_space = 10018 [deprecated=true];
RemainingBatteryCapacity remaining_battery_capacity = 10019;
FullBatteryCapacity full_battery_capacity = 10020;
Temperature temperature = 10021;
BinderCalls binder_calls = 10022;
BinderCallsExceptions binder_calls_exceptions = 10023;
LooperStats looper_stats = 10024;
DiskStats disk_stats = 10025;
DirectoryUsage directory_usage = 10026;
AppSize app_size = 10027;
CategorySize category_size = 10028;
ProcStats proc_stats = 10029;
BatteryVoltage battery_voltage = 10030;
NumFingerprintsEnrolled num_fingerprints_enrolled = 10031;
DiskIo disk_io = 10032;
PowerProfile power_profile = 10033;
ProcStatsPkgProc proc_stats_pkg_proc = 10034;
ProcessCpuTime process_cpu_time = 10035;
NativeProcessMemoryState native_process_memory_state = 10036;
CpuTimePerThreadFreq cpu_time_per_thread_freq = 10037;
OnDevicePowerMeasurement on_device_power_measurement = 10038;
DeviceCalculatedPowerUse device_calculated_power_use = 10039;
DeviceCalculatedPowerBlameUid device_calculated_power_blame_uid = 10040;
DeviceCalculatedPowerBlameOther device_calculated_power_blame_other = 10041;
ProcessMemoryHighWaterMark process_memory_high_water_mark = 10042;
BatteryLevel battery_level = 10043;
BuildInformation build_information = 10044;
BatteryCycleCount battery_cycle_count = 10045;
DebugElapsedClock debug_elapsed_clock = 10046;
DebugFailingElapsedClock debug_failing_elapsed_clock = 10047;
NumFacesEnrolled num_faces_enrolled = 10048;
RoleHolder role_holder = 10049;
DangerousPermissionState dangerous_permission_state = 10050;
TrainInfo train_info = 10051;
TimeZoneDataInfo time_zone_data_info = 10052;
ExternalStorageInfo external_storage_info = 10053;
GpuStatsGlobalInfo gpu_stats_global_info = 10054;
GpuStatsAppInfo gpu_stats_app_info = 10055;
SystemIonHeapSize system_ion_heap_size = 10056;
AppsOnExternalStorageInfo apps_on_external_storage_info = 10057;
FaceSettings face_settings = 10058;
CoolingDevice cooling_device = 10059;
AppOps app_ops = 10060;
ProcessSystemIonHeapSize process_system_ion_heap_size = 10061;
VmsClientStats vms_client_stats = 10065;
NotificationRemoteViews notification_remote_views = 10066;
}
// 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.
}
/**
* 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).option = EXCLUSIVE];
}
/**
* 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).option = PRIMARY, (is_uid) = true];
// The state, from frameworks/base/core/proto/android/app/enums.proto.
optional android.app.ProcessStateEnum state = 2 [(state_field_option).option = EXCLUSIVE];
}
/**
* 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).option = EXCLUSIVE];
}
/**
* 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).option = EXCLUSIVE];
}
/**
* 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 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;
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;
// Does the scan have a filter.
optional bool is_filtered = 3;
// Whether the scan is a CALLBACK_TYPE_FIRST_MATCH scan. Called 'background' scan internally.
optional bool is_first_match = 4;
// Whether the scan set to piggy-back off the results of other scans (SCAN_MODE_OPPORTUNISTIC).
optional bool is_opportunistic = 5;
}
/**
* 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;
}
optional Bucket standby_bucket = 5 [default = UNKNOWN];
// The job id (as assigned by the app).
optional int32 job_id = 6;
}
/**
* 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;
// 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;
// The wakelock tag (Called tag in the Java API, sometimes name elsewhere).
optional string tag = 3;
enum State {
RELEASE = 0;
ACQUIRE = 1;
CHANGE_RELEASE = 2;
CHANGE_ACQUIRE = 3;
}
optional State state = 4;
}
/**
* 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;
// These enum values match the STANDBY_BUCKET_XXX constants defined in UsageStatsManager.java.
enum Bucket {
UNKNOWN = 0;
EXEMPTED = 5;
ACTIVE = 10;
WORKING_SET = 20;
FREQUENT = 30;
RARE = 40;
NEVER = 50;
}
// The App Standby bucket of the app that scheduled the alarm at the time the alarm fired.
optional 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;
}
/**
* 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: 5
*/
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];
}
/**
* Logs when a Bluetooth device connects and disconnects over ACL
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/AdapterProperties.java
*
* Next Tag: 3
*/
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;
}
/**
* 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: 4
*/
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;
}
/**
* 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];
}
// 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;
}
/**
* 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;
}
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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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];
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* 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;
}
optional BackType type = 1;
optional int32 y_coordinate = 2; // y coordinate for ACTION_DOWN event
enum WindowHorizontalLocation {
DEFAULT_LOCATION = 0;
LEFT = 1;
RIGHT = 2;
}
optional WindowHorizontalLocation x_location = 3;
}
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;
}
message LauncherUIChanged {
optional android.stats.launcher.LauncherAction action = 1;
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];
optional bool is_swipe_up_enabled = 5;
}
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 latency between the kernel and framework
* for touchscreen events. The units are microseconds.
*
* The number is measured as the difference between the time at which
* the input event was received in the evdev driver,
* and the time at which the input event was received in EventHub.
*/
// 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 sint32 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 sint32 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 [(is_uid) = true];
optional string package_name = 2;
optional bool using_alert_window = 3;
enum State {
ENTERED = 1;
EXITED = 2;
}
optional State state = 4;
}
/*
* 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;
}
/**
* 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).option = EXCLUSIVE];
}
/**
* 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;
}
/**
* 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