blob: 5899e0cfbca12dd1e87ae34c520ab596939914ec [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/settings_enums.proto";
import "frameworks/base/core/proto/android/app/job/enums.proto";
import "frameworks/base/core/proto/android/bluetooth/enums.proto";
import "frameworks/base/core/proto/android/os/enums.proto";
import "frameworks/base/core/proto/android/server/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/stats/enums.proto";
import "frameworks/base/core/proto/android/stats/docsui/docsui_enums.proto";
import "frameworks/base/core/proto/android/stats/launcher/launcher.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/stats/devicepolicy/device_policy_enums.proto";
import "frameworks/base/core/proto/android/stats/devicepolicy/device_policy.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;
// 34 is available
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;
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;
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;
VibratorStateChanged vibrator_state_changed = 84;
DeferredJobStatsReported deferred_job_stats_reported = 85;
ThermalThrottlingStateChanged thermal_throttling = 86;
FingerprintAcquired fingerprint_acquired = 87;
FingerprintAuthenticated fingerprint_authenticated = 88;
FingerprintErrorOccurred fingerprint_error_occurred = 89;
Notification notification = 90;
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;
PhenotypeFlagStateChanged phenotype_flag_state_changed = 101;
BinaryPushStateChanged binary_push_state_changed = 102;
DevicePolicyEvent device_policy_event = 103;
DocsUIFileOperationCanceledReported docs_ui_file_op_canceled = 104;
DocsUIFileOperationCopyMoveModeReported docs_ui_file_op_copy_move_mode_reported = 105;
DocsUIFileOperationFailureReported docs_ui_file_op_failure = 106;
DocsUIFileOperationReported docs_ui_provider_file_op = 107;
DocsUIInvalidScopedAccessRequestReported docs_ui_invalid_scoped_access_request = 108;
DocsUILaunchReported docs_ui_launch_reported = 109;
DocsUIRootVisitedReported docs_ui_root_visited = 110;
DocsUIStartupMsReported docs_ui_startup_ms = 111;
DocsUIUserActionReported docs_ui_user_action_reported = 112;
WifiEnabledStateChanged wifi_enabled_state_changed = 113;
WifiRunningStateChanged wifi_running_state_changed = 114;
}
// Pulled events will start at field 10000.
// Next: 10043
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;
NumFingerprints num_fingerprints = 10031;
DiskIo disk_io = 10032;
PowerProfile power_profile = 10033;
ProcStats 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;
}
// 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.
* *****************************************************************************
*/
/**
* 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 {
optional android.os.TemperatureTypeEnum sensor_type = 1;
enum State {
UNKNOWN = 0;
START = 1;
STOP = 2;
}
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 = 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;
}
/**
* 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;
}
/**
* 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;
}
/**
* Logs wifi signal strength changes.
*
* Logged from:
* frameworks/base/core/java/com/android/internal/os/BatteryStatsImpl.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/base/core/java/com/android/internal/os/BatteryStatsImpl.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/base/core/java/com/android/internal/os/BatteryStatsImpl.java
*/
message WifiMulticastLockStateChanged {
repeated AttributionNode attribution_node = 1;
enum State {
OFF = 0;
ON = 1;
}
optional State state = 2;
}
/**
* 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 a Bluetooth device connects and disconnects.
*
* Logged from:
* packages/apps/Bluetooth/src/com/android/bluetooth/btservice/AdapterProperties.java
*/
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.
optional int32 obfuscated_id = 2;
// The profile that is connected. Eg. GATT, A2DP, HEADSET.
// From android.bluetooth.BluetoothAdapter.java
optional int32 bt_profile = 3;
}
/**
* Logs when something is plugged into or removed from the USB-C connector.
*
* Logged from:
* UsbService
*/
message UsbConnectorStateChanged {
enum State {
STATE_DISCONNECTED = 0;
STATE_CONNECTED = 1;
}
optional State state = 1;
optional string id = 2;
// Last active session in ms.
// 0 when the port is in connected state.
optional int64 last_connect_duration_millis = 3;
}
/**
* Logs the reported speaker impedance.
*
* Logged from:
* Vendor audio implementation.
*/
message SpeakerImpedanceReported {
optional int32 speaker_location = 1;
optional int32 impedance = 2;
}
/**
* Logs the report of a failed hardware.
*
* Logged from:
* Vendor HALs.
*
*/
message HardwareFailed {
enum HardwareType {
HARDWARE_FAILED_UNKNOWN = 0;
HARDWARE_FAILED_MICROPHONE = 1;
HARDWARE_FAILED_CODEC = 2;
HARDWARE_FAILED_SPEAKER = 3;
HARDWARE_FAILED_FINGERPRINT = 4;
}
optional HardwareType hardware_type = 1;
/* hardware_location allows vendors to differentiate between multiple instances of
* the same hardware_type. The specific locations are vendor defined integers,
* referring to board-specific numbering schemes.
*/
optional int32 hardware_location = 2;
/* failure_code is specific to the HardwareType of the failed hardware.
* It should use the enum values defined below.
*/
enum MicrophoneFailureCode {
MICROPHONE_FAILURE_COMPLETE = 0;
}
enum CodecFailureCode {
CODEC_FAILURE_COMPLETE = 0;
}
enum SpeakerFailureCode {
SPEAKER_FAILURE_COMPLETE = 0;
SPEAKER_FAILURE_HIGH_Z = 1;
SPEAKER_FAILURE_SHORT = 2;
}
enum FingerprintFailureCode {
FINGERPRINT_FAILURE_COMPLETE = 0;
FINGERPRINT_SENSOR_BROKEN = 1;
FINGERPRINT_TOO_MANY_DEAD_PIXELS = 2;
}
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 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 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;
}
/**
* 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 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 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;
}
/*
* 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 fingerprint acquire event occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics/fingerprint/FingerprintService.java
*/
message FingerprintAcquired {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// If this acquire is for a crypto fingerprint.
// e.g. Secure purchases, unlock password storage.
optional bool is_crypto = 2;
}
/**
* Logs when a fingerprint authentication event occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics/fingerprint/FingerprintService.java
*/
message FingerprintAuthenticated {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// If this authentication is for a crypto fingerprint.
// e.g. Secure purchases, unlock password storage.
optional bool is_crypto = 2;
// Whether or not this authentication was successful.
optional bool is_authenticated = 3;
}
/**
* Logs when a fingerprint error occurs.
*
* Logged from:
* frameworks/base/services/core/java/com/android/server/biometrics/fingerprint/FingerprintService.java
*/
message FingerprintErrorOccurred {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// If this error is for a crypto fingerprint.
// e.g. Secure purchases, unlock password storage.
optional bool is_crypto = 2;
enum Error {
UNKNOWN = 0;
LOCKOUT = 1;
PERMANENT_LOCKOUT = 2;
}
// The type of error.
optional Error error = 3;
}
message Notification {
// Type of notification event.
enum Type {
TYPE_UNKNOWN = 0;
// Notification became visible to the user.
TYPE_OPEN = 1;
// Notification became hidden.
TYPE_CLOSE = 2;
// Notification switched to detail mode.
TYPE_DETAIL = 3;
// Notification was clicked.
TYPE_ACTION = 4;
// Notification was dismissed.
TYPE_DISMISS = 5;
// Notification switched to summary mode. The enum value of 14 is to
// match that of metrics_constants.
TYPE_COLLAPSE = 14;
}
optional Type type = 1;
// Package name associated with the notification.
optional string package_name = 2;
// Tag associated with notification.
optional string tag = 3;
// Application-supplied ID associated with the notification.
optional int32 id = 4;
// Index of notification in the notification panel.
optional int32 shade_index = 5;
// The number of notifications in the notification panel.
optional int32 shade_count = 6;
// Importance for the notification.
optional int32 importance = 7;
// ID for the notification channel.
optional string channel_id = 8;
// Importance for the notification channel.
optional int32 channel_importance = 9;
// Application-supplied ID associated with the notifications group.
optional string group_id = 10;
// Whether notification was a group summary.
optional bool group_summary = 11;
// Reason for dismissal of a notification. This field is only meaningful for
// TYPE_DISMISS events.
optional int32 dismiss_reason = 12;
// The first post time of notification, stable across updates.
optional int64 creation_millis = 13;
// The most recent interruption time, or the creation time if no updates.
// Differs from update_millis because updates are filtered based on whether
// they actually interrupted the user.
optional int64 interruption_millis = 14;
// The most recent update time, or the creation time if no updates.
optional int64 update_millis = 15;
// The most recent visibility event.
optional int64 visible_millis = 16;
}
/*
* Logs when a flag flip state changes.
* Logged in P/h.
*/
message PhenotypeFlagStateChanged {
// Mendel configuration name.
optional string mendel_config_name = 1;
// State
enum State {
STATE_UNKNOWN = 0;
COMMITTED = 1;
}
optional State state = 2;
}
/*
* Logs when a binary push state changes.
* Logged in Play store
*/
message BinaryPushStateChanged {
// Binary package name.
optional string binary_name = 1;
// Version code.
optional int64 version = 2;
// State
enum State {
STATE_UNKNOWN = 0;
DOWNLOAD_START = 1;
DOWNLOAD_DONE = 2;
INSTALL_START = 3;
INSTALL_DONE = 4;
REBOOT_START = 5;
REBOOT_DONE = 6;
}
optional State state = 3;
}
/*
* Logs when a connection becomes available and lost.
* Logged in StatsCompanionService.java
*/
message ConnectivityStateChanged {
// Id of the network.
optional int32 net_id = 1;
enum State {
UNKNOWN = 0;
CONNECTED = 1;
DISCONNECTED = 2;
}
// Connected state of a network.
optional State state = 2;
}
/**
* Logs when a service starts and stops.
* Logged from:
* services/core/java/com/android/server/am/ActiveServices.java
*/
message ServiceStateChanged {
optional int32 uid = 1 [(is_uid) = true];
optional string package_name = 2;
optional string service_name = 3;
enum State {
START = 1;
STOP = 2;
}
optional State state = 4;
}
/**
* Logs when a service is launched.
* Logged from:
* services/core/java/com/android/server/am/ActiveServices.java
*/
message ServiceLaunchReported {
optional int32 uid = 1 [(is_uid) = true];
optional string package_name = 2;
optional string service_name = 3;
}
//////////////////////////////////////////////////////////////////////
// Pulled atoms below this line //
//////////////////////////////////////////////////////////////////////
/**
* Pulls bytes transferred via wifi (Sum of foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are wifi)
*/
message WifiBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 rx_packets = 3;
optional int64 tx_bytes = 4;
optional int64 tx_packets = 5;
}
/**
* Pulls bytes transferred via wifi (separated by foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are wifi)
*/
message WifiBytesTransferByFgBg {
optional int32 uid = 1 [(is_uid) = true];
// 1 denotes foreground and 0 denotes background. This is called Set in NetworkStats.
optional bool is_foreground = 2;
optional int64 rx_bytes = 3;
optional int64 rx_packets = 4;
optional int64 tx_bytes = 5;
optional int64 tx_packets = 6;
}
/**
* Pulls bytes transferred via mobile networks (Sum of foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are mobile data)
*/
message MobileBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 rx_packets = 3;
optional int64 tx_bytes = 4;
optional int64 tx_packets = 5;
}
/**
* Pulls bytes transferred via mobile networks (separated by foreground and background usage).
*
* Pulled from:
* StatsCompanionService (using BatteryStats to get which interfaces are mobile data)
*/
message MobileBytesTransferByFgBg {
optional int32 uid = 1 [(is_uid) = true];
// 1 denotes foreground and 0 denotes background. This is called Set in
// NetworkStats.
optional bool is_foreground = 2;
optional int64 rx_bytes = 3;
optional int64 rx_packets = 4;
optional int64 tx_bytes = 5;
optional int64 tx_packets = 6;
}
/**
* Pulls bytes transferred via bluetooth. It is pulled from Bluetooth controller.
*
* Pulled from:
* StatsCompanionService
*/
message BluetoothBytesTransfer {
optional int32 uid = 1 [(is_uid) = true];
optional int64 rx_bytes = 2;
optional int64 tx_bytes = 3;
}
/**
* Pulls the kernel wakelock durations. This atom is adapted from
* android/internal/os/KernelWakelockStats.java
*
* Pulled from:
* StatsCompanionService using KernelWakelockReader.
*/
message KernelWakelock {
optional string name = 1;
optional int32 count = 2;
optional int32 version = 3;
optional int64 time_micros = 4;
}
/**
* Pulls low power state information. If power.stats HAL is not available, this
* includes platform and subsystem sleep state information,
* PowerStatePlatformSleepState, PowerStateVoter or PowerStateSubsystemSleepState
* as defined in:
* hardware/interfaces/power/1.0/types.hal
* hardware/interfaces/power/1.1/types.hal
* If power.stats HAL is available, this includes PowerEntityStateResidencyResult
* as defined in:
* hardware/interfaces/power/stats/1.0/types.hal
*/
message SubsystemSleepState {
// Subsystem name
optional string subsystem_name = 1;
// For PlatformLowPowerStats (hal 1.0), this is the voter name, which could be empty.
// For SubsystemLowPowerStats (hal 1.1), this is the sleep state name.
// For PowerEntityStateResidencyResult (hal power/stats/1.0) this is the
// powerEntityStateName from the corresponding PowerEntityStateInfo.
optional string subname = 2;
// The number of times it entered, or voted for entering the sleep state
optional uint64 count = 3;
// The length of time spent in, or spent voting for, the sleep state
optional uint64 time_millis = 4;
}
/**
* Pulls on-device power measurement information.
* Data defined by hardware/interfaces/power/stats/1.0/types.hal.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/PowerStatsPuller.cpp
*/
message OnDevicePowerMeasurement {
// Name of the subsystem (to which the rail belongs).
optional string subsystem_name = 1;
// Rail name. The rail lies within the subsystem.
optional string rail_name = 2;
// Time (in ms since boot) at which the rail energy value was measured.
// This may differ slightly from the time that statsd logs this information.
optional uint64 measurement_timestamp_millis = 3;
// Accumulated energy used via the rail since device boot in uWs.
optional uint64 energy_microwatt_secs = 4;
}
/**
* Pulls Cpu time per frequency.
* Pulls the time the cpu spend on the frequency index. Frequency index
* starts from highest to lowest. The value should be monotonically
* increasing since boot. However, if there is a cpu
* hotplug event, the value would be reset as well.
*/
message CpuTimePerFreq {
optional uint32 cluster = 1;
optional uint32 freq_index = 2;
optional uint64 time_millis = 3;
}
/**
* Pulls Cpu Time Per Uid.
* Note that isolated process uid time should be attributed to host uids.
*/
message CpuTimePerUid {
optional int32 uid = 1 [(is_uid) = true];
optional uint64 user_time_micros = 2;
optional uint64 sys_time_micros = 3;
}
/**
* Pulls Cpu Time Per Uid per frequency.
* Note that isolated process uid time should be attributed to host uids.
* For each uid, we order the time by descending frequencies.
*/
message CpuTimePerUidFreq {
optional int32 uid = 1 [(is_uid) = true];
optional uint32 freq_index = 2;
optional uint64 time_millis = 3;
}
/**
* Pulls Wifi Controller Activity Energy Info
*/
message WifiActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// stack reported state
// TODO: replace this with proto enum
optional int32 stack_state = 2;
// tx time in millis
optional uint64 controller_tx_time_millis = 3;
// rx time in millis
optional uint64 controller_rx_time_millis = 4;
// idle time in millis
optional uint64 controller_idle_time_millis = 5;
// product of current(mA), voltage(V) and time(ms)
optional uint64 controller_energy_used = 6;
}
/**
* Pulls Modem Activity Energy Info
*/
message ModemActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// sleep time in millis.
optional uint64 sleep_time_millis = 2;
// idle time in millis
optional uint64 controller_idle_time_millis = 3;
/**
* Tx power index
* index 0 = tx_power < 0dBm
* index 1 = 0dBm < tx_power < 5dBm
* index 2 = 5dBm < tx_power < 15dBm
* index 3 = 15dBm < tx_power < 20dBm
* index 4 = tx_power > 20dBm
*/
// tx time in ms at power level 0
optional uint64 controller_tx_time_pl0_millis = 4;
// tx time in ms at power level 1
optional uint64 controller_tx_time_pl1_millis = 5;
// tx time in ms at power level 2
optional uint64 controller_tx_time_pl2_millis = 6;
// tx time in ms at power level 3
optional uint64 controller_tx_time_pl3_millis = 7;
// tx time in ms at power level 4
optional uint64 controller_tx_time_pl4_millis = 8;
// rx time in ms at power level 5
optional uint64 controller_rx_time_millis = 9;
// product of current(mA), voltage(V) and time(ms)
optional uint64 energy_used = 10;
}
/**
* Pulls Bluetooth Activity Energy Info
* Note: BluetoothBytesTransfer is pulled at the same time from the controller.
*/
message BluetoothActivityInfo {
// timestamp(wall clock) of record creation
optional uint64 timestamp_millis = 1;
// bluetooth stack state
optional int32 bluetooth_stack_state = 2;
// tx time in millis
optional uint64 controller_tx_time_millis = 3;
// rx time in millis
optional uint64 controller_rx_time_millis = 4;
// idle time in millis
optional uint64 controller_idle_time_millis = 5;
// product of current(mA), voltage(V) and time(ms)
optional uint64 energy_used = 6;
}
/*
* Logs the memory stats for a process.
*
* Pulled from StatsCompanionService for all managed processes (from ActivityManagerService).
*/
message ProcessMemoryState {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Usually package name, "system" for system server.
// Provided by ActivityManagerService.
optional string process_name = 2;
// Current OOM score adjustment. Value read from ProcessRecord.
optional int32 oom_adj_score = 3;
// # of page-faults
optional int64 page_fault = 4;
// # of major page-faults
optional int64 page_major_fault = 5;
// RSS
// Value is read from /proc/PID/stat, field 24. Or from memory.stat, field
// total_rss if per-app memory cgroups are enabled.
optional int64 rss_in_bytes = 6;
// CACHE
// Value is read from memory.stat, field total_cache if per-app memory
// cgroups are enabled. Otherwise, 0.
optional int64 cache_in_bytes = 7;
// SWAP
// Value is read from memory.stat, field total_swap if per-app memory
// cgroups are enabled. Otherwise, 0.
optional int64 swap_in_bytes = 8;
// Deprecated: use ProcessMemoryHighWaterMark atom instead. Always 0.
optional int64 rss_high_watermark_in_bytes = 9 [deprecated = true];
// Elapsed real time when the process started.
// Value is read from /proc/PID/stat, field 22. 0 if read from per-app memory cgroups.
optional int64 start_time_nanos = 10;
}
/*
* Logs the memory stats for a native process (from procfs).
*
* Pulled from StatsCompanionService for selected native processes.
*/
message NativeProcessMemoryState {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Value read from /proc/PID/cmdline.
optional string process_name = 2;
// # of page-faults
optional int64 page_fault = 3;
// # of major page-faults
optional int64 page_major_fault = 4;
// RSS
// Value read from /proc/PID/stat, field 24.
optional int64 rss_in_bytes = 5;
// Deprecated: use ProcessMemoryHighWaterMark atom instead. Always 0.
optional int64 rss_high_watermark_in_bytes = 6 [deprecated = true];
// Elapsed real time when the process started.
// Value is read from /proc/PID/stat, field 22.
optional int64 start_time_nanos = 7;
}
/*
* Logs the memory high-water mark for a process.
*
* Pulled from StatsCompanionService for all managed processes (from ActivityManagerServie)
* and for selected native processes.
*
* Pulling this atom resets high-water mark counters for all processes.
*/
message ProcessMemoryHighWaterMark {
// The uid if available. -1 means not available.
optional int32 uid = 1 [(is_uid) = true];
// The process name.
// Usually package name or process cmdline.
// Provided by ActivityManagerService or read from /proc/PID/cmdline.
optional string process_name = 2;
// RSS high-water mark. Peak RSS usage of the process. Read from the VmHWM field in
// /proc/PID/status.
optional int64 rss_high_water_mark_in_bytes = 3;
}
/*
* Elapsed real time from SystemClock.
*/
message SystemElapsedRealtime {
optional uint64 time_millis = 1;
}
/*
* Up time from SystemClock.
*/
message SystemUptime {
// Milliseconds since the system was booted.
// This clock stops when the system enters deep sleep (CPU off, display dark, device waiting
// for external input).
// It is not affected by clock scaling, idle, or other power saving mechanisms.
optional uint64 uptime_millis = 1;
}
/*
* Reads from /proc/uid_concurrent_active_time which has the format:
* active: X (X is # cores)
* [uid0]: [time-0] [time-1] [time-2] ... (# entries = # cores)
* [uid1]: [time-0] [time-1] [time-2] ... ...
* ...
* Time-N means the CPU time a UID spent running concurrently with N other processes.
* The file contains a monotonically increasing count of time for a single boot.
*/
message CpuActiveTime {
optional int32 uid = 1 [(is_uid) = true];
optional uint64 time_millis = 2;
}
/**
* Reads from /proc/uid_concurrent_policy_time which has the format:
* policy0: X policy4: Y (there are X cores on policy0, Y cores on policy4)
* [uid0]: [time-0-0] [time-0-1] ... [time-1-0] [time-1-1] ...
* [uid1]: [time-0-0] [time-0-1] ... [time-1-0] [time-1-1] ...
* ...
* Time-X-Y means the time a UID spent on clusterX running concurrently with Y other processes.
* The file contains a monotonically increasing count of time for a single boot.
*/
message CpuClusterTime {
optional int32 uid = 1 [(is_uid) = true];
optional int32 cluster_index = 2;
optional uint64 time_millis = 3;
}
/*
* Pulls free disk space, for data, system partition and temporary directory.
*/
message DiskSpace {
// available bytes in data partition
optional uint64 data_available_bytes = 1;
// available bytes in system partition
optional uint64 system_available_bytes = 2;
// available bytes in download cache or temp directories
optional uint64 temp_available_bytes = 3;
}
/**
* Pulls battery coulomb counter, which is the remaining battery charge in uAh.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message RemainingBatteryCapacity {
optional int32 charge_micro_ampere_hour = 1;
}
/**
* Pulls battery capacity, which is the battery capacity when full in uAh.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message FullBatteryCapacity {
optional int32 capacity_micro_ampere_hour = 1;
}
/**
* Pulls battery voltage.
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message BatteryVoltage {
// The voltage of the battery, in millivolts.
optional int32 voltage_millivolt = 1;
}
/**
* Pulls battery level (percent full, from 0 to 100).
*
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceHealthManagerPuller.cpp
*/
message BatteryLevel {
// Battery level. Should be in [0, 100].
optional int32 battery_level = 1;
}
/**
* Pulls the temperature of various parts of the device.
* The units are tenths of a degree Celsius. Eg: 30.3C is reported as 303.
*
* Pulled from:
* frameworks/base/cmds/statsd/src/external/ResourceThermalManagerPuller.cpp
*/
message Temperature {
// The type of temperature being reported. Eg. CPU, GPU, SKIN, BATTERY.
optional android.os.TemperatureTypeEnum sensor_location = 1;
// The name of the temperature source. Eg. CPU0
optional string sensor_name = 2;
// Temperature in tenths of a degree C.
optional int32 temperature_deci_celsius = 3;
}
/**
* Pulls the statistics of calls to Binder.
*
* Binder stats will be reset every time the data is pulled. It means it can only be pulled by one
* config on the device.
*
* Next tag: 15
*/
message BinderCalls {
// UID of the process responsible for the binder transaction. It will be set if the process
// executing the binder transaction attribute the transaction to another uid using
// Binder.setThreadWorkSource().
//
// If not set, the value will be -1.
optional int32 uid = 1 [(is_uid) = true];
// UID of the process executing the binder transaction.
optional int32 direct_caller_uid = 14;
// Fully qualified class name of the API call.
//
// This is a system server class name.
//
// TODO(gaillard): figure out if binder call stats includes data from isolated uids, if a uid
// gets recycled and we have isolated uids, we might attribute the data incorrectly.
// TODO(gaillard): there is a high dimensions cardinality, figure out if we should drop the less
// commonly used APIs.
optional string service_class_name = 2;
// Method name of the API call. It can also be a transaction code if we cannot
// resolve it to a name. See Binder#getTransactionName.
//
// This is a system server method name.
optional string service_method_name = 3;
// Total number of API calls.
optional int64 call_count = 4;
// True if the screen was interactive PowerManager#isInteractive at the end of the call.
optional bool screen_interactive = 13;
// Total number of API calls we have data recorded for. If we collected data for all the calls,
// call_count will be equal to recorded_call_count.
//
// If recorded_call_count is different than call_count, it means data collection has been
// sampled. All the fields below will be sampled in this case.
optional int64 recorded_call_count = 12;
// Number of exceptions thrown by the API.
optional int64 recorded_exception_count = 5;
// Total latency of all API calls.
// Average can be computed using total_latency_micros / recorded_call_count.
optional int64 recorded_total_latency_micros = 6;
// Maximum latency of one API call.
optional int64 recorded_max_latency_micros = 7;
// Total CPU usage of all API calls.
// Average can be computed using total_cpu_micros / recorded_call_count.
// Total can be computed using total_cpu_micros / recorded_call_count * call_count.
optional int64 recorded_total_cpu_micros = 8;
// Maximum CPU usage of one API call.
optional int64 recorded_max_cpu_micros = 9;
// Maximum parcel reply size of one API call.
optional int64 recorded_max_reply_size_bytes = 10;
// Maximum parcel request size of one API call.
optional int64 recorded_max_request_size_bytes = 11;
}
/**
* Pulls the statistics of exceptions during calls to Binder.
*
* Binder stats are cumulative from boot unless somebody reset the data using
* > adb shell dumpsys binder_calls_stats --reset
*/
message BinderCallsExceptions {
// Exception class name, e.g. java.lang.IllegalArgumentException.
//
// This is an exception class name thrown by the system server.
optional string exception_class_name = 1;
// Total number of exceptions.
optional int64 exception_count = 2;
}
/**
* Pulls the statistics of message dispatching on HandlerThreads.
*
* Looper stats will be reset every time the data is pulled. It means it can only be pulled by one
* config on the device.
*
* Next tag: 11
*/
message LooperStats {
// The uid that made a call to the System Server and caused the message to be enqueued.
optional int32 uid = 1 [(is_uid) = true];
// Fully qualified class name of the handler target class.
//
// This field does not contain PII. This is a system server class name.
optional string handler_class_name = 2;
// The name of the thread that runs the Looper.
//
// This field does not contain PII. This is a system server thread name.
optional string looper_thread_name = 3;
// The name of the dispatched message.
//
// This field does not contain PII. This is a system server constant or class
// name.
optional string message_name = 4;
// Total number of successfully dispatched messages.
optional int64 message_count = 5;
// Total number of messages that failed dispatching.
optional int64 exception_count = 6;
// Total number of processed messages we have data recorded for. If we
// collected data for all the messages, message_count will be equal to
// recorded_message_count.
//
// If recorded_message_count is different than message_count, it means data
// collection has been sampled. The fields below will be sampled in this case.
optional int64 recorded_message_count = 7;
// Total latency of all processed messages.
// Average can be computed using recorded_total_latency_micros /
// recorded_message_count.
optional int64 recorded_total_latency_micros = 8;
// Total CPU usage of all processed message.
// Average can be computed using recorded_total_cpu_micros /
// recorded_message_count. Total can be computed using
// recorded_total_cpu_micros / recorded_message_count * message_count.
optional int64 recorded_total_cpu_micros = 9;
// True if the screen was interactive PowerManager#isInteractive at the end of the call.
optional bool screen_interactive = 10;
// Max recorded CPU usage of all processed messages.
optional int64 recorded_max_cpu_micros = 11;
// Max recorded latency of all processed messages.
optional int64 recorded_max_latency_micros = 12;
// Total number of messages we tracked the dispatching delay for. If we
// collected data for all the messages, message_count will be equal to
// recorded_delay_message_count.
//
// If recorded_delay_message_count is different than message_count, it means data
// collection has been sampled or/and not all messages specified the target dispatch time.
// The fields below will be sampled in this case.
optional int64 recorded_delay_message_count = 13;
// Total dispatching delay of all processed messages.
// Calculated as a difference between the target dispatching time (Message.when)
// and the actual dispatching time.
// Average can be computed using recorded_total_delay_millis / recorded_delay_message_count.
optional int64 recorded_total_delay_millis = 14;
// Max dispatching delay of all processed messages.
// Calculated as a difference between the target dispatching time (Message.when)
// and the actual dispatching time.
optional int64 recorded_max_delay_millis = 15;
}
/**
* Pulls disk information, such as write speed and latency.
*/
message DiskStats {
// Time taken to open, write 512B to, and close a file.
// -1 if error performing the check.
optional int64 data_write_latency_millis = 1;
optional bool file_based_encryption = 2;
// Recent disk write speed in kB/s.
// -1 if error querying storageed.
// 0 if data is unavailable.
optional int32 recent_disk_write_speed = 3;
}
/**
* Free and total bytes of the Data, Cache, and System partition.
*/
message DirectoryUsage {
enum Directory {
UNKNOWN = 0;
DATA = 1;
CACHE = 2;
SYSTEM = 3;
}
optional Directory directory = 1;
optional int64 free_bytes = 2;
optional int64 total_bytes = 3;
}
/**
* Size of an application: apk size, data size, and cache size.
* Reads from a cached file produced daily by DiskStatsLoggingService.java.
* Information is only reported for apps with the primary user (user 0).
* Sizes are aggregated by package name.
*/
message AppSize {
// Including uids will involve modifying diskstats logic.
optional string package_name = 1;
// App size in bytes. -1 if unavailable.
optional int64 app_size_bytes = 2;
// App data size in bytes. -1 if unavailable.
optional int64 app_data_size_bytes = 3;
// App cache size in bytes. -1 if unavailable.
optional int64 app_cache_size_bytes = 4;
// Time that the cache file was produced.
// Uses System.currentTimeMillis(), which is wall clock time.
optional int64 cache_time_millis = 5;
}
/**
* Size of a particular category. Eg: photos, videos.
* Reads from a cached file produced daily by DiskStatsLoggingService.java.
*/
message CategorySize {
enum Category {
UNKNOWN = 0;
APP_SIZE = 1;
APP_DATA_SIZE = 2;
APP_CACHE_SIZE = 3;
PHOTOS = 4;
VIDEOS = 5;
AUDIO = 6;
DOWNLOADS = 7;
SYSTEM = 8;
OTHER = 9;
}
optional Category category = 1;
// Category size in bytes.
optional int64 size_bytes = 2;
// Time that the cache file was produced.
// Uses System.currentTimeMillis(), which is wall clock time.
optional int64 cache_time_millis = 3;
}
/**
* Pulls per uid I/O stats. The stats are cumulative since boot.
*
* Read/write bytes are I/O events from a storage device
* Read/write chars are data requested by read/write syscalls, and can be
* satisfied by caching.
*
* Pulled from StatsCompanionService, which reads proc/uid_io/stats.
*/
message DiskIo {
optional int32 uid = 1 [(is_uid) = true];
optional int64 fg_chars_read = 2;
optional int64 fg_chars_write = 3;
optional int64 fg_bytes_read = 4;
optional int64 fg_bytes_write = 5;
optional int64 bg_chars_read = 6;
optional int64 bg_chars_write = 7;
optional int64 bg_bytes_read = 8;
optional int64 bg_bytes_write = 9;
optional int64 fg_fsync = 10;
optional int64 bg_fsync= 11;
}
/**
* Pulls the number of fingerprints for each user.
*
* Pulled from StatsCompanionService, which queries FingerprintManager.
*/
message NumFingerprints {
// The associated user. Eg: 0 for owners, 10+ for others.
// Defined in android/os/UserHandle.java
optional int32 user = 1;
// Number of fingerprints registered to that user.
optional int32 num_fingerprints = 2;
}
message AggStats {
optional int64 min = 1;
optional int64 average = 2;
optional int64 max = 3;
}
message ProcessStatsStateProto {
optional android.service.procstats.ScreenState screen_state = 1;
optional android.service.procstats.MemoryState memory_state = 2;
// this enum list is from frameworks/base/core/java/com/android/internal/app/procstats/ProcessStats.java
// and not frameworks/base/core/java/android/app/ActivityManager.java
optional android.service.procstats.ProcessState process_state = 3;
// Millisecond uptime duration spent in this state
optional int64 duration_millis = 4;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_millis = 9;
// # of samples taken
optional int32 sample_size = 5;
// PSS is memory reserved for this process
optional AggStats pss = 6;
// USS is memory shared between processes, divided evenly for accounting
optional AggStats uss = 7;
// RSS is memory resident for this process
optional AggStats rss = 8;
}
// Next Tag: 7
message ProcessStatsProto {
// Name of process.
optional string process = 1;
// Uid of the process.
optional int32 uid = 2;
// Information about how often kills occurred
message Kill {
// Count of excessive CPU kills
optional int32 cpu = 1;
// Count of kills when cached
optional int32 cached = 2;
// PSS stats during cached kill
optional AggStats cached_pss = 3;
}
optional Kill kill = 3;
// Time and memory spent in various states.
repeated ProcessStatsStateProto states = 5;
// Total time process has been running... screen_state, memory_state, and process_state
// will not be set.
optional ProcessStatsStateProto total_running_state = 6;
}
message PackageServiceOperationStatsProto {
// Operate enum: Started, Foreground, Bound, Executing
optional android.service.procstats.ServiceOperationState operation = 1;
// Number of times the service was in this operation.
optional int32 count = 2;
// Information about a state the service can be in.
message StateStats {
// Screen state enum.
optional android.service.procstats.ScreenState screen_state = 1;
// Memory state enum.
optional android.service.procstats.MemoryState memory_state = 2;
// duration in milliseconds.
optional int64 duration_millis = 3;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_millis = 4;
}
repeated StateStats state_stats = 3;
}
message PackageServiceStatsProto {
// Name of service component.
optional string service_name = 1;
// The operation stats.
// The package_name, package_uid, package_version, service_name will not be set to save space.
repeated PackageServiceOperationStatsProto operation_stats = 2;
}
message PackageAssociationSourceProcessStatsProto {
// Uid of the process.
optional int32 process_uid = 1;
// Process name.
optional string process_name = 2;
// Total count of the times this association appeared.
optional int32 total_count = 3;
// Millisecond uptime total duration this association was around.
optional int64 total_duration_millis = 4;
// Total count of the times this association became actively impacting its target process.
optional int32 active_count = 5;
// Information on one source in this association.
message StateStats {
// Process state enum.
optional android.service.procstats.ProcessState process_state = 1;
// Millisecond uptime duration spent in this state
optional int64 duration_millis = 2;
// Millisecond elapsed realtime duration spent in this state
optional int64 realtime_duration_mmillis = 3;
}
repeated StateStats active_state_stats = 6;
}
message PackageAssociationProcessStatsProto {
// Name of the target component.
optional string component_name = 1;
// Information on one source in this association.
repeated PackageAssociationSourceProcessStatsProto sources = 2;
}
message ProcessStatsPackageProto {
// Name of package.
optional string package = 1;
// Uid of the package.
optional int32 uid = 2;
// Version of the package.
optional int64 version = 3;
// Stats for each process running with the package loaded in to it.
repeated ProcessStatsProto process_stats = 4;
// Stats for each of the package's services.
repeated PackageServiceStatsProto service_stats = 5;
// Stats for each association with the package.
repeated PackageAssociationProcessStatsProto association_stats = 6;
}
message ProcessStatsSectionProto {
// Elapsed realtime at start of report.
optional int64 start_realtime_millis = 1;
// Elapsed realtime at end of report.
optional int64 end_realtime_millis = 2;
// CPU uptime at start of report.
optional int64 start_uptime_millis = 3;
// CPU uptime at end of report.
optional int64 end_uptime_millis = 4;
// System runtime library. e.g. "libdvm.so", "libart.so".
optional string runtime = 5;
// whether kernel reports swapped pss.
optional bool has_swapped_pss = 6;
// Data completeness. e.g. "complete", "partial", shutdown", or "sysprops".
enum Status {
STATUS_UNKNOWN = 0;
STATUS_COMPLETE = 1;
STATUS_PARTIAL = 2;
STATUS_SHUTDOWN = 3;
STATUS_SYSPROPS = 4;
}
repeated Status status = 7;
// Stats for each process.
repeated ProcessStatsProto process_stats = 8;
// Stats for each package.
repeated ProcessStatsPackageProto package_stats = 9;
}
/**
* Pulled from ProcessStatsService.java
*/
message ProcStats {
optional ProcessStatsSectionProto proc_stats_section = 1;
}
message PowerProfileProto {
optional double cpu_suspend = 1;
optional double cpu_idle = 2;
optional double cpu_active = 3;
message CpuCluster {
optional int32 id = 1;
optional double cluster_power = 2;
optional int32 cores = 3;
repeated int64 speed = 4;
repeated double core_power = 5;
}
repeated CpuCluster cpu_cluster = 40;
optional double wifi_scan = 4;
optional double wifi_on = 5;
optional double wifi_active = 6;
optional double wifi_controller_idle = 7;
optional double wifi_controller_rx = 8;
optional double wifi_controller_tx = 9;
repeated double wifi_controller_tx_levels = 10;
optional double wifi_controller_operating_voltage = 11;
optional double bluetooth_controller_idle = 12;
optional double bluetooth_controller_rx = 13;
optional double bluetooth_controller_tx = 14;
optional double bluetooth_controller_operating_voltage = 15;
optional double modem_controller_sleep = 16;
optional double modem_controller_idle = 17;
optional double modem_controller_rx = 18;
repeated double modem_controller_tx = 19;
optional double modem_controller_operating_voltage = 20;
optional double gps_on = 21;
repeated double gps_signal_quality_based = 22;
optional double gps_operating_voltage = 23;
optional double bluetooth_on = 24;
optional double bluetooth_active = 25;
optional double bluetooth_at_cmd = 26;
optional double ambient_display = 27;
optional double screen_on = 28;
optional double radio_on = 29;
optional double radio_scanning = 30;
optional double radio_active = 31;
optional double screen_full = 32;
optional double audio = 33;
optional double video = 34;
optional double flashlight = 35;
optional double memory = 36;
optional double camera = 37;
optional double wifi_batched_scan = 38;
optional double battery_capacity = 39;
}
/**
* power_profile.xml and other constants for power model calculations.
* Pulled from PowerProfile.java
*/
message PowerProfile {
optional PowerProfileProto power_profile = 1;
}
/**
* Logs when a user restriction was added or removed.
*
* Logged from:
* frameworks/base/services/devicepolicy/java/com/android/server/devicepolicy/DevicePolicyManagerService.java
*/
message UserRestrictionChanged {
// The raw string of the user restriction as defined in UserManager.
// Allowed values are defined in UserRestrictionsUtils#USER_RESTRICTIONS.
optional string restriction = 1;
// Whether the restriction is enabled or disabled.
optional bool enabled = 2;
}
/**
* Pulls process user time and system time. Puller takes a snapshot of all pids
* in the system and returns cpu stats for those that are working at the time.
* Dead pids will be dropped. Kernel processes are excluded.
* Min cool-down is 5 sec.
*/
message ProcessCpuTime {
optional int32 uid = 1 [(is_uid) = true];
optional string process_name = 2;
// Process cpu time in user space, cumulative from boot/process start
optional int64 user_time_millis = 3;
// Process cpu time in system space, cumulative from boot/process start
optional int64 system_time_millis = 4;
}
/**
* Pulls the CPU usage for each thread.
*
* Read from /proc/$PID/task/$TID/time_in_state files.
*
* TODO(mishaw): This is an experimental atom. Issues with big/little CPU frequencies, and
* time_in_state files not being present on some phones, have not been addressed. These should be
* considered before a public release.
*/
message CpuTimePerThreadFreq {
// UID that owns the process.
optional int32 uid = 1 [(is_uid) = true];
// ID of the process.
optional int32 process_id = 2;
// ID of the thread.
optional int32 thread_id = 3;
// Name of the process taken from `/proc/$PID/cmdline`.
optional string process_name = 4;
// Name of the thread taken from `/proc/$PID/task/$TID/comm`
optional string thread_name = 5;
// Report eight different frequencies, and how much time is spent in each frequency. Frequencies
// are given in KHz, and time is given in milliseconds since the thread started. All eight
// frequencies are given here as the alternative is sending eight separate atoms. This method
// significantly reduces the amount of data created
optional int32 frequency1_khz = 6;
optional int32 time1_millis = 7;
optional int32 frequency2_khz = 8;
optional int32 time2_millis = 9;
optional int32 frequency3_khz = 10;
optional int32 time3_millis = 11;
optional int32 frequency4_khz = 12;
optional int32 time4_millis = 13;
optional int32 frequency5_khz = 14;
optional int32 time5_millis = 15;
optional int32 frequency6_khz = 16;
optional int32 time6_millis = 17;
optional int32 frequency7_khz = 18;
optional int32 time7_millis = 19;
optional int32 frequency8_khz = 20;
optional int32 time8_millis = 21;
}
/**
* Pulls information about the device's build.
*/
message BuildInformation {
// Build.FINGERPRINT. A string that uniquely identifies this build. Do not parse.
// E.g. may be composed of the brand, product, device, release, id, incremental, type, and tags.
optional string fingerprint = 1;
// Build.BRAND. The consumer-visible brand with which the product/hardware will be associated.
optional string brand = 2;
// Build.PRODUCT. The name of the overall product.
optional string product = 3;
// Build.DEVICE. The name of the industrial design.
optional string device = 4;
// Build.VERSION.RELEASE. The user-visible version string. E.g., "1.0" or "3.4b5" or "bananas".
optional string version_release = 5;
// Build.ID. E.g. a label like "M4-rc20".
optional string id = 6;
// Build.VERSION.INCREMENTAL. The internal value used by the underlying source control to
// represent this build.
optional string version_incremental = 7;
// Build.TYPE. The type of build, like "user" or "eng".
optional string type = 8;
// Build.TAGS. Comma-separated tags describing the build, like "unsigned,debug".
optional string tags = 9;
}
/**
* Pulls on-device BatteryStats power use calculations for the overall device.
*/
message DeviceCalculatedPowerUse {
// Power used by the device in mAh, as computed by BatteryStats, since BatteryStats last reset
// (i.e. roughly since device was last significantly charged).
// Currently, this is BatteryStatsHelper.getComputedPower() (not getTotalPower()).
optional float computed_power_milli_amp_hours = 1;
}
/**
* Pulls on-device BatteryStats power use calculations broken down by uid.
* This atom should be complemented by DeviceCalculatedPowerBlameOther, which contains the power use
* that is attributed to non-uid items. They must all be included to get the total power use.
*/
message DeviceCalculatedPowerBlameUid {
// Uid being blamed. Note: isolated uids have already been mapped to host uid.
optional int32 uid = 1 [(is_uid) = true];
// Power used by this uid in mAh, as computed by BatteryStats, since BatteryStats last reset
// (i.e. roughly since device was last significantly charged).
optional float power_milli_amp_hours = 2;
}
/**
* Pulls on-device BatteryStats power use calculations that are not due to a uid, broken down by
* drain type.
* This atom should be complemented by DeviceCalculatedPowerBlameUid, which contains the blame that
* is attributed uids. They must all be included to get the total power use.
*/
message DeviceCalculatedPowerBlameOther {
// The type of item whose power use is being reported.
enum DrainType {
AMBIENT_DISPLAY = 0;
// reserved 1; reserved "APP"; // Logged instead in DeviceCalculatedPowerBlameUid.
BLUETOOTH = 2;
CAMERA = 3;
// Cell-standby
CELL = 4;
FLASHLIGHT = 5;
IDLE = 6;
MEMORY = 7;
// Amount that total computed drain exceeded the drain estimated using the
// battery level changes and capacity.
OVERCOUNTED = 8;
PHONE = 9;
SCREEN = 10;
// Amount that total computed drain was below the drain estimated using the
// battery level changes and capacity.
UNACCOUNTED = 11;
// reserved 12; reserved "USER"; // Entire drain for a user. This is NOT supported.
WIFI = 13;
}
optional DrainType drain_type = 1;
// Power used by this item in mAh, as computed by BatteryStats, since BatteryStats last reset
// (i.e. roughly since device was last significantly charged).
optional float power_milli_amp_hours = 2;
}
/**
* Logs device policy features.
*
* Logged from:
* frameworks/base/services/devicepolicy/java/com/android/server/devicepolicy/DevicePolicyManagerService.java
* packages/apps/ManagedProvisioning/src/com/android/managedprovisioning/
*/
message DevicePolicyEvent {
// The event id - unique for each event.
optional android.stats.devicepolicy.EventId event_id = 1;
// The admin package name.
optional string admin_package_name = 2;
// A generic integer parameter.
optional int32 integer_value = 3;
// A generic boolean parameter.
optional bool boolean_value = 4;
// A parameter specifying a time period in milliseconds.
optional uint64 time_period_millis = 5;
// A parameter specifying a list of package names, bundle extras or string parameters.
optional android.stats.devicepolicy.StringList string_list_value = 6 [(log_mode) = MODE_BYTES];
}
/**
* Logs when DocumentsUI is started, and how. Call this when DocumentsUI first starts up.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUILaunchReported {
optional android.stats.docsui.LaunchAction launch_action = 1;
optional bool has_initial_uri = 2;
optional android.stats.docsui.MimeType mime_type = 3;
optional android.stats.docsui.Root initial_root = 4;
}
/**
* Logs root/app visited event in file managers/picker. Call this when the user
* taps on root/app in hamburger menu.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIRootVisitedReported {
optional android.stats.docsui.ContextScope scope = 1;
optional android.stats.docsui.Root root = 2;
}
/**
* Logs file operation stats. Call this when a file operation has completed.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationReported {
optional android.stats.docsui.Provider provider = 1;
optional android.stats.docsui.FileOperation file_op = 2;
}
/**
* Logs file operation stats. Call this when a copy/move operation has completed with a specific
* mode.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationCopyMoveModeReported {
optional android.stats.docsui.FileOperation file_op = 1;
optional android.stats.docsui.CopyMoveOpMode mode = 2;
}
/**
* Logs file sub operation stats. Call this when a file operation has failed.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationFailureReported {
optional android.stats.docsui.Authority authority = 1;
optional android.stats.docsui.SubFileOperation sub_op = 2;
}
/**
* Logs the cancellation of a file operation. Call this when a job is canceled
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIFileOperationCanceledReported {
optional android.stats.docsui.FileOperation file_op = 1;
}
/**
* Logs startup time in milliseconds.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIStartupMsReported {
optional int32 startup_millis = 1;
}
/**
* Logs the action that was started by user.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/Metrics.java
*/
message DocsUIUserActionReported {
optional android.stats.docsui.UserAction action = 1;
}
/**
* Logs the invalid type when invalid scoped access is requested.
*
* Logged from:
* package/app/DocumentsUI/src/com/android/documentsui/ScopedAccessMetrics.java
*/
message DocsUIInvalidScopedAccessRequestReported {
optional android.stats.docsui.InvalidScopedAccess type = 1;
}