TraceConfig

The overall config that is used when starting a new tracing session through ProducerPort::StartTracing(). It contains the general config for the logging buffer(s) and the configs for all the data source being enabled.

Defined in trace_config.proto

Fields:

Field	Type	Description
buffers	BufferConfig[]
data_sources	DataSource[]
builtin_data_sources	BuiltinDataSource
duration_ms	uint32	If specified, the trace will be stopped `duration_ms` after starting. This does not count the time the system is suspended, so we will run for duration_ms of system activity, not wall time. However in case of traces with triggers, see TriggerConfig.trigger_timeout_ms instead.
prefer_suspend_clock_for_duration	bool	If true, tries to use CLOCK_BOOTTIME for duration_ms rather than CLOCK_MONOTONIC (which doesn't count time in suspend). Supported only on Linux/Android, no-op on other platforms. This is used when dealing with long (e.g. 24h) traces, where suspend can inflate them to weeks of wall-time, making them more likely to hit device reboots (and hence loss). This option also changes consistently the semantic of TrigerConfig.stop_delay_ms.
enable_extra_guardrails	bool	This is set when --dropbox is passed to the Perfetto command line client and enables guardrails that limit resource usage for traces requested by statsd.
lockdown_mode	LockdownModeOperation	Reject producers that are not running under the same UID as the tracing service.
producers	ProducerConfig[]
statsd_metadata	StatsdMetadata	Statsd-specific metadata.
write_into_file	bool	When true && `output_path` is empty, the EnableTracing() request must provide a file descriptor. The service will then periodically read packets out of the trace buffer and store it into the passed file. If `output_path` is not empty no fd should be passed, the service will create a new file and write into that (see comment below).
output_path	string	This must point to a non-existing file. If the file exists the service will NOT overwrite and will fail instead as a security precaution. On Android, when this is used with the system traced, the path must be within /data/misc/perfetto-traces/ or the trace will fail. This option has been introduced in Android R. Before R write_into_file can be used only with the "pass a file descriptor over IPC" mode.
file_write_period_ms	uint32	Optional. If non-zero tunes the write period. A min value of 100ms is enforced (i.e. smaller values are ignored).
max_file_size_bytes	uint64	Optional. When non zero the periodic write stops once at most X bytes have been written into the file. Tracing is disabled when this limit is reached, even if `duration_ms` has not been reached yet.
guardrail_overrides	GuardrailOverrides
deferred_start	bool	When true, data sources are not started until an explicit call to StartTracing() on the consumer port. This is to support early initialization and fast trace triggering. This can be used only when the Consumer explicitly triggers the StartTracing() method. This should not be used in a remote trace config via statsd, doing so will result in a hung trace session.
flush_period_ms	uint32	When set, it periodically issues a Flush() to all data source, forcing them to commit their data into the tracing service. This can be used for quasi-real-time streaming mode and to guarantee some partial ordering of events in the trace in windows of X ms.
flush_timeout_ms	uint32	Wait for this long for producers to acknowledge flush requests. Default 5s.
data_source_stop_timeout_ms	uint32	Wait for this long for producers to acknowledge stop requests. Default 5s.
notify_traceur	bool	Android-only. If set, sends an intent to the Traceur system app when the trace ends to notify it about the trace readiness.
bugreport_score	int32	Android-only. If set to a value > 0, marks the trace session as a candidate for being attached to a bugreport. This field effectively acts as a z-index for bugreports. When Android's dumpstate runs perfetto --save-for-bugreport, traced will pick the tracing session with the highest score (score <= 0 is ignored), will steal its contents, save the trace into a known path and stop prematurely. This field was introduced in Android S.
trigger_config	TriggerConfig
activate_triggers	string[]	When this is non-empty the perfetto command line tool will ignore the rest of this TraceConfig and instead connect to the perfetto service as a producer and send these triggers, potentially stopping or starting traces that were previous configured to use a TriggerConfig.
incremental_state_config	IncrementalStateConfig
allow_user_build_tracing	bool	Additional guardrail used by the Perfetto command line client. On user builds when --dropbox is set perfetto will refuse to trace unless this is also set. Added in Q.
unique_session_name	string	If set the tracing service will ensure there is at most one tracing session with this key.
compression_type	CompressionType
compress_from_cli	bool	Use the legacy codepath that compresses from perfetto_cmd.cc instead of using the new codepath that compresses from tracing_service_impl.cc. This will be removed in the future.
incident_report_config	IncidentReportConfig
statsd_logging	StatsdLogging	Android-only. Not for general use. If specified, sets the logging to statsd of guardrails and checkpoints in the tracing service. perfetto_cmd sets this to enabled (if not explicitly set in the config) when specifying --upload.
trace_uuid_msb	int64	An identifier clients can use to tie this trace to other logging. DEPRECATED as per v32. See TracePacket.trace_uuid for the authoritative Trace UUID. If this field is set, the tracing service will respect the requested UUID (i.e. TracePacket.trace_uuid == this field) but only if gap-less snapshotting is not used.
trace_uuid_lsb	int64
trace_filter	TraceFilter
android_report_config	AndroidReportConfig
cmd_trace_start_delay	CmdTraceStartDelay

TraceConfig.BufferConfig

Defined in trace_config.proto

Fields:

Field	Type	Description
size_kb	uint32
fill_policy	FillPolicy

TraceConfig.BufferConfig.FillPolicy

Defined in trace_config.proto

Enum values:

Name	Value	Description
UNSPECIFIED	0
RING_BUFFER	1	Default behavior. The buffer operates as a conventional ring buffer. If the writer is faster than the reader (or if the reader reads only after tracing is stopped) newly written packets will overwrite old packets.
DISCARD	2	Behaves like RING_BUFFER as long as there is space in the buffer or the reader catches up with the writer. As soon as the writer hits an unread chunk, it stops accepting new data in the buffer.

TraceConfig.DataSource

Defined in trace_config.proto

Fields:

Field	Type	Description
config	protos.DataSourceConfig	Filters and data-source specific config. It contains also the unique name of the data source, the one passed in the DataSourceDescriptor when they register on the service.
producer_name_filter	string[]	Optional. If multiple producers (~processes) expose the same data source and either `producer_name_filter` or `producer_name_regex_filter` is set, the data source is enabled only for producers whose names match any of the filters. `producer_name_filter` has to be an exact match, while `producer_name_regex_filter` is a regular expression. This allows to enable a data source only for specific processes. The "repeated" fields have OR semantics: specifying a filter ["foo", "bar"] will enable data sources on both "foo" and "bar" (if they exist).
producer_name_regex_filter	string[]

DataSourceConfig

The configuration that is passed to each data source when starting tracing.

Defined in data_source_config.proto

Fields:

Field	Type	Description
name	string	Data source unique name, e.g., "linux.ftrace". This must match the name passed by the data source when it registers (see RegisterDataSource()).
target_buffer	uint32	The index of the logging buffer where TracePacket(s) will be stored. This field doesn't make a major difference for the Producer(s). The final logging buffers, in fact, are completely owned by the Service. We just ask the Producer to copy this number into the chunk headers it emits, so that the Service can quickly identify the buffer where to move the chunks into without expensive lookups on its fastpath.
trace_duration_ms	uint32	Set by the service to indicate the duration of the trace. DO NOT SET in consumer as this will be overridden by the service.
prefer_suspend_clock_for_duration	bool	If true, `trace_duration_ms` should count also time in suspend. This is propagated from TraceConfig.prefer_suspend_clock_for_duration.
stop_timeout_ms	uint32	Set by the service to indicate how long it waits after StopDataSource. DO NOT SET in consumer as this will be overridden by the service.
enable_extra_guardrails	bool	Set by the service to indicate whether this tracing session has extra guardrails. DO NOT SET in consumer as this will be overridden by the service.
session_initiator	SessionInitiator	Set by the service to indicate which user initiated this trace. DO NOT SET in consumer as this will be overridden by the service.
tracing_session_id	uint64	Set by the service to indicate which tracing session the data source belongs to. The intended use case for this is checking if two data sources, one of which produces metadata for the other one, belong to the same trace session and hence should be linked together. This field was introduced in Aug 2018 after Android P. DO NOT SET in consumer as this will be overridden by the service.
ftrace_config	FtraceConfig	Data source name: linux.ftrace
inode_file_config	InodeFileConfig	Data source name: linux.inode_file_map
process_stats_config	ProcessStatsConfig	Data source name: linux.process_stats
sys_stats_config	SysStatsConfig	Data source name: linux.sys_stats
heapprofd_config	HeapprofdConfig	Data source name: android.heapprofd Introduced in Android 10.
java_hprof_config	JavaHprofConfig	Data source name: android.java_hprof Introduced in Android 11.
android_power_config	AndroidPowerConfig	Data source name: android.power
android_log_config	AndroidLogConfig	Data source name: android.log
gpu_counter_config	GpuCounterConfig
android_game_intervention_list_config	AndroidGameInterventionListConfig
packages_list_config	PackagesListConfig	Data source name: android.packages_list
perf_event_config	PerfEventConfig	Data source name: linux.perf
vulkan_memory_config	VulkanMemoryConfig	Data source name: vulkan.memory_tracker
track_event_config	TrackEventConfig	Data source name: track_event
android_polled_state_config	AndroidPolledStateConfig	Data source name: android.polled_state
android_system_property_config	AndroidSystemPropertyConfig	Data source name: android.system_property
statsd_tracing_config	StatsdTracingConfig	Data source name: android.statsd
system_info_config	SystemInfoConfig	Data source name: linux.system_info
chrome_config	ChromeConfig	Chrome is special as it doesn't use the perfetto IPC layer. We want to avoid proto serialization and de-serialization there because that would just add extra hops on top of the Mojo ser/des. Instead we auto-generate a C++ class for it so it can pass around plain C++ objets.
interceptor_config	InterceptorConfig	If an interceptor is specified here, packets for this data source will be rerouted to the interceptor instead of the main trace buffer. This can be used, for example, to write trace data into ETW or for logging trace points to the console. Note that interceptors are only supported by data sources registered through the Perfetto SDK API. Data sources that don't use that API (e.g., traced_probes) may not support interception.
network_packet_trace_config	NetworkPacketTraceConfig	Data source name: android.network_packets. Introduced in Android 14 (U).
legacy_config	string	This is a fallback mechanism to send a free-form text config to the producer. In theory this should never be needed. All the code that is part of the platform (i.e. traced service) is supposed to not truncate the trace config proto and propagate unknown fields. However, if anything in the pipeline (client or backend) ends up breaking this forward compat plan, this field will become the escape hatch to allow future data sources to get some meaningful configuration.
for_testing	TestConfig	This field is only used for testing.

DataSourceConfig.SessionInitiator

Defined in data_source_config.proto

Enum values:

Name	Value	Description
SESSION_INITIATOR_UNSPECIFIED	0
SESSION_INITIATOR_TRUSTED_SYSTEM	1	This trace was initiated from a trusted system app has DUMP and USAGE_STATS permission. This system app is expected to not expose the trace to the user of the device. This is determined by checking the UID initiating the trace.

FtraceConfig

Defined in ftrace_config.proto

Fields:

Field	Type	Description
ftrace_events	string[]
atrace_categories	string[]
atrace_apps	string[]
buffer_size_kb	uint32	Per-CPU* buffer size.
drain_period_ms	uint32
compact_sched	CompactSchedConfig
print_filter	PrintFilter
symbolize_ksyms	bool	Enables symbol name resolution against /proc/kallsyms. It requires that either traced_probes is running as root or that kptr_restrict has been manually lowered. It does not disclose KASLR, symbol addresses are mangled.
ksyms_mem_policy	KsymsMemPolicy
initialize_ksyms_synchronously_for_testing	bool	By default the kernel symbolizer is lazily initialized on a deferred task to reduce ftrace's time-to-start-recording. Unfortunately that makes ksyms integration tests hard. This flag forces the kernel symbolizer to be initialized synchronously on the data source start and hence avoiding timing races in tests. DEPRECATED in v28 / Android U. This is now the default behavior, setting it to true is a no-op.
throttle_rss_stat	bool	When this boolean is true AND the ftrace_events contains "kmem/rss_stat", this option causes traced_probes to enable the "kmem/rss_stat_throttled" event instead if present, and fall back to "kmem/rss_stat" if not present. The historical context for this is the following: - Up to Android S (12), the rss_stat was internally throttled in its kernel implementation. - A change introduced in the kernels after S has introduced a new "rss_stat_throttled" making the original "rss_stat" event unthrottled (hence very spammy). - Not all Android T/13 devices will receive a new kernel though, hence we need to deal with both cases. For more context: go/rss-stat-throttled.
disable_generic_events	bool	If true, avoid enabling events that aren't statically known by traced_probes. Otherwise, the default is to emit such events as GenericFtraceEvent protos. Prefer to keep this flag at its default. This was added for Android tracing, where atrace categories and/or atrace HAL requested events can expand to events that aren't of interest to the tracing user. Introduced in: Android T.
syscall_events	string[]	The list of syscalls that should be recorded by sys_{enter,exit} ftrace events. When empty, all syscalls are recorded. If neither sys_{enter,exit} are enabled, this setting has no effect. Example: ["sys_read", "sys_open"]. Introduced in: Android U.
enable_function_graph	bool	If true, enable the "function_graph" kernel tracer that emits events whenever a kernel function is entered and exited (funcgraph_entry/funcgraph_exit). Notes on use: * Requires `symbolize_ksyms` for function name resolution. * Use `function_filters` or `function_graph_roots` to constrain the traced set of functions, otherwise the event bandwidth will be too high for practical use. * The data source might be rejected if there is already a concurrent ftrace data source that does not use function graph itself, as we do not support switching kernel tracers mid-trace. * Requires a kernel compiled with CONFIG_FUNCTION_GRAPH_TRACER. This is enabled if "cat /sys/kernel/tracing/available_tracers" includes "function_graph". Android: * Available only on debuggable builds. * Introduced in: Android U.
function_filters	string[]	Constrains the set of functions traced when `enable_function_graph` is true. Supports globs, e.g. "sched". You can specify multiple filters, in which case all matching functions will be traced. See kernel documentation on ftrace "set_ftrace_filter" file for more details. Android: Available only on debuggable builds. * Introduced in: Android U.
function_graph_roots	string[]	If `enable_function_graph` is true, trace this set of functions and all of its callees. Supports globs. Can be set together with `function_filters`, in which case only callees matching the filter will be traced. If setting both, you most likely want all roots to also be included in `function_filters`. Android: * Available only on debuggable builds. * Introduced in: Android U.
preserve_ftrace_buffer	bool	If true, does not clear ftrace buffers before the start of the program. This makes sense only if this is the first ftrace data source instance created after the daemon has been started. Can be useful for gathering boot traces, if ftrace has been separately configured (e.g. via kernel commandline).
use_monotonic_raw_clock	bool	If true, overrides the default timestamp clock and uses a raw hardware based monotonic clock for getting timestamps. * Introduced in: Android U.
instance_name	string	Caution: under development as of 2023/03/01. If `instance_name` is not empty, then attempt to use that tracefs instance for event recording. Normally, this means `/sys/kernel/tracing/instances/$instance_name`. The name "hyp" is reserved. The instance must already exist, the tracing daemon will not create it for you as it typically doesn't have such permissions. Only a subset of features is guaranteed to work with non-default instances, at the time of writing: * ftrace_events * buffer_size_kb TODO(b/249050813): reword comment once instance support is stable.

FtraceConfig.CompactSchedConfig

Configuration for compact encoding of scheduler events. When enabled (and recording the relevant ftrace events), specific high-volume events are encoded in a denser format than normal.

Defined in ftrace_config.proto

Fields:

Field	Type	Description
enabled	bool	If true, and sched_switch or sched_waking ftrace events are enabled, record those events in the compact format.

FtraceConfig.PrintFilter

Optional filter for "ftrace/print" events.

The filter consists of multiple rules. As soon as a rule matches (the rules are processed in order), its allow field will be used as the outcome: if allow is true, the event will be included in the trace, otherwise it will be discarded. If an event does not match any rule, it will be allowed by default (a rule with an empty prefix and allow=false, disallows everything by default).

Defined in ftrace_config.proto

Fields:

Field	Type	Description
rules	Rule[]

FtraceConfig.PrintFilter.Rule

Defined in ftrace_config.proto

Fields:

Field	Type	Description
prefix	string	This rule matches if `prefix` matches exactly with the beginning of the "ftrace/print" "buf" field.
atrace_msg	AtraceMessage	This rule matches if the "buf" field contains an atrace-style print message as specified in `atrace_msg`.
allow	bool

FtraceConfig.PrintFilter.Rule.AtraceMessage

Matches an atrace message of the form: pid...

Defined in ftrace_config.proto

Fields:

Field	Type	Description
type	string
prefix	string

FtraceConfig.KsymsMemPolicy

When symbolize_ksyms=true, determines whether the traced_probes daemon should keep the symbol map in memory (and reuse it for future tracing sessions) or clear it (saving memory) and re-create it on each tracing session (wasting cpu and wall time). The tradeoff is roughly: KSYMS_RETAIN: pay a fixed ~1.2 MB cost after the first trace. KSYMS_CLEANUP_ON_STOP: pay a ~300-500ms cost when starting each trace. Default behavior: KSYMS_CLEANUP_ON_STOP.

Defined in ftrace_config.proto

Enum values:

Name	Value	Description
KSYMS_UNSPECIFIED	0
KSYMS_CLEANUP_ON_STOP	1
KSYMS_RETAIN	2

InodeFileConfig

Defined in inode_file_config.proto

Fields:

Field	Type	Description
scan_interval_ms	uint32	How long to pause between batches.
scan_delay_ms	uint32	How long to wait before the first scan in order to accumulate inodes.
scan_batch_size	uint32	How many inodes to scan in one batch.
do_not_scan	bool	Do not scan for inodes not found in the static map.
scan_mount_points	string[]	If non-empty, only scan inodes corresponding to block devices named in this list.
mount_point_mapping	MountPointMappingEntry[]	When encountering an inode belonging to a block device corresponding to one of the mount points in this map, scan its scan_roots instead.

InodeFileConfig.MountPointMappingEntry

Defined in inode_file_config.proto

Fields:

Field	Type	Description
mountpoint	string
scan_roots	string[]

ProcessStatsConfig

Defined in process_stats_config.proto

Fields:

Field	Type	Description
quirks	Quirks[]
scan_all_processes_on_start	bool	If enabled all processes will be scanned and dumped when the trace starts.
record_thread_names	bool	If enabled thread names are also recoded (this is redundant if sched_switch is enabled).
proc_stats_poll_ms	uint32	If > 0 samples counters (see process_stats.proto) from /proc/pid/status and oom_score_adj every X ms. It will also sample /proc/pid/smaps_rollup if scan_smaps_rollup = true. This is required to be > 100ms to avoid excessive CPU usage.
proc_stats_cache_ttl_ms	uint32	This is required to be either = 0 or a multiple of `proc_stats_poll_ms` (default: `proc_stats_poll_ms`). If = 0, will be set to `proc_stats_poll_ms`. Non-multiples will be rounded down to the nearest multiple.
resolve_process_fds	bool	If true this will resolve filedescriptors for each process so these can be mapped to their actual device or file. Requires raw_syscalls/sys_exit ftrace events to be enabled or new fds opened after initially scanning a process will not be recognized.
scan_smaps_rollup	bool	If enabled memory stats from /proc/pid/smaps_rollup will be included in process stats.

ProcessStatsConfig.Quirks

Defined in process_stats_config.proto

Enum values:

Name	Value	Description
QUIRKS_UNSPECIFIED	0
DISABLE_INITIAL_DUMP	1	This has been deprecated and ignored as per 2018-05-01. Full scan at startup is now disabled by default and can be re-enabled using the `scan_all_processes_on_start` arg.
DISABLE_ON_DEMAND	2

SysStatsConfig

This file defines the configuration for the Linux /proc poller data source, which injects counters in the trace. Counters that are needed in the trace must be explicitly listed in the _counters fields. This is to avoid spamming the trace with all counters at all times. The sampling rate is configurable. All polling rates (_period_ms) need to be integer multiples of each other. OK: [10ms, 10ms, 10ms], [10ms, 20ms, 10ms], [10ms, 20ms, 60ms] Not OK: [10ms, 10ms, 11ms], [10ms, 15ms, 20ms]

Defined in sys_stats_config.proto

Fields:

Field	Type	Description
meminfo_period_ms	uint32	Polls /proc/meminfo every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage. Cost: 0.3 ms [read] + 0.07 ms [parse + trace injection]
meminfo_counters	MeminfoCounters[]	If empty all known counters are reported. Otherwise, only the counters specified below are reported.
vmstat_period_ms	uint32	Polls /proc/vmstat every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage. Cost: 0.2 ms [read] + 0.3 ms [parse + trace injection]
vmstat_counters	VmstatCounters[]
stat_period_ms	uint32	Pols /proc/stat every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage. Cost: 4.1 ms [read] + 1.9 ms [parse + trace injection]
stat_counters	StatCounters[]
devfreq_period_ms	uint32	Polls /sys/devfreq/*/curfreq every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage. This option can be used to record unchanging values. Updates from frequency changes can come from ftrace/set_clock_rate.
cpufreq_period_ms	uint32	Polls /sys/devices/system/cpu/cpu*/cpufreq/cpuinfo_cur_freq every X ms. This is required to be > 10ms to avoid excessive CPU usage.
buddyinfo_period_ms	uint32	Polls /proc/buddyinfo every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage.
diskstat_period_ms	uint32	Polls /proc/diskstats every X ms, if non-zero. This is required to be > 10ms to avoid excessive CPU usage.

MeminfoCounters

Counter definitions for Linux's /proc/meminfo.

Defined in sys_stats_counters.proto

Enum values:

Name	Value	Description
MEMINFO_UNSPECIFIED	0
MEMINFO_MEM_TOTAL	1
MEMINFO_MEM_FREE	2
MEMINFO_MEM_AVAILABLE	3
MEMINFO_BUFFERS	4
MEMINFO_CACHED	5
MEMINFO_SWAP_CACHED	6
MEMINFO_ACTIVE	7
MEMINFO_INACTIVE	8
MEMINFO_ACTIVE_ANON	9
MEMINFO_INACTIVE_ANON	10
MEMINFO_ACTIVE_FILE	11
MEMINFO_INACTIVE_FILE	12
MEMINFO_UNEVICTABLE	13
MEMINFO_MLOCKED	14
MEMINFO_SWAP_TOTAL	15
MEMINFO_SWAP_FREE	16
MEMINFO_DIRTY	17
MEMINFO_WRITEBACK	18
MEMINFO_ANON_PAGES	19
MEMINFO_MAPPED	20
MEMINFO_SHMEM	21
MEMINFO_SLAB	22
MEMINFO_SLAB_RECLAIMABLE	23
MEMINFO_SLAB_UNRECLAIMABLE	24
MEMINFO_KERNEL_STACK	25
MEMINFO_PAGE_TABLES	26
MEMINFO_COMMIT_LIMIT	27
MEMINFO_COMMITED_AS	28
MEMINFO_VMALLOC_TOTAL	29
MEMINFO_VMALLOC_USED	30
MEMINFO_VMALLOC_CHUNK	31
MEMINFO_CMA_TOTAL	32
MEMINFO_CMA_FREE	33

VmstatCounters

Counter definitions for Linux's /proc/vmstat.

Defined in sys_stats_counters.proto

Enum values:

Name	Value	Description
VMSTAT_UNSPECIFIED	0
VMSTAT_NR_FREE_PAGES	1
VMSTAT_NR_ALLOC_BATCH	2
VMSTAT_NR_INACTIVE_ANON	3
VMSTAT_NR_ACTIVE_ANON	4
VMSTAT_NR_INACTIVE_FILE	5
VMSTAT_NR_ACTIVE_FILE	6
VMSTAT_NR_UNEVICTABLE	7
VMSTAT_NR_MLOCK	8
VMSTAT_NR_ANON_PAGES	9
VMSTAT_NR_MAPPED	10
VMSTAT_NR_FILE_PAGES	11
VMSTAT_NR_DIRTY	12
VMSTAT_NR_WRITEBACK	13
VMSTAT_NR_SLAB_RECLAIMABLE	14
VMSTAT_NR_SLAB_UNRECLAIMABLE	15
VMSTAT_NR_PAGE_TABLE_PAGES	16
VMSTAT_NR_KERNEL_STACK	17
VMSTAT_NR_OVERHEAD	18
VMSTAT_NR_UNSTABLE	19
VMSTAT_NR_BOUNCE	20
VMSTAT_NR_VMSCAN_WRITE	21
VMSTAT_NR_VMSCAN_IMMEDIATE_RECLAIM	22
VMSTAT_NR_WRITEBACK_TEMP	23
VMSTAT_NR_ISOLATED_ANON	24
VMSTAT_NR_ISOLATED_FILE	25
VMSTAT_NR_SHMEM	26
VMSTAT_NR_DIRTIED	27
VMSTAT_NR_WRITTEN	28
VMSTAT_NR_PAGES_SCANNED	29
VMSTAT_WORKINGSET_REFAULT	30
VMSTAT_WORKINGSET_ACTIVATE	31
VMSTAT_WORKINGSET_NODERECLAIM	32
VMSTAT_NR_ANON_TRANSPARENT_HUGEPAGES	33
VMSTAT_NR_FREE_CMA	34
VMSTAT_NR_SWAPCACHE	35
VMSTAT_NR_DIRTY_THRESHOLD	36
VMSTAT_NR_DIRTY_BACKGROUND_THRESHOLD	37
VMSTAT_PGPGIN	38
VMSTAT_PGPGOUT	39
VMSTAT_PGPGOUTCLEAN	40
VMSTAT_PSWPIN	41
VMSTAT_PSWPOUT	42
VMSTAT_PGALLOC_DMA	43
VMSTAT_PGALLOC_NORMAL	44
VMSTAT_PGALLOC_MOVABLE	45
VMSTAT_PGFREE	46
VMSTAT_PGACTIVATE	47
VMSTAT_PGDEACTIVATE	48
VMSTAT_PGFAULT	49
VMSTAT_PGMAJFAULT	50
VMSTAT_PGREFILL_DMA	51
VMSTAT_PGREFILL_NORMAL	52
VMSTAT_PGREFILL_MOVABLE	53
VMSTAT_PGSTEAL_KSWAPD_DMA	54
VMSTAT_PGSTEAL_KSWAPD_NORMAL	55
VMSTAT_PGSTEAL_KSWAPD_MOVABLE	56
VMSTAT_PGSTEAL_DIRECT_DMA	57
VMSTAT_PGSTEAL_DIRECT_NORMAL	58
VMSTAT_PGSTEAL_DIRECT_MOVABLE	59
VMSTAT_PGSCAN_KSWAPD_DMA	60
VMSTAT_PGSCAN_KSWAPD_NORMAL	61
VMSTAT_PGSCAN_KSWAPD_MOVABLE	62
VMSTAT_PGSCAN_DIRECT_DMA	63
VMSTAT_PGSCAN_DIRECT_NORMAL	64
VMSTAT_PGSCAN_DIRECT_MOVABLE	65
VMSTAT_PGSCAN_DIRECT_THROTTLE	66
VMSTAT_PGINODESTEAL	67
VMSTAT_SLABS_SCANNED	68
VMSTAT_KSWAPD_INODESTEAL	69
VMSTAT_KSWAPD_LOW_WMARK_HIT_QUICKLY	70
VMSTAT_KSWAPD_HIGH_WMARK_HIT_QUICKLY	71
VMSTAT_PAGEOUTRUN	72
VMSTAT_ALLOCSTALL	73
VMSTAT_PGROTATED	74
VMSTAT_DROP_PAGECACHE	75
VMSTAT_DROP_SLAB	76
VMSTAT_PGMIGRATE_SUCCESS	77
VMSTAT_PGMIGRATE_FAIL	78
VMSTAT_COMPACT_MIGRATE_SCANNED	79
VMSTAT_COMPACT_FREE_SCANNED	80
VMSTAT_COMPACT_ISOLATED	81
VMSTAT_COMPACT_STALL	82
VMSTAT_COMPACT_FAIL	83
VMSTAT_COMPACT_SUCCESS	84
VMSTAT_COMPACT_DAEMON_WAKE	85
VMSTAT_UNEVICTABLE_PGS_CULLED	86
VMSTAT_UNEVICTABLE_PGS_SCANNED	87
VMSTAT_UNEVICTABLE_PGS_RESCUED	88
VMSTAT_UNEVICTABLE_PGS_MLOCKED	89
VMSTAT_UNEVICTABLE_PGS_MUNLOCKED	90
VMSTAT_UNEVICTABLE_PGS_CLEARED	91
VMSTAT_UNEVICTABLE_PGS_STRANDED	92
VMSTAT_NR_ZSPAGES	93
VMSTAT_NR_ION_HEAP	94
VMSTAT_NR_GPU_HEAP	95
VMSTAT_ALLOCSTALL_DMA	96
VMSTAT_ALLOCSTALL_MOVABLE	97
VMSTAT_ALLOCSTALL_NORMAL	98
VMSTAT_COMPACT_DAEMON_FREE_SCANNED	99
VMSTAT_COMPACT_DAEMON_MIGRATE_SCANNED	100
VMSTAT_NR_FASTRPC	101
VMSTAT_NR_INDIRECTLY_RECLAIMABLE	102
VMSTAT_NR_ION_HEAP_POOL	103
VMSTAT_NR_KERNEL_MISC_RECLAIMABLE	104
VMSTAT_NR_SHADOW_CALL_STACK_BYTES	105
VMSTAT_NR_SHMEM_HUGEPAGES	106
VMSTAT_NR_SHMEM_PMDMAPPED	107
VMSTAT_NR_UNRECLAIMABLE_PAGES	108
VMSTAT_NR_ZONE_ACTIVE_ANON	109
VMSTAT_NR_ZONE_ACTIVE_FILE	110
VMSTAT_NR_ZONE_INACTIVE_ANON	111
VMSTAT_NR_ZONE_INACTIVE_FILE	112
VMSTAT_NR_ZONE_UNEVICTABLE	113
VMSTAT_NR_ZONE_WRITE_PENDING	114
VMSTAT_OOM_KILL	115
VMSTAT_PGLAZYFREE	116
VMSTAT_PGLAZYFREED	117
VMSTAT_PGREFILL	118
VMSTAT_PGSCAN_DIRECT	119
VMSTAT_PGSCAN_KSWAPD	120
VMSTAT_PGSKIP_DMA	121
VMSTAT_PGSKIP_MOVABLE	122
VMSTAT_PGSKIP_NORMAL	123
VMSTAT_PGSTEAL_DIRECT	124
VMSTAT_PGSTEAL_KSWAPD	125
VMSTAT_SWAP_RA	126
VMSTAT_SWAP_RA_HIT	127
VMSTAT_WORKINGSET_RESTORE	128

SysStatsConfig.StatCounters

Defined in sys_stats_config.proto

Enum values:

Name	Value	Description
STAT_UNSPECIFIED	0
STAT_CPU_TIMES	1
STAT_IRQ_COUNTS	2
STAT_SOFTIRQ_COUNTS	3
STAT_FORK_COUNT	4

HeapprofdConfig

Configuration for go/heapprofd.

Defined in heapprofd_config.proto

Fields:

Field	Type	Description
sampling_interval_bytes	uint64	Sampling rate for all heaps not specified via heap_sampling_intervals. These are: * All heaps if heap_sampling_intervals is empty. * Those profiled due to all_heaps and not named in heaps if heap_sampling_intervals is not empty. * The implicit libc.malloc heap if heaps is empty. Set to 1 for perfect accuracy. Otherwise, sample every sample_interval_bytes on average. See https://perfetto.dev/docs/data-sources/native-heap-profiler#sampling-interval for more details. BUGS Before Android 12, setting this to 0 would crash the target process. N.B. This must be explicitly set to a non-zero value for all heaps (with this field or with heap_sampling_intervals), otherwise the producer will not start.
adaptive_sampling_shmem_threshold	uint64	If less than the given numbers of bytes are left free in the shared memory buffer, increase sampling interval by a factor of two. Adaptive sampling is disabled when set to 0.
adaptive_sampling_max_sampling_interval_bytes	uint64	Stop doubling the sampling_interval once the sampling interval has reached this value.
process_cmdline	string[]	E.g. surfaceflinger, com.android.phone This input is normalized in the following way: if it contains slashes, everything up to the last slash is discarded. If it contains "@", everything after the first @ is discared. E.g. /system/bin/surfaceflinger@1.0 normalizes to surfaceflinger. This transformation is also applied to the processes' command lines when matching.
pid	uint64[]	For watermark based triggering or local debugging.
target_installed_by	string[]	Only profile target if it was installed by one of the packages given. Special values are: * @system: installed on the system partition * @product: installed on the product partition * @null: sideloaded Supported on Android 12+.
heaps	string[]	Which heaps to sample, e.g. "libc.malloc". If left empty, only samples "malloc". Introduced in Android 12.
exclude_heaps	string[]	Which heaps not to sample, e.g. "libc.malloc". This is useful when used in combination with all_heaps; Introduced in Android 12.
stream_allocations	bool
heap_sampling_intervals	uint64[]	If given, needs to be the same length as heaps and gives the sampling interval for the respective entry in heaps. Otherwise, sampling_interval_bytes is used. It is recommended to set sampling_interval_bytes to a reasonable default value when using this, as a value of 0 for sampling_interval_bytes will crash the target process before Android 12. Introduced in Android 12. All values must be non-zero or the producer will not start.
all_heaps	bool	Sample all heaps registered by target process. Introduced in Android 12.
all	bool	Profile all processes eligible for profiling on the system. See https://perfetto.dev/docs/data-sources/native-heap-profiler#heapprofd-targets for which processes are eligible. On unmodified userdebug builds, this will lead to system crashes. Zygote will crash when trying to launch a new process as it will have an unexpected open socket to heapprofd. heapprofd will likely be overloaded by the amount of data for low sampling intervals.
min_anonymous_memory_kb	uint32	Do not profile processes whose anon RSS + swap < given value. Introduced in Android 11.
max_heapprofd_memory_kb	uint32	Stop profile if heapprofd memory usage goes beyond the given value. Introduced in Android 11.
max_heapprofd_cpu_secs	uint64	Stop profile if heapprofd CPU time since start of this data-source goes beyond given value. Introduced in Android 11.
skip_symbol_prefix	string[]	Do not emit function names for mappings starting with this prefix. E.g. /system to not emit symbols for any system libraries.
continuous_dump_config	ContinuousDumpConfig	Dump at a predefined interval.
shmem_size_bytes	uint64	Size of the shared memory buffer between the profiled processes and heapprofd. Defaults to 8 MiB. If larger than 500 MiB, truncated to 500 MiB. Needs to be: * at least 8192, * a power of two, * a multiple of 4096.
block_client	bool	When the shmem buffer is full, block the client instead of ending the trace. Use with caution as this will significantly slow down the target process.
block_client_timeout_us	uint32	If set, stop the trace session after blocking the client for this timeout. Needs to be larger than 100 us, otherwise no retries are done. Introduced in Android 11.
no_startup	bool	Do not profile processes from startup, only match already running processes. Can not be set at the same time as no_running. Introduced in Android 11.
no_running	bool	Do not profile running processes. Only match processes on startup. Can not be set at the same time as no_startup. Introduced in Android 11.
dump_at_max	bool	Cause heapprofd to emit a single dump at the end, showing the memory usage at the point in time when the sampled heap usage of the process was at its maximum. This causes ProfilePacket.HeapSample.self_max to be set, and self_allocated and self_freed to not be set. Introduced in Android 11.
disable_fork_teardown	bool	Escape hatch if the session is being torn down because of a forked child that shares memory space, but is not correctly identified as a vforked child. Introduced in Android 11.
disable_vfork_detection	bool	We try to automatically detect when a target applicatation vforks but then does a memory allocation (or free). This auto-detection can be disabled with this. Introduced in Android 11.

HeapprofdConfig.ContinuousDumpConfig

Defined in heapprofd_config.proto

Fields:

Field	Type	Description
dump_phase_ms	uint32	ms to wait before first dump.
dump_interval_ms	uint32	ms to wait between following dumps.

JavaHprofConfig

Configuration for managed app heap graph snapshots.

Defined in java_hprof_config.proto

Fields:

Field	Type	Description
process_cmdline	string[]	Command line allowlist, matched against the /proc//cmdline (not the comm string). The semantics of this field were changed since its original introduction. On Android T+ (13+), this field can specify a single wildcard (), and the profiler will attempt to match it in two possible ways: if the pattern starts with a '/', then it is matched against the first segment of the cmdline (i.e. argv0). For example "/bin/e" would match "/bin/echo". otherwise the pattern is matched against the part of argv0 corresponding to the binary name (this is unrelated to /proc/pid/exe). For example "echo" would match "/bin/echo". On Android S (12) and below, both this pattern and /proc/pid/cmdline get normalized prior to an exact string comparison. Normalization is as follows: (1) trim everything beyond the first null or "@" byte; (2) if the string contains forward slashes, trim everything up to and including the last one. Implementation note: in either case, at most 511 characters of cmdline are considered.
pid	uint64[]	For watermark based triggering or local debugging.
target_installed_by	string[]	Only profile target if it was installed by one of the packages given. Special values are: * @system: installed on the system partition * @product: installed on the product partition * @null: sideloaded Supported on Android 12+.
continuous_dump_config	ContinuousDumpConfig	Dump at a predefined interval.
min_anonymous_memory_kb	uint32	Do not profile processes whose anon RSS + swap < given value.
dump_smaps	bool	Include the process' /proc/self/smaps. This only shows maps that: * start with /system * start with /vendor * start with /data/app * contain "extracted in memory from Y", where Y matches any of the above
ignored_types	string[]	Exclude objects of the following types from the profile. This can be useful if lots of uninteresting objects, e.g. "sun.misc.Cleaner".

JavaHprofConfig.ContinuousDumpConfig

If dump_interval_ms != 0, the following configuration is used.

Defined in java_hprof_config.proto

Fields:

Field	Type	Description
dump_phase_ms	uint32	ms to wait before first continuous dump. A dump is always created at the beginning of the trace.
dump_interval_ms	uint32	ms to wait between following dumps.
scan_pids_only_on_start	bool	If true, scans all the processes to find `process_cmdline` and filter by `min_anonymous_memory_kb` only at data source start. Default on Android S-. If false, rescans all the processes to find on every dump. Default on Android T+.

AndroidPowerConfig

Defined in android_power_config.proto

Fields:

Field	Type	Description
battery_poll_ms	uint32
battery_counters	BatteryCounters[]
collect_power_rails	bool	Where available enables per-power-rail measurements.
collect_energy_estimation_breakdown	bool	Provides a breakdown of energy estimation for various subsystem (e.g. GPU). Available from Android S.
collect_entity_state_residency	bool	Provides a breakdown of time in state for various subsystems. Available from Android U.

AndroidPowerConfig.BatteryCounters

Defined in android_power_config.proto

Enum values:

Name	Value	Description
BATTERY_COUNTER_UNSPECIFIED	0
BATTERY_COUNTER_CHARGE	1	Coulomb counter.
BATTERY_COUNTER_CAPACITY_PERCENT	2	Charge (%).
BATTERY_COUNTER_CURRENT	3	Instantaneous current.
BATTERY_COUNTER_CURRENT_AVG	4	Avg current.

AndroidLogConfig

Defined in android_log_config.proto

Fields:

Field	Type	Description
log_ids	AndroidLogId[]
min_prio	AndroidLogPriority	If set ignores all log messages whose prio is < the given value.
filter_tags	string[]	If non-empty ignores all log messages whose tag doesn't match one of the specified values.

AndroidLogId

Values from NDK's android/log.h.

Defined in android_log_constants.proto

Enum values:

Name	Value	Description
LID_DEFAULT	0	MAIN.
LID_RADIO	1
LID_EVENTS	2
LID_SYSTEM	3
LID_CRASH	4
LID_STATS	5
LID_SECURITY	6
LID_KERNEL	7

AndroidLogPriority

Defined in android_log_constants.proto

Enum values:

Name	Value	Description
PRIO_UNSPECIFIED	0
PRIO_UNUSED	1	_DEFAULT, but should never be seen in logs.
PRIO_VERBOSE	2
PRIO_DEBUG	3
PRIO_INFO	4
PRIO_WARN	5
PRIO_ERROR	6
PRIO_FATAL	7

GpuCounterConfig

Defined in gpu_counter_config.proto

Fields:

Field	Type	Description
counter_period_ns	uint64	Desired sampling interval for counters.
counter_ids	uint32[]	List of counters to be sampled. Counter IDs correspond to the ones described in GpuCounterSpec in the data source descriptor.
instrumented_sampling	bool	Sample counters by instrumenting command buffers.
fix_gpu_clock	bool	Fix gpu clock rate during trace session.

AndroidGameInterventionListConfig

Data source that lists game modes and game interventions of games on an Android device.

Defined in android_game_intervention_list_config.proto

Fields:

Field	Type	Description
package_name_filter	string[]	If not empty, emit info about only the following list of package names (exact match, no regex). Otherwise, emit info about all packages.

PackagesListConfig

Data source that lists details (such as version code) about packages on an Android device.

Defined in packages_list_config.proto

Fields:

Field	Type	Description
package_name_filter	string[]	If not empty, emit info about only the following list of package names (exact match, no regex). Otherwise, emit info about all packages.

PerfEventConfig

Configuration for the traced_perf profiler.

Example config for basic cpu profiling: perf_event_config { timebase { frequency: 80 } callstack_sampling { scope { target_cmdline: "surfaceflinger" target_cmdline: "system_server" } kernel_frames: true } }

Defined in perf_event_config.proto

Fields:

Field	Type	Description
timebase	PerfEvents.Timebase	What event to sample on, and how often. Defined in common/perf_events.proto.
callstack_sampling	CallstackSampling	If set, the profiler will sample userspace processes' callstacks at the interval specified by the `timebase`. If unset, the profiler will record only the event counts.
ring_buffer_read_period_ms	uint32	How often the per-cpu ring buffers are read by the producer. If unset, an implementation-defined default is used.
ring_buffer_pages	uint32	Size (in 4k pages) of each per-cpu ring buffer that is filled by the kernel. If set, must be a power of two. If unset, an implementation-defined default is used.
max_enqueued_footprint_kb	uint64	Drop samples if the heap memory held by the samples in the unwinder queue is above the given limit. This counts the memory across all concurrent data sources (not just this one's), and there is no fairness guarantee - the whole quota might be used up by a concurrent source.
max_daemon_memory_kb	uint32	Stop the data source if traced_perf's combined {RssAnon + Swap} memory footprint exceeds this value.
remote_descriptor_timeout_ms	uint32	Timeout for the remote /proc//{maps,mem} file descriptors for a sampled process. This is primarily for Android, where this lookup is asynchronous. As long as the producer is waiting, the associated samples will be kept enqueued (putting pressure on the capacity of the shared unwinding queue). Once a lookup for a process expires, all associated samples are discarded. However, if the lookup still succeeds after the timeout, future samples will be handled normally. If unset, an implementation-defined default is used.
unwind_state_clear_period_ms	uint32	Optional period for clearing state cached by the unwinder. This is a heavy operation that is only necessary for traces that target a wide set of processes, and require the memory footprint to be reset periodically. If unset, the cached state will not be cleared.
target_installed_by	string[]	If set, only profile target if it was installed by a package with one of these names. Special values: * "@system": installed on the system partition * "@product": installed on the product partition * "@null": sideloaded Supported on Android 12+.
all_cpus	bool	Note: legacy configs had to set `all_cpus` to true to pass parsing. We rely on this to detect such configs.
sampling_frequency	uint32
kernel_frames	bool
target_pid	int32[]
target_cmdline	string[]
exclude_pid	int32[]
exclude_cmdline	string[]
additional_cmdline_count	uint32

PerfEvents.Timebase

What event to sample on, and how often. Commented from the perspective of its use in PerfEventConfig.

Defined in perf_events.proto

Fields:

Field	Type	Description
frequency	uint64	Per-cpu sampling frequency in Hz, as requested from the kernel. Not the same as 1/period. Details: the actual sampling will still be based on a period, but the kernel will dynamically adjust it based on the observed event rate, to approximate this frequency. Works best with steady-rate events like timers.
period	uint64	Per-cpu sampling will occur every `period` counts of `event`. Prefer `frequency` by default, as it's easier to oversample with a fixed period.
counter	Counter
tracepoint	Tracepoint
raw_event	RawEvent
timestamp_clock	PerfClock	If set, samples will be timestamped with the given clock. If unset, the clock is chosen by the implementation. For software events, prefer PERF_CLOCK_BOOTTIME. However it cannot be used for hardware events (due to interrupt safety), for which the recommendation is to use one of the monotonic clocks.
name	string	Optional arbitrary name for the event, to identify it in the parsed trace. Does not affect the profiling itself. If unset, the trace parser will choose a suitable name.

PerfEvents.Counter

Builtin counter names from the uapi header. Commented with their perf tool aliases. finite), and generally make this list as extensive as possible. Excluding things like dynamic PMUs since those don't fit into a static enum.

Defined in perf_events.proto

Enum values:

Name	Value	Description
UNKNOWN_COUNTER	0
SW_CPU_CLOCK	1	cpu-clock
SW_PAGE_FAULTS	2	page-faults, faults
SW_TASK_CLOCK	3	task-clock
SW_CONTEXT_SWITCHES	4	context-switches, cs
SW_CPU_MIGRATIONS	5	cpu-migrations, migrations
SW_PAGE_FAULTS_MIN	6	minor-faults
SW_PAGE_FAULTS_MAJ	7	major-faults
SW_ALIGNMENT_FAULTS	8	alignment-faults
SW_EMULATION_FAULTS	9	emulation-faults
SW_DUMMY	20	dummy
HW_CPU_CYCLES	10	cpu-cycles, cycles
HW_INSTRUCTIONS	11	instructions
HW_CACHE_REFERENCES	12	cache-references
HW_CACHE_MISSES	13	cache-misses
HW_BRANCH_INSTRUCTIONS	14	branch-instructions, branches
HW_BRANCH_MISSES	15	branch-misses
HW_BUS_CYCLES	16	bus-cycles
HW_STALLED_CYCLES_FRONTEND	17	stalled-cycles-frontend, idle-cycles-frontend
HW_STALLED_CYCLES_BACKEND	18	stalled-cycles-backend, idle-cycles-backend
HW_REF_CPU_CYCLES	19	ref-cycles

PerfEvents.Tracepoint

Defined in perf_events.proto

Fields:

Field	Type	Description
name	string	Group and name for the tracepoint, acceptable forms: * "sched/sched_switch" * "sched:sched_switch"
filter	string	Optional field-level filter for the tracepoint. Only events matching this filter will be counted (and therefore contribute to the sampling period). Example: "prev_pid >= 42 && next_pid == 0". For full syntax, see kernel documentation on "Event filtering": https://www.kernel.org/doc/Documentation/trace/events.txt

PerfEvents.RawEvent

Syscall-level description of the event, propagated to the perf_event_attr struct. Primarily for local use-cases, since the event availability and encoding is hardware-specific.

Defined in perf_events.proto

Fields:

Field	Type	Description
type	uint32
config	uint64
config1	uint64
config2	uint64

PerfEvents.PerfClock

Subset of clocks that is supported by perf timestamping. CLOCK_TAI is excluded since it's not expected to be used in practice, but would require additions to the trace clock synchronisation logic.

Defined in perf_events.proto

Enum values:

Name	Value	Description
UNKNOWN_PERF_CLOCK	0
PERF_CLOCK_REALTIME	1
PERF_CLOCK_MONOTONIC	2
PERF_CLOCK_MONOTONIC_RAW	3
PERF_CLOCK_BOOTTIME	4

PerfEventConfig.CallstackSampling

Defined in perf_event_config.proto

Fields:

Field	Type	Description
scope	Scope	Defines a set of processes for which samples are retained/skipped. If unset, all samples are kept, but beware that it will be very heavy on the stack unwinder, which might start dropping samples due to overload.
kernel_frames	bool	If true, callstacks will include the kernel-space frames. Such frames can be identified by a magical "kernel" string as their mapping name. Requires traced_perf to be running as root, or kptr_restrict to have been manually unrestricted. On Android, the platform should do the right thing on debug builds. This does not disclose KASLR, as only the function names are emitted.
user_frames	UnwindMode	Whether to record and unwind userspace callstacks. If unset, defaults to including userspace (UNWIND_DWARF) both for backwards compatibility and as the most common default (this defaulting is only applicable if the outer CallstackSampling message is explicitly set).

PerfEventConfig.Scope

Defined in perf_event_config.proto

Fields:

Field	Type	Description
target_pid	int32[]	Process ID (TGID) allowlist. If this list is not empty, only matching samples will be retained. If multiple allow/deny-lists are specified by the config, then all of them are evaluated for each sampled process.
target_cmdline	string[]	Command line allowlist, matched against the /proc//cmdline (not the comm string). The semantics of this field were changed since its original introduction. On Android T+ (13+), this field can specify a single wildcard (), and the profiler will attempt to match it in two possible ways: if the pattern starts with a '/', then it is matched against the first segment of the cmdline (i.e. argv0). For example "/bin/e" would match "/bin/echo". otherwise the pattern is matched against the part of argv0 corresponding to the binary name (this is unrelated to /proc/pid/exe). For example "echo" would match "/bin/echo". On Android S (12) and below, both this pattern and /proc/pid/cmdline get normalized prior to an exact string comparison. Normalization is as follows: (1) trim everything beyond the first null or "@" byte; (2) if the string contains forward slashes, trim everything up to and including the last one. Implementation note: in either case, at most 511 characters of cmdline are considered.
exclude_pid	int32[]	List of excluded pids.
exclude_cmdline	string[]	List of excluded cmdlines. See description of `target_cmdline` for how this is handled.
additional_cmdline_count	uint32	Number of additional command lines to sample. Only those which are neither explicitly included nor excluded will be considered. Processes are accepted on a first come, first served basis.
process_shard_count	uint32	If set to N, all encountered processes will be put into one of the N possible bins, and only one randomly-chosen bin will be selected for unwinding. The binning is simply "pid % N", under the assumption that low-order bits of pids are roughly uniformly distributed. Other explicit inclusions/exclusions in this `Scope` message are still respected. The profiler will report the chosen shard in PerfSampleDefaults, and the values will be queryable in trace processor under the "stats" table as "perf_process_shard_count" and "perf_chosen_process_shard". NB: all data sources in a config that set `process_shard_count` must set it to the same value. The profiler will choose one bin for all those data sources.

PerfEventConfig.UnwindMode

Userspace unwinding mode. A possible future addition is kernel-unwound callchains for frame pointer based systems.

Defined in perf_event_config.proto

Enum values:

Name	Value	Description
UNWIND_UNKNOWN	0
UNWIND_SKIP	1	Do not unwind userspace:
UNWIND_DWARF	2	Use libunwindstack (default):

VulkanMemoryConfig

Defined in vulkan_memory_config.proto

Fields:

Field	Type	Description
track_driver_memory_usage	bool	Tracking driver memory usage events
track_device_memory_usage	bool	Tracking device memory usage events

TrackEventConfig

Defined in track_event_config.proto

Fields:

Field	Type	Description
disabled_categories	string[]	Default: []
enabled_categories	string[]	Default: []
disabled_tags	string[]	Default: ["slow", "debug"]
enabled_tags	string[]	Default: []
disable_incremental_timestamps	bool	Default: false (i.e. enabled by default)
timestamp_unit_multiplier	uint64	Allows to specify a custom unit different than the default (ns). Also affects thread timestamps if enable_thread_time_sampling = true. A multiplier of 1000 means that a timestamp = 3 should be interpreted as 3000 ns = 3 us. Default: 1 (if unset, it should be read as 1).
filter_debug_annotations	bool	Default: false (i.e. debug_annotations is NOT filtered out by default) When true, any debug annotations provided as arguments to the TRACE_EVENT macros are not written into the trace. Typed arguments will still be emitted even if set to true.
enable_thread_time_sampling	bool	Default : false (i.e. disabled) When true, the SDK samples and emits the current thread time counter value for each event on the current thread's track. This value represents the total CPU time consumed by that thread since its creation. Note that if a thread is not scheduled by OS for some duration, that time won't be included in thread_time. Learn more : "CLOCK_THREAD_CPUTIME_ID" flag at https://linux.die.net/man/3/clock_gettime
filter_dynamic_event_names	bool	Default: false (i.e. dynamic event names are NOT filtered out by default) When true, event_names wrapped in perfetto::DynamicString will be filtered out.

AndroidPolledStateConfig

Data source that polls for display state. This should only be used for backward-compatibility; AndroidSystemPropertyConfig should be preferred.

Defined in android_polled_state_config.proto

Fields:

Field	Type	Description
poll_ms	uint32	Frequency of polling. If absent the state will be recorded once, at the start of the trace. This is required to be > 100ms to avoid excessive CPU usage.

AndroidSystemPropertyConfig

Data source that polls for system properties.

Defined in android_system_property_config.proto

Fields:

Field	Type	Description
poll_ms	uint32	Frequency of polling. If absent the state will be recorded once, at the start of the trace. This is required to be > 100ms to avoid excessive CPU usage.
property_name	string[]	Properties to poll. All property names must start with "debug.tracing.".

StatsdTracingConfig

This file is named 'statsd_tracing_config.proto' rather than 'statsd_config.proto' (which would be more consistent with the other config protos) so it doesn't show up and confuse folks looking for the existing statsd_config.proto for configuring statsd itself. Same for the config proto itself.

Defined in statsd_tracing_config.proto

Fields:

Field	Type	Description
push_atom_id	AtomId[]	This is for the common case of the atom id being known in the enum AtomId.
raw_push_atom_id	int32[]	Escape hatch for Atom IDs that are not yet in the AtomId enum (e.g. non-upstream atoms that don't exist in AOSP).
pull_config	StatsdPullAtomConfig[]

AtomId

This enum is obtained by post-processing AOSP/frameworks/proto_logging/stats/atoms.proto through AOSP/external/perfetto/tools/update-statsd-descriptor, which extracts one enum value for each proto field defined in the upstream atoms.proto.

Defined in atom_ids.proto

Enum values:

Name	Value	Description
ATOM_UNSPECIFIED	0
ATOM_BLE_SCAN_STATE_CHANGED	2
ATOM_PROCESS_STATE_CHANGED	3
ATOM_BLE_SCAN_RESULT_RECEIVED	4
ATOM_SENSOR_STATE_CHANGED	5
ATOM_GPS_SCAN_STATE_CHANGED	6
ATOM_SYNC_STATE_CHANGED	7
ATOM_SCHEDULED_JOB_STATE_CHANGED	8
ATOM_SCREEN_BRIGHTNESS_CHANGED	9
ATOM_WAKELOCK_STATE_CHANGED	10
ATOM_LONG_PARTIAL_WAKELOCK_STATE_CHANGED	11
ATOM_MOBILE_RADIO_POWER_STATE_CHANGED	12
ATOM_WIFI_RADIO_POWER_STATE_CHANGED	13
ATOM_ACTIVITY_MANAGER_SLEEP_STATE_CHANGED	14
ATOM_MEMORY_FACTOR_STATE_CHANGED	15
ATOM_EXCESSIVE_CPU_USAGE_REPORTED	16
ATOM_CACHED_KILL_REPORTED	17
ATOM_PROCESS_MEMORY_STAT_REPORTED	18
ATOM_LAUNCHER_EVENT	19
ATOM_BATTERY_SAVER_MODE_STATE_CHANGED	20
ATOM_DEVICE_IDLE_MODE_STATE_CHANGED	21
ATOM_DEVICE_IDLING_MODE_STATE_CHANGED	22
ATOM_AUDIO_STATE_CHANGED	23
ATOM_MEDIA_CODEC_STATE_CHANGED	24
ATOM_CAMERA_STATE_CHANGED	25
ATOM_FLASHLIGHT_STATE_CHANGED	26
ATOM_UID_PROCESS_STATE_CHANGED	27
ATOM_PROCESS_LIFE_CYCLE_STATE_CHANGED	28
ATOM_SCREEN_STATE_CHANGED	29
ATOM_BATTERY_LEVEL_CHANGED	30
ATOM_CHARGING_STATE_CHANGED	31
ATOM_PLUGGED_STATE_CHANGED	32
ATOM_INTERACTIVE_STATE_CHANGED	33
ATOM_TOUCH_EVENT_REPORTED	34
ATOM_WAKEUP_ALARM_OCCURRED	35
ATOM_KERNEL_WAKEUP_REPORTED	36
ATOM_WIFI_LOCK_STATE_CHANGED	37
ATOM_WIFI_SIGNAL_STRENGTH_CHANGED	38
ATOM_WIFI_SCAN_STATE_CHANGED	39
ATOM_PHONE_SIGNAL_STRENGTH_CHANGED	40
ATOM_SETTING_CHANGED	41
ATOM_ACTIVITY_FOREGROUND_STATE_CHANGED	42
ATOM_ISOLATED_UID_CHANGED	43
ATOM_PACKET_WAKEUP_OCCURRED	44
ATOM_WALL_CLOCK_TIME_SHIFTED	45
ATOM_ANOMALY_DETECTED	46
ATOM_APP_BREADCRUMB_REPORTED	47
ATOM_APP_START_OCCURRED	48
ATOM_APP_START_CANCELED	49
ATOM_APP_START_FULLY_DRAWN	50
ATOM_LMK_KILL_OCCURRED	51
ATOM_PICTURE_IN_PICTURE_STATE_CHANGED	52
ATOM_WIFI_MULTICAST_LOCK_STATE_CHANGED	53
ATOM_LMK_STATE_CHANGED	54
ATOM_APP_START_MEMORY_STATE_CAPTURED	55
ATOM_SHUTDOWN_SEQUENCE_REPORTED	56
ATOM_BOOT_SEQUENCE_REPORTED	57
ATOM_DAVEY_OCCURRED	58
ATOM_OVERLAY_STATE_CHANGED	59
ATOM_FOREGROUND_SERVICE_STATE_CHANGED	60
ATOM_CALL_STATE_CHANGED	61
ATOM_KEYGUARD_STATE_CHANGED	62
ATOM_KEYGUARD_BOUNCER_STATE_CHANGED	63
ATOM_KEYGUARD_BOUNCER_PASSWORD_ENTERED	64
ATOM_APP_DIED	65
ATOM_RESOURCE_CONFIGURATION_CHANGED	66
ATOM_BLUETOOTH_ENABLED_STATE_CHANGED	67
ATOM_BLUETOOTH_CONNECTION_STATE_CHANGED	68
ATOM_GPS_SIGNAL_QUALITY_CHANGED	69
ATOM_USB_CONNECTOR_STATE_CHANGED	70
ATOM_SPEAKER_IMPEDANCE_REPORTED	71
ATOM_HARDWARE_FAILED	72
ATOM_PHYSICAL_DROP_DETECTED	73
ATOM_CHARGE_CYCLES_REPORTED	74
ATOM_MOBILE_CONNECTION_STATE_CHANGED	75
ATOM_MOBILE_RADIO_TECHNOLOGY_CHANGED	76
ATOM_USB_DEVICE_ATTACHED	77
ATOM_APP_CRASH_OCCURRED	78
ATOM_ANR_OCCURRED	79
ATOM_WTF_OCCURRED	80
ATOM_LOW_MEM_REPORTED	81
ATOM_GENERIC_ATOM	82
ATOM_VIBRATOR_STATE_CHANGED	84
ATOM_DEFERRED_JOB_STATS_REPORTED	85
ATOM_THERMAL_THROTTLING	86
ATOM_BIOMETRIC_ACQUIRED	87
ATOM_BIOMETRIC_AUTHENTICATED	88
ATOM_BIOMETRIC_ERROR_OCCURRED	89
ATOM_UI_EVENT_REPORTED	90
ATOM_BATTERY_HEALTH_SNAPSHOT	91
ATOM_SLOW_IO	92
ATOM_BATTERY_CAUSED_SHUTDOWN	93
ATOM_PHONE_SERVICE_STATE_CHANGED	94
ATOM_PHONE_STATE_CHANGED	95
ATOM_USER_RESTRICTION_CHANGED	96
ATOM_SETTINGS_UI_CHANGED	97
ATOM_CONNECTIVITY_STATE_CHANGED	98
ATOM_SERVICE_STATE_CHANGED	99
ATOM_SERVICE_LAUNCH_REPORTED	100
ATOM_FLAG_FLIP_UPDATE_OCCURRED	101
ATOM_BINARY_PUSH_STATE_CHANGED	102
ATOM_DEVICE_POLICY_EVENT	103
ATOM_DOCS_UI_FILE_OP_CANCELED	104
ATOM_DOCS_UI_FILE_OP_COPY_MOVE_MODE_REPORTED	105
ATOM_DOCS_UI_FILE_OP_FAILURE	106
ATOM_DOCS_UI_PROVIDER_FILE_OP	107
ATOM_DOCS_UI_INVALID_SCOPED_ACCESS_REQUEST	108
ATOM_DOCS_UI_LAUNCH_REPORTED	109
ATOM_DOCS_UI_ROOT_VISITED	110
ATOM_DOCS_UI_STARTUP_MS	111
ATOM_DOCS_UI_USER_ACTION_REPORTED	112
ATOM_WIFI_ENABLED_STATE_CHANGED	113
ATOM_WIFI_RUNNING_STATE_CHANGED	114
ATOM_APP_COMPACTED	115
ATOM_NETWORK_DNS_EVENT_REPORTED	116
ATOM_DOCS_UI_PICKER_LAUNCHED_FROM_REPORTED	117
ATOM_DOCS_UI_PICK_RESULT_REPORTED	118
ATOM_DOCS_UI_SEARCH_MODE_REPORTED	119
ATOM_DOCS_UI_SEARCH_TYPE_REPORTED	120
ATOM_DATA_STALL_EVENT	121
ATOM_RESCUE_PARTY_RESET_REPORTED	122
ATOM_SIGNED_CONFIG_REPORTED	123
ATOM_GNSS_NI_EVENT_REPORTED	124
ATOM_BLUETOOTH_LINK_LAYER_CONNECTION_EVENT	125
ATOM_BLUETOOTH_ACL_CONNECTION_STATE_CHANGED	126
ATOM_BLUETOOTH_SCO_CONNECTION_STATE_CHANGED	127
ATOM_APP_DOWNGRADED	128
ATOM_APP_OPTIMIZED_AFTER_DOWNGRADED	129
ATOM_LOW_STORAGE_STATE_CHANGED	130
ATOM_GNSS_NFW_NOTIFICATION_REPORTED	131
ATOM_GNSS_CONFIGURATION_REPORTED	132
ATOM_USB_PORT_OVERHEAT_EVENT_REPORTED	133
ATOM_NFC_ERROR_OCCURRED	134
ATOM_NFC_STATE_CHANGED	135
ATOM_NFC_BEAM_OCCURRED	136
ATOM_NFC_CARDEMULATION_OCCURRED	137
ATOM_NFC_TAG_OCCURRED	138
ATOM_NFC_HCE_TRANSACTION_OCCURRED	139
ATOM_SE_STATE_CHANGED	140
ATOM_SE_OMAPI_REPORTED	141
ATOM_BROADCAST_DISPATCH_LATENCY_REPORTED	142
ATOM_ATTENTION_MANAGER_SERVICE_RESULT_REPORTED	143
ATOM_ADB_CONNECTION_CHANGED	144
ATOM_SPEECH_DSP_STAT_REPORTED	145
ATOM_USB_CONTAMINANT_REPORTED	146
ATOM_WATCHDOG_ROLLBACK_OCCURRED	147
ATOM_BIOMETRIC_SYSTEM_HEALTH_ISSUE_DETECTED	148
ATOM_BUBBLE_UI_CHANGED	149
ATOM_SCHEDULED_JOB_CONSTRAINT_CHANGED	150
ATOM_BLUETOOTH_ACTIVE_DEVICE_CHANGED	151
ATOM_BLUETOOTH_A2DP_PLAYBACK_STATE_CHANGED	152
ATOM_BLUETOOTH_A2DP_CODEC_CONFIG_CHANGED	153
ATOM_BLUETOOTH_A2DP_CODEC_CAPABILITY_CHANGED	154
ATOM_BLUETOOTH_A2DP_AUDIO_UNDERRUN_REPORTED	155
ATOM_BLUETOOTH_A2DP_AUDIO_OVERRUN_REPORTED	156
ATOM_BLUETOOTH_DEVICE_RSSI_REPORTED	157
ATOM_BLUETOOTH_DEVICE_FAILED_CONTACT_COUNTER_REPORTED	158
ATOM_BLUETOOTH_DEVICE_TX_POWER_LEVEL_REPORTED	159
ATOM_BLUETOOTH_HCI_TIMEOUT_REPORTED	160
ATOM_BLUETOOTH_QUALITY_REPORT_REPORTED	161
ATOM_BLUETOOTH_DEVICE_INFO_REPORTED	162
ATOM_BLUETOOTH_REMOTE_VERSION_INFO_REPORTED	163
ATOM_BLUETOOTH_SDP_ATTRIBUTE_REPORTED	164
ATOM_BLUETOOTH_BOND_STATE_CHANGED	165
ATOM_BLUETOOTH_CLASSIC_PAIRING_EVENT_REPORTED	166
ATOM_BLUETOOTH_SMP_PAIRING_EVENT_REPORTED	167
ATOM_SCREEN_TIMEOUT_EXTENSION_REPORTED	168
ATOM_PROCESS_START_TIME	169
ATOM_PERMISSION_GRANT_REQUEST_RESULT_REPORTED	170
ATOM_BLUETOOTH_SOCKET_CONNECTION_STATE_CHANGED	171
ATOM_DEVICE_IDENTIFIER_ACCESS_DENIED	172
ATOM_BUBBLE_DEVELOPER_ERROR_REPORTED	173
ATOM_ASSIST_GESTURE_STAGE_REPORTED	174
ATOM_ASSIST_GESTURE_FEEDBACK_REPORTED	175
ATOM_ASSIST_GESTURE_PROGRESS_REPORTED	176
ATOM_TOUCH_GESTURE_CLASSIFIED	177
ATOM_HIDDEN_API_USED	178
ATOM_STYLE_UI_CHANGED	179
ATOM_PRIVACY_INDICATORS_INTERACTED	180
ATOM_APP_INSTALL_ON_EXTERNAL_STORAGE_REPORTED	181
ATOM_NETWORK_STACK_REPORTED	182
ATOM_APP_MOVED_STORAGE_REPORTED	183
ATOM_BIOMETRIC_ENROLLED	184
ATOM_SYSTEM_SERVER_WATCHDOG_OCCURRED	185
ATOM_TOMB_STONE_OCCURRED	186
ATOM_BLUETOOTH_CLASS_OF_DEVICE_REPORTED	187
ATOM_INTELLIGENCE_EVENT_REPORTED	188
ATOM_THERMAL_THROTTLING_SEVERITY_STATE_CHANGED	189
ATOM_ROLE_REQUEST_RESULT_REPORTED	190
ATOM_MEDIAMETRICS_AUDIOPOLICY_REPORTED	191
ATOM_MEDIAMETRICS_AUDIORECORD_REPORTED	192
ATOM_MEDIAMETRICS_AUDIOTHREAD_REPORTED	193
ATOM_MEDIAMETRICS_AUDIOTRACK_REPORTED	194
ATOM_MEDIAMETRICS_CODEC_REPORTED	195
ATOM_MEDIAMETRICS_DRM_WIDEVINE_REPORTED	196
ATOM_MEDIAMETRICS_EXTRACTOR_REPORTED	197
ATOM_MEDIAMETRICS_MEDIADRM_REPORTED	198
ATOM_MEDIAMETRICS_NUPLAYER_REPORTED	199
ATOM_MEDIAMETRICS_RECORDER_REPORTED	200
ATOM_MEDIAMETRICS_DRMMANAGER_REPORTED	201
ATOM_CAR_POWER_STATE_CHANGED	203
ATOM_GARAGE_MODE_INFO	204
ATOM_TEST_ATOM_REPORTED	205
ATOM_CONTENT_CAPTURE_CALLER_MISMATCH_REPORTED	206
ATOM_CONTENT_CAPTURE_SERVICE_EVENTS	207
ATOM_CONTENT_CAPTURE_SESSION_EVENTS	208
ATOM_CONTENT_CAPTURE_FLUSHED	209
ATOM_LOCATION_MANAGER_API_USAGE_REPORTED	210
ATOM_REVIEW_PERMISSIONS_FRAGMENT_RESULT_REPORTED	211
ATOM_RUNTIME_PERMISSIONS_UPGRADE_RESULT	212
ATOM_GRANT_PERMISSIONS_ACTIVITY_BUTTON_ACTIONS	213
ATOM_LOCATION_ACCESS_CHECK_NOTIFICATION_ACTION	214
ATOM_APP_PERMISSION_FRAGMENT_ACTION_REPORTED	215
ATOM_APP_PERMISSION_FRAGMENT_VIEWED	216
ATOM_APP_PERMISSIONS_FRAGMENT_VIEWED	217
ATOM_PERMISSION_APPS_FRAGMENT_VIEWED	218
ATOM_TEXT_SELECTION_EVENT	219
ATOM_TEXT_LINKIFY_EVENT	220
ATOM_CONVERSATION_ACTIONS_EVENT	221
ATOM_LANGUAGE_DETECTION_EVENT	222
ATOM_EXCLUSION_RECT_STATE_CHANGED	223
ATOM_BACK_GESTURE_REPORTED_REPORTED	224
ATOM_UPDATE_ENGINE_UPDATE_ATTEMPT_REPORTED	225
ATOM_UPDATE_ENGINE_SUCCESSFUL_UPDATE_REPORTED	226
ATOM_CAMERA_ACTION_EVENT	227
ATOM_APP_COMPATIBILITY_CHANGE_REPORTED	228
ATOM_PERFETTO_UPLOADED	229
ATOM_VMS_CLIENT_CONNECTION_STATE_CHANGED	230
ATOM_MEDIA_PROVIDER_SCAN_OCCURRED	233
ATOM_MEDIA_CONTENT_DELETED	234
ATOM_MEDIA_PROVIDER_PERMISSION_REQUESTED	235
ATOM_MEDIA_PROVIDER_SCHEMA_CHANGED	236
ATOM_MEDIA_PROVIDER_IDLE_MAINTENANCE_FINISHED	237
ATOM_REBOOT_ESCROW_RECOVERY_REPORTED	238
ATOM_BOOT_TIME_EVENT_DURATION_REPORTED	239
ATOM_BOOT_TIME_EVENT_ELAPSED_TIME_REPORTED	240
ATOM_BOOT_TIME_EVENT_UTC_TIME_REPORTED	241
ATOM_BOOT_TIME_EVENT_ERROR_CODE_REPORTED	242
ATOM_USERSPACE_REBOOT_REPORTED	243
ATOM_NOTIFICATION_REPORTED	244
ATOM_NOTIFICATION_PANEL_REPORTED	245
ATOM_NOTIFICATION_CHANNEL_MODIFIED	246
ATOM_INTEGRITY_CHECK_RESULT_REPORTED	247
ATOM_INTEGRITY_RULES_PUSHED	248
ATOM_CB_MESSAGE_REPORTED	249
ATOM_CB_MESSAGE_ERROR	250
ATOM_WIFI_HEALTH_STAT_REPORTED	251
ATOM_WIFI_FAILURE_STAT_REPORTED	252
ATOM_WIFI_CONNECTION_RESULT_REPORTED	253
ATOM_APP_FREEZE_CHANGED	254
ATOM_SNAPSHOT_MERGE_REPORTED	255
ATOM_FOREGROUND_SERVICE_APP_OP_SESSION_ENDED	256
ATOM_DISPLAY_JANK_REPORTED	257
ATOM_APP_STANDBY_BUCKET_CHANGED	258
ATOM_SHARESHEET_STARTED	259
ATOM_RANKING_SELECTED	260
ATOM_TVSETTINGS_UI_INTERACTED	261
ATOM_LAUNCHER_SNAPSHOT	262
ATOM_PACKAGE_INSTALLER_V2_REPORTED	263
ATOM_USER_LIFECYCLE_JOURNEY_REPORTED	264
ATOM_USER_LIFECYCLE_EVENT_OCCURRED	265
ATOM_ACCESSIBILITY_SHORTCUT_REPORTED	266
ATOM_ACCESSIBILITY_SERVICE_REPORTED	267
ATOM_DOCS_UI_DRAG_AND_DROP_REPORTED	268
ATOM_APP_USAGE_EVENT_OCCURRED	269
ATOM_AUTO_REVOKE_NOTIFICATION_CLICKED	270
ATOM_AUTO_REVOKE_FRAGMENT_APP_VIEWED	271
ATOM_AUTO_REVOKED_APP_INTERACTION	272
ATOM_APP_PERMISSION_GROUPS_FRAGMENT_AUTO_REVOKE_ACTION	273
ATOM_EVS_USAGE_STATS_REPORTED	274
ATOM_AUDIO_POWER_USAGE_DATA_REPORTED	275
ATOM_TV_TUNER_STATE_CHANGED	276
ATOM_MEDIAOUTPUT_OP_SWITCH_REPORTED	277
ATOM_CB_MESSAGE_FILTERED	278
ATOM_TV_TUNER_DVR_STATUS	279
ATOM_TV_CAS_SESSION_OPEN_STATUS	280
ATOM_ASSISTANT_INVOCATION_REPORTED	281
ATOM_DISPLAY_WAKE_REPORTED	282
ATOM_CAR_USER_HAL_MODIFY_USER_REQUEST_REPORTED	283
ATOM_CAR_USER_HAL_MODIFY_USER_RESPONSE_REPORTED	284
ATOM_CAR_USER_HAL_POST_SWITCH_RESPONSE_REPORTED	285
ATOM_CAR_USER_HAL_INITIAL_USER_INFO_REQUEST_REPORTED	286
ATOM_CAR_USER_HAL_INITIAL_USER_INFO_RESPONSE_REPORTED	287
ATOM_CAR_USER_HAL_USER_ASSOCIATION_REQUEST_REPORTED	288
ATOM_CAR_USER_HAL_SET_USER_ASSOCIATION_RESPONSE_REPORTED	289
ATOM_NETWORK_IP_PROVISIONING_REPORTED	290
ATOM_NETWORK_DHCP_RENEW_REPORTED	291
ATOM_NETWORK_VALIDATION_REPORTED	292
ATOM_NETWORK_STACK_QUIRK_REPORTED	293
ATOM_MEDIAMETRICS_AUDIORECORDDEVICEUSAGE_REPORTED	294
ATOM_MEDIAMETRICS_AUDIOTHREADDEVICEUSAGE_REPORTED	295
ATOM_MEDIAMETRICS_AUDIOTRACKDEVICEUSAGE_REPORTED	296
ATOM_MEDIAMETRICS_AUDIODEVICECONNECTION_REPORTED	297
ATOM_BLOB_COMMITTED	298
ATOM_BLOB_LEASED	299
ATOM_BLOB_OPENED	300
ATOM_CONTACTS_PROVIDER_STATUS_REPORTED	301
ATOM_KEYSTORE_KEY_EVENT_REPORTED	302
ATOM_NETWORK_TETHERING_REPORTED	303
ATOM_IME_TOUCH_REPORTED	304
ATOM_UI_INTERACTION_FRAME_INFO_REPORTED	305
ATOM_UI_ACTION_LATENCY_REPORTED	306
ATOM_WIFI_DISCONNECT_REPORTED	307
ATOM_WIFI_CONNECTION_STATE_CHANGED	308
ATOM_HDMI_CEC_ACTIVE_SOURCE_CHANGED	309
ATOM_HDMI_CEC_MESSAGE_REPORTED	310
ATOM_AIRPLANE_MODE	311
ATOM_MODEM_RESTART	312
ATOM_CARRIER_ID_MISMATCH_REPORTED	313
ATOM_CARRIER_ID_TABLE_UPDATED	314
ATOM_DATA_STALL_RECOVERY_REPORTED	315
ATOM_MEDIAMETRICS_MEDIAPARSER_REPORTED	316
ATOM_TLS_HANDSHAKE_REPORTED	317
ATOM_TEXT_CLASSIFIER_API_USAGE_REPORTED	318
ATOM_CAR_WATCHDOG_KILL_STATS_REPORTED	319
ATOM_MEDIAMETRICS_PLAYBACK_REPORTED	320
ATOM_MEDIA_NETWORK_INFO_CHANGED	321
ATOM_MEDIA_PLAYBACK_STATE_CHANGED	322
ATOM_MEDIA_PLAYBACK_ERROR_REPORTED	323
ATOM_MEDIA_PLAYBACK_TRACK_CHANGED	324
ATOM_WIFI_SCAN_REPORTED	325
ATOM_WIFI_PNO_SCAN_REPORTED	326
ATOM_TIF_TUNE_CHANGED	327
ATOM_AUTO_ROTATE_REPORTED	328
ATOM_PERFETTO_TRIGGER	329
ATOM_TRANSCODING_DATA	330
ATOM_IMS_SERVICE_ENTITLEMENT_UPDATED	331
ATOM_ART_DATUM_REPORTED	332
ATOM_DEVICE_ROTATED	333
ATOM_SIM_SPECIFIC_SETTINGS_RESTORED	334
ATOM_TEXT_CLASSIFIER_DOWNLOAD_REPORTED	335
ATOM_PIN_STORAGE_EVENT	336
ATOM_FACE_DOWN_REPORTED	337
ATOM_BLUETOOTH_HAL_CRASH_REASON_REPORTED	338
ATOM_REBOOT_ESCROW_PREPARATION_REPORTED	339
ATOM_REBOOT_ESCROW_LSKF_CAPTURE_REPORTED	340
ATOM_REBOOT_ESCROW_REBOOT_REPORTED	341
ATOM_BINDER_LATENCY_REPORTED	342
ATOM_MEDIAMETRICS_AAUDIOSTREAM_REPORTED	343
ATOM_MEDIA_TRANSCODING_SESSION_ENDED	344
ATOM_MAGNIFICATION_USAGE_REPORTED	345
ATOM_MAGNIFICATION_MODE_WITH_IME_ON_REPORTED	346
ATOM_APP_SEARCH_CALL_STATS_REPORTED	347
ATOM_APP_SEARCH_PUT_DOCUMENT_STATS_REPORTED	348
ATOM_DEVICE_CONTROL_CHANGED	349
ATOM_DEVICE_STATE_CHANGED	350
ATOM_INPUTDEVICE_REGISTERED	351
ATOM_SMARTSPACE_CARD_REPORTED	352
ATOM_AUTH_PROMPT_AUTHENTICATE_INVOKED	353
ATOM_AUTH_MANAGER_CAN_AUTHENTICATE_INVOKED	354
ATOM_AUTH_ENROLL_ACTION_INVOKED	355
ATOM_AUTH_DEPRECATED_API_USED	356
ATOM_UNATTENDED_REBOOT_OCCURRED	357
ATOM_LONG_REBOOT_BLOCKING_REPORTED	358
ATOM_LOCATION_TIME_ZONE_PROVIDER_STATE_CHANGED	359
ATOM_FDTRACK_EVENT_OCCURRED	364
ATOM_TIMEOUT_AUTO_EXTENDED_REPORTED	365
ATOM_ODREFRESH_REPORTED	366
ATOM_ALARM_BATCH_DELIVERED	367
ATOM_ALARM_SCHEDULED	368
ATOM_CAR_WATCHDOG_IO_OVERUSE_STATS_REPORTED	369
ATOM_USER_LEVEL_HIBERNATION_STATE_CHANGED	370
ATOM_APP_SEARCH_INITIALIZE_STATS_REPORTED	371
ATOM_APP_SEARCH_QUERY_STATS_REPORTED	372
ATOM_APP_PROCESS_DIED	373
ATOM_NETWORK_IP_REACHABILITY_MONITOR_REPORTED	374
ATOM_SLOW_INPUT_EVENT_REPORTED	375
ATOM_ANR_OCCURRED_PROCESSING_STARTED	376
ATOM_APP_SEARCH_REMOVE_STATS_REPORTED	377
ATOM_MEDIA_CODEC_REPORTED	378
ATOM_PERMISSION_USAGE_FRAGMENT_INTERACTION	379
ATOM_PERMISSION_DETAILS_INTERACTION	380
ATOM_PRIVACY_SENSOR_TOGGLE_INTERACTION	381
ATOM_PRIVACY_TOGGLE_DIALOG_INTERACTION	382
ATOM_APP_SEARCH_OPTIMIZE_STATS_REPORTED	383
ATOM_NON_A11Y_TOOL_SERVICE_WARNING_REPORT	384
ATOM_APP_SEARCH_SET_SCHEMA_STATS_REPORTED	385
ATOM_APP_COMPAT_STATE_CHANGED	386
ATOM_SIZE_COMPAT_RESTART_BUTTON_EVENT_REPORTED	387
ATOM_SPLITSCREEN_UI_CHANGED	388
ATOM_NETWORK_DNS_HANDSHAKE_REPORTED	389
ATOM_BLUETOOTH_CODE_PATH_COUNTER	390
ATOM_BLUETOOTH_LE_BATCH_SCAN_REPORT_DELAY	392
ATOM_ACCESSIBILITY_FLOATING_MENU_UI_CHANGED	393
ATOM_NEURALNETWORKS_COMPILATION_COMPLETED	394
ATOM_NEURALNETWORKS_EXECUTION_COMPLETED	395
ATOM_NEURALNETWORKS_COMPILATION_FAILED	396
ATOM_NEURALNETWORKS_EXECUTION_FAILED	397
ATOM_CONTEXT_HUB_BOOTED	398
ATOM_CONTEXT_HUB_RESTARTED	399
ATOM_CONTEXT_HUB_LOADED_NANOAPP_SNAPSHOT_REPORTED	400
ATOM_CHRE_CODE_DOWNLOAD_TRANSACTED	401
ATOM_UWB_SESSION_INITED	402
ATOM_UWB_SESSION_CLOSED	403
ATOM_UWB_FIRST_RANGING_RECEIVED	404
ATOM_UWB_RANGING_MEASUREMENT_RECEIVED	405
ATOM_TEXT_CLASSIFIER_DOWNLOAD_WORK_SCHEDULED	406
ATOM_TEXT_CLASSIFIER_DOWNLOAD_WORK_COMPLETED	407
ATOM_CLIPBOARD_CLEARED	408
ATOM_VM_CREATION_REQUESTED	409
ATOM_NEARBY_DEVICE_SCAN_STATE_CHANGED	410
ATOM_CAMERA_COMPAT_CONTROL_EVENT_REPORTED	411
ATOM_APPLICATION_LOCALES_CHANGED	412
ATOM_MEDIAMETRICS_AUDIOTRACKSTATUS_REPORTED	413
ATOM_FOLD_STATE_DURATION_REPORTED	414
ATOM_LOCATION_TIME_ZONE_PROVIDER_CONTROLLER_STATE_CHANGED	415
ATOM_DISPLAY_HBM_STATE_CHANGED	416
ATOM_DISPLAY_HBM_BRIGHTNESS_CHANGED	417
ATOM_PERSISTENT_URI_PERMISSIONS_FLUSHED	418
ATOM_EARLY_BOOT_COMP_OS_ARTIFACTS_CHECK_REPORTED	419
ATOM_VBMETA_DIGEST_REPORTED	420
ATOM_APEX_INFO_GATHERED	421
ATOM_PVM_INFO_GATHERED	422
ATOM_WEAR_SETTINGS_UI_INTERACTED	423
ATOM_TRACING_SERVICE_REPORT_EVENT	424
ATOM_MEDIAMETRICS_AUDIORECORDSTATUS_REPORTED	425
ATOM_LAUNCHER_LATENCY	426
ATOM_DROPBOX_ENTRY_DROPPED	427
ATOM_WIFI_P2P_CONNECTION_REPORTED	428
ATOM_GAME_STATE_CHANGED	429
ATOM_HOTWORD_DETECTOR_CREATE_REQUESTED	430
ATOM_HOTWORD_DETECTION_SERVICE_INIT_RESULT_REPORTED	431
ATOM_HOTWORD_DETECTION_SERVICE_RESTARTED	432
ATOM_HOTWORD_DETECTOR_KEYPHRASE_TRIGGERED	433
ATOM_HOTWORD_DETECTOR_EVENTS	434
ATOM_BOOT_COMPLETED_BROADCAST_COMPLETION_LATENCY_REPORTED	437
ATOM_CONTACTS_INDEXER_UPDATE_STATS_REPORTED	440
ATOM_APP_BACKGROUND_RESTRICTIONS_INFO	441
ATOM_MMS_SMS_PROVIDER_GET_THREAD_ID_FAILED	442
ATOM_MMS_SMS_DATABASE_HELPER_ON_UPGRADE_FAILED	443
ATOM_PERMISSION_REMINDER_NOTIFICATION_INTERACTED	444
ATOM_RECENT_PERMISSION_DECISIONS_INTERACTED	445
ATOM_GNSS_PSDS_DOWNLOAD_REPORTED	446
ATOM_LE_AUDIO_CONNECTION_SESSION_REPORTED	447
ATOM_LE_AUDIO_BROADCAST_SESSION_REPORTED	448
ATOM_DREAM_UI_EVENT_REPORTED	449
ATOM_TASK_MANAGER_EVENT_REPORTED	450
ATOM_CDM_ASSOCIATION_ACTION	451
ATOM_MAGNIFICATION_TRIPLE_TAP_AND_HOLD_ACTIVATED_SESSION_REPORTED	452
ATOM_MAGNIFICATION_FOLLOW_TYPING_FOCUS_ACTIVATED_SESSION_REPORTED	453
ATOM_ACCESSIBILITY_TEXT_READING_OPTIONS_CHANGED	454
ATOM_WIFI_SETUP_FAILURE_CRASH_REPORTED	455
ATOM_UWB_DEVICE_ERROR_REPORTED	456
ATOM_ISOLATED_COMPILATION_SCHEDULED	457
ATOM_ISOLATED_COMPILATION_ENDED	458
ATOM_ONS_OPPORTUNISTIC_ESIM_PROVISIONING_COMPLETE	459
ATOM_TELEPHONY_ANOMALY_DETECTED	461
ATOM_LETTERBOX_POSITION_CHANGED	462
ATOM_REMOTE_KEY_PROVISIONING_ATTEMPT	463
ATOM_REMOTE_KEY_PROVISIONING_NETWORK_INFO	464
ATOM_REMOTE_KEY_PROVISIONING_TIMING	465
ATOM_MEDIAOUTPUT_OP_INTERACTION_REPORT	466
ATOM_BACKGROUND_DEXOPT_JOB_ENDED	467
ATOM_SYNC_EXEMPTION_OCCURRED	468
ATOM_AUTOFILL_PRESENTATION_EVENT_REPORTED	469
ATOM_DOCK_STATE_CHANGED	470
ATOM_BROADCAST_DELIVERY_EVENT_REPORTED	475
ATOM_SERVICE_REQUEST_EVENT_REPORTED	476
ATOM_PROVIDER_ACQUISITION_EVENT_REPORTED	477
ATOM_BLUETOOTH_DEVICE_NAME_REPORTED	478
ATOM_VIBRATION_REPORTED	487
ATOM_UWB_RANGING_START	489
ATOM_DISPLAY_BRIGHTNESS_CHANGED	494
ATOM_ACTIVITY_ACTION_BLOCKED	495
ATOM_NETWORK_DNS_SERVER_SUPPORT_REPORTED	504
ATOM_VM_BOOTED	505
ATOM_VM_EXITED	506
ATOM_AMBIENT_BRIGHTNESS_STATS_REPORTED	507
ATOM_MEDIAMETRICS_SPATIALIZERCAPABILITIES_REPORTED	508
ATOM_MEDIAMETRICS_SPATIALIZERDEVICEENABLED_REPORTED	509
ATOM_MEDIAMETRICS_HEADTRACKERDEVICEENABLED_REPORTED	510
ATOM_MEDIAMETRICS_HEADTRACKERDEVICESUPPORTED_REPORTED	511
ATOM_HEARING_AID_INFO_REPORTED	513
ATOM_DEVICE_WIDE_JOB_CONSTRAINT_CHANGED	514
ATOM_IWLAN_SETUP_DATA_CALL_RESULT_REPORTED	519
ATOM_IWLAN_PDN_DISCONNECTED_REASON_REPORTED	520
ATOM_AIRPLANE_MODE_SESSION_REPORTED	521
ATOM_VM_CPU_STATUS_REPORTED	522
ATOM_VM_MEM_STATUS_REPORTED	523
ATOM_DEFAULT_NETWORK_REMATCH_INFO	525
ATOM_NETWORK_SELECTION_PERFORMANCE	526
ATOM_NETWORK_NSD_REPORTED	527
ATOM_BLUETOOTH_DISCONNECTION_REASON_REPORTED	529
ATOM_BLUETOOTH_LOCAL_VERSIONS_REPORTED	530
ATOM_BLUETOOTH_REMOTE_SUPPORTED_FEATURES_REPORTED	531
ATOM_BLUETOOTH_LOCAL_SUPPORTED_FEATURES_REPORTED	532
ATOM_BLUETOOTH_GATT_APP_INFO	533
ATOM_BRIGHTNESS_CONFIGURATION_UPDATED	534
ATOM_LAUNCHER_IMPRESSION_EVENT	547
ATOM_ODSIGN_REPORTED	548
ATOM_ART_DEVICE_DATUM_REPORTED	550
ATOM_NETWORK_SLICE_SESSION_ENDED	558
ATOM_NETWORK_SLICE_DAILY_DATA_USAGE_REPORTED	559
ATOM_NFC_TAG_TYPE_OCCURRED	560
ATOM_NFC_AID_CONFLICT_OCCURRED	561
ATOM_NFC_READER_CONFLICT_OCCURRED	562
ATOM_ART_DATUM_DELTA_REPORTED	565
ATOM_MEDIA_DRM_CREATED	568
ATOM_MEDIA_DRM_ERRORED	569
ATOM_MEDIA_DRM_SESSION_OPENED	570
ATOM_MEDIA_DRM_SESSION_CLOSED	571
ATOM_PERFORMANCE_HINT_SESSION_REPORTED	574
ATOM_HOTWORD_AUDIO_EGRESS_EVENT_REPORTED	578
ATOM_NETWORK_VALIDATION_FAILURE_STATS_DAILY_REPORTED	601
ATOM_WIFI_BYTES_TRANSFER	10000
ATOM_WIFI_BYTES_TRANSFER_BY_FG_BG	10001
ATOM_MOBILE_BYTES_TRANSFER	10002
ATOM_MOBILE_BYTES_TRANSFER_BY_FG_BG	10003
ATOM_BLUETOOTH_BYTES_TRANSFER	10006
ATOM_KERNEL_WAKELOCK	10004
ATOM_SUBSYSTEM_SLEEP_STATE	10005
ATOM_CPU_TIME_PER_UID	10009
ATOM_CPU_TIME_PER_UID_FREQ	10010
ATOM_WIFI_ACTIVITY_INFO	10011
ATOM_MODEM_ACTIVITY_INFO	10012
ATOM_BLUETOOTH_ACTIVITY_INFO	10007
ATOM_PROCESS_MEMORY_STATE	10013
ATOM_SYSTEM_ELAPSED_REALTIME	10014
ATOM_SYSTEM_UPTIME	10015
ATOM_CPU_ACTIVE_TIME	10016
ATOM_CPU_CLUSTER_TIME	10017
ATOM_DISK_SPACE	10018
ATOM_REMAINING_BATTERY_CAPACITY	10019
ATOM_FULL_BATTERY_CAPACITY	10020
ATOM_TEMPERATURE	10021
ATOM_BINDER_CALLS	10022
ATOM_BINDER_CALLS_EXCEPTIONS	10023
ATOM_LOOPER_STATS	10024
ATOM_DISK_STATS	10025
ATOM_DIRECTORY_USAGE	10026
ATOM_APP_SIZE	10027
ATOM_CATEGORY_SIZE	10028
ATOM_PROC_STATS	10029
ATOM_BATTERY_VOLTAGE	10030
ATOM_NUM_FINGERPRINTS_ENROLLED	10031
ATOM_DISK_IO	10032
ATOM_POWER_PROFILE	10033
ATOM_PROC_STATS_PKG_PROC	10034
ATOM_PROCESS_CPU_TIME	10035
ATOM_CPU_TIME_PER_THREAD_FREQ	10037
ATOM_ON_DEVICE_POWER_MEASUREMENT	10038
ATOM_DEVICE_CALCULATED_POWER_USE	10039
ATOM_PROCESS_MEMORY_HIGH_WATER_MARK	10042
ATOM_BATTERY_LEVEL	10043
ATOM_BUILD_INFORMATION	10044
ATOM_BATTERY_CYCLE_COUNT	10045
ATOM_DEBUG_ELAPSED_CLOCK	10046
ATOM_DEBUG_FAILING_ELAPSED_CLOCK	10047
ATOM_NUM_FACES_ENROLLED	10048
ATOM_ROLE_HOLDER	10049
ATOM_DANGEROUS_PERMISSION_STATE	10050
ATOM_TRAIN_INFO	10051
ATOM_TIME_ZONE_DATA_INFO	10052
ATOM_EXTERNAL_STORAGE_INFO	10053
ATOM_GPU_STATS_GLOBAL_INFO	10054
ATOM_GPU_STATS_APP_INFO	10055
ATOM_SYSTEM_ION_HEAP_SIZE	10056
ATOM_APPS_ON_EXTERNAL_STORAGE_INFO	10057
ATOM_FACE_SETTINGS	10058
ATOM_COOLING_DEVICE	10059
ATOM_APP_OPS	10060
ATOM_PROCESS_SYSTEM_ION_HEAP_SIZE	10061
ATOM_SURFACEFLINGER_STATS_GLOBAL_INFO	10062
ATOM_SURFACEFLINGER_STATS_LAYER_INFO	10063
ATOM_PROCESS_MEMORY_SNAPSHOT	10064
ATOM_VMS_CLIENT_STATS	10065
ATOM_NOTIFICATION_REMOTE_VIEWS	10066
ATOM_DANGEROUS_PERMISSION_STATE_SAMPLED	10067
ATOM_GRAPHICS_STATS	10068
ATOM_RUNTIME_APP_OP_ACCESS	10069
ATOM_ION_HEAP_SIZE	10070
ATOM_PACKAGE_NOTIFICATION_PREFERENCES	10071
ATOM_PACKAGE_NOTIFICATION_CHANNEL_PREFERENCES	10072
ATOM_PACKAGE_NOTIFICATION_CHANNEL_GROUP_PREFERENCES	10073
ATOM_GNSS_STATS	10074
ATOM_ATTRIBUTED_APP_OPS	10075
ATOM_VOICE_CALL_SESSION	10076
ATOM_VOICE_CALL_RAT_USAGE	10077
ATOM_SIM_SLOT_STATE	10078
ATOM_SUPPORTED_RADIO_ACCESS_FAMILY	10079
ATOM_SETTING_SNAPSHOT	10080
ATOM_BLOB_INFO	10081
ATOM_DATA_USAGE_BYTES_TRANSFER	10082
ATOM_BYTES_TRANSFER_BY_TAG_AND_METERED	10083
ATOM_DND_MODE_RULE	10084
ATOM_GENERAL_EXTERNAL_STORAGE_ACCESS_STATS	10085
ATOM_INCOMING_SMS	10086
ATOM_OUTGOING_SMS	10087
ATOM_CARRIER_ID_TABLE_VERSION	10088
ATOM_DATA_CALL_SESSION	10089
ATOM_CELLULAR_SERVICE_STATE	10090
ATOM_CELLULAR_DATA_SERVICE_SWITCH	10091
ATOM_SYSTEM_MEMORY	10092
ATOM_IMS_REGISTRATION_TERMINATION	10093
ATOM_IMS_REGISTRATION_STATS	10094
ATOM_CPU_TIME_PER_CLUSTER_FREQ	10095
ATOM_CPU_CYCLES_PER_UID_CLUSTER	10096
ATOM_DEVICE_ROTATED_DATA	10097
ATOM_CPU_CYCLES_PER_THREAD_GROUP_CLUSTER	10098
ATOM_MEDIA_DRM_ACTIVITY_INFO	10099
ATOM_OEM_MANAGED_BYTES_TRANSFER	10100
ATOM_GNSS_POWER_STATS	10101
ATOM_TIME_ZONE_DETECTOR_STATE	10102
ATOM_KEYSTORE2_STORAGE_STATS	10103
ATOM_RKP_POOL_STATS	10104
ATOM_PROCESS_DMABUF_MEMORY	10105
ATOM_PENDING_ALARM_INFO	10106
ATOM_USER_LEVEL_HIBERNATED_APPS	10107
ATOM_LAUNCHER_LAYOUT_SNAPSHOT	10108
ATOM_GLOBAL_HIBERNATED_APPS	10109
ATOM_INPUT_EVENT_LATENCY_SKETCH	10110
ATOM_BATTERY_USAGE_STATS_BEFORE_RESET	10111
ATOM_BATTERY_USAGE_STATS_SINCE_RESET	10112
ATOM_BATTERY_USAGE_STATS_SINCE_RESET_USING_POWER_PROFILE_MODEL	10113
ATOM_INSTALLED_INCREMENTAL_PACKAGE	10114
ATOM_TELEPHONY_NETWORK_REQUESTS	10115
ATOM_APP_SEARCH_STORAGE_INFO	10116
ATOM_VMSTAT	10117
ATOM_KEYSTORE2_KEY_CREATION_WITH_GENERAL_INFO	10118
ATOM_KEYSTORE2_KEY_CREATION_WITH_AUTH_INFO	10119
ATOM_KEYSTORE2_KEY_CREATION_WITH_PURPOSE_AND_MODES_INFO	10120
ATOM_KEYSTORE2_ATOM_WITH_OVERFLOW	10121
ATOM_KEYSTORE2_KEY_OPERATION_WITH_PURPOSE_AND_MODES_INFO	10122
ATOM_KEYSTORE2_KEY_OPERATION_WITH_GENERAL_INFO	10123
ATOM_RKP_ERROR_STATS	10124
ATOM_KEYSTORE2_CRASH_STATS	10125
ATOM_VENDOR_APEX_INFO	10126
ATOM_ACCESSIBILITY_SHORTCUT_STATS	10127
ATOM_ACCESSIBILITY_FLOATING_MENU_STATS	10128
ATOM_DATA_USAGE_BYTES_TRANSFER_V2	10129
ATOM_MEDIA_CAPABILITIES	10130
ATOM_CAR_WATCHDOG_SYSTEM_IO_USAGE_SUMMARY	10131
ATOM_CAR_WATCHDOG_UID_IO_USAGE_SUMMARY	10132
ATOM_IMS_REGISTRATION_FEATURE_TAG_STATS	10133
ATOM_RCS_CLIENT_PROVISIONING_STATS	10134
ATOM_RCS_ACS_PROVISIONING_STATS	10135
ATOM_SIP_DELEGATE_STATS	10136
ATOM_SIP_TRANSPORT_FEATURE_TAG_STATS	10137
ATOM_SIP_MESSAGE_RESPONSE	10138
ATOM_SIP_TRANSPORT_SESSION	10139
ATOM_IMS_DEDICATED_BEARER_LISTENER_EVENT	10140
ATOM_IMS_DEDICATED_BEARER_EVENT	10141
ATOM_IMS_REGISTRATION_SERVICE_DESC_STATS	10142
ATOM_UCE_EVENT_STATS	10143
ATOM_PRESENCE_NOTIFY_EVENT	10144
ATOM_GBA_EVENT	10145
ATOM_PER_SIM_STATUS	10146
ATOM_GPU_WORK_PER_UID	10147
ATOM_PERSISTENT_URI_PERMISSIONS_AMOUNT_PER_PACKAGE	10148
ATOM_SIGNED_PARTITION_INFO	10149
ATOM_PINNED_FILE_SIZES_PER_PACKAGE	10150
ATOM_PENDING_INTENTS_PER_PACKAGE	10151
ATOM_USER_INFO	10152
ATOM_TELEPHONY_NETWORK_REQUESTS_V2	10153
ATOM_DEVICE_TELEPHONY_PROPERTIES	10154
ATOM_REMOTE_KEY_PROVISIONING_ERROR_COUNTS	10155
ATOM_INCOMING_MMS	10157
ATOM_OUTGOING_MMS	10158
ATOM_MULTI_USER_INFO	10160
ATOM_NETWORK_BPF_MAP_INFO	10161
ATOM_CONNECTIVITY_STATE_SAMPLE	10163
ATOM_NETWORK_SELECTION_REMATCH_REASONS_INFO	10164
ATOM_NETWORK_SLICE_REQUEST_COUNT	10168
ATOM_ADPF_SYSTEM_COMPONENT_INFO	10173
ATOM_NOTIFICATION_MEMORY_USE	10174

StatsdPullAtomConfig

Defined in statsd_tracing_config.proto

Fields:

Field	Type	Description
pull_atom_id	AtomId[]
raw_pull_atom_id	int32[]
pull_frequency_ms	int32
packages	string[]

SystemInfoConfig

This data-source does a one-off recording of system information when the trace starts. Currently this includes:

Values of /sys/devices/system/cpu/cpu*/cpufreq/scaling_available_frequencies This datasource has no configuration options at present.

Defined in system_info.proto

Fields:

Field	Type	Description

ChromeConfig

Defined in chrome_config.proto

Fields:

Field	Type	Description
trace_config	string
privacy_filtering_enabled	bool	When enabled, the data source should only fill in fields in the output that are not potentially privacy sensitive.
convert_to_legacy_json	bool	Instead of emitting binary protobuf, convert the trace data to the legacy JSON format. Note that the trace data will still be returned as a series of TracePackets, but the embedded data will be JSON instead of serialized protobuf.
client_priority	ClientPriority
json_agent_label_filter	string	Applicable only when using legacy JSON format. If `json_agent_label_filter` is not empty, only data pertaining to the specified tracing agent label (e.g. "traceEvents") will be returned.

ChromeConfig.ClientPriority

Priority of the tracing session client. A higher priority session may preempt a lower priority one in configurations where concurrent sessions aren't supported.

Defined in chrome_config.proto

Enum values:

Name	Value	Description
UNKNOWN	0
BACKGROUND	1
USER_INITIATED	2

InterceptorConfig

Configuration for trace packet interception. Used for diverting trace data to non-Perfetto sources (e.g., logging to the console, ETW) when using the Perfetto SDK.

Defined in interceptor_config.proto

Fields:

Field	Type	Description
name	string	Matches the name given to RegisterInterceptor().
console_config	ConsoleConfig

ConsoleConfig

Defined in console_config.proto

Fields:

Field	Type	Description
output	Output
enable_colors	bool

ConsoleConfig.Output

Defined in console_config.proto

Enum values:

Name	Value	Description
OUTPUT_UNSPECIFIED	0
OUTPUT_STDOUT	1
OUTPUT_STDERR	2

NetworkPacketTraceConfig

Network tracing data source that records details on all packets sent or received by the network.

Defined in network_trace_config.proto

Fields:

Field	Type	Description
poll_ms	uint32	Polling frequency in milliseconds. Network tracing writes to a fixed size ring buffer. The polling interval should be such that the ring buffer is unlikely to fill in that interval (or that filling is an acceptable risk). The minimum polling rate is 100ms (values below this are ignored). Introduced in Android 14 (U).
aggregation_threshold	uint32	The aggregation_threshold is the number of packets at which an event will switch from per-packet details to aggregate details. For example, a value of 50 means that if a particular event (grouped by the unique combinations of metadata fields: {interface, direction, uid, etc}) has fewer than 50 packets, the exact timestamp and length are recorded for each packet. If there were 50 or more packets in an event, it would only record the total duration, packets, and length. A value of zero or unspecified will always record per-packet details. A value of 1 always records aggregate details.
intern_limit	uint32	Specifies the maximum number of packet contexts to intern at a time. This prevents the interning table from growing too large and controls whether interning is enabled or disabled (a value of zero disables interning and is the default). When a data sources interning table reaches this amount, packet contexts will be inlined into NetworkPacketEvents.
drop_local_port	bool	The following fields specify whether certain fields should be dropped from the output. Dropping fields improves normalization results, reduces the size of the interning table, and slightly reduces event size.
drop_remote_port	bool
drop_tcp_flags	bool

TestConfig

The configuration for a fake producer used in tests.

Defined in test_config.proto

Fields:

Field	Type	Description
message_count	uint32	The number of messages the fake producer should send.
max_messages_per_second	uint32	The maximum number of messages which should be sent each second. The actual obserced speed may be lower if the producer is unable to work fast enough. If this is zero or unset, the producer will send as fast as possible.
seed	uint32	The seed value for a simple multiplicative congruential pseudo-random number sequence.
message_size	uint32	The size of each message in bytes. Should be greater than or equal 5 to account for the number of bytes needed to encode the random number and a null byte for the string.
send_batch_on_register	bool	Whether the producer should send a event batch when the data source is is initially registered.
dummy_fields	DummyFields

TestConfig.DummyFields

Defined in test_config.proto

Fields:

Field	Type	Description
field_uint32	uint32
field_int32	int32
field_uint64	uint64
field_int64	int64
field_fixed64	fixed64
field_sfixed64	sfixed64
field_fixed32	fixed32
field_sfixed32	sfixed32
field_double	double
field_float	float
field_sint64	sint64
field_sint32	sint32
field_string	string
field_bytes	bytes

TraceConfig.BuiltinDataSource

Config for disabling builtin data sources in the tracing service.

Defined in trace_config.proto

Fields:

Field	Type	Description
disable_clock_snapshotting	bool	Disable emitting clock timestamps into the trace.
disable_trace_config	bool	Disable echoing the original trace config in the trace.
disable_system_info	bool	Disable emitting system info (build fingerprint, cpuinfo, etc).
disable_service_events	bool	Disable emitting events for data-source state changes (e.g. the marker for all data sources having ACKed the start of the trace).
primary_trace_clock	BuiltinClock	The authoritative clock domain for the trace. Defaults to BOOTTIME. See also ClockSnapshot's primary_trace_clock. The configured value is written into the trace as part of the ClockSnapshots emitted by the service. Trace processor will attempt to translate packet/event timestamps from various data sources (and their chosen clock domains) to this domain during import. Added in Android R.
snapshot_interval_ms	uint32	Time interval in between snapshotting of sync markers, clock snapshots, stats, and other periodic service-emitted events. Note that the service only keeps track of the first and the most recent snapshot until ReadBuffers() is called.
prefer_suspend_clock_for_snapshot	bool	Hints to the service that a suspend-aware (i.e. counting time in suspend) clock should be used for periodic snapshots of service-emitted events. This means, if a snapshot should have happened during suspend, it will happen immediately after the device resumes. Choosing a clock like this is done on best-effort basis; not all platforms (e.g. Windows) expose a clock which can be used for periodic tasks counting suspend. If such a clock is not available, the service falls back to the best-available alternative. Introduced in Android S. crashes in S.
disable_chunk_usage_histograms	bool	Disables the reporting of per-trace-writer histograms in TraceStats.

BuiltinClock

Defined in builtin_clock.proto

Enum values:

Name	Value	Description
BUILTIN_CLOCK_UNKNOWN	0
BUILTIN_CLOCK_REALTIME	1
BUILTIN_CLOCK_REALTIME_COARSE	2
BUILTIN_CLOCK_MONOTONIC	3
BUILTIN_CLOCK_MONOTONIC_COARSE	4
BUILTIN_CLOCK_MONOTONIC_RAW	5
BUILTIN_CLOCK_BOOTTIME	6
BUILTIN_CLOCK_MAX_ID	63

TraceConfig.LockdownModeOperation

Defined in trace_config.proto

Enum values:

Name	Value	Description
LOCKDOWN_UNCHANGED	0
LOCKDOWN_CLEAR	1
LOCKDOWN_SET	2

TraceConfig.ProducerConfig

Defined in trace_config.proto

Fields:

Field	Type	Description
producer_name	string	Identifies the producer for which this config is for.
shm_size_kb	uint32	Specifies the preferred size of the shared memory buffer. If the size is larger than the max size, the max will be used. If it is smaller than the page size or doesn't fit pages evenly into it, it will fall back to the size specified by the producer or finally the default shared memory size.
page_size_kb	uint32	Specifies the preferred size of each page in the shared memory buffer. Must be an integer multiple of 4K.

TraceConfig.StatsdMetadata

Contains statsd-specific metadata about an alert associated with the trace.

Defined in trace_config.proto

Fields:

Field	Type	Description
triggering_alert_id	int64	The identifier of the alert which triggered this trace.
triggering_config_uid	int32	The uid which registered the triggering configuration with statsd.
triggering_config_id	int64	The identifier of the config which triggered the alert.
triggering_subscription_id	int64	The identifier of the subscription which triggered this trace.

TraceConfig.GuardrailOverrides

Contains flags which override the default values of the guardrails inside Perfetto.

Defined in trace_config.proto

Fields:

Field	Type	Description
max_upload_per_day_bytes	uint64	Override the default limit (in bytes) for uploading data to server within a 24 hour period. On R-, this override only affected userdebug builds. Since S, it also affects user builds.
max_tracing_buffer_size_kb	uint32	Overrides the guardrail for maximum trace buffer size. Available on U+

TraceConfig.TriggerConfig

Triggers allow producers to start or stop the tracing session when an event occurs.

For example if we are tracing probabilistically, most traces will be uninteresting. Triggers allow us to keep only the interesting ones such as those traces during which the device temperature reached a certain threshold. In this case the producer can activate a trigger to keep (STOP_TRACING) the trace, otherwise it can also begin a trace (START_TRACING) because it knows something is about to happen.

Defined in trace_config.proto

Fields:

Field	Type	Description
trigger_mode	TriggerMode
use_clone_snapshot_if_available	bool	This flag is really a workaround for b/274931668. This is needed only when deploying configs to different versions of the tracing service. When this is set to true this has the same effect of setting trigger_mode to CLONE_SNAPSHOT on newer versions of the service. This boolean has been introduced to allow to have configs that use CLONE_SNAPSHOT on newer versions of Android and fall back to STOP_TRACING on older versions where CLONE_SNAPSHOT did not exist. When using this flag, trigger_mode must be set to STOP_TRACING.
triggers	Trigger[]	A list of triggers which are related to this configuration. If ANY trigger is seen then an action will be performed based on `trigger_mode`.
trigger_timeout_ms	uint32	Required and must be positive if a TriggerConfig is specified. This is how long this TraceConfig should wait for a trigger to arrive. After this period of time if no trigger is seen the TracingSession will be cleaned up.

TraceConfig.TriggerConfig.TriggerMode

Defined in trace_config.proto

Enum values:

Name	Value	Description
UNSPECIFIED	0
START_TRACING	1	When this mode is chosen, data sources are not started until one of the `triggers` are received. This supports early initialization and fast starting of the tracing system. On triggering, the session will then record for `stop_delay_ms`. However if no trigger is seen after `trigger_timeout_ms` the session will be stopped and no data will be returned.
STOP_TRACING	2	When this mode is chosen, the session will be started via the normal EnableTracing() & StartTracing(). If no trigger is ever seen the session will be stopped after `trigger_timeout_ms` and no data will be returned. However if triggered the trace will stop after `stop_delay_ms` and any data in the buffer will be returned to the consumer.
CLONE_SNAPSHOT	3	When this mode is chosen, this causes a snapshot of the current tracing session to be created after `stop_delay_ms` while the current tracing session continues undisturbed (% an extra flush). This mode can be used only when the tracing session is handled by the "perfetto" cmdline client (which is true in 90% of cases). Part of the business logic necessary for this behavior, and ensuing file handling, lives in perfetto_cmd.cc . On other consumers, this causes only a notification of the trigger through a CloneTriggerHit ObservableEvent. The custom consumer is supposed to call CloneSession() itself after the event. Use use_clone_snapshot_if_available=true when targeting older versions of perfetto.

TraceConfig.TriggerConfig.Trigger

Defined in trace_config.proto

Fields:

Field	Type	Description
name	string	The producer must specify this name to activate the trigger.
producer_name_regex	string	An std::regex that will match the producer that can activate this trigger. This is optional. If unset any producers can activate this trigger.
stop_delay_ms	uint32	After a trigger is received either in START_TRACING or STOP_TRACING mode then the trace will end `stop_delay_ms` after triggering. In CLONE_SNAPSHOT mode, this is the delay between the trigger and the snapshot. If `prefer_suspend_clock_for_duration` is set, the duration will be based on wall-clock, counting also time in suspend.
max_per_24_h	uint32	Limits the number of traces this trigger can start/stop in a rolling 24 hour window. If this field is unset or zero, no limit is applied and activiation of this trigger always starts/stops the trace.
skip_probability	double	A value between 0 and 1 which encodes the probability of skipping a trigger with this name. This is useful for reducing the probability of high-frequency triggers from dominating trace finaization. If this field is unset or zero, the trigger will never be skipped. If this field is greater than or equal to 1, this trigger will always be skipped i.e. it will be as if this trigger was never included in the first place. This probability check is applied before any other limits. For example, if `max_per_24_h` is also set, first we will check if the probability bar is met and only then will we check the `max_per_24_h` limit.

TraceConfig.IncrementalStateConfig

Configuration for trace contents that reference earlier trace data. For example, a data source might intern strings, and emit packets containing {interned id : string} pairs. Future packets from that data source can then use the interned ids instead of duplicating the raw string contents. The trace parser will then need to use that interning table to fully interpret the rest of the trace.

Defined in trace_config.proto

Fields:

Field	Type	Description
clear_period_ms	uint32	If nonzero, notify eligible data sources to clear their incremental state periodically, with the given period. The notification is sent only to data sources that have `handles_incremental_state_clear` set in their DataSourceDescriptor. The notification requests that the data source stops referring to past trace contents. This is particularly useful when tracing in ring buffer mode, where it is not exceptional to overwrite old trace data. Warning: this time-based global clearing is likely to be removed in the future, to be replaced with a smarter way of sending the notifications only when necessary.

TraceConfig.CompressionType

Compress trace with the given method. Best effort.

Defined in trace_config.proto

Enum values:

Name	Value	Description
COMPRESSION_TYPE_UNSPECIFIED	0
COMPRESSION_TYPE_DEFLATE	1

TraceConfig.IncidentReportConfig

Android-only. Not for general use. If set, saves the trace into an incident. This field is read by perfetto_cmd, rather than the tracing service. This field must be set when passing the --upload flag to perfetto_cmd.

Defined in trace_config.proto

Fields:

Field	Type	Description
destination_package	string
destination_class	string
privacy_level	int32	Level of filtering in the requested incident. See `Destination` in frameworks/base/core/proto/android/privacy.proto.
skip_incidentd	bool	If true, then skips saving the trace to incidentd. This flag is useful in testing (e.g. Perfetto-statsd integration tests) or when we explicitly don't want traces to go to incidentd even when they usually would (e.g. configs deployed using statsd but only used for inclusion in bugreports using `bugreport_score`). The motivation for having this flag, instead of just not setting `incident_report_config`, is prevent accidents where `incident_report_config` is omitted by mistake.
skip_dropbox	bool	If true, do not write the trace into dropbox (i.e. incident only). Otherwise, write to both dropbox and incident.

TraceConfig.StatsdLogging

Defined in trace_config.proto

Enum values:

Name	Value	Description
STATSD_LOGGING_UNSPECIFIED	0
STATSD_LOGGING_ENABLED	1
STATSD_LOGGING_DISABLED	2

TraceConfig.TraceFilter

When set applies a post-filter to the trace contents using the filter provided. The filter is applied at ReadBuffers() time and works both in the case of IPC readback and write_into_file. This filter can be generated using tools/proto_filter -s schema.proto -F filter_out.bytes or -T filter_out.escaped_string (for .pbtx). See go/trace-filtering for design.

Introduced in Android S, but it was broken (b/195065199). Reintroduced in Android T with a different field number.

Defined in trace_config.proto

Fields:

Field	Type	Description
bytecode	bytes

TraceConfig.AndroidReportConfig

Android-only. Not for general use. If set, reports the trace to the Android framework. This field is read by perfetto_cmd, rather than the tracing service. This field must be set when passing the --upload flag to perfetto_cmd.

Defined in trace_config.proto

Fields:

Field	Type	Description
reporter_service_package	string
reporter_service_class	string
skip_report	bool	If true, then skips reporting the trace to Android framework. This flag is useful in testing (e.g. Perfetto-statsd integration tests) or when we explicitly don't want to report traces to the framework even when they usually would (e.g. configs deployed using statsd but only used for inclusion in bugreports using `bugreport_score`). The motivation for having this flag, instead of just not setting `framework_report_config`, is prevent accidents where `framework_report_config` is omitted by mistake.
use_pipe_in_framework_for_testing	bool	If true, will direct the Android framework to read the data in trace file and pass it to the reporter class over a pipe instead of passing the file descriptor directly. This flag is needed because the Android test framework does not currently support priv-app helper apps (in terms of SELinux) and we really don't want to add an allow rule for untrusted_app to receive trace fds. Because of this, we instead will direct the framework to create a new pipe and pass this to the reporter process instead. As the pipe is created by the framework, we won't have any problems with SELinux (system_server is already allowed to pass pipe fds, even to untrusted apps). As the name suggests this option MUST only be used for testing. Note that the framework will reject (and drop) files which are too large both for simplicity and to be minimize the amount of data we pass to a non-priv app (note that the framework will still check manifest permissions even though SELinux permissions are worked around).

TraceConfig.CmdTraceStartDelay

If set, delays the start of tracing by a random duration. The duration is chosen from a uniform distribution between the specified minimum and maximum. Note: this delay is implemented by perfetto_cmd not by traced so will not work if you communicate with traced directly over the consumer API. Introduced in Android T.

Defined in trace_config.proto

Fields:

Field	Type	Description
min_delay_ms	uint32
max_delay_ms	uint32