xref: /aosp_15_r20/external/perfetto/protos/perfetto/config/perfetto_config.proto (revision 6dbdd20afdafa5e3ca9b8809fa73465d530080dc)
1// AUTOGENERATED - DO NOT EDIT
2// ---------------------------
3// This file has been generated by
4// AOSP://external/perfetto/tools/gen_merged_protos
5// merging the perfetto config protos.
6// This fused proto is intended to be copied in:
7//  - Android tree, for statsd.
8//  - Google internal repos.
9
10syntax = "proto2";
11
12package perfetto.protos;
13
14option go_package = "github.com/google/perfetto/perfetto_proto";
15
16// Begin of protos/perfetto/common/ftrace_descriptor.proto
17
18message FtraceDescriptor {
19  message AtraceCategory {
20    optional string name = 1;
21    optional string description = 2;
22  }
23
24  // Report the available atrace categories.
25  //
26  // Used by Traceur via `perfetto --query`.
27  repeated AtraceCategory atrace_categories = 1;
28}
29
30// End of protos/perfetto/common/ftrace_descriptor.proto
31
32// Begin of protos/perfetto/common/gpu_counter_descriptor.proto
33
34// Description of GPU counters.
35// This message is sent by a GPU counter producer to specify the counters
36// available in the hardware.
37message GpuCounterDescriptor {
38  // Logical groups for a counter.  This is used in the UI to present the
39  // related counters together.
40  enum GpuCounterGroup {
41    UNCLASSIFIED = 0;
42    SYSTEM = 1;
43    VERTICES = 2;
44    FRAGMENTS = 3;
45    PRIMITIVES = 4;
46    // Includes counters relating to caching and bandwidth.
47    MEMORY = 5;
48    COMPUTE = 6;
49  }
50
51  message GpuCounterSpec {
52    optional uint32 counter_id = 1;
53    optional string name = 2;
54    optional string description = 3;
55    // MeasureUnit unit (deprecated)
56    reserved 4;
57    oneof peak_value {
58      int64 int_peak_value = 5;
59      double double_peak_value = 6;
60    }
61    repeated MeasureUnit numerator_units = 7;
62    repeated MeasureUnit denominator_units = 8;
63    optional bool select_by_default = 9;
64    repeated GpuCounterGroup groups = 10;
65  }
66  repeated GpuCounterSpec specs = 1;
67
68  // Allow producer to group counters into block to represent counter islands.
69  // A capacity may be specified to indicate the number of counters that can be
70  // enable simultaneously in that block.
71  message GpuCounterBlock {
72    // required. Unique ID for the counter group.
73    optional uint32 block_id = 1;
74    // optional. Number of counters supported by the block. No limit if unset.
75    optional uint32 block_capacity = 2;
76    // optional. Name of block.
77    optional string name = 3;
78    // optional. Description for the block.
79    optional string description = 4;
80    // list of counters that are part of the block.
81    repeated uint32 counter_ids = 5;
82  }
83  repeated GpuCounterBlock blocks = 2;
84
85  // optional.  Minimum sampling period supported by the producer in
86  // nanoseconds.
87  optional uint64 min_sampling_period_ns = 3;
88
89  // optional.  Maximum sampling period supported by the producer in
90  // nanoseconds.
91  optional uint64 max_sampling_period_ns = 4;
92
93  // optional.  The producer supports counter sampling by instrumenting the
94  // command buffer.
95  optional bool supports_instrumented_sampling = 5;
96
97  // next id: 41
98  enum MeasureUnit {
99    NONE = 0;
100
101    BIT = 1;
102    KILOBIT = 2;
103    MEGABIT = 3;
104    GIGABIT = 4;
105    TERABIT = 5;
106    PETABIT = 6;
107
108    BYTE = 7;
109    KILOBYTE = 8;
110    MEGABYTE = 9;
111    GIGABYTE = 10;
112    TERABYTE = 11;
113    PETABYTE = 12;
114
115    HERTZ = 13;
116    KILOHERTZ = 14;
117    MEGAHERTZ = 15;
118    GIGAHERTZ = 16;
119    TERAHERTZ = 17;
120    PETAHERTZ = 18;
121
122    NANOSECOND = 19;
123    MICROSECOND = 20;
124    MILLISECOND = 21;
125    SECOND = 22;
126    MINUTE = 23;
127    HOUR = 24;
128
129    VERTEX = 25;
130    PIXEL = 26;
131    TRIANGLE = 27;
132    PRIMITIVE = 38;
133    FRAGMENT = 39;
134
135    MILLIWATT = 28;
136    WATT = 29;
137    KILOWATT = 30;
138
139    JOULE = 31;
140    VOLT = 32;
141    AMPERE = 33;
142
143    CELSIUS = 34;
144    FAHRENHEIT = 35;
145    KELVIN = 36;
146
147    // Values should be out of 100.
148    PERCENT = 37;
149
150    INSTRUCTION = 40;
151  }
152}
153
154// End of protos/perfetto/common/gpu_counter_descriptor.proto
155
156// Begin of protos/perfetto/common/track_event_descriptor.proto
157
158message TrackEventCategory {
159  optional string name = 1;
160  optional string description = 2;
161  repeated string tags = 3;
162}
163
164message TrackEventDescriptor {
165  repeated TrackEventCategory available_categories = 1;
166}
167
168// End of protos/perfetto/common/track_event_descriptor.proto
169
170// Begin of protos/perfetto/common/data_source_descriptor.proto
171
172// This message is sent from Producer(s) to the tracing Service when registering
173// to advertise their capabilities. It describes the structure of tracing
174// protos that will be produced by the data source and the supported filters.
175message DataSourceDescriptor {
176  // e.g., "linux.ftrace", "chromium.tracing"
177  optional string name = 1;
178
179  // When non-zero, this is a unique ID within the scope of the Producer for
180  // this data source (it is NOT globally unique). This is useful to
181  // differentiate between data sources with matching names when calling
182  // UpdateDataSource(). This field has been introduced in November 2021
183  // (v22, Android T) and is not supported on older versions.
184  optional uint64 id = 7;
185
186  // When true the data source is expected to ack the stop request through the
187  // NotifyDataSourceStopped() IPC. This field has been introduced after
188  // Android P in Jul 2018 and is not supported on older versions.
189  optional bool will_notify_on_stop = 2;
190
191  // When true the data source is expected to ack the start request through the
192  // NotifyDataSourceStarted() IPC. This field has been introduced after
193  // Android P in March 2019 and is not supported on older versions.
194  optional bool will_notify_on_start = 3;
195
196  // If true, opt into receiving the ClearIncrementalState() IPC. This should be
197  // set if the data source writes packets that refer to previous trace
198  // contents, and knows how to stop referring to the already-emitted data.
199  optional bool handles_incremental_state_clear = 4;
200
201  // If true, indicates that the data source does nothing upon Flush. This
202  // allows the service to reduce the flush-related IPC traffic and better deal
203  // with frozen producers (see go/perfetto-frozen). This is usually the case
204  // for data sources like 'track_event' that don't have access to the various
205  // thread task runners to post a flush task and rely purely on server-side
206  // scraping.
207  // Introduced in v39 / Android V.
208  optional bool no_flush = 9;
209
210  // Optional specification about available GPU counters.
211  optional GpuCounterDescriptor gpu_counter_descriptor = 5 [lazy = true];
212
213  optional TrackEventDescriptor track_event_descriptor = 6 [lazy = true];
214
215  optional FtraceDescriptor ftrace_descriptor = 8 [lazy = true];
216}
217
218// End of protos/perfetto/common/data_source_descriptor.proto
219
220// Begin of protos/perfetto/common/tracing_service_state.proto
221
222// Reports the state of the tracing service. Used to gather details about the
223// data sources connected.
224// See ConsumerPort::QueryServiceState().
225message TracingServiceState {
226  // Describes a producer process.
227  message Producer {
228    // Unique ID of the producer (monotonic counter).
229    optional int32 id = 1;
230
231    // Typically matches the process name.
232    optional string name = 2;
233
234    // Unix pid of the remote process. Supported only on Linux-based systems.
235    // Introduced in v24 / Android T.
236    optional int32 pid = 5;
237
238    // Unix uid of the remote process.
239    optional int32 uid = 3;
240
241    // The version of the client library used by the producer.
242    // This is a human readable string with and its format varies depending on
243    // the build system and the repo (standalone vs AOSP).
244    // This is intended for human debugging only.
245    optional string sdk_version = 4;
246
247    // Returns true if the process appears to be frozen (Android only).
248    // Introduced in Perfetto V49 / Android 24Q4.
249    optional bool frozen = 6;
250  }
251
252  // Describes a data source registered by a producer. Data sources are listed
253  // regardless of the fact that they are being used or not.
254  message DataSource {
255    // Descriptor passed by the data source when calling RegisterDataSource().
256    optional DataSourceDescriptor ds_descriptor = 1;
257
258    // ID of the producer, as per Producer.id.
259    optional int32 producer_id = 2;
260  }
261
262  message TracingSession {
263    // The TracingSessionID.
264    optional uint64 id = 1;
265
266    // The Unix uid of the consumer that started the session.
267    // This is meaningful only if the caller is root. In all other cases only
268    // tracing sessions that match the caller UID will be displayed.
269    optional int32 consumer_uid = 2;
270
271    // Internal state of the tracing session.
272    // These strings are FYI only and subjected to change.
273    optional string state = 3;
274
275    // The unique_session_name as set in the trace config (might be empty).
276    optional string unique_session_name = 4;
277
278    // The number and size of each buffer.
279    repeated uint32 buffer_size_kb = 5;
280
281    // Duration, as specified in the TraceConfig.duration_ms.
282    optional uint32 duration_ms = 6;
283
284    // Number of data sources involved in the session.
285    optional uint32 num_data_sources = 7;
286
287    // Time when the session was started, in the CLOCK_REALTIME domain.
288    // Available only on Linux-based systems.
289    optional int64 start_realtime_ns = 8;
290
291    // The fields below have been introduced in v42.
292
293    // The bugreport_score, as set in TraceConfig.bugreport_score.
294    optional int32 bugreport_score = 9;
295
296    // As per TraceConfig.bugreport_filename.
297    optional string bugreport_filename = 10;
298
299    // If true, the session is in the STARTED state. If false the session is in
300    // any other state (see `state` field).
301    optional bool is_started = 11;
302  }
303
304  // Lists all the producers connected.
305  repeated Producer producers = 1;
306
307  // Lists the data sources available.
308  repeated DataSource data_sources = 2;
309
310  // Lists the tracing sessions active AND owned by a consumer that has the same
311  // UID of the caller (or all of them if the caller is root).
312  // Introduced in v24 / Android T.
313  repeated TracingSession tracing_sessions = 6;
314
315  // This is always set to true from v24 and beyond. This flag is only used to
316  // tell the difference between: (1) talking to a recent service which happens
317  // to have no tracing session active; (2) talking to an older version of the
318  // service which will never report any tracing session.
319  optional bool supports_tracing_sessions = 7;
320
321  // Total number of tracing sessions.
322  optional int32 num_sessions = 3;
323
324  // Number of tracing sessions in the started state. Always <= num_sessions.
325  optional int32 num_sessions_started = 4;
326
327  // The version of traced (the same returned by `traced --version`).
328  // This is a human readable string with and its format varies depending on
329  // the build system and the repo (standalone vs AOSP).
330  // This is intended for human debugging only.
331  optional string tracing_service_version = 5;
332}
333
334// End of protos/perfetto/common/tracing_service_state.proto
335
336// Begin of protos/perfetto/common/builtin_clock.proto
337
338enum BuiltinClock {
339  BUILTIN_CLOCK_UNKNOWN = 0;
340  BUILTIN_CLOCK_REALTIME = 1;
341  BUILTIN_CLOCK_REALTIME_COARSE = 2;
342  BUILTIN_CLOCK_MONOTONIC = 3;
343  BUILTIN_CLOCK_MONOTONIC_COARSE = 4;
344  BUILTIN_CLOCK_MONOTONIC_RAW = 5;
345  BUILTIN_CLOCK_BOOTTIME = 6;
346  BUILTIN_CLOCK_TSC = 9;
347  BUILTIN_CLOCK_PERF = 10;
348  BUILTIN_CLOCK_MAX_ID = 63;
349
350  reserved 7, 8;
351}
352
353// End of protos/perfetto/common/builtin_clock.proto
354
355// Begin of protos/perfetto/config/android/android_game_intervention_list_config.proto
356
357// Data source that lists game modes and game interventions of games
358// on an Android device.
359message AndroidGameInterventionListConfig {
360  // If not empty, emit info about only the following list of package names
361  // (exact match, no regex). Otherwise, emit info about all packages.
362  repeated string package_name_filter = 1;
363}
364
365// End of protos/perfetto/config/android/android_game_intervention_list_config.proto
366
367// Begin of protos/perfetto/config/android/android_input_event_config.proto
368
369// Custom configuration for the "android.input.inputevent" data source.
370//
371// NOTE: Input traces can only be taken on debuggable (userdebug/eng) builds!
372//
373// Next ID: 5
374message AndroidInputEventConfig {
375  // Trace modes are tracing presets that are included in the system.
376  enum TraceMode {
377    // Preset mode for maximal tracing.
378    // WARNING: This will bypass all privacy measures on debuggable builds, and
379    // will record all
380    //          input events processed by the system, regardless of the context
381    //          in which they were processed. It should only be used for tracing
382    //          on a local device or for tests. It should NEVER be used for
383    //          field tracing.
384    TRACE_MODE_TRACE_ALL = 0;
385    // Use the tracing rules defined in this config to specify what events to
386    // trace.
387    TRACE_MODE_USE_RULES = 1;
388  }
389
390  // The tracing mode to use. If unspecified, it will default to
391  // TRACE_MODE_USE_RULES.
392  optional TraceMode mode = 1;
393
394  // The level of tracing that should be applied to an event.
395  enum TraceLevel {
396    // Do not trace the input event.
397    TRACE_LEVEL_NONE = 0;
398    // Trace the event as a redacted event, where certain sensitive fields are
399    // omitted from the trace, including the coordinates of pointer events and
400    // the key/scan codes of key events.
401    TRACE_LEVEL_REDACTED = 1;
402    // Trace the complete event.
403    TRACE_LEVEL_COMPLETE = 2;
404  }
405
406  // A rule that specifies the TraceLevel for an event based on matching
407  // conditions. All matchers in the rule are optional. To trigger this rule, an
408  // event must match all of its specified matchers (i.e. the matchers function
409  // like a series of conditions connected by a logical 'AND' operator). A rule
410  // with no specified matchers will match all events. Next ID: 6
411  message TraceRule {
412    // The trace level to be used for events that trigger this rule.
413    // If unspecified, TRACE_LEVEL_NONE will be used by default.
414    optional TraceLevel trace_level = 1;
415
416    // --- Optional Matchers ---
417
418    // Package matchers
419    //
420    // Respectively matches if all or any of the target apps for this event are
421    // contained in the specified list of package names.
422    //
423    // Intended usage:
424    //   - Use match_all_packages to selectively allow tracing for the listed
425    //   packages.
426    //   - Use match_any_packages to selectively deny tracing for certain
427    //   packages.
428    //
429    // WARNING: Great care must be taken when designing rules for field tracing!
430    //          This is because each event is almost always sent to more than
431    //          one app.
432    //              For example, when allowing tracing for a package that has a
433    //              spy window
434    //          over the display (e.g. SystemUI) using match_any_packages,
435    //          essentially all input will be recorded on that display. This is
436    //          because the events will be sent to the spy as well as the
437    //          foreground app, and regardless of what the foreground app is,
438    //          the event will end up being traced.
439    //              Alternatively, when attempting to block tracing for specific
440    //              packages using
441    //          match_all_packages, no events will likely be blocked. This is
442    //          because the event will also be sent to other apps (such as, but
443    //          not limited to, ones with spy windows), so the matcher will not
444    //          match unless all other targets are also listed under the
445    //          match_all_packages list.
446    repeated string match_all_packages = 2;
447    repeated string match_any_packages = 3;
448
449    // Matches if the event is secure, which means that at least one of the
450    // targets of this event is using the window flag FLAG_SECURE.
451    optional bool match_secure = 4;
452
453    // Matches if there was an active IME connection while this event was being
454    // processed.
455    optional bool match_ime_connection_active = 5;
456  }
457
458  // The list of rules to use to determine the trace level of events.
459  // Each event will be traced using the TraceLevel of the first rule that it
460  // triggers from this list. The rules are evaluated in the order in which they
461  // are specified. If an event does not match any of the rules,
462  // TRACE_LEVEL_NONE will be used by default.
463  repeated TraceRule rules = 2;
464
465  // --- Control flags ---
466
467  // Trace input events processed by the system as they are being dispatched
468  // to application windows. All trace rules will apply.
469  //   - If this flag is used without enabling trace_dispatcher_window_dispatch,
470  //   it will
471  //     trace InputDispatcher's inbound events (which does not include events
472  //     synthesized within InputDispatcher) that match the rules.
473  //   - If used with trace_dispatcher_window_dispatch, all inbound and outbound
474  //   events
475  //     matching the rules, including all events synthesized within
476  //     InputDispatcher, will be traced.
477  optional bool trace_dispatcher_input_events = 3;
478
479  // Trace details about which windows the system is sending each input event
480  // to. All trace rules will apply.
481  optional bool trace_dispatcher_window_dispatch = 4;
482}
483
484// End of protos/perfetto/config/android/android_input_event_config.proto
485
486// Begin of protos/perfetto/common/android_log_constants.proto
487
488// Values from NDK's android/log.h.
489enum AndroidLogId {
490  // MAIN.
491  LID_DEFAULT = 0;
492
493  LID_RADIO = 1;
494  LID_EVENTS = 2;
495  LID_SYSTEM = 3;
496  LID_CRASH = 4;
497  LID_STATS = 5;
498  LID_SECURITY = 6;
499  LID_KERNEL = 7;
500}
501
502enum AndroidLogPriority {
503  PRIO_UNSPECIFIED = 0;
504
505  // _DEFAULT, but should never be seen in logs.
506  PRIO_UNUSED = 1;
507
508  PRIO_VERBOSE = 2;
509  PRIO_DEBUG = 3;
510  PRIO_INFO = 4;
511  PRIO_WARN = 5;
512  PRIO_ERROR = 6;
513  PRIO_FATAL = 7;
514}
515
516// End of protos/perfetto/common/android_log_constants.proto
517
518// Begin of protos/perfetto/config/android/android_log_config.proto
519
520message AndroidLogConfig {
521  repeated AndroidLogId log_ids = 1;
522
523  // Was |poll_ms|, deprecated.
524  reserved 2;
525
526  // If set ignores all log messages whose prio is < the given value.
527  optional AndroidLogPriority min_prio = 3;
528
529  // If non-empty ignores all log messages whose tag doesn't match one of the
530  // specified values.
531  repeated string filter_tags = 4;
532}
533
534// End of protos/perfetto/config/android/android_log_config.proto
535
536// Begin of protos/perfetto/config/android/android_polled_state_config.proto
537
538// Data source that polls for display state. This should only be used for
539// backward-compatibility; AndroidSystemPropertyConfig should be preferred.
540message AndroidPolledStateConfig {
541  // Frequency of polling. If absent the state will be recorded once, at the
542  // start of the trace.
543  // This is required to be > 100ms to avoid excessive CPU usage.
544  optional uint32 poll_ms = 1;
545}
546
547// End of protos/perfetto/config/android/android_polled_state_config.proto
548
549// Begin of protos/perfetto/config/android/android_sdk_sysprop_guard_config.proto
550
551// Data source that controls the system properties used to guard initialization
552// of track_event producers (i.e. Skia) in apps using HWUI, and certain
553// processes like SurfaceFlinger.
554//
555// This data source only tells Skia to initialized the Perfetto SDK and start
556// routing data to the Track Event system instead of ATrace. For those events
557// to actually show up in a trace, the track_event data source must be used as
558// well. The Perfetto SDK cannot be de-initialized, so some long-lived apps and
559// processes may need to be restarted for Skia to revert to using ATrace if
560// Track Events are no longer desired.
561//
562// In addition to switching Skia to use Perfetto's track_event data source,
563// this "guard" also controls Skia's "broad tracing", which removes Skia's
564// internal tracing constraints and allows the track_event config to specify
565// which categories should be traced. Filtering to the "skia.always" category
566// *tag* in a track_event config can be used to re-enable the standard
567// constraints typically used with ATrace.
568//
569// Data source name: android.sdk_sysprop_guard
570// Introduced in Android 14 (U) QPR1.
571// Next id: 4
572message AndroidSdkSyspropGuardConfig {
573  // If true, configures SurfaceFlinger to initialize Skia's Perfetto
574  // integration with the track_event data source in RenderEngine.
575  // If false or omitted, the simpler ATrace fallback is used.
576  //
577  // NOTE: once enabled, Skia will only revert to ATrace if SurfaceFlinger is
578  // restarted.
579  //
580  // Specifically this sets the following system properties:
581  //   - debug.tracing.ctl.renderengine.skia_tracing_enabled
582  //   - debug.tracing.ctl.renderengine.skia_use_perfetto_track_events
583  //
584  // Does not affect actual track_event data *collection*, which must be
585  // configured separately.
586  optional bool surfaceflinger_skia_track_events = 1;
587
588  // If true, configures HWUI apps to initialize Skia's Perfetto integration
589  // with the track_event data source. hwui_package_name_filter
590  // can be used to control which apps are affected.
591  // If false or omitted, the simpler ATrace fallback is used.
592  //
593  // NOTE: once enabled, Skia will only revert to ATrace if the app is
594  // restarted.
595  //
596  // ATTENTION: affects ALL HWUI APPS if hwui_package_name_filter is not set!
597  // If filtering is NOT set, this controls these GLOBAL system properties:
598  //   - debug.tracing.ctl.hwui.skia_tracing_enabled
599  //   - debug.tracing.ctl.hwui.skia_use_perfetto_track_events
600  // If filtering IS set, this controls these APP-SPECIFIC system properties,
601  // for each package listed in the filter:
602  //   - debug.tracing.ctl.hwui.skia_tracing_enabled.<package.name>
603  //   - debug.tracing.ctl.hwui.skia_use_perfetto_track_events.<package.name>
604  //
605  // Does not affect actual track_event data *collection*, which must be
606  // configured separately.
607  optional bool hwui_skia_track_events = 2;
608
609  // If non-empty, hwui_skia_track_events applies to only the packages listed.
610  // Otherwise, hwui_skia_track_events applies globally to all HWUI apps.
611  repeated string hwui_package_name_filter = 3;
612}
613
614// End of protos/perfetto/config/android/android_sdk_sysprop_guard_config.proto
615
616// Begin of protos/perfetto/config/android/android_system_property_config.proto
617
618// Data source that polls for system properties.
619message AndroidSystemPropertyConfig {
620  // Frequency of polling. If absent the state will be recorded once, at the
621  // start of the trace.
622  // This is required to be > 100ms to avoid excessive CPU usage.
623  optional uint32 poll_ms = 1;
624
625  // Properties to poll. All property names must start with "debug.tracing.".
626  repeated string property_name = 2;
627}
628
629// End of protos/perfetto/config/android/android_system_property_config.proto
630
631// Begin of protos/perfetto/config/android/network_trace_config.proto
632
633// Network tracing data source that records details on all packets sent or
634// received by the network.
635message NetworkPacketTraceConfig {
636  // Polling frequency in milliseconds. Network tracing writes to a fixed size
637  // ring buffer. The polling interval should be such that the ring buffer is
638  // unlikely to fill in that interval (or that filling is an acceptable risk).
639  // The minimum polling rate is 100ms (values below this are ignored).
640  // Introduced in Android 14 (U).
641  optional uint32 poll_ms = 1;
642
643  // The aggregation_threshold is the number of packets at which an event will
644  // switch from per-packet details to aggregate details. For example, a value
645  // of 50 means that if a particular event (grouped by the unique combinations
646  // of metadata fields: {interface, direction, uid, etc}) has fewer than 50
647  // packets, the exact timestamp and length are recorded for each packet. If
648  // there were 50 or more packets in an event, it would only record the total
649  // duration, packets, and length. A value of zero or unspecified will always
650  /// record per-packet details. A value of 1 always records aggregate details.
651  optional uint32 aggregation_threshold = 2;
652
653  // Specifies the maximum number of packet contexts to intern at a time. This
654  // prevents the interning table from growing too large and controls whether
655  // interning is enabled or disabled (a value of zero disables interning and
656  // is the default). When a data sources interning table reaches this amount,
657  // packet contexts will be inlined into NetworkPacketEvents.
658  optional uint32 intern_limit = 3;
659
660  // The following fields specify whether certain fields should be dropped from
661  // the output. Dropping fields improves normalization results, reduces the
662  // size of the interning table, and slightly reduces event size.
663  optional bool drop_local_port = 4;
664  optional bool drop_remote_port = 5;
665  optional bool drop_tcp_flags = 6;
666}
667
668// End of protos/perfetto/config/android/network_trace_config.proto
669
670// Begin of protos/perfetto/config/android/packages_list_config.proto
671
672// Data source that lists details (such as version code) about packages on an
673// Android device.
674message PackagesListConfig {
675  // If not empty, emit info about only the following list of package names
676  // (exact match, no regex). Otherwise, emit info about all packages.
677  repeated string package_name_filter = 1;
678}
679
680// End of protos/perfetto/config/android/packages_list_config.proto
681
682// Begin of protos/perfetto/config/android/pixel_modem_config.proto
683
684// Data source that records events from the modem.
685message PixelModemConfig {
686  // Event group to record, as defined by the modem.
687  enum EventGroup {
688    EVENT_GROUP_UNKNOWN = 0;
689
690    // Events suitable for low bandwidth tracing only.
691    EVENT_GROUP_LOW_BANDWIDTH = 1;
692
693    // Events suitable for high and low bandwidth tracing.
694    EVENT_GROUP_HIGH_AND_LOW_BANDWIDTH = 2;
695  }
696
697  optional EventGroup event_group = 1;
698
699  // If set, record only events with these hashes.
700  repeated int64 pigweed_hash_allow_list = 2;
701
702  // If set and allow_list is not set, deny events with these hashes.
703  repeated int64 pigweed_hash_deny_list = 3;
704}
705
706// End of protos/perfetto/config/android/pixel_modem_config.proto
707
708// Begin of protos/perfetto/common/protolog_common.proto
709
710enum ProtoLogLevel {
711  PROTOLOG_LEVEL_UNDEFINED = 0;
712  PROTOLOG_LEVEL_DEBUG = 1;
713  PROTOLOG_LEVEL_VERBOSE = 2;
714  PROTOLOG_LEVEL_INFO = 3;
715  PROTOLOG_LEVEL_WARN = 4;
716  PROTOLOG_LEVEL_ERROR = 5;
717  PROTOLOG_LEVEL_WTF = 6;
718}
719// End of protos/perfetto/common/protolog_common.proto
720
721// Begin of protos/perfetto/config/android/protolog_config.proto
722
723// Custom configuration for the "android.protolog" data source.
724// ProtoLog is a logging mechanism that is intented to be more efficient than
725// logcat. This configures what logs to capture in the tracing instance.
726message ProtoLogConfig {
727  enum TracingMode {
728    // When using the DEFAULT tracing mode, only log groups and levels specified
729    // in the group_overrides are traced.
730    DEFAULT = 0;
731    // When using the ENABLE_ALL tracing mode, all log groups and levels are
732    // traced, unless specified in the group_overrides.
733    ENABLE_ALL = 1;
734  }
735
736  // Specified the configurations for each of the logging groups. If none is
737  // specified for a group the defaults will be used.
738  repeated ProtoLogGroup group_overrides = 1;
739  // Specified what tracing mode to use for the tracing instance.
740  optional TracingMode tracing_mode = 2;
741  // If set, any message with log level higher than this level (inclusive) will
742  // be traced. Group overrides take precedence over this value.
743  optional ProtoLogLevel default_log_from_level = 3;
744}
745
746message ProtoLogGroup {
747  // The ProtoLog group name this configuration entry applies to.
748  optional string group_name = 1;
749  // Specify the level from which to start capturing protologs.
750  // e.g. if ProtoLogLevel.WARN is specified only warning, errors and fatal log
751  // message will be traced.
752  optional ProtoLogLevel log_from = 2;
753  // When set to true we will collect the stacktrace for each protolog message
754  // in this group that we are tracing.
755  optional bool collect_stacktrace = 3;
756}
757
758// End of protos/perfetto/config/android/protolog_config.proto
759
760// Begin of protos/perfetto/config/android/surfaceflinger_layers_config.proto
761
762// Custom configuration for the "android.surfaceflinger.layers" data source.
763message SurfaceFlingerLayersConfig {
764  enum Mode {
765    MODE_UNSPECIFIED = 0;
766
767    // Trace layers snapshots. A snapshot is taken every time a layers change
768    // occurs.
769    MODE_ACTIVE = 1;
770
771    // Generate layers snapshots from the transactions kept in the
772    // SurfaceFlinger's internal ring buffer.
773    // The layers snapshots generation occurs when this data source is flushed.
774    MODE_GENERATED = 2;
775
776    // Trace a single layers snapshot.
777    MODE_DUMP = 3;
778
779    // Default mode (applied by SurfaceFlinger if no mode is specified).
780    // Same as MODE_GENERATED, but triggers the layers snapshots generation only when a bugreport
781    // is taken.
782    MODE_GENERATED_BUGREPORT_ONLY = 4;
783  }
784  optional Mode mode = 1;
785
786  enum TraceFlag {
787    TRACE_FLAG_UNSPECIFIED = 0;
788    TRACE_FLAG_INPUT = 0x02;
789    TRACE_FLAG_COMPOSITION = 0x04;
790    TRACE_FLAG_EXTRA = 0x08;
791    TRACE_FLAG_HWC = 0x10;
792    TRACE_FLAG_BUFFERS = 0x20;
793    TRACE_FLAG_VIRTUAL_DISPLAYS = 0x40;
794
795    // INPUT | COMPOSITION | EXTRA
796    TRACE_FLAG_ALL = 0x0e;
797  }
798  repeated TraceFlag trace_flags = 2;
799}
800
801// End of protos/perfetto/config/android/surfaceflinger_layers_config.proto
802
803// Begin of protos/perfetto/config/android/surfaceflinger_transactions_config.proto
804
805// Custom configuration for the "android.surfaceflinger.transactions" data
806// source.
807message SurfaceFlingerTransactionsConfig {
808  enum Mode {
809    MODE_UNSPECIFIED = 0;
810
811    // Default mode (applied by SurfaceFlinger if no mode is specified).
812    // SurfaceFlinger writes its internal ring buffer of transactions every time
813    // the data source is flushed. The ring buffer contains the SurfaceFlinger's
814    // initial state and the latest transactions.
815    MODE_CONTINUOUS = 1;
816
817    // SurfaceFlinger writes the initial state and then each incoming
818    // transaction until the data source is stopped.
819    MODE_ACTIVE = 2;
820  }
821  optional Mode mode = 1;
822}
823
824// End of protos/perfetto/config/android/surfaceflinger_transactions_config.proto
825
826// Begin of protos/perfetto/config/android/windowmanager_config.proto
827
828// Custom configuration for the "android.windowmanager" data source.
829message WindowManagerConfig {
830  enum LogFrequency {
831    LOG_FREQUENCY_UNSPECIFIED = 0;
832
833    // Trace state snapshots when a frame is committed.
834    LOG_FREQUENCY_FRAME = 1;
835
836    // Trace state snapshots every time a transaction is committed.
837    LOG_FREQUENCY_TRANSACTION = 2;
838
839    // Trace single state snapshots when the data source is started.
840    LOG_FREQUENCY_SINGLE_DUMP = 3;
841  }
842  optional LogFrequency log_frequency = 1;
843
844  enum LogLevel {
845    LOG_LEVEL_UNSPECIFIED = 0;
846
847    // Logs all elements with maximum amount of information.
848    LOG_LEVEL_VERBOSE = 1;
849
850    // Logs all elements but doesn't write all configuration data.
851    LOG_LEVEL_DEBUG = 2;
852
853    // Logs only visible elements, with the minimum amount of performance
854    // overhead
855    LOG_LEVEL_CRITICAL = 3;
856  }
857  optional LogLevel log_level = 2;
858}
859
860// End of protos/perfetto/config/android/windowmanager_config.proto
861
862// Begin of protos/perfetto/config/chrome/chrome_config.proto
863
864message ChromeConfig {
865  optional string trace_config = 1;
866
867  // When enabled, the data source should only fill in fields in the output that
868  // are not potentially privacy sensitive.
869  optional bool privacy_filtering_enabled = 2;
870
871  // Instead of emitting binary protobuf, convert the trace data to the legacy
872  // JSON format. Note that the trace data will still be returned as a series of
873  // TracePackets, but the embedded data will be JSON instead of serialized
874  // protobuf.
875  optional bool convert_to_legacy_json = 3;
876
877  // Priority of the tracing session client. A higher priority session may
878  // preempt a lower priority one in configurations where concurrent sessions
879  // aren't supported.
880  enum ClientPriority {
881    UNKNOWN = 0;
882    BACKGROUND = 1;
883    USER_INITIATED = 2;
884  }
885  optional ClientPriority client_priority = 4;
886
887  // Applicable only when using legacy JSON format.
888  // If |json_agent_label_filter| is not empty, only data pertaining to
889  // the specified tracing agent label (e.g. "traceEvents") will be returned.
890  optional string json_agent_label_filter = 5;
891}
892
893// End of protos/perfetto/config/chrome/chrome_config.proto
894
895// Begin of protos/perfetto/config/chrome/system_metrics.proto
896
897message ChromiumSystemMetricsConfig {
898  // Samples counters every X ms.
899  optional uint32 sampling_interval_ms = 1;
900}
901
902// End of protos/perfetto/config/chrome/system_metrics.proto
903
904// Begin of protos/perfetto/config/chrome/v8_config.proto
905
906message V8Config {
907  // Whether to log the actual content of scripts (e.g. content of the JS file
908  // that was compiled to generate code).
909  // ATTENTION: This could considerably increase the size of the resuling trace
910  //            file.
911  optional bool log_script_sources = 1;
912  // Whether to log the generated code for jitted functions (machine code or
913  // bytecode).
914  // ATTENTION: This could considerably increase the size of the resuling trace
915  //            file.
916  optional bool log_instructions = 2;
917}
918
919// End of protos/perfetto/config/chrome/v8_config.proto
920
921// Begin of protos/perfetto/config/etw/etw_config.proto
922
923// Proto definition based on the struct _EVENT_TRACE_PROPERTIES definition
924// See: https://learn.microsoft.com/en-us/windows/win32/api/evntrace/
925// ns-evntrace-event_trace_properties
926message EtwConfig {
927  // The KernelFlag represent list of kernel flags that we are intrested in.
928  // To get a more extensive list run 'xperf -providers k'.
929  enum KernelFlag {
930    CSWITCH = 0;
931    DISPATCHER = 1;
932  }
933
934  // The kernel_flags determines the flags that will be used by the etw tracing
935  // session. These kernel flags have been built to expose the useful events
936  // captured from the kernel mode only.
937  repeated KernelFlag kernel_flags = 1;
938}
939// End of protos/perfetto/config/etw/etw_config.proto
940
941// Begin of protos/perfetto/config/ftrace/ftrace_config.proto
942
943// Next id: 31
944message FtraceConfig {
945  // Ftrace events to record, example: "sched/sched_switch".
946  repeated string ftrace_events = 1;
947
948  message KprobeEvent {
949    enum KprobeType {
950      KPROBE_TYPE_UNKNOWN = 0;
951      KPROBE_TYPE_KPROBE = 1;
952      KPROBE_TYPE_KRETPROBE = 2;
953      KPROBE_TYPE_BOTH = 3;
954    }
955    // Kernel function name to attach to, for example "fuse_file_write_iter"
956    optional string probe = 1;
957    optional KprobeType type = 2;
958  }
959
960  // Ftrace events to record, specific for kprobes and kretprobes
961  repeated KprobeEvent kprobe_events = 30;
962
963  // Android-specific event categories:
964  repeated string atrace_categories = 2;
965  repeated string atrace_apps = 3;
966  // Some processes can emit data through atrace or through the perfetto SDK via
967  // the "track_event" data source. For these categories, the SDK will be
968  // preferred, if possible, for this config.
969  repeated string atrace_categories_prefer_sdk = 28;
970
971  // Size of each per-cpu kernel ftrace ring buffer.
972  // Not guaranteed if there are multiple concurrent tracing sessions, as the
973  // buffers cannot be resized without pausing recording in the kernel.
974  optional uint32 buffer_size_kb = 10;
975
976  // If set, specifies how often the tracing daemon reads from the kernel ring
977  // buffer. Not guaranteed if there are multiple concurrent tracing sessions.
978  // Leave unset unless you're fine-tuning a local config.
979  optional uint32 drain_period_ms = 11;
980
981  // If set, the tracing daemon will read kernel ring buffers as soon as
982  // they're filled past this percentage of occupancy. In other words, a value
983  // of 50 means that a read pass is triggered as soon as any per-cpu buffer is
984  // half-full. Not guaranteed if there are multiple concurrent tracing
985  // sessions.
986  // Currently does nothing on Linux kernels below v6.9.
987  // Introduced in: perfetto v48.
988  optional uint32 drain_buffer_percent = 29;
989
990  // Configuration for compact encoding of scheduler events. When enabled (and
991  // recording the relevant ftrace events), specific high-volume events are
992  // encoded in a denser format than normal.
993  message CompactSchedConfig {
994    // If true, and sched_switch or sched_waking ftrace events are enabled,
995    // record those events in the compact format.
996    //
997    // If the field is unset, the default is:
998    // * perfetto v42.0+: enabled
999    // * before: disabled
1000    optional bool enabled = 1;
1001  }
1002  optional CompactSchedConfig compact_sched = 12;
1003
1004  // Optional filter for "ftrace/print" events.
1005  //
1006  // The filter consists of multiple rules. As soon as a rule matches (the rules
1007  // are processed in order), its `allow` field will be used as the outcome: if
1008  // `allow` is true, the event will be included in the trace, otherwise it will
1009  // be discarded. If an event does not match any rule, it will be allowed by
1010  // default (a rule with an empty prefix and allow=false, disallows everything
1011  // by default).
1012  message PrintFilter {
1013    message Rule {
1014      // Matches an atrace message of the form:
1015      // <type>|pid|<prefix>...
1016      message AtraceMessage {
1017        optional string type = 1;
1018        optional string prefix = 2;
1019      }
1020      oneof match {
1021        // This rule matches if `prefix` matches exactly with the beginning of
1022        // the "ftrace/print" "buf" field.
1023        string prefix = 1;
1024        // This rule matches if the "buf" field contains an atrace-style print
1025        // message as specified in `atrace_msg`.
1026        AtraceMessage atrace_msg = 3;
1027      }
1028      optional bool allow = 2;
1029    }
1030    repeated Rule rules = 1;
1031  }
1032  optional PrintFilter print_filter = 22;
1033
1034  // Enables symbol name resolution against /proc/kallsyms.
1035  // It requires that either traced_probes is running as root or that
1036  // kptr_restrict has been manually lowered.
1037  // It does not disclose KASLR, symbol addresses are mangled.
1038  optional bool symbolize_ksyms = 13;
1039
1040  // When symbolize_ksyms=true, determines whether the traced_probes daemon
1041  // should keep the symbol map in memory (and reuse it for future tracing
1042  // sessions) or clear it (saving memory) and re-create it on each tracing
1043  // session (wasting cpu and wall time).
1044  // The tradeoff is roughly:
1045  //  KSYMS_RETAIN: pay a fixed ~1.2 MB cost after the first trace.
1046  //  KSYMS_CLEANUP_ON_STOP: pay a ~300-500ms cost when starting each trace.
1047  // Default behavior: KSYMS_CLEANUP_ON_STOP.
1048  enum KsymsMemPolicy {
1049    KSYMS_UNSPECIFIED = 0;
1050    KSYMS_CLEANUP_ON_STOP = 1;
1051    KSYMS_RETAIN = 2;
1052  }
1053  optional KsymsMemPolicy ksyms_mem_policy = 17;
1054
1055  // By default the kernel symbolizer is lazily initialized on a deferred task
1056  // to reduce ftrace's time-to-start-recording. Unfortunately that makes
1057  // ksyms integration tests hard. This flag forces the kernel symbolizer to be
1058  // initialized synchronously on the data source start and hence avoiding
1059  // timing races in tests.
1060  // DEPRECATED in v28 / Android U. This is now the default behavior, setting it
1061  // to true is a no-op.
1062  optional bool initialize_ksyms_synchronously_for_testing = 14
1063      [deprecated = true];
1064
1065  // When this boolean is true AND the ftrace_events contains "kmem/rss_stat",
1066  // this option causes traced_probes to enable the "kmem/rss_stat_throttled"
1067  // event instead if present, and fall back to "kmem/rss_stat" if not present.
1068  // The historical context for this is the following:
1069  // - Up to Android S (12), the rss_stat was internally throttled in its
1070  //   kernel implementation.
1071  // - A change introduced in the kernels after S has introduced a new
1072  //   "rss_stat_throttled" making the original "rss_stat" event unthrottled
1073  //   (hence very spammy).
1074  // - Not all Android T/13 devices will receive a new kernel though, hence we
1075  //   need to deal with both cases.
1076  // For more context: go/rss-stat-throttled.
1077  optional bool throttle_rss_stat = 15;
1078
1079  // If true, avoid enabling events that aren't statically known by
1080  // traced_probes. Otherwise, the default is to emit such events as
1081  // GenericFtraceEvent protos.
1082  // Prefer to keep this flag at its default. This was added for Android
1083  // tracing, where atrace categories and/or atrace HAL requested events can
1084  // expand to events that aren't of interest to the tracing user.
1085  // Introduced in: Android T.
1086  optional bool disable_generic_events = 16;
1087
1088  // The subset of syscalls to record. To record all syscalls, leave this unset
1089  // and add "ftrace_events: raw_syscalls/sys_{enter,exit}" to the config.
1090  // * before perfetto v43, requires the config to also enable
1091  //   raw_syscalls/sys_{enter,exit}.
1092  // * perfetto v43+ does the right thing if you set only this field.
1093  // Example: ["sys_read", "sys_open"].
1094  // Introduced in: Android U.
1095  repeated string syscall_events = 18;
1096
1097  // If true, enable the "function_graph" kernel tracer that emits events
1098  // whenever a kernel function is entered and exited
1099  // (funcgraph_entry/funcgraph_exit).
1100  // Notes on use:
1101  // * Requires |symbolize_ksyms| for function name resolution.
1102  // * Use |function_filters| or |function_graph_roots| to constrain the traced
1103  //   set of functions, otherwise the event bandwidth will be too high for
1104  //   practical use.
1105  // * The data source might be rejected if there is already a concurrent
1106  //   ftrace data source that does not use function graph itself, as we do not
1107  //   support switching kernel tracers mid-trace.
1108  // * Requires a kernel compiled with CONFIG_FUNCTION_GRAPH_TRACER. This is
1109  //   enabled if "cat /sys/kernel/tracing/available_tracers" includes
1110  //   "function_graph".
1111  // Android:
1112  // * Available only on debuggable builds.
1113  // * Introduced in: Android U.
1114  optional bool enable_function_graph = 19;
1115
1116  // Constrains the set of functions traced when |enable_function_graph| is
1117  // true. Supports globs, e.g. "sched*". You can specify multiple filters,
1118  // in which case all matching functions will be traced. See kernel
1119  // documentation on ftrace "set_ftrace_filter" file for more details.
1120  // Android:
1121  // * Available only on debuggable builds.
1122  // * Introduced in: Android U.
1123  repeated string function_filters = 20;
1124
1125  // If |enable_function_graph| is true, trace this set of functions *and* all
1126  // of its callees. Supports globs. Can be set together with
1127  // |function_filters|, in which case only callees matching the filter will be
1128  // traced. If setting both, you most likely want all roots to also be
1129  // included in |function_filters|.
1130  // Android:
1131  // * Available only on debuggable builds.
1132  // * Introduced in: Android U.
1133  repeated string function_graph_roots = 21;
1134
1135  // If true, does not clear ftrace buffers before the start of the program.
1136  // This makes sense only if this is the first ftrace data source instance
1137  // created after the daemon has been started. Can be useful for gathering boot
1138  // traces, if ftrace has been separately configured (e.g. via kernel
1139  // commandline).
1140  optional bool preserve_ftrace_buffer = 23;
1141
1142  // If true, overrides the default timestamp clock and uses a raw hardware
1143  // based monotonic clock for getting timestamps.
1144  // * Introduced in: Android U.
1145  optional bool use_monotonic_raw_clock = 24;
1146
1147  // If |instance_name| is not empty, then attempt to use that tracefs instance
1148  // for event recording. Normally, this means
1149  // `/sys/kernel/tracing/instances/$instance_name`.
1150  //
1151  // The name "hyp" is reserved.
1152  //
1153  // The instance must already exist, the tracing daemon *will not* create it
1154  // for you as it typically doesn't have such permissions.
1155  // Only a subset of features is guaranteed to work with non-default instances,
1156  // at the time of writing:
1157  //  * ftrace_events
1158  //  * buffer_size_kb
1159  optional string instance_name = 25;
1160
1161  // If true, |buffer_size_kb| is interpreted as a lower bound, allowing the
1162  // implementation to choose a bigger buffer size.
1163  //
1164  // Most configs for perfetto v43+ should simply leave both fields unset.
1165  //
1166  // If you need a config compatible with a range of perfetto builds and you
1167  // used to set a non-default buffer_size_kb, consider setting both fields.
1168  // Example:
1169  //   buffer_size_kb: 4096
1170  //   buffer_size_lower_bound: true
1171  // On older builds, the per-cpu buffers will be exactly 4 MB.
1172  // On v43+, buffers will be at least 4 MB.
1173  // In both cases, neither is guaranteed if there are other concurrent
1174  // perfetto ftrace sessions, as the buffers cannot be resized without pausing
1175  // the recording in the kernel.
1176  // Introduced in: perfetto v43.
1177  optional bool buffer_size_lower_bound = 27;
1178
1179  // Previously drain_buffer_percent, perfetto v43-v47.
1180  reserved 26;
1181}
1182
1183// End of protos/perfetto/config/ftrace/ftrace_config.proto
1184
1185// Begin of protos/perfetto/config/gpu/gpu_counter_config.proto
1186
1187message GpuCounterConfig {
1188  // Desired sampling interval for counters.
1189  optional uint64 counter_period_ns = 1;
1190
1191  // List of counters to be sampled. Counter IDs correspond to the ones
1192  // described in GpuCounterSpec in the data source descriptor.
1193  repeated uint32 counter_ids = 2;
1194
1195  // Sample counters by instrumenting command buffers.
1196  optional bool instrumented_sampling = 3;
1197
1198  // Fix gpu clock rate during trace session.
1199  optional bool fix_gpu_clock = 4;
1200}
1201
1202// End of protos/perfetto/config/gpu/gpu_counter_config.proto
1203
1204// Begin of protos/perfetto/config/gpu/vulkan_memory_config.proto
1205
1206message VulkanMemoryConfig {
1207  // Tracking driver memory usage events
1208  optional bool track_driver_memory_usage = 1;
1209
1210  // Tracking device memory usage events
1211  optional bool track_device_memory_usage = 2;
1212}
1213
1214// End of protos/perfetto/config/gpu/vulkan_memory_config.proto
1215
1216// Begin of protos/perfetto/config/inode_file/inode_file_config.proto
1217
1218message InodeFileConfig {
1219  message MountPointMappingEntry {
1220    optional string mountpoint = 1;
1221    repeated string scan_roots = 2;
1222  }
1223
1224  // How long to pause between batches.
1225  optional uint32 scan_interval_ms = 1;
1226
1227  // How long to wait before the first scan in order to accumulate inodes.
1228  optional uint32 scan_delay_ms = 2;
1229
1230  // How many inodes to scan in one batch.
1231  optional uint32 scan_batch_size = 3;
1232
1233  // Do not scan for inodes not found in the static map.
1234  optional bool do_not_scan = 4;
1235
1236  // If non-empty, only scan inodes corresponding to block devices named in
1237  // this list.
1238  repeated string scan_mount_points = 5;
1239
1240  // When encountering an inode belonging to a block device corresponding
1241  // to one of the mount points in this map, scan its scan_roots instead.
1242  repeated MountPointMappingEntry mount_point_mapping = 6;
1243}
1244
1245// End of protos/perfetto/config/inode_file/inode_file_config.proto
1246
1247// Begin of protos/perfetto/config/interceptors/console_config.proto
1248
1249message ConsoleConfig {
1250  enum Output {
1251    OUTPUT_UNSPECIFIED = 0;
1252    OUTPUT_STDOUT = 1;
1253    OUTPUT_STDERR = 2;
1254  }
1255  optional Output output = 1;
1256  optional bool enable_colors = 2;
1257}
1258
1259// End of protos/perfetto/config/interceptors/console_config.proto
1260
1261// Begin of protos/perfetto/config/interceptor_config.proto
1262
1263// Configuration for trace packet interception. Used for diverting trace data to
1264// non-Perfetto sources (e.g., logging to the console, ETW) when using the
1265// Perfetto SDK.
1266message InterceptorConfig {
1267  // Matches the name given to RegisterInterceptor().
1268  optional string name = 1;
1269
1270  optional ConsoleConfig console_config = 100;
1271}
1272
1273// End of protos/perfetto/config/interceptor_config.proto
1274
1275// Begin of protos/perfetto/config/power/android_power_config.proto
1276
1277message AndroidPowerConfig {
1278  enum BatteryCounters {
1279    BATTERY_COUNTER_UNSPECIFIED = 0;
1280
1281    // Coulomb counter.
1282    BATTERY_COUNTER_CHARGE = 1;
1283
1284    // Charge (%).
1285    BATTERY_COUNTER_CAPACITY_PERCENT = 2;
1286
1287    // Instantaneous current.
1288    BATTERY_COUNTER_CURRENT = 3;
1289
1290    // Avg current.
1291    BATTERY_COUNTER_CURRENT_AVG = 4;
1292
1293    // Instantaneous voltage.
1294    BATTERY_COUNTER_VOLTAGE = 5;
1295  }
1296  optional uint32 battery_poll_ms = 1;
1297  repeated BatteryCounters battery_counters = 2;
1298
1299  // Where available enables per-power-rail measurements.
1300  optional bool collect_power_rails = 3;
1301
1302  // Provides a breakdown of energy estimation for various subsystem (e.g. GPU).
1303  // Available from Android S.
1304  optional bool collect_energy_estimation_breakdown = 4;
1305
1306  // Provides a breakdown of time in state for various subsystems.
1307  // Available from Android U.
1308  optional bool collect_entity_state_residency = 5;
1309}
1310
1311// End of protos/perfetto/config/power/android_power_config.proto
1312
1313// Begin of protos/perfetto/config/process_stats/process_stats_config.proto
1314
1315message ProcessStatsConfig {
1316  enum Quirks {
1317    QUIRKS_UNSPECIFIED = 0;
1318
1319    // This has been deprecated and ignored as per 2018-05-01. Full scan at
1320    // startup is now disabled by default and can be re-enabled using the
1321    // |scan_all_processes_on_start| arg.
1322    DISABLE_INITIAL_DUMP = 1 [deprecated = true];
1323
1324    DISABLE_ON_DEMAND = 2;
1325  }
1326  repeated Quirks quirks = 1;
1327
1328  // If enabled all processes will be scanned and dumped when the trace starts.
1329  optional bool scan_all_processes_on_start = 2;
1330
1331  // If enabled thread names are also recoded (this is redundant if sched_switch
1332  // is enabled).
1333  optional bool record_thread_names = 3;
1334
1335  // If > 0 samples counters (see process_stats.proto) from
1336  // /proc/pid/status and oom_score_adj every X ms.
1337  // It will also sample /proc/pid/smaps_rollup if scan_smaps_rollup = true.
1338  // This is required to be > 100ms to avoid excessive CPU usage.
1339  optional uint32 proc_stats_poll_ms = 4;
1340
1341  // id 5 never used
1342
1343  // This is required to be either = 0 or a multiple of |proc_stats_poll_ms|
1344  // (default: |proc_stats_poll_ms|). If = 0, will be set to
1345  // |proc_stats_poll_ms|. Non-multiples will be rounded down to the nearest
1346  // multiple.
1347  optional uint32 proc_stats_cache_ttl_ms = 6;
1348
1349  // Niche feature: If true this will resolve file descriptors for each process
1350  // so these can be mapped to their actual device or file.
1351  // Requires raw_syscalls/sys_{enter,exit} ftrace events to be enabled or
1352  // new fds opened after initially scanning a process will not be
1353  // recognized.
1354  optional bool resolve_process_fds = 9;
1355
1356  // If true, output will include memory stats from /proc/pid/smaps_rollup.
1357  optional bool scan_smaps_rollup = 10;
1358
1359  // If true: process descriptions will include process age (starttime in
1360  // /proc/pid/stat).
1361  // Introduced in: perfetto v44.
1362  optional bool record_process_age = 11;
1363
1364  // If true and |proc_stats_poll_ms| is true, process stats will include time
1365  // spent running in user/kernel mode (utime/stime in /proc/pid/stat).
1366  // Introduced in: perfetto v44.
1367  optional bool record_process_runtime = 12;
1368
1369  // record_thread_time_in_state
1370  reserved 7;
1371  // thread_time_in_state_cache_size
1372  reserved 8;
1373}
1374
1375// End of protos/perfetto/config/process_stats/process_stats_config.proto
1376
1377// Begin of protos/perfetto/config/profiling/heapprofd_config.proto
1378
1379// Configuration for go/heapprofd.
1380// Next id: 28
1381message HeapprofdConfig {
1382  message ContinuousDumpConfig {
1383    // ms to wait before first dump.
1384    optional uint32 dump_phase_ms = 5;
1385    // ms to wait between following dumps.
1386    optional uint32 dump_interval_ms = 6;
1387  }
1388
1389  // Sampling rate for all heaps not specified via heap_sampling_intervals.
1390  //
1391  // These are:
1392  // * All heaps if heap_sampling_intervals is empty.
1393  // * Those profiled due to all_heaps and not named in heaps if
1394  //   heap_sampling_intervals is not empty.
1395  // * The implicit libc.malloc heap if heaps is empty.
1396  //
1397  // Set to 1 for perfect accuracy.
1398  // Otherwise, sample every sample_interval_bytes on average.
1399  //
1400  // See
1401  // https://perfetto.dev/docs/data-sources/native-heap-profiler#sampling-interval
1402  // for more details.
1403  //
1404  // BUGS
1405  // Before Android 12, setting this to 0 would crash the target process.
1406  //
1407  // N.B. This must be explicitly set to a non-zero value for all heaps (with
1408  // this field or with heap_sampling_intervals), otherwise the producer will
1409  // not start.
1410  optional uint64 sampling_interval_bytes = 1;
1411
1412  // If less than the given numbers of bytes are left free in the shared
1413  // memory buffer, increase sampling interval by a factor of two.
1414  // Adaptive sampling is disabled when set to 0.
1415  optional uint64 adaptive_sampling_shmem_threshold = 24;
1416  // Stop doubling the sampling_interval once the sampling interval has reached
1417  // this value.
1418  optional uint64 adaptive_sampling_max_sampling_interval_bytes = 25;
1419
1420  // E.g. surfaceflinger, com.android.phone
1421  // This input is normalized in the following way: if it contains slashes,
1422  // everything up to the last slash is discarded. If it contains "@",
1423  // everything after the first @ is discared.
1424  // E.g. /system/bin/surfaceflinger@1.0 normalizes to surfaceflinger.
1425  // This transformation is also applied to the processes' command lines when
1426  // matching.
1427  repeated string process_cmdline = 2;
1428
1429  // For watermark based triggering or local debugging.
1430  repeated uint64 pid = 4;
1431
1432  // Only profile target if it was installed by one of the packages given.
1433  // Special values are:
1434  // * @system: installed on the system partition
1435  // * @product: installed on the product partition
1436  // * @null: sideloaded
1437  // Supported on Android 12+.
1438  repeated string target_installed_by = 26;
1439
1440  // Which heaps to sample, e.g. "libc.malloc". If left empty, only samples
1441  // "malloc".
1442  //
1443  // Introduced in Android 12.
1444  repeated string heaps = 20;
1445
1446  // Which heaps not to sample, e.g. "libc.malloc". This is useful when used in
1447  // combination with all_heaps;
1448  //
1449  // Introduced in Android 12.
1450  repeated string exclude_heaps = 27;
1451
1452  optional bool stream_allocations = 23;
1453
1454  // If given, needs to be the same length as heaps and gives the sampling
1455  // interval for the respective entry in heaps.
1456  //
1457  // Otherwise, sampling_interval_bytes is used.
1458  //
1459  // It is recommended to set sampling_interval_bytes to a reasonable default
1460  // value when using this, as a value of 0 for sampling_interval_bytes will
1461  // crash the target process before Android 12.
1462  //
1463  // Introduced in Android 12.
1464  //
1465  // All values must be non-zero or the producer will not start.
1466  repeated uint64 heap_sampling_intervals = 22;
1467
1468  // Sample all heaps registered by target process. Introduced in Android 12.
1469  optional bool all_heaps = 21;
1470
1471  // Profile all processes eligible for profiling on the system.
1472  // See
1473  // https://perfetto.dev/docs/data-sources/native-heap-profiler#heapprofd-targets
1474  // for which processes are eligible.
1475  //
1476  // On unmodified userdebug builds, this will lead to system crashes. Zygote
1477  // will crash when trying to launch a new process as it will have an
1478  // unexpected open socket to heapprofd.
1479  //
1480  // heapprofd will likely be overloaded by the amount of data for low
1481  // sampling intervals.
1482  optional bool all = 5;
1483
1484  // Do not profile processes whose anon RSS + swap < given value.
1485  // Introduced in Android 11.
1486  optional uint32 min_anonymous_memory_kb = 15;
1487
1488  // Stop profile if heapprofd memory usage goes beyond the given value.
1489  // Introduced in Android 11.
1490  optional uint32 max_heapprofd_memory_kb = 16;
1491
1492  // Stop profile if heapprofd CPU time since start of this data-source
1493  // goes beyond given value.
1494  // Introduced in Android 11.
1495  optional uint64 max_heapprofd_cpu_secs = 17;
1496
1497  // Do not emit function names for mappings starting with this prefix.
1498  // E.g. /system to not emit symbols for any system libraries.
1499  repeated string skip_symbol_prefix = 7;
1500
1501  // Dump at a predefined interval.
1502  optional ContinuousDumpConfig continuous_dump_config = 6;
1503
1504  // Size of the shared memory buffer between the profiled processes and
1505  // heapprofd. Defaults to 8 MiB. If larger than 500 MiB, truncated to 500
1506  // MiB.
1507  //
1508  // Needs to be:
1509  // * at least 8192,
1510  // * a power of two,
1511  // * a multiple of 4096.
1512  optional uint64 shmem_size_bytes = 8;
1513
1514  // When the shmem buffer is full, block the client instead of ending the
1515  // trace. Use with caution as this will significantly slow down the target
1516  // process.
1517  optional bool block_client = 9;
1518
1519  // If set, stop the trace session after blocking the client for this
1520  // timeout. Needs to be larger than 100 us, otherwise no retries are done.
1521  // Introduced in Android 11.
1522  optional uint32 block_client_timeout_us = 14;
1523
1524  // Do not profile processes from startup, only match already running
1525  // processes.
1526  //
1527  // Can not be set at the same time as no_running.
1528  // Introduced in Android 11.
1529  optional bool no_startup = 10;
1530
1531  // Do not profile running processes. Only match processes on startup.
1532  //
1533  // Can not be set at the same time as no_startup.
1534  // Introduced in Android 11.
1535  optional bool no_running = 11;
1536
1537  // deprecated idle_allocations.
1538  reserved 12;
1539
1540  // Cause heapprofd to emit a single dump at the end, showing the memory usage
1541  // at the point in time when the sampled heap usage of the process was at its
1542  // maximum. This causes ProfilePacket.HeapSample.self_max to be set, and
1543  // self_allocated and self_freed to not be set.
1544  // Introduced in Android 11.
1545  optional bool dump_at_max = 13;
1546
1547  // FEATURE FLAGS. THERE BE DRAGONS.
1548
1549  // Escape hatch if the session is being torn down because of a forked child
1550  // that shares memory space, but is not correctly identified as a vforked
1551  // child.
1552  // Introduced in Android 11.
1553  optional bool disable_fork_teardown = 18;
1554
1555  // We try to automatically detect when a target applicatation vforks but then
1556  // does a memory allocation (or free). This auto-detection can be disabled
1557  // with this.
1558  // Introduced in Android 11.
1559  optional bool disable_vfork_detection = 19;
1560}
1561
1562// End of protos/perfetto/config/profiling/heapprofd_config.proto
1563
1564// Begin of protos/perfetto/config/profiling/java_hprof_config.proto
1565
1566// Configuration for managed app heap graph snapshots.
1567message JavaHprofConfig {
1568  // If dump_interval_ms != 0, the following configuration is used.
1569  message ContinuousDumpConfig {
1570    // ms to wait before first continuous dump.
1571    // A dump is always created at the beginning of the trace.
1572    optional uint32 dump_phase_ms = 1;
1573    // ms to wait between following dumps.
1574    optional uint32 dump_interval_ms = 2;
1575    // If true, scans all the processes to find `process_cmdline` and filter by
1576    // `min_anonymous_memory_kb` only at data source start. Default on Android
1577    // S-.
1578    //
1579    // If false, rescans all the processes to find on every dump. Default on
1580    // Android T+.
1581    optional bool scan_pids_only_on_start = 3;
1582  }
1583
1584  // Command line allowlist, matched against the /proc/<pid>/cmdline (not the
1585  // comm string). The semantics of this field were changed since its original
1586  // introduction.
1587  //
1588  // On Android T+ (13+), this field can specify a single wildcard (*), and
1589  // the profiler will attempt to match it in two possible ways:
1590  // * if the pattern starts with a '/', then it is matched against the first
1591  //   segment of the cmdline (i.e. argv0). For example "/bin/e*" would match
1592  //   "/bin/echo".
1593  // * otherwise the pattern is matched against the part of argv0
1594  //   corresponding to the binary name (this is unrelated to /proc/pid/exe).
1595  //   For example "echo" would match "/bin/echo".
1596  //
1597  // On Android S (12) and below, both this pattern and /proc/pid/cmdline get
1598  // normalized prior to an exact string comparison. Normalization is as
1599  // follows: (1) trim everything beyond the first null or "@" byte; (2) if
1600  // the string contains forward slashes, trim everything up to and including
1601  // the last one.
1602  //
1603  // Implementation note: in either case, at most 511 characters of cmdline
1604  // are considered.
1605  repeated string process_cmdline = 1;
1606
1607  // For watermark based triggering or local debugging.
1608  repeated uint64 pid = 2;
1609
1610  // Only profile target if it was installed by one of the packages given.
1611  // Special values are:
1612  // * @system: installed on the system partition
1613  // * @product: installed on the product partition
1614  // * @null: sideloaded
1615  // Supported on Android 12+.
1616  repeated string target_installed_by = 7;
1617
1618  // Dump at a predefined interval.
1619  optional ContinuousDumpConfig continuous_dump_config = 3;
1620
1621  // Do not profile processes whose anon RSS + swap < given value.
1622  optional uint32 min_anonymous_memory_kb = 4;
1623
1624  // Include the process' /proc/self/smaps.
1625  // This only shows maps that:
1626  // * start with /system
1627  // * start with /vendor
1628  // * start with /data/app
1629  // * contain "extracted in memory from Y", where Y matches any of the above
1630  optional bool dump_smaps = 5;
1631
1632  // Exclude objects of the following types from the profile. This can be
1633  // useful if lots of uninteresting objects, e.g. "sun.misc.Cleaner".
1634  repeated string ignored_types = 6;
1635}
1636
1637// End of protos/perfetto/config/profiling/java_hprof_config.proto
1638
1639// Begin of protos/perfetto/common/perf_events.proto
1640
1641// Next id: 12
1642message PerfEvents {
1643  // What event to sample on, and how often. Commented from the perspective of
1644  // its use in |PerfEventConfig|.
1645  message Timebase {
1646    // How often the per-cpu sampling will occur. Not guaranteed to be honored
1647    // as the kernel can throttle the sampling rate if it's too high.
1648    // If unset, an implementation-defined default is used.
1649    oneof interval {
1650      // Per-cpu sampling frequency in Hz, as requested from the kernel. Not the
1651      // same as 1/period.
1652      // Details: the actual sampling will still be based on a period, but the
1653      // kernel will dynamically adjust it based on the observed event rate, to
1654      // approximate this frequency. Works best with steady-rate events like
1655      // timers.
1656      uint64 frequency = 2;
1657
1658      // Per-cpu sampling will occur every |period| counts of |event|.
1659      // Prefer |frequency| by default, as it's easier to oversample with a
1660      // fixed period.
1661      uint64 period = 1;
1662    }
1663
1664    // Counting event to use as a timebase for the sampling.
1665    // If unset, implies the CPU timer (SW_CPU_CLOCK) as the event,
1666    // which is what you usually want.
1667    // See common/perf_events.proto for the definitions.
1668    oneof event {
1669      Counter counter = 4;
1670      Tracepoint tracepoint = 3;
1671      RawEvent raw_event = 5;
1672    }
1673
1674    // If set, samples will be timestamped with the given clock.
1675    // If unset, the clock is chosen by the implementation.
1676    // For software events, prefer PERF_CLOCK_BOOTTIME. However it cannot be
1677    // used for hardware events (due to interrupt safety), for which the
1678    // recommendation is to use one of the monotonic clocks.
1679    optional PerfClock timestamp_clock = 11;
1680
1681    // Optional arbitrary name for the event, to identify it in the parsed
1682    // trace. Does *not* affect the profiling itself. If unset, the trace
1683    // parser will choose a suitable name.
1684    optional string name = 10;
1685  }
1686
1687  // Builtin counter names from the uapi header. Commented with their perf tool
1688  // aliases.
1689  // TODO(rsavitski): consider generating enums for cache events (should be
1690  // finite), and generally make this list as extensive as possible. Excluding
1691  // things like dynamic PMUs since those don't fit into a static enum.
1692  // Next id: 21
1693  enum Counter {
1694    UNKNOWN_COUNTER = 0;
1695
1696    // cpu-clock
1697    SW_CPU_CLOCK = 1;
1698    // page-faults, faults
1699    SW_PAGE_FAULTS = 2;
1700    // task-clock
1701    SW_TASK_CLOCK = 3;
1702    // context-switches, cs
1703    SW_CONTEXT_SWITCHES = 4;
1704    // cpu-migrations, migrations
1705    SW_CPU_MIGRATIONS = 5;
1706    // minor-faults
1707    SW_PAGE_FAULTS_MIN = 6;
1708    // major-faults
1709    SW_PAGE_FAULTS_MAJ = 7;
1710    // alignment-faults
1711    SW_ALIGNMENT_FAULTS = 8;
1712    // emulation-faults
1713    SW_EMULATION_FAULTS = 9;
1714    // dummy
1715    SW_DUMMY = 20;
1716
1717    // cpu-cycles, cycles
1718    HW_CPU_CYCLES = 10;
1719    // instructions
1720    HW_INSTRUCTIONS = 11;
1721    // cache-references
1722    HW_CACHE_REFERENCES = 12;
1723    // cache-misses
1724    HW_CACHE_MISSES = 13;
1725    // branch-instructions, branches
1726    HW_BRANCH_INSTRUCTIONS = 14;
1727    // branch-misses
1728    HW_BRANCH_MISSES = 15;
1729    // bus-cycles
1730    HW_BUS_CYCLES = 16;
1731    // stalled-cycles-frontend, idle-cycles-frontend
1732    HW_STALLED_CYCLES_FRONTEND = 17;
1733    // stalled-cycles-backend, idle-cycles-backend
1734    HW_STALLED_CYCLES_BACKEND = 18;
1735    // ref-cycles
1736    HW_REF_CPU_CYCLES = 19;
1737  }
1738
1739  message Tracepoint {
1740    // Group and name for the tracepoint, acceptable forms:
1741    // * "sched/sched_switch"
1742    // * "sched:sched_switch"
1743    optional string name = 1;
1744
1745    // Optional field-level filter for the tracepoint. Only events matching this
1746    // filter will be counted (and therefore contribute to the sampling period).
1747    // Example: "prev_pid >= 42 && next_pid == 0".
1748    // For full syntax, see kernel documentation on "Event filtering":
1749    // https://www.kernel.org/doc/Documentation/trace/events.txt
1750    optional string filter = 2;
1751  }
1752
1753  // Syscall-level description of the event, propagated to the perf_event_attr
1754  // struct. Primarily for local use-cases, since the event availability and
1755  // encoding is hardware-specific.
1756  message RawEvent {
1757    optional uint32 type = 1;
1758    optional uint64 config = 2;
1759    optional uint64 config1 = 3;
1760    optional uint64 config2 = 4;
1761  }
1762
1763  // Subset of clocks that is supported by perf timestamping.
1764  // CLOCK_TAI is excluded since it's not expected to be used in practice, but
1765  // would require additions to the trace clock synchronisation logic.
1766  enum PerfClock {
1767    UNKNOWN_PERF_CLOCK = 0;
1768    PERF_CLOCK_REALTIME = 1;
1769    PERF_CLOCK_MONOTONIC = 2;
1770    PERF_CLOCK_MONOTONIC_RAW = 3;
1771    PERF_CLOCK_BOOTTIME = 4;
1772  }
1773}
1774
1775// Additional events associated with a leader.
1776// Configuration is similar to Timebase event. Because data acquisition is
1777// driven by the leader there is no option to configure the clock or the
1778// frequency.
1779message FollowerEvent {
1780  oneof event {
1781    PerfEvents.Counter counter = 1;
1782    PerfEvents.Tracepoint tracepoint = 2;
1783    PerfEvents.RawEvent raw_event = 3;
1784  }
1785  optional string name = 4;
1786}
1787
1788// End of protos/perfetto/common/perf_events.proto
1789
1790// Begin of protos/perfetto/config/profiling/perf_event_config.proto
1791
1792// Configuration for the traced_perf profiler.
1793//
1794// Example config for basic cpu profiling:
1795//   perf_event_config {
1796//     timebase {
1797//       frequency: 80
1798//     }
1799//     callstack_sampling {
1800//       scope {
1801//         target_cmdline: "surfaceflinger"
1802//         target_cmdline: "system_server"
1803//       }
1804//       kernel_frames: true
1805//     }
1806//   }
1807//
1808// Next id: 20
1809message PerfEventConfig {
1810  // What event to sample on, and how often.
1811  // Defined in common/perf_events.proto.
1812  optional PerfEvents.Timebase timebase = 15;
1813
1814  // Other events associated with the leader described in the timebase.
1815  repeated FollowerEvent followers = 19;
1816
1817  // If set, the profiler will sample userspace processes' callstacks at the
1818  // interval specified by the |timebase|.
1819  // If unset, the profiler will record only the event counts.
1820  optional CallstackSampling callstack_sampling = 16;
1821
1822  //
1823  // Kernel <-> userspace ring buffer options:
1824  //
1825
1826  // How often the per-cpu ring buffers are read by the producer.
1827  // If unset, an implementation-defined default is used.
1828  optional uint32 ring_buffer_read_period_ms = 8;
1829
1830  // Size (in 4k pages) of each per-cpu ring buffer that is filled by the
1831  // kernel. If set, must be a power of two.
1832  // If unset, an implementation-defined default is used.
1833  optional uint32 ring_buffer_pages = 3;
1834
1835  //
1836  // Daemon's resource usage limits:
1837  //
1838
1839  // Drop samples if the heap memory held by the samples in the unwinder queue
1840  // is above the given limit. This counts the memory across all concurrent data
1841  // sources (not just this one's), and there is no fairness guarantee - the
1842  // whole quota might be used up by a concurrent source.
1843  optional uint64 max_enqueued_footprint_kb = 17;
1844
1845  // Stop the data source if traced_perf's combined {RssAnon + Swap} memory
1846  // footprint exceeds this value.
1847  optional uint32 max_daemon_memory_kb = 13;
1848
1849  //
1850  // Uncommon options:
1851  //
1852
1853  // Timeout for the remote /proc/<pid>/{maps,mem} file descriptors for a
1854  // sampled process. This is primarily for Android, where this lookup is
1855  // asynchronous. As long as the producer is waiting, the associated samples
1856  // will be kept enqueued (putting pressure on the capacity of the shared
1857  // unwinding queue). Once a lookup for a process expires, all associated
1858  // samples are discarded. However, if the lookup still succeeds after the
1859  // timeout, future samples will be handled normally.
1860  // If unset, an implementation-defined default is used.
1861  optional uint32 remote_descriptor_timeout_ms = 9;
1862
1863  // Optional period for clearing state cached by the unwinder. This is a heavy
1864  // operation that is only necessary for traces that target a wide set of
1865  // processes, and require the memory footprint to be reset periodically.
1866  // If unset, the cached state will not be cleared.
1867  optional uint32 unwind_state_clear_period_ms = 10;
1868
1869  // If set, only profile target if it was installed by a package with one of
1870  // these names. Special values:
1871  // * "@system": installed on the system partition
1872  // * "@product": installed on the product partition
1873  // * "@null": sideloaded
1874  // Supported on Android 12+.
1875  repeated string target_installed_by = 18;
1876
1877  //
1878  // Deprecated (superseded by options above):
1879  //
1880  // Do not set *any* of these fields in new configs.
1881  //
1882
1883  // Note: legacy configs had to set |all_cpus| to true to pass parsing.
1884  // We rely on this to detect such configs.
1885  optional bool all_cpus = 1;
1886  optional uint32 sampling_frequency = 2;
1887  optional bool kernel_frames = 12;
1888  repeated int32 target_pid = 4;
1889  repeated string target_cmdline = 5;
1890  repeated int32 exclude_pid = 6;
1891  repeated string exclude_cmdline = 7;
1892  optional uint32 additional_cmdline_count = 11;
1893  // previously |tracepoint|
1894  reserved 14;
1895
1896  //
1897  // Sub-messages (nested for generated code namespacing).
1898  //
1899
1900  message CallstackSampling {
1901    // Defines a set of processes for which samples are retained/skipped. If
1902    // unset, all samples are kept, but beware that it will be very heavy on the
1903    // stack unwinder, which might start dropping samples due to overload.
1904    optional Scope scope = 1;
1905
1906    // If true, callstacks will include the kernel-space frames. Such frames can
1907    // be identified by a magical "kernel" string as their mapping name.
1908    // Requires traced_perf to be running as root, or kptr_restrict to have been
1909    // manually unrestricted. On Android, the platform should do the right thing
1910    // on debug builds.
1911    // This does *not* disclose KASLR, as only the function names are emitted.
1912    optional bool kernel_frames = 2;
1913
1914    // Whether to record and unwind userspace callstacks. If unset, defaults to
1915    // including userspace (UNWIND_DWARF) both for backwards compatibility and
1916    // as the most common default (this defaulting is only applicable if the
1917    // outer CallstackSampling message is explicitly set).
1918    optional UnwindMode user_frames = 3;
1919  }
1920
1921  message Scope {
1922    // Process ID (TGID) allowlist. If this list is not empty, only matching
1923    // samples will be retained. If multiple allow/deny-lists are
1924    // specified by the config, then all of them are evaluated for each sampled
1925    // process.
1926    repeated int32 target_pid = 1;
1927
1928    // Command line allowlist, matched against the /proc/<pid>/cmdline (not the
1929    // comm string). The semantics of this field were changed since its original
1930    // introduction.
1931    //
1932    // On Android T+ (13+), this field can specify a single wildcard (*), and
1933    // the profiler will attempt to match it in two possible ways:
1934    // * if the pattern starts with a '/', then it is matched against the first
1935    //   segment of the cmdline (i.e. argv0). For example "/bin/e*" would match
1936    //   "/bin/echo".
1937    // * otherwise the pattern is matched against the part of argv0
1938    //   corresponding to the binary name (this is unrelated to /proc/pid/exe).
1939    //   For example "echo" would match "/bin/echo".
1940    //
1941    // On Android S (12) and below, both this pattern and /proc/pid/cmdline get
1942    // normalized prior to an exact string comparison. Normalization is as
1943    // follows: (1) trim everything beyond the first null or "@" byte; (2) if
1944    // the string contains forward slashes, trim everything up to and including
1945    // the last one.
1946    //
1947    // Implementation note: in either case, at most 511 characters of cmdline
1948    // are considered.
1949    repeated string target_cmdline = 2;
1950
1951    // List of excluded pids.
1952    repeated int32 exclude_pid = 3;
1953
1954    // List of excluded cmdlines. See description of |target_cmdline| for how
1955    // this is handled.
1956    repeated string exclude_cmdline = 4;
1957
1958    // Niche features for systemwide callstacks:
1959
1960    // Number of additional command lines to sample. Only those which are
1961    // neither explicitly included nor excluded will be considered. Processes
1962    // are accepted on a first come, first served basis.
1963    optional uint32 additional_cmdline_count = 5;
1964
1965    // If set to N, all encountered processes will be put into one of the N
1966    // possible bins, and only one randomly-chosen bin will be selected for
1967    // unwinding. The binning is simply "pid % N", under the assumption that
1968    // low-order bits of pids are roughly uniformly distributed. Other explicit
1969    // inclusions/exclusions in this |Scope| message are still respected.
1970    //
1971    // The profiler will report the chosen shard in PerfSampleDefaults, and the
1972    // values will be queryable in trace processor under the "stats" table as
1973    // "perf_process_shard_count" and "perf_chosen_process_shard".
1974    //
1975    // NB: all data sources in a config that set |process_shard_count| must set
1976    // it to the same value. The profiler will choose one bin for all those data
1977    // sources.
1978    optional uint32 process_shard_count = 6;
1979  }
1980
1981  // Userspace unwinding mode. A possible future addition is kernel-unwound
1982  // callchains for frame pointer based systems.
1983  enum UnwindMode {
1984    UNWIND_UNKNOWN = 0;
1985    // Do not unwind userspace:
1986    UNWIND_SKIP = 1;
1987    // Use libunwindstack (default):
1988    UNWIND_DWARF = 2;
1989    // Use userspace frame pointer unwinder:
1990    UNWIND_FRAME_POINTER = 3;
1991  }
1992}
1993
1994// End of protos/perfetto/config/profiling/perf_event_config.proto
1995
1996// Begin of protos/perfetto/config/statsd/atom_ids.proto
1997
1998// This enum is obtained by post-processing
1999// AOSP/frameworks/proto_logging/stats/atoms.proto through
2000// AOSP/external/perfetto/tools/update-statsd-descriptor, which extracts one
2001// enum value for each proto field defined in the upstream atoms.proto.
2002enum AtomId {
2003  ATOM_UNSPECIFIED = 0;
2004  ATOM_BLE_SCAN_STATE_CHANGED = 2;
2005  ATOM_PROCESS_STATE_CHANGED = 3;
2006  ATOM_BLE_SCAN_RESULT_RECEIVED = 4;
2007  ATOM_SENSOR_STATE_CHANGED = 5;
2008  ATOM_GPS_SCAN_STATE_CHANGED = 6;
2009  ATOM_SYNC_STATE_CHANGED = 7;
2010  ATOM_SCHEDULED_JOB_STATE_CHANGED = 8;
2011  ATOM_SCREEN_BRIGHTNESS_CHANGED = 9;
2012  ATOM_WAKELOCK_STATE_CHANGED = 10;
2013  ATOM_LONG_PARTIAL_WAKELOCK_STATE_CHANGED = 11;
2014  ATOM_MOBILE_RADIO_POWER_STATE_CHANGED = 12;
2015  ATOM_WIFI_RADIO_POWER_STATE_CHANGED = 13;
2016  ATOM_ACTIVITY_MANAGER_SLEEP_STATE_CHANGED = 14;
2017  ATOM_MEMORY_FACTOR_STATE_CHANGED = 15;
2018  ATOM_EXCESSIVE_CPU_USAGE_REPORTED = 16;
2019  ATOM_CACHED_KILL_REPORTED = 17;
2020  ATOM_PROCESS_MEMORY_STAT_REPORTED = 18;
2021  ATOM_LAUNCHER_EVENT = 19;
2022  ATOM_BATTERY_SAVER_MODE_STATE_CHANGED = 20;
2023  ATOM_DEVICE_IDLE_MODE_STATE_CHANGED = 21;
2024  ATOM_DEVICE_IDLING_MODE_STATE_CHANGED = 22;
2025  ATOM_AUDIO_STATE_CHANGED = 23;
2026  ATOM_MEDIA_CODEC_STATE_CHANGED = 24;
2027  ATOM_CAMERA_STATE_CHANGED = 25;
2028  ATOM_FLASHLIGHT_STATE_CHANGED = 26;
2029  ATOM_UID_PROCESS_STATE_CHANGED = 27;
2030  ATOM_PROCESS_LIFE_CYCLE_STATE_CHANGED = 28;
2031  ATOM_SCREEN_STATE_CHANGED = 29;
2032  ATOM_BATTERY_LEVEL_CHANGED = 30;
2033  ATOM_CHARGING_STATE_CHANGED = 31;
2034  ATOM_PLUGGED_STATE_CHANGED = 32;
2035  ATOM_INTERACTIVE_STATE_CHANGED = 33;
2036  ATOM_TOUCH_EVENT_REPORTED = 34;
2037  ATOM_WAKEUP_ALARM_OCCURRED = 35;
2038  ATOM_KERNEL_WAKEUP_REPORTED = 36;
2039  ATOM_WIFI_LOCK_STATE_CHANGED = 37;
2040  ATOM_WIFI_SIGNAL_STRENGTH_CHANGED = 38;
2041  ATOM_WIFI_SCAN_STATE_CHANGED = 39;
2042  ATOM_PHONE_SIGNAL_STRENGTH_CHANGED = 40;
2043  ATOM_SETTING_CHANGED = 41;
2044  ATOM_ACTIVITY_FOREGROUND_STATE_CHANGED = 42;
2045  ATOM_ISOLATED_UID_CHANGED = 43;
2046  ATOM_PACKET_WAKEUP_OCCURRED = 44;
2047  ATOM_WALL_CLOCK_TIME_SHIFTED = 45;
2048  ATOM_ANOMALY_DETECTED = 46;
2049  ATOM_APP_BREADCRUMB_REPORTED = 47;
2050  ATOM_APP_START_OCCURRED = 48;
2051  ATOM_APP_START_CANCELED = 49;
2052  ATOM_APP_START_FULLY_DRAWN = 50;
2053  ATOM_LMK_KILL_OCCURRED = 51;
2054  ATOM_PICTURE_IN_PICTURE_STATE_CHANGED = 52;
2055  ATOM_WIFI_MULTICAST_LOCK_STATE_CHANGED = 53;
2056  ATOM_APP_START_MEMORY_STATE_CAPTURED = 55;
2057  ATOM_SHUTDOWN_SEQUENCE_REPORTED = 56;
2058  ATOM_BOOT_SEQUENCE_REPORTED = 57;
2059  ATOM_OVERLAY_STATE_CHANGED = 59;
2060  ATOM_FOREGROUND_SERVICE_STATE_CHANGED = 60;
2061  ATOM_CALL_STATE_CHANGED = 61;
2062  ATOM_KEYGUARD_STATE_CHANGED = 62;
2063  ATOM_KEYGUARD_BOUNCER_STATE_CHANGED = 63;
2064  ATOM_KEYGUARD_BOUNCER_PASSWORD_ENTERED = 64;
2065  ATOM_APP_DIED = 65;
2066  ATOM_RESOURCE_CONFIGURATION_CHANGED = 66;
2067  ATOM_BLUETOOTH_ENABLED_STATE_CHANGED = 67;
2068  ATOM_BLUETOOTH_CONNECTION_STATE_CHANGED = 68;
2069  ATOM_GPS_SIGNAL_QUALITY_CHANGED = 69;
2070  ATOM_USB_CONNECTOR_STATE_CHANGED = 70;
2071  ATOM_SPEAKER_IMPEDANCE_REPORTED = 71;
2072  ATOM_HARDWARE_FAILED = 72;
2073  ATOM_PHYSICAL_DROP_DETECTED = 73;
2074  ATOM_CHARGE_CYCLES_REPORTED = 74;
2075  ATOM_MOBILE_CONNECTION_STATE_CHANGED = 75;
2076  ATOM_MOBILE_RADIO_TECHNOLOGY_CHANGED = 76;
2077  ATOM_USB_DEVICE_ATTACHED = 77;
2078  ATOM_APP_CRASH_OCCURRED = 78;
2079  ATOM_ANR_OCCURRED = 79;
2080  ATOM_WTF_OCCURRED = 80;
2081  ATOM_LOW_MEM_REPORTED = 81;
2082  ATOM_GENERIC_ATOM = 82;
2083  ATOM_VIBRATOR_STATE_CHANGED = 84;
2084  ATOM_DEFERRED_JOB_STATS_REPORTED = 85;
2085  ATOM_THERMAL_THROTTLING = 86;
2086  ATOM_BIOMETRIC_ACQUIRED = 87;
2087  ATOM_BIOMETRIC_AUTHENTICATED = 88;
2088  ATOM_BIOMETRIC_ERROR_OCCURRED = 89;
2089  ATOM_UI_EVENT_REPORTED = 90;
2090  ATOM_BATTERY_HEALTH_SNAPSHOT = 91;
2091  ATOM_SLOW_IO = 92;
2092  ATOM_BATTERY_CAUSED_SHUTDOWN = 93;
2093  ATOM_PHONE_SERVICE_STATE_CHANGED = 94;
2094  ATOM_PHONE_STATE_CHANGED = 95;
2095  ATOM_USER_RESTRICTION_CHANGED = 96;
2096  ATOM_SETTINGS_UI_CHANGED = 97;
2097  ATOM_CONNECTIVITY_STATE_CHANGED = 98;
2098  ATOM_SERVICE_STATE_CHANGED = 99;
2099  ATOM_SERVICE_LAUNCH_REPORTED = 100;
2100  ATOM_FLAG_FLIP_UPDATE_OCCURRED = 101;
2101  ATOM_BINARY_PUSH_STATE_CHANGED = 102;
2102  ATOM_DEVICE_POLICY_EVENT = 103;
2103  ATOM_DOCS_UI_FILE_OP_CANCELED = 104;
2104  ATOM_DOCS_UI_FILE_OP_COPY_MOVE_MODE_REPORTED = 105;
2105  ATOM_DOCS_UI_FILE_OP_FAILURE = 106;
2106  ATOM_DOCS_UI_PROVIDER_FILE_OP = 107;
2107  ATOM_DOCS_UI_INVALID_SCOPED_ACCESS_REQUEST = 108;
2108  ATOM_DOCS_UI_LAUNCH_REPORTED = 109;
2109  ATOM_DOCS_UI_ROOT_VISITED = 110;
2110  ATOM_DOCS_UI_STARTUP_MS = 111;
2111  ATOM_DOCS_UI_USER_ACTION_REPORTED = 112;
2112  ATOM_WIFI_ENABLED_STATE_CHANGED = 113;
2113  ATOM_WIFI_RUNNING_STATE_CHANGED = 114;
2114  ATOM_APP_COMPACTED = 115;
2115  ATOM_NETWORK_DNS_EVENT_REPORTED = 116;
2116  ATOM_DOCS_UI_PICKER_LAUNCHED_FROM_REPORTED = 117;
2117  ATOM_DOCS_UI_PICK_RESULT_REPORTED = 118;
2118  ATOM_DOCS_UI_SEARCH_MODE_REPORTED = 119;
2119  ATOM_DOCS_UI_SEARCH_TYPE_REPORTED = 120;
2120  ATOM_DATA_STALL_EVENT = 121;
2121  ATOM_RESCUE_PARTY_RESET_REPORTED = 122;
2122  ATOM_SIGNED_CONFIG_REPORTED = 123;
2123  ATOM_GNSS_NI_EVENT_REPORTED = 124;
2124  ATOM_BLUETOOTH_LINK_LAYER_CONNECTION_EVENT = 125;
2125  ATOM_BLUETOOTH_ACL_CONNECTION_STATE_CHANGED = 126;
2126  ATOM_BLUETOOTH_SCO_CONNECTION_STATE_CHANGED = 127;
2127  ATOM_APP_DOWNGRADED = 128;
2128  ATOM_APP_OPTIMIZED_AFTER_DOWNGRADED = 129;
2129  ATOM_LOW_STORAGE_STATE_CHANGED = 130;
2130  ATOM_GNSS_NFW_NOTIFICATION_REPORTED = 131;
2131  ATOM_GNSS_CONFIGURATION_REPORTED = 132;
2132  ATOM_USB_PORT_OVERHEAT_EVENT_REPORTED = 133;
2133  ATOM_NFC_ERROR_OCCURRED = 134;
2134  ATOM_NFC_STATE_CHANGED = 135;
2135  ATOM_NFC_BEAM_OCCURRED = 136;
2136  ATOM_NFC_CARDEMULATION_OCCURRED = 137;
2137  ATOM_NFC_TAG_OCCURRED = 138;
2138  ATOM_NFC_HCE_TRANSACTION_OCCURRED = 139;
2139  ATOM_SE_STATE_CHANGED = 140;
2140  ATOM_SE_OMAPI_REPORTED = 141;
2141  ATOM_BROADCAST_DISPATCH_LATENCY_REPORTED = 142;
2142  ATOM_ATTENTION_MANAGER_SERVICE_RESULT_REPORTED = 143;
2143  ATOM_ADB_CONNECTION_CHANGED = 144;
2144  ATOM_SPEECH_DSP_STAT_REPORTED = 145;
2145  ATOM_USB_CONTAMINANT_REPORTED = 146;
2146  ATOM_WATCHDOG_ROLLBACK_OCCURRED = 147;
2147  ATOM_BIOMETRIC_SYSTEM_HEALTH_ISSUE_DETECTED = 148;
2148  ATOM_BUBBLE_UI_CHANGED = 149;
2149  ATOM_SCHEDULED_JOB_CONSTRAINT_CHANGED = 150;
2150  ATOM_BLUETOOTH_ACTIVE_DEVICE_CHANGED = 151;
2151  ATOM_BLUETOOTH_A2DP_PLAYBACK_STATE_CHANGED = 152;
2152  ATOM_BLUETOOTH_A2DP_CODEC_CONFIG_CHANGED = 153;
2153  ATOM_BLUETOOTH_A2DP_CODEC_CAPABILITY_CHANGED = 154;
2154  ATOM_BLUETOOTH_A2DP_AUDIO_UNDERRUN_REPORTED = 155;
2155  ATOM_BLUETOOTH_A2DP_AUDIO_OVERRUN_REPORTED = 156;
2156  ATOM_BLUETOOTH_DEVICE_RSSI_REPORTED = 157;
2157  ATOM_BLUETOOTH_DEVICE_FAILED_CONTACT_COUNTER_REPORTED = 158;
2158  ATOM_BLUETOOTH_DEVICE_TX_POWER_LEVEL_REPORTED = 159;
2159  ATOM_BLUETOOTH_HCI_TIMEOUT_REPORTED = 160;
2160  ATOM_BLUETOOTH_QUALITY_REPORT_REPORTED = 161;
2161  ATOM_BLUETOOTH_DEVICE_INFO_REPORTED = 162;
2162  ATOM_BLUETOOTH_REMOTE_VERSION_INFO_REPORTED = 163;
2163  ATOM_BLUETOOTH_SDP_ATTRIBUTE_REPORTED = 164;
2164  ATOM_BLUETOOTH_BOND_STATE_CHANGED = 165;
2165  ATOM_BLUETOOTH_CLASSIC_PAIRING_EVENT_REPORTED = 166;
2166  ATOM_BLUETOOTH_SMP_PAIRING_EVENT_REPORTED = 167;
2167  ATOM_SCREEN_TIMEOUT_EXTENSION_REPORTED = 168;
2168  ATOM_PROCESS_START_TIME = 169;
2169  ATOM_PERMISSION_GRANT_REQUEST_RESULT_REPORTED = 170;
2170  ATOM_BLUETOOTH_SOCKET_CONNECTION_STATE_CHANGED = 171;
2171  ATOM_DEVICE_IDENTIFIER_ACCESS_DENIED = 172;
2172  ATOM_BUBBLE_DEVELOPER_ERROR_REPORTED = 173;
2173  ATOM_ASSIST_GESTURE_STAGE_REPORTED = 174;
2174  ATOM_ASSIST_GESTURE_FEEDBACK_REPORTED = 175;
2175  ATOM_ASSIST_GESTURE_PROGRESS_REPORTED = 176;
2176  ATOM_TOUCH_GESTURE_CLASSIFIED = 177;
2177  ATOM_HIDDEN_API_USED = 178;
2178  ATOM_STYLE_UI_CHANGED = 179;
2179  ATOM_PRIVACY_INDICATORS_INTERACTED = 180;
2180  ATOM_APP_INSTALL_ON_EXTERNAL_STORAGE_REPORTED = 181;
2181  ATOM_NETWORK_STACK_REPORTED = 182;
2182  ATOM_APP_MOVED_STORAGE_REPORTED = 183;
2183  ATOM_BIOMETRIC_ENROLLED = 184;
2184  ATOM_SYSTEM_SERVER_WATCHDOG_OCCURRED = 185;
2185  ATOM_TOMB_STONE_OCCURRED = 186;
2186  ATOM_BLUETOOTH_CLASS_OF_DEVICE_REPORTED = 187;
2187  ATOM_INTELLIGENCE_EVENT_REPORTED = 188;
2188  ATOM_THERMAL_THROTTLING_SEVERITY_STATE_CHANGED = 189;
2189  ATOM_ROLE_REQUEST_RESULT_REPORTED = 190;
2190  ATOM_MEDIAMETRICS_AUDIOPOLICY_REPORTED = 191;
2191  ATOM_MEDIAMETRICS_AUDIORECORD_REPORTED = 192;
2192  ATOM_MEDIAMETRICS_AUDIOTHREAD_REPORTED = 193;
2193  ATOM_MEDIAMETRICS_AUDIOTRACK_REPORTED = 194;
2194  ATOM_MEDIAMETRICS_CODEC_REPORTED = 195;
2195  ATOM_MEDIAMETRICS_DRM_WIDEVINE_REPORTED = 196;
2196  ATOM_MEDIAMETRICS_EXTRACTOR_REPORTED = 197;
2197  ATOM_MEDIAMETRICS_MEDIADRM_REPORTED = 198;
2198  ATOM_MEDIAMETRICS_NUPLAYER_REPORTED = 199;
2199  ATOM_MEDIAMETRICS_RECORDER_REPORTED = 200;
2200  ATOM_MEDIAMETRICS_DRMMANAGER_REPORTED = 201;
2201  ATOM_CAR_POWER_STATE_CHANGED = 203;
2202  ATOM_GARAGE_MODE_INFO = 204;
2203  ATOM_TEST_ATOM_REPORTED = 205;
2204  ATOM_CONTENT_CAPTURE_CALLER_MISMATCH_REPORTED = 206;
2205  ATOM_CONTENT_CAPTURE_SERVICE_EVENTS = 207;
2206  ATOM_CONTENT_CAPTURE_SESSION_EVENTS = 208;
2207  ATOM_CONTENT_CAPTURE_FLUSHED = 209;
2208  ATOM_LOCATION_MANAGER_API_USAGE_REPORTED = 210;
2209  ATOM_REVIEW_PERMISSIONS_FRAGMENT_RESULT_REPORTED = 211;
2210  ATOM_RUNTIME_PERMISSIONS_UPGRADE_RESULT = 212;
2211  ATOM_GRANT_PERMISSIONS_ACTIVITY_BUTTON_ACTIONS = 213;
2212  ATOM_LOCATION_ACCESS_CHECK_NOTIFICATION_ACTION = 214;
2213  ATOM_APP_PERMISSION_FRAGMENT_ACTION_REPORTED = 215;
2214  ATOM_APP_PERMISSION_FRAGMENT_VIEWED = 216;
2215  ATOM_APP_PERMISSIONS_FRAGMENT_VIEWED = 217;
2216  ATOM_PERMISSION_APPS_FRAGMENT_VIEWED = 218;
2217  ATOM_TEXT_SELECTION_EVENT = 219;
2218  ATOM_TEXT_LINKIFY_EVENT = 220;
2219  ATOM_CONVERSATION_ACTIONS_EVENT = 221;
2220  ATOM_LANGUAGE_DETECTION_EVENT = 222;
2221  ATOM_EXCLUSION_RECT_STATE_CHANGED = 223;
2222  ATOM_BACK_GESTURE_REPORTED_REPORTED = 224;
2223  ATOM_UPDATE_ENGINE_UPDATE_ATTEMPT_REPORTED = 225;
2224  ATOM_UPDATE_ENGINE_SUCCESSFUL_UPDATE_REPORTED = 226;
2225  ATOM_CAMERA_ACTION_EVENT = 227;
2226  ATOM_APP_COMPATIBILITY_CHANGE_REPORTED = 228;
2227  ATOM_PERFETTO_UPLOADED = 229;
2228  ATOM_VMS_CLIENT_CONNECTION_STATE_CHANGED = 230;
2229  ATOM_MEDIA_PROVIDER_SCAN_OCCURRED = 233;
2230  ATOM_MEDIA_CONTENT_DELETED = 234;
2231  ATOM_MEDIA_PROVIDER_PERMISSION_REQUESTED = 235;
2232  ATOM_MEDIA_PROVIDER_SCHEMA_CHANGED = 236;
2233  ATOM_MEDIA_PROVIDER_IDLE_MAINTENANCE_FINISHED = 237;
2234  ATOM_REBOOT_ESCROW_RECOVERY_REPORTED = 238;
2235  ATOM_BOOT_TIME_EVENT_DURATION_REPORTED = 239;
2236  ATOM_BOOT_TIME_EVENT_ELAPSED_TIME_REPORTED = 240;
2237  ATOM_BOOT_TIME_EVENT_UTC_TIME_REPORTED = 241;
2238  ATOM_BOOT_TIME_EVENT_ERROR_CODE_REPORTED = 242;
2239  ATOM_USERSPACE_REBOOT_REPORTED = 243;
2240  ATOM_NOTIFICATION_REPORTED = 244;
2241  ATOM_NOTIFICATION_PANEL_REPORTED = 245;
2242  ATOM_NOTIFICATION_CHANNEL_MODIFIED = 246;
2243  ATOM_INTEGRITY_CHECK_RESULT_REPORTED = 247;
2244  ATOM_INTEGRITY_RULES_PUSHED = 248;
2245  ATOM_CB_MESSAGE_REPORTED = 249;
2246  ATOM_CB_MESSAGE_ERROR = 250;
2247  ATOM_WIFI_HEALTH_STAT_REPORTED = 251;
2248  ATOM_WIFI_FAILURE_STAT_REPORTED = 252;
2249  ATOM_WIFI_CONNECTION_RESULT_REPORTED = 253;
2250  ATOM_APP_FREEZE_CHANGED = 254;
2251  ATOM_SNAPSHOT_MERGE_REPORTED = 255;
2252  ATOM_FOREGROUND_SERVICE_APP_OP_SESSION_ENDED = 256;
2253  ATOM_DISPLAY_JANK_REPORTED = 257;
2254  ATOM_APP_STANDBY_BUCKET_CHANGED = 258;
2255  ATOM_SHARESHEET_STARTED = 259;
2256  ATOM_RANKING_SELECTED = 260;
2257  ATOM_TVSETTINGS_UI_INTERACTED = 261;
2258  ATOM_LAUNCHER_SNAPSHOT = 262;
2259  ATOM_PACKAGE_INSTALLER_V2_REPORTED = 263;
2260  ATOM_USER_LIFECYCLE_JOURNEY_REPORTED = 264;
2261  ATOM_USER_LIFECYCLE_EVENT_OCCURRED = 265;
2262  ATOM_ACCESSIBILITY_SHORTCUT_REPORTED = 266;
2263  ATOM_ACCESSIBILITY_SERVICE_REPORTED = 267;
2264  ATOM_DOCS_UI_DRAG_AND_DROP_REPORTED = 268;
2265  ATOM_APP_USAGE_EVENT_OCCURRED = 269;
2266  ATOM_AUTO_REVOKE_NOTIFICATION_CLICKED = 270;
2267  ATOM_AUTO_REVOKE_FRAGMENT_APP_VIEWED = 271;
2268  ATOM_AUTO_REVOKED_APP_INTERACTION = 272;
2269  ATOM_APP_PERMISSION_GROUPS_FRAGMENT_AUTO_REVOKE_ACTION = 273;
2270  ATOM_EVS_USAGE_STATS_REPORTED = 274;
2271  ATOM_AUDIO_POWER_USAGE_DATA_REPORTED = 275;
2272  ATOM_TV_TUNER_STATE_CHANGED = 276;
2273  ATOM_MEDIAOUTPUT_OP_SWITCH_REPORTED = 277;
2274  ATOM_CB_MESSAGE_FILTERED = 278;
2275  ATOM_TV_TUNER_DVR_STATUS = 279;
2276  ATOM_TV_CAS_SESSION_OPEN_STATUS = 280;
2277  ATOM_ASSISTANT_INVOCATION_REPORTED = 281;
2278  ATOM_DISPLAY_WAKE_REPORTED = 282;
2279  ATOM_CAR_USER_HAL_MODIFY_USER_REQUEST_REPORTED = 283;
2280  ATOM_CAR_USER_HAL_MODIFY_USER_RESPONSE_REPORTED = 284;
2281  ATOM_CAR_USER_HAL_POST_SWITCH_RESPONSE_REPORTED = 285;
2282  ATOM_CAR_USER_HAL_INITIAL_USER_INFO_REQUEST_REPORTED = 286;
2283  ATOM_CAR_USER_HAL_INITIAL_USER_INFO_RESPONSE_REPORTED = 287;
2284  ATOM_CAR_USER_HAL_USER_ASSOCIATION_REQUEST_REPORTED = 288;
2285  ATOM_CAR_USER_HAL_SET_USER_ASSOCIATION_RESPONSE_REPORTED = 289;
2286  ATOM_NETWORK_IP_PROVISIONING_REPORTED = 290;
2287  ATOM_NETWORK_DHCP_RENEW_REPORTED = 291;
2288  ATOM_NETWORK_VALIDATION_REPORTED = 292;
2289  ATOM_NETWORK_STACK_QUIRK_REPORTED = 293;
2290  ATOM_MEDIAMETRICS_AUDIORECORDDEVICEUSAGE_REPORTED = 294;
2291  ATOM_MEDIAMETRICS_AUDIOTHREADDEVICEUSAGE_REPORTED = 295;
2292  ATOM_MEDIAMETRICS_AUDIOTRACKDEVICEUSAGE_REPORTED = 296;
2293  ATOM_MEDIAMETRICS_AUDIODEVICECONNECTION_REPORTED = 297;
2294  ATOM_BLOB_COMMITTED = 298;
2295  ATOM_BLOB_LEASED = 299;
2296  ATOM_BLOB_OPENED = 300;
2297  ATOM_CONTACTS_PROVIDER_STATUS_REPORTED = 301;
2298  ATOM_KEYSTORE_KEY_EVENT_REPORTED = 302;
2299  ATOM_NETWORK_TETHERING_REPORTED = 303;
2300  ATOM_IME_TOUCH_REPORTED = 304;
2301  ATOM_UI_INTERACTION_FRAME_INFO_REPORTED = 305;
2302  ATOM_UI_ACTION_LATENCY_REPORTED = 306;
2303  ATOM_WIFI_DISCONNECT_REPORTED = 307;
2304  ATOM_WIFI_CONNECTION_STATE_CHANGED = 308;
2305  ATOM_HDMI_CEC_ACTIVE_SOURCE_CHANGED = 309;
2306  ATOM_HDMI_CEC_MESSAGE_REPORTED = 310;
2307  ATOM_AIRPLANE_MODE = 311;
2308  ATOM_MODEM_RESTART = 312;
2309  ATOM_CARRIER_ID_MISMATCH_REPORTED = 313;
2310  ATOM_CARRIER_ID_TABLE_UPDATED = 314;
2311  ATOM_DATA_STALL_RECOVERY_REPORTED = 315;
2312  ATOM_MEDIAMETRICS_MEDIAPARSER_REPORTED = 316;
2313  ATOM_TLS_HANDSHAKE_REPORTED = 317;
2314  ATOM_TEXT_CLASSIFIER_API_USAGE_REPORTED = 318;
2315  ATOM_CAR_WATCHDOG_KILL_STATS_REPORTED = 319;
2316  ATOM_MEDIAMETRICS_PLAYBACK_REPORTED = 320;
2317  ATOM_MEDIA_NETWORK_INFO_CHANGED = 321;
2318  ATOM_MEDIA_PLAYBACK_STATE_CHANGED = 322;
2319  ATOM_MEDIA_PLAYBACK_ERROR_REPORTED = 323;
2320  ATOM_MEDIA_PLAYBACK_TRACK_CHANGED = 324;
2321  ATOM_WIFI_SCAN_REPORTED = 325;
2322  ATOM_WIFI_PNO_SCAN_REPORTED = 326;
2323  ATOM_TIF_TUNE_CHANGED = 327;
2324  ATOM_AUTO_ROTATE_REPORTED = 328;
2325  ATOM_PERFETTO_TRIGGER = 329;
2326  ATOM_TRANSCODING_DATA = 330;
2327  ATOM_IMS_SERVICE_ENTITLEMENT_UPDATED = 331;
2328  ATOM_DEVICE_ROTATED = 333;
2329  ATOM_SIM_SPECIFIC_SETTINGS_RESTORED = 334;
2330  ATOM_TEXT_CLASSIFIER_DOWNLOAD_REPORTED = 335;
2331  ATOM_PIN_STORAGE_EVENT = 336;
2332  ATOM_FACE_DOWN_REPORTED = 337;
2333  ATOM_BLUETOOTH_HAL_CRASH_REASON_REPORTED = 338;
2334  ATOM_REBOOT_ESCROW_PREPARATION_REPORTED = 339;
2335  ATOM_REBOOT_ESCROW_LSKF_CAPTURE_REPORTED = 340;
2336  ATOM_REBOOT_ESCROW_REBOOT_REPORTED = 341;
2337  ATOM_BINDER_LATENCY_REPORTED = 342;
2338  ATOM_MEDIAMETRICS_AAUDIOSTREAM_REPORTED = 343;
2339  ATOM_MEDIA_TRANSCODING_SESSION_ENDED = 344;
2340  ATOM_MAGNIFICATION_USAGE_REPORTED = 345;
2341  ATOM_MAGNIFICATION_MODE_WITH_IME_ON_REPORTED = 346;
2342  ATOM_APP_SEARCH_CALL_STATS_REPORTED = 347;
2343  ATOM_APP_SEARCH_PUT_DOCUMENT_STATS_REPORTED = 348;
2344  ATOM_DEVICE_CONTROL_CHANGED = 349;
2345  ATOM_DEVICE_STATE_CHANGED = 350;
2346  ATOM_INPUTDEVICE_REGISTERED = 351;
2347  ATOM_SMARTSPACE_CARD_REPORTED = 352;
2348  ATOM_AUTH_PROMPT_AUTHENTICATE_INVOKED = 353;
2349  ATOM_AUTH_MANAGER_CAN_AUTHENTICATE_INVOKED = 354;
2350  ATOM_AUTH_ENROLL_ACTION_INVOKED = 355;
2351  ATOM_AUTH_DEPRECATED_API_USED = 356;
2352  ATOM_UNATTENDED_REBOOT_OCCURRED = 357;
2353  ATOM_LONG_REBOOT_BLOCKING_REPORTED = 358;
2354  ATOM_LOCATION_TIME_ZONE_PROVIDER_STATE_CHANGED = 359;
2355  ATOM_FDTRACK_EVENT_OCCURRED = 364;
2356  ATOM_TIMEOUT_AUTO_EXTENDED_REPORTED = 365;
2357  ATOM_ALARM_BATCH_DELIVERED = 367;
2358  ATOM_ALARM_SCHEDULED = 368;
2359  ATOM_CAR_WATCHDOG_IO_OVERUSE_STATS_REPORTED = 369;
2360  ATOM_USER_LEVEL_HIBERNATION_STATE_CHANGED = 370;
2361  ATOM_APP_SEARCH_INITIALIZE_STATS_REPORTED = 371;
2362  ATOM_APP_SEARCH_QUERY_STATS_REPORTED = 372;
2363  ATOM_APP_PROCESS_DIED = 373;
2364  ATOM_NETWORK_IP_REACHABILITY_MONITOR_REPORTED = 374;
2365  ATOM_SLOW_INPUT_EVENT_REPORTED = 375;
2366  ATOM_ANR_OCCURRED_PROCESSING_STARTED = 376;
2367  ATOM_APP_SEARCH_REMOVE_STATS_REPORTED = 377;
2368  ATOM_MEDIA_CODEC_REPORTED = 378;
2369  ATOM_PERMISSION_USAGE_FRAGMENT_INTERACTION = 379;
2370  ATOM_PERMISSION_DETAILS_INTERACTION = 380;
2371  ATOM_PRIVACY_SENSOR_TOGGLE_INTERACTION = 381;
2372  ATOM_PRIVACY_TOGGLE_DIALOG_INTERACTION = 382;
2373  ATOM_APP_SEARCH_OPTIMIZE_STATS_REPORTED = 383;
2374  ATOM_NON_A11Y_TOOL_SERVICE_WARNING_REPORT = 384;
2375  ATOM_APP_COMPAT_STATE_CHANGED = 386;
2376  ATOM_SIZE_COMPAT_RESTART_BUTTON_EVENT_REPORTED = 387;
2377  ATOM_SPLITSCREEN_UI_CHANGED = 388;
2378  ATOM_NETWORK_DNS_HANDSHAKE_REPORTED = 389;
2379  ATOM_BLUETOOTH_CODE_PATH_COUNTER = 390;
2380  ATOM_BLUETOOTH_LE_BATCH_SCAN_REPORT_DELAY = 392;
2381  ATOM_ACCESSIBILITY_FLOATING_MENU_UI_CHANGED = 393;
2382  ATOM_NEURALNETWORKS_COMPILATION_COMPLETED = 394;
2383  ATOM_NEURALNETWORKS_EXECUTION_COMPLETED = 395;
2384  ATOM_NEURALNETWORKS_COMPILATION_FAILED = 396;
2385  ATOM_NEURALNETWORKS_EXECUTION_FAILED = 397;
2386  ATOM_CONTEXT_HUB_BOOTED = 398;
2387  ATOM_CONTEXT_HUB_RESTARTED = 399;
2388  ATOM_CONTEXT_HUB_LOADED_NANOAPP_SNAPSHOT_REPORTED = 400;
2389  ATOM_CHRE_CODE_DOWNLOAD_TRANSACTED = 401;
2390  ATOM_UWB_SESSION_INITED = 402;
2391  ATOM_UWB_SESSION_CLOSED = 403;
2392  ATOM_UWB_FIRST_RANGING_RECEIVED = 404;
2393  ATOM_UWB_RANGING_MEASUREMENT_RECEIVED = 405;
2394  ATOM_TEXT_CLASSIFIER_DOWNLOAD_WORK_SCHEDULED = 406;
2395  ATOM_TEXT_CLASSIFIER_DOWNLOAD_WORK_COMPLETED = 407;
2396  ATOM_CLIPBOARD_CLEARED = 408;
2397  ATOM_VM_CREATION_REQUESTED = 409;
2398  ATOM_NEARBY_DEVICE_SCAN_STATE_CHANGED = 410;
2399  ATOM_CAMERA_COMPAT_CONTROL_EVENT_REPORTED = 411;
2400  ATOM_APPLICATION_LOCALES_CHANGED = 412;
2401  ATOM_MEDIAMETRICS_AUDIOTRACKSTATUS_REPORTED = 413;
2402  ATOM_FOLD_STATE_DURATION_REPORTED = 414;
2403  ATOM_LOCATION_TIME_ZONE_PROVIDER_CONTROLLER_STATE_CHANGED = 415;
2404  ATOM_DISPLAY_HBM_STATE_CHANGED = 416;
2405  ATOM_DISPLAY_HBM_BRIGHTNESS_CHANGED = 417;
2406  ATOM_PERSISTENT_URI_PERMISSIONS_FLUSHED = 418;
2407  ATOM_EARLY_BOOT_COMP_OS_ARTIFACTS_CHECK_REPORTED = 419;
2408  ATOM_VBMETA_DIGEST_REPORTED = 420;
2409  ATOM_APEX_INFO_GATHERED = 421;
2410  ATOM_PVM_INFO_GATHERED = 422;
2411  ATOM_WEAR_SETTINGS_UI_INTERACTED = 423;
2412  ATOM_TRACING_SERVICE_REPORT_EVENT = 424;
2413  ATOM_MEDIAMETRICS_AUDIORECORDSTATUS_REPORTED = 425;
2414  ATOM_LAUNCHER_LATENCY = 426;
2415  ATOM_DROPBOX_ENTRY_DROPPED = 427;
2416  ATOM_WIFI_P2P_CONNECTION_REPORTED = 428;
2417  ATOM_GAME_STATE_CHANGED = 429;
2418  ATOM_HOTWORD_DETECTOR_CREATE_REQUESTED = 430;
2419  ATOM_HOTWORD_DETECTION_SERVICE_INIT_RESULT_REPORTED = 431;
2420  ATOM_HOTWORD_DETECTION_SERVICE_RESTARTED = 432;
2421  ATOM_HOTWORD_DETECTOR_KEYPHRASE_TRIGGERED = 433;
2422  ATOM_HOTWORD_DETECTOR_EVENTS = 434;
2423  ATOM_BOOT_COMPLETED_BROADCAST_COMPLETION_LATENCY_REPORTED = 437;
2424  ATOM_CONTACTS_INDEXER_UPDATE_STATS_REPORTED = 440;
2425  ATOM_APP_BACKGROUND_RESTRICTIONS_INFO = 441;
2426  ATOM_MMS_SMS_PROVIDER_GET_THREAD_ID_FAILED = 442;
2427  ATOM_MMS_SMS_DATABASE_HELPER_ON_UPGRADE_FAILED = 443;
2428  ATOM_PERMISSION_REMINDER_NOTIFICATION_INTERACTED = 444;
2429  ATOM_RECENT_PERMISSION_DECISIONS_INTERACTED = 445;
2430  ATOM_GNSS_PSDS_DOWNLOAD_REPORTED = 446;
2431  ATOM_LE_AUDIO_CONNECTION_SESSION_REPORTED = 447;
2432  ATOM_LE_AUDIO_BROADCAST_SESSION_REPORTED = 448;
2433  ATOM_DREAM_UI_EVENT_REPORTED = 449;
2434  ATOM_TASK_MANAGER_EVENT_REPORTED = 450;
2435  ATOM_CDM_ASSOCIATION_ACTION = 451;
2436  ATOM_MAGNIFICATION_TRIPLE_TAP_AND_HOLD_ACTIVATED_SESSION_REPORTED = 452;
2437  ATOM_MAGNIFICATION_FOLLOW_TYPING_FOCUS_ACTIVATED_SESSION_REPORTED = 453;
2438  ATOM_ACCESSIBILITY_TEXT_READING_OPTIONS_CHANGED = 454;
2439  ATOM_WIFI_SETUP_FAILURE_CRASH_REPORTED = 455;
2440  ATOM_UWB_DEVICE_ERROR_REPORTED = 456;
2441  ATOM_ISOLATED_COMPILATION_SCHEDULED = 457;
2442  ATOM_ISOLATED_COMPILATION_ENDED = 458;
2443  ATOM_ONS_OPPORTUNISTIC_ESIM_PROVISIONING_COMPLETE = 459;
2444  ATOM_SYSTEM_SERVER_PRE_WATCHDOG_OCCURRED = 460;
2445  ATOM_TELEPHONY_ANOMALY_DETECTED = 461;
2446  ATOM_LETTERBOX_POSITION_CHANGED = 462;
2447  ATOM_REMOTE_KEY_PROVISIONING_ATTEMPT = 463;
2448  ATOM_REMOTE_KEY_PROVISIONING_NETWORK_INFO = 464;
2449  ATOM_REMOTE_KEY_PROVISIONING_TIMING = 465;
2450  ATOM_MEDIAOUTPUT_OP_INTERACTION_REPORT = 466;
2451  ATOM_SYNC_EXEMPTION_OCCURRED = 468;
2452  ATOM_AUTOFILL_PRESENTATION_EVENT_REPORTED = 469;
2453  ATOM_DOCK_STATE_CHANGED = 470;
2454  ATOM_SAFETY_SOURCE_STATE_COLLECTED = 471;
2455  ATOM_SAFETY_CENTER_SYSTEM_EVENT_REPORTED = 472;
2456  ATOM_SAFETY_CENTER_INTERACTION_REPORTED = 473;
2457  ATOM_SETTINGS_PROVIDER_SETTING_CHANGED = 474;
2458  ATOM_BROADCAST_DELIVERY_EVENT_REPORTED = 475;
2459  ATOM_SERVICE_REQUEST_EVENT_REPORTED = 476;
2460  ATOM_PROVIDER_ACQUISITION_EVENT_REPORTED = 477;
2461  ATOM_BLUETOOTH_DEVICE_NAME_REPORTED = 478;
2462  ATOM_CB_CONFIG_UPDATED = 479;
2463  ATOM_CB_MODULE_ERROR_REPORTED = 480;
2464  ATOM_CB_SERVICE_FEATURE_CHANGED = 481;
2465  ATOM_CB_RECEIVER_FEATURE_CHANGED = 482;
2466  ATOM_PRIVACY_SIGNAL_NOTIFICATION_INTERACTION = 484;
2467  ATOM_PRIVACY_SIGNAL_ISSUE_CARD_INTERACTION = 485;
2468  ATOM_PRIVACY_SIGNALS_JOB_FAILURE = 486;
2469  ATOM_VIBRATION_REPORTED = 487;
2470  ATOM_UWB_RANGING_START = 489;
2471  ATOM_APP_COMPACTED_V2 = 491;
2472  ATOM_DISPLAY_BRIGHTNESS_CHANGED = 494;
2473  ATOM_ACTIVITY_ACTION_BLOCKED = 495;
2474  ATOM_NETWORK_DNS_SERVER_SUPPORT_REPORTED = 504;
2475  ATOM_VM_BOOTED = 505;
2476  ATOM_VM_EXITED = 506;
2477  ATOM_AMBIENT_BRIGHTNESS_STATS_REPORTED = 507;
2478  ATOM_MEDIAMETRICS_SPATIALIZERCAPABILITIES_REPORTED = 508;
2479  ATOM_MEDIAMETRICS_SPATIALIZERDEVICEENABLED_REPORTED = 509;
2480  ATOM_MEDIAMETRICS_HEADTRACKERDEVICEENABLED_REPORTED = 510;
2481  ATOM_MEDIAMETRICS_HEADTRACKERDEVICESUPPORTED_REPORTED = 511;
2482  ATOM_HEARING_AID_INFO_REPORTED = 513;
2483  ATOM_DEVICE_WIDE_JOB_CONSTRAINT_CHANGED = 514;
2484  ATOM_AMBIENT_MODE_CHANGED = 515;
2485  ATOM_ANR_LATENCY_REPORTED = 516;
2486  ATOM_RESOURCE_API_INFO = 517;
2487  ATOM_SYSTEM_DEFAULT_NETWORK_CHANGED = 518;
2488  ATOM_IWLAN_SETUP_DATA_CALL_RESULT_REPORTED = 519;
2489  ATOM_IWLAN_PDN_DISCONNECTED_REASON_REPORTED = 520;
2490  ATOM_AIRPLANE_MODE_SESSION_REPORTED = 521;
2491  ATOM_VM_CPU_STATUS_REPORTED = 522;
2492  ATOM_VM_MEM_STATUS_REPORTED = 523;
2493  ATOM_PACKAGE_INSTALLATION_SESSION_REPORTED = 524;
2494  ATOM_DEFAULT_NETWORK_REMATCH_INFO = 525;
2495  ATOM_NETWORK_SELECTION_PERFORMANCE = 526;
2496  ATOM_NETWORK_NSD_REPORTED = 527;
2497  ATOM_BLUETOOTH_DISCONNECTION_REASON_REPORTED = 529;
2498  ATOM_BLUETOOTH_LOCAL_VERSIONS_REPORTED = 530;
2499  ATOM_BLUETOOTH_REMOTE_SUPPORTED_FEATURES_REPORTED = 531;
2500  ATOM_BLUETOOTH_LOCAL_SUPPORTED_FEATURES_REPORTED = 532;
2501  ATOM_BLUETOOTH_GATT_APP_INFO = 533;
2502  ATOM_BRIGHTNESS_CONFIGURATION_UPDATED = 534;
2503  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_LAUNCHED = 538;
2504  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_FINISHED = 539;
2505  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_CONNECTION_REPORTED = 540;
2506  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_DEVICE_SCAN_TRIGGERED = 541;
2507  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_FIRST_DEVICE_SCAN_LATENCY = 542;
2508  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_CONNECT_DEVICE_LATENCY = 543;
2509  ATOM_PACKAGE_MANAGER_SNAPSHOT_REPORTED = 544;
2510  ATOM_PACKAGE_MANAGER_APPS_FILTER_CACHE_BUILD_REPORTED = 545;
2511  ATOM_PACKAGE_MANAGER_APPS_FILTER_CACHE_UPDATE_REPORTED = 546;
2512  ATOM_LAUNCHER_IMPRESSION_EVENT = 547;
2513  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_ALL_DEVICES_SCAN_LATENCY = 549;
2514  ATOM_WS_WATCH_FACE_EDITED = 551;
2515  ATOM_WS_WATCH_FACE_FAVORITE_ACTION_REPORTED = 552;
2516  ATOM_WS_WATCH_FACE_SET_ACTION_REPORTED = 553;
2517  ATOM_PACKAGE_UNINSTALLATION_REPORTED = 554;
2518  ATOM_GAME_MODE_CHANGED = 555;
2519  ATOM_GAME_MODE_CONFIGURATION_CHANGED = 556;
2520  ATOM_BEDTIME_MODE_STATE_CHANGED = 557;
2521  ATOM_NETWORK_SLICE_SESSION_ENDED = 558;
2522  ATOM_NETWORK_SLICE_DAILY_DATA_USAGE_REPORTED = 559;
2523  ATOM_NFC_TAG_TYPE_OCCURRED = 560;
2524  ATOM_NFC_AID_CONFLICT_OCCURRED = 561;
2525  ATOM_NFC_READER_CONFLICT_OCCURRED = 562;
2526  ATOM_WS_TILE_LIST_CHANGED = 563;
2527  ATOM_GET_TYPE_ACCESSED_WITHOUT_PERMISSION = 564;
2528  ATOM_MOBILE_BUNDLED_APP_INFO_GATHERED = 566;
2529  ATOM_WS_WATCH_FACE_COMPLICATION_SET_CHANGED = 567;
2530  ATOM_MEDIA_DRM_CREATED = 568;
2531  ATOM_MEDIA_DRM_ERRORED = 569;
2532  ATOM_MEDIA_DRM_SESSION_OPENED = 570;
2533  ATOM_MEDIA_DRM_SESSION_CLOSED = 571;
2534  ATOM_USER_SELECTED_RESOLUTION = 572;
2535  ATOM_UNSAFE_INTENT_EVENT_REPORTED = 573;
2536  ATOM_PERFORMANCE_HINT_SESSION_REPORTED = 574;
2537  ATOM_MEDIAMETRICS_MIDI_DEVICE_CLOSE_REPORTED = 576;
2538  ATOM_BIOMETRIC_TOUCH_REPORTED = 577;
2539  ATOM_HOTWORD_AUDIO_EGRESS_EVENT_REPORTED = 578;
2540  ATOM_LOCATION_ENABLED_STATE_CHANGED = 580;
2541  ATOM_IME_REQUEST_FINISHED = 581;
2542  ATOM_USB_COMPLIANCE_WARNINGS_REPORTED = 582;
2543  ATOM_APP_SUPPORTED_LOCALES_CHANGED = 583;
2544  ATOM_MEDIA_PROVIDER_VOLUME_RECOVERY_REPORTED = 586;
2545  ATOM_BIOMETRIC_PROPERTIES_COLLECTED = 587;
2546  ATOM_KERNEL_WAKEUP_ATTRIBUTED = 588;
2547  ATOM_SCREEN_STATE_CHANGED_V2 = 589;
2548  ATOM_WS_BACKUP_ACTION_REPORTED = 590;
2549  ATOM_WS_RESTORE_ACTION_REPORTED = 591;
2550  ATOM_DEVICE_LOG_ACCESS_EVENT_REPORTED = 592;
2551  ATOM_MEDIA_SESSION_UPDATED = 594;
2552  ATOM_WEAR_OOBE_STATE_CHANGED = 595;
2553  ATOM_WS_NOTIFICATION_UPDATED = 596;
2554  ATOM_NETWORK_VALIDATION_FAILURE_STATS_DAILY_REPORTED = 601;
2555  ATOM_WS_COMPLICATION_TAPPED = 602;
2556  ATOM_WS_NOTIFICATION_BLOCKING = 780;
2557  ATOM_WS_NOTIFICATION_BRIDGEMODE_UPDATED = 822;
2558  ATOM_WS_NOTIFICATION_DISMISSAL_ACTIONED = 823;
2559  ATOM_WS_NOTIFICATION_ACTIONED = 824;
2560  ATOM_WS_NOTIFICATION_LATENCY = 880;
2561  ATOM_WIFI_BYTES_TRANSFER = 10000;
2562  ATOM_WIFI_BYTES_TRANSFER_BY_FG_BG = 10001;
2563  ATOM_MOBILE_BYTES_TRANSFER = 10002;
2564  ATOM_MOBILE_BYTES_TRANSFER_BY_FG_BG = 10003;
2565  ATOM_BLUETOOTH_BYTES_TRANSFER = 10006;
2566  ATOM_KERNEL_WAKELOCK = 10004;
2567  ATOM_SUBSYSTEM_SLEEP_STATE = 10005;
2568  ATOM_CPU_TIME_PER_UID = 10009;
2569  ATOM_CPU_TIME_PER_UID_FREQ = 10010;
2570  ATOM_WIFI_ACTIVITY_INFO = 10011;
2571  ATOM_MODEM_ACTIVITY_INFO = 10012;
2572  ATOM_BLUETOOTH_ACTIVITY_INFO = 10007;
2573  ATOM_PROCESS_MEMORY_STATE = 10013;
2574  ATOM_SYSTEM_ELAPSED_REALTIME = 10014;
2575  ATOM_SYSTEM_UPTIME = 10015;
2576  ATOM_CPU_ACTIVE_TIME = 10016;
2577  ATOM_CPU_CLUSTER_TIME = 10017;
2578  ATOM_DISK_SPACE = 10018;
2579  ATOM_REMAINING_BATTERY_CAPACITY = 10019;
2580  ATOM_FULL_BATTERY_CAPACITY = 10020;
2581  ATOM_TEMPERATURE = 10021;
2582  ATOM_BINDER_CALLS = 10022;
2583  ATOM_BINDER_CALLS_EXCEPTIONS = 10023;
2584  ATOM_LOOPER_STATS = 10024;
2585  ATOM_DISK_STATS = 10025;
2586  ATOM_DIRECTORY_USAGE = 10026;
2587  ATOM_APP_SIZE = 10027;
2588  ATOM_CATEGORY_SIZE = 10028;
2589  ATOM_PROC_STATS = 10029;
2590  ATOM_BATTERY_VOLTAGE = 10030;
2591  ATOM_NUM_FINGERPRINTS_ENROLLED = 10031;
2592  ATOM_DISK_IO = 10032;
2593  ATOM_POWER_PROFILE = 10033;
2594  ATOM_PROC_STATS_PKG_PROC = 10034;
2595  ATOM_PROCESS_CPU_TIME = 10035;
2596  ATOM_CPU_TIME_PER_THREAD_FREQ = 10037;
2597  ATOM_ON_DEVICE_POWER_MEASUREMENT = 10038;
2598  ATOM_DEVICE_CALCULATED_POWER_USE = 10039;
2599  ATOM_PROCESS_MEMORY_HIGH_WATER_MARK = 10042;
2600  ATOM_BATTERY_LEVEL = 10043;
2601  ATOM_BUILD_INFORMATION = 10044;
2602  ATOM_BATTERY_CYCLE_COUNT = 10045;
2603  ATOM_DEBUG_ELAPSED_CLOCK = 10046;
2604  ATOM_DEBUG_FAILING_ELAPSED_CLOCK = 10047;
2605  ATOM_NUM_FACES_ENROLLED = 10048;
2606  ATOM_ROLE_HOLDER = 10049;
2607  ATOM_DANGEROUS_PERMISSION_STATE = 10050;
2608  ATOM_TRAIN_INFO = 10051;
2609  ATOM_TIME_ZONE_DATA_INFO = 10052;
2610  ATOM_EXTERNAL_STORAGE_INFO = 10053;
2611  ATOM_GPU_STATS_GLOBAL_INFO = 10054;
2612  ATOM_GPU_STATS_APP_INFO = 10055;
2613  ATOM_SYSTEM_ION_HEAP_SIZE = 10056;
2614  ATOM_APPS_ON_EXTERNAL_STORAGE_INFO = 10057;
2615  ATOM_FACE_SETTINGS = 10058;
2616  ATOM_COOLING_DEVICE = 10059;
2617  ATOM_APP_OPS = 10060;
2618  ATOM_PROCESS_SYSTEM_ION_HEAP_SIZE = 10061;
2619  ATOM_SURFACEFLINGER_STATS_GLOBAL_INFO = 10062;
2620  ATOM_SURFACEFLINGER_STATS_LAYER_INFO = 10063;
2621  ATOM_PROCESS_MEMORY_SNAPSHOT = 10064;
2622  ATOM_VMS_CLIENT_STATS = 10065;
2623  ATOM_NOTIFICATION_REMOTE_VIEWS = 10066;
2624  ATOM_DANGEROUS_PERMISSION_STATE_SAMPLED = 10067;
2625  ATOM_GRAPHICS_STATS = 10068;
2626  ATOM_RUNTIME_APP_OP_ACCESS = 10069;
2627  ATOM_ION_HEAP_SIZE = 10070;
2628  ATOM_PACKAGE_NOTIFICATION_PREFERENCES = 10071;
2629  ATOM_PACKAGE_NOTIFICATION_CHANNEL_PREFERENCES = 10072;
2630  ATOM_PACKAGE_NOTIFICATION_CHANNEL_GROUP_PREFERENCES = 10073;
2631  ATOM_GNSS_STATS = 10074;
2632  ATOM_ATTRIBUTED_APP_OPS = 10075;
2633  ATOM_VOICE_CALL_SESSION = 10076;
2634  ATOM_VOICE_CALL_RAT_USAGE = 10077;
2635  ATOM_SIM_SLOT_STATE = 10078;
2636  ATOM_SUPPORTED_RADIO_ACCESS_FAMILY = 10079;
2637  ATOM_SETTING_SNAPSHOT = 10080;
2638  ATOM_BLOB_INFO = 10081;
2639  ATOM_DATA_USAGE_BYTES_TRANSFER = 10082;
2640  ATOM_BYTES_TRANSFER_BY_TAG_AND_METERED = 10083;
2641  ATOM_DND_MODE_RULE = 10084;
2642  ATOM_GENERAL_EXTERNAL_STORAGE_ACCESS_STATS = 10085;
2643  ATOM_INCOMING_SMS = 10086;
2644  ATOM_OUTGOING_SMS = 10087;
2645  ATOM_CARRIER_ID_TABLE_VERSION = 10088;
2646  ATOM_DATA_CALL_SESSION = 10089;
2647  ATOM_CELLULAR_SERVICE_STATE = 10090;
2648  ATOM_CELLULAR_DATA_SERVICE_SWITCH = 10091;
2649  ATOM_SYSTEM_MEMORY = 10092;
2650  ATOM_IMS_REGISTRATION_TERMINATION = 10093;
2651  ATOM_IMS_REGISTRATION_STATS = 10094;
2652  ATOM_CPU_TIME_PER_CLUSTER_FREQ = 10095;
2653  ATOM_CPU_CYCLES_PER_UID_CLUSTER = 10096;
2654  ATOM_DEVICE_ROTATED_DATA = 10097;
2655  ATOM_CPU_CYCLES_PER_THREAD_GROUP_CLUSTER = 10098;
2656  ATOM_MEDIA_DRM_ACTIVITY_INFO = 10099;
2657  ATOM_OEM_MANAGED_BYTES_TRANSFER = 10100;
2658  ATOM_GNSS_POWER_STATS = 10101;
2659  ATOM_TIME_ZONE_DETECTOR_STATE = 10102;
2660  ATOM_KEYSTORE2_STORAGE_STATS = 10103;
2661  ATOM_RKP_POOL_STATS = 10104;
2662  ATOM_PROCESS_DMABUF_MEMORY = 10105;
2663  ATOM_PENDING_ALARM_INFO = 10106;
2664  ATOM_USER_LEVEL_HIBERNATED_APPS = 10107;
2665  ATOM_LAUNCHER_LAYOUT_SNAPSHOT = 10108;
2666  ATOM_GLOBAL_HIBERNATED_APPS = 10109;
2667  ATOM_INPUT_EVENT_LATENCY_SKETCH = 10110;
2668  ATOM_BATTERY_USAGE_STATS_BEFORE_RESET = 10111;
2669  ATOM_BATTERY_USAGE_STATS_SINCE_RESET = 10112;
2670  ATOM_BATTERY_USAGE_STATS_SINCE_RESET_USING_POWER_PROFILE_MODEL = 10113;
2671  ATOM_INSTALLED_INCREMENTAL_PACKAGE = 10114;
2672  ATOM_TELEPHONY_NETWORK_REQUESTS = 10115;
2673  ATOM_APP_SEARCH_STORAGE_INFO = 10116;
2674  ATOM_VMSTAT = 10117;
2675  ATOM_KEYSTORE2_KEY_CREATION_WITH_GENERAL_INFO = 10118;
2676  ATOM_KEYSTORE2_KEY_CREATION_WITH_AUTH_INFO = 10119;
2677  ATOM_KEYSTORE2_KEY_CREATION_WITH_PURPOSE_AND_MODES_INFO = 10120;
2678  ATOM_KEYSTORE2_ATOM_WITH_OVERFLOW = 10121;
2679  ATOM_KEYSTORE2_KEY_OPERATION_WITH_PURPOSE_AND_MODES_INFO = 10122;
2680  ATOM_KEYSTORE2_KEY_OPERATION_WITH_GENERAL_INFO = 10123;
2681  ATOM_RKP_ERROR_STATS = 10124;
2682  ATOM_KEYSTORE2_CRASH_STATS = 10125;
2683  ATOM_VENDOR_APEX_INFO = 10126;
2684  ATOM_ACCESSIBILITY_SHORTCUT_STATS = 10127;
2685  ATOM_ACCESSIBILITY_FLOATING_MENU_STATS = 10128;
2686  ATOM_DATA_USAGE_BYTES_TRANSFER_V2 = 10129;
2687  ATOM_MEDIA_CAPABILITIES = 10130;
2688  ATOM_CAR_WATCHDOG_SYSTEM_IO_USAGE_SUMMARY = 10131;
2689  ATOM_CAR_WATCHDOG_UID_IO_USAGE_SUMMARY = 10132;
2690  ATOM_IMS_REGISTRATION_FEATURE_TAG_STATS = 10133;
2691  ATOM_RCS_CLIENT_PROVISIONING_STATS = 10134;
2692  ATOM_RCS_ACS_PROVISIONING_STATS = 10135;
2693  ATOM_SIP_DELEGATE_STATS = 10136;
2694  ATOM_SIP_TRANSPORT_FEATURE_TAG_STATS = 10137;
2695  ATOM_SIP_MESSAGE_RESPONSE = 10138;
2696  ATOM_SIP_TRANSPORT_SESSION = 10139;
2697  ATOM_IMS_DEDICATED_BEARER_LISTENER_EVENT = 10140;
2698  ATOM_IMS_DEDICATED_BEARER_EVENT = 10141;
2699  ATOM_IMS_REGISTRATION_SERVICE_DESC_STATS = 10142;
2700  ATOM_UCE_EVENT_STATS = 10143;
2701  ATOM_PRESENCE_NOTIFY_EVENT = 10144;
2702  ATOM_GBA_EVENT = 10145;
2703  ATOM_PER_SIM_STATUS = 10146;
2704  ATOM_GPU_WORK_PER_UID = 10147;
2705  ATOM_PERSISTENT_URI_PERMISSIONS_AMOUNT_PER_PACKAGE = 10148;
2706  ATOM_SIGNED_PARTITION_INFO = 10149;
2707  ATOM_PINNED_FILE_SIZES_PER_PACKAGE = 10150;
2708  ATOM_PENDING_INTENTS_PER_PACKAGE = 10151;
2709  ATOM_USER_INFO = 10152;
2710  ATOM_TELEPHONY_NETWORK_REQUESTS_V2 = 10153;
2711  ATOM_DEVICE_TELEPHONY_PROPERTIES = 10154;
2712  ATOM_REMOTE_KEY_PROVISIONING_ERROR_COUNTS = 10155;
2713  ATOM_SAFETY_STATE = 10156;
2714  ATOM_INCOMING_MMS = 10157;
2715  ATOM_OUTGOING_MMS = 10158;
2716  ATOM_MULTI_USER_INFO = 10160;
2717  ATOM_NETWORK_BPF_MAP_INFO = 10161;
2718  ATOM_OUTGOING_SHORT_CODE_SMS = 10162;
2719  ATOM_CONNECTIVITY_STATE_SAMPLE = 10163;
2720  ATOM_NETWORK_SELECTION_REMATCH_REASONS_INFO = 10164;
2721  ATOM_GAME_MODE_INFO = 10165;
2722  ATOM_GAME_MODE_CONFIGURATION = 10166;
2723  ATOM_GAME_MODE_LISTENER = 10167;
2724  ATOM_NETWORK_SLICE_REQUEST_COUNT = 10168;
2725  ATOM_WS_TILE_SNAPSHOT = 10169;
2726  ATOM_WS_ACTIVE_WATCH_FACE_COMPLICATION_SET_SNAPSHOT = 10170;
2727  ATOM_PROCESS_STATE = 10171;
2728  ATOM_PROCESS_ASSOCIATION = 10172;
2729  ATOM_ADPF_SYSTEM_COMPONENT_INFO = 10173;
2730  ATOM_NOTIFICATION_MEMORY_USE = 10174;
2731  ATOM_HDR_CAPABILITIES = 10175;
2732  ATOM_WS_FAVOURITE_WATCH_FACE_LIST_SNAPSHOT = 10176;
2733  ATOM_ADAPTIVE_AUTH_UNLOCK_AFTER_LOCK_REPORTED = 820;
2734  ATOM_THERMAL_STATUS_CALLED = 772;
2735  ATOM_THERMAL_HEADROOM_CALLED = 773;
2736  ATOM_THERMAL_HEADROOM_THRESHOLDS_CALLED = 774;
2737  ATOM_ADPF_HINT_SESSION_TID_CLEANUP = 839;
2738  ATOM_THERMAL_HEADROOM_THRESHOLDS = 10201;
2739  ATOM_ADPF_SESSION_SNAPSHOT = 10218;
2740  ATOM_JSSCRIPTENGINE_LATENCY_REPORTED = 483;
2741  ATOM_AD_SERVICES_API_CALLED = 435;
2742  ATOM_AD_SERVICES_MESUREMENT_REPORTS_UPLOADED = 436;
2743  ATOM_MOBILE_DATA_DOWNLOAD_FILE_GROUP_STATUS_REPORTED = 490;
2744  ATOM_MOBILE_DATA_DOWNLOAD_DOWNLOAD_RESULT_REPORTED = 502;
2745  ATOM_AD_SERVICES_SETTINGS_USAGE_REPORTED = 493;
2746  ATOM_BACKGROUND_FETCH_PROCESS_REPORTED = 496;
2747  ATOM_UPDATE_CUSTOM_AUDIENCE_PROCESS_REPORTED = 497;
2748  ATOM_RUN_AD_BIDDING_PROCESS_REPORTED = 498;
2749  ATOM_RUN_AD_SCORING_PROCESS_REPORTED = 499;
2750  ATOM_RUN_AD_SELECTION_PROCESS_REPORTED = 500;
2751  ATOM_RUN_AD_BIDDING_PER_CA_PROCESS_REPORTED = 501;
2752  ATOM_MOBILE_DATA_DOWNLOAD_FILE_GROUP_STORAGE_STATS_REPORTED = 503;
2753  ATOM_AD_SERVICES_MEASUREMENT_REGISTRATIONS = 512;
2754  ATOM_AD_SERVICES_GET_TOPICS_REPORTED = 535;
2755  ATOM_AD_SERVICES_EPOCH_COMPUTATION_GET_TOP_TOPICS_REPORTED = 536;
2756  ATOM_AD_SERVICES_EPOCH_COMPUTATION_CLASSIFIER_REPORTED = 537;
2757  ATOM_AD_SERVICES_BACK_COMPAT_GET_TOPICS_REPORTED = 598;
2758  ATOM_AD_SERVICES_BACK_COMPAT_EPOCH_COMPUTATION_CLASSIFIER_REPORTED = 599;
2759  ATOM_AD_SERVICES_MEASUREMENT_DEBUG_KEYS = 640;
2760  ATOM_AD_SERVICES_ERROR_REPORTED = 662;
2761  ATOM_AD_SERVICES_BACKGROUND_JOBS_EXECUTION_REPORTED = 663;
2762  ATOM_AD_SERVICES_MEASUREMENT_DELAYED_SOURCE_REGISTRATION = 673;
2763  ATOM_AD_SERVICES_MEASUREMENT_ATTRIBUTION = 674;
2764  ATOM_AD_SERVICES_MEASUREMENT_JOBS = 675;
2765  ATOM_AD_SERVICES_MEASUREMENT_WIPEOUT = 676;
2766  ATOM_AD_SERVICES_MEASUREMENT_AD_ID_MATCH_FOR_DEBUG_KEYS = 695;
2767  ATOM_AD_SERVICES_ENROLLMENT_DATA_STORED = 697;
2768  ATOM_AD_SERVICES_ENROLLMENT_FILE_DOWNLOADED = 698;
2769  ATOM_AD_SERVICES_ENROLLMENT_MATCHED = 699;
2770  ATOM_AD_SERVICES_CONSENT_MIGRATED = 702;
2771  ATOM_AD_SERVICES_ENROLLMENT_FAILED = 714;
2772  ATOM_AD_SERVICES_MEASUREMENT_CLICK_VERIFICATION = 756;
2773  ATOM_AD_SERVICES_ENCRYPTION_KEY_FETCHED = 765;
2774  ATOM_AD_SERVICES_ENCRYPTION_KEY_DB_TRANSACTION_ENDED = 766;
2775  ATOM_DESTINATION_REGISTERED_BEACONS = 767;
2776  ATOM_REPORT_INTERACTION_API_CALLED = 768;
2777  ATOM_INTERACTION_REPORTING_TABLE_CLEARED = 769;
2778  ATOM_APP_MANIFEST_CONFIG_HELPER_CALLED = 788;
2779  ATOM_AD_FILTERING_PROCESS_JOIN_CA_REPORTED = 793;
2780  ATOM_AD_FILTERING_PROCESS_AD_SELECTION_REPORTED = 794;
2781  ATOM_AD_COUNTER_HISTOGRAM_UPDATER_REPORTED = 795;
2782  ATOM_SIGNATURE_VERIFICATION = 807;
2783  ATOM_K_ANON_IMMEDIATE_SIGN_JOIN_STATUS_REPORTED = 808;
2784  ATOM_K_ANON_BACKGROUND_JOB_STATUS_REPORTED = 809;
2785  ATOM_K_ANON_INITIALIZE_STATUS_REPORTED = 810;
2786  ATOM_K_ANON_SIGN_STATUS_REPORTED = 811;
2787  ATOM_K_ANON_JOIN_STATUS_REPORTED = 812;
2788  ATOM_K_ANON_KEY_ATTESTATION_STATUS_REPORTED = 813;
2789  ATOM_GET_AD_SELECTION_DATA_API_CALLED = 814;
2790  ATOM_GET_AD_SELECTION_DATA_BUYER_INPUT_GENERATED = 815;
2791  ATOM_BACKGROUND_JOB_SCHEDULING_REPORTED = 834;
2792  ATOM_TOPICS_ENCRYPTION_EPOCH_COMPUTATION_REPORTED = 840;
2793  ATOM_TOPICS_ENCRYPTION_GET_TOPICS_REPORTED = 841;
2794  ATOM_ADSERVICES_SHELL_COMMAND_CALLED = 842;
2795  ATOM_UPDATE_SIGNALS_API_CALLED = 843;
2796  ATOM_ENCODING_JOB_RUN = 844;
2797  ATOM_ENCODING_JS_FETCH = 845;
2798  ATOM_ENCODING_JS_EXECUTION = 846;
2799  ATOM_PERSIST_AD_SELECTION_RESULT_CALLED = 847;
2800  ATOM_SERVER_AUCTION_KEY_FETCH_CALLED = 848;
2801  ATOM_SERVER_AUCTION_BACKGROUND_KEY_FETCH_ENABLED = 849;
2802  ATOM_AD_SERVICES_MEASUREMENT_PROCESS_ODP_REGISTRATION = 864;
2803  ATOM_AD_SERVICES_MEASUREMENT_NOTIFY_REGISTRATION_TO_ODP = 865;
2804  ATOM_SELECT_ADS_FROM_OUTCOMES_API_CALLED = 876;
2805  ATOM_REPORT_IMPRESSION_API_CALLED = 877;
2806  ATOM_AD_SERVICES_ENROLLMENT_TRANSACTION_STATS = 885;
2807  ATOM_AI_WALLPAPERS_BUTTON_PRESSED = 706;
2808  ATOM_AI_WALLPAPERS_TEMPLATE_SELECTED = 707;
2809  ATOM_AI_WALLPAPERS_TERM_SELECTED = 708;
2810  ATOM_AI_WALLPAPERS_WALLPAPER_SET = 709;
2811  ATOM_AI_WALLPAPERS_SESSION_SUMMARY = 710;
2812  ATOM_APEX_INSTALLATION_REQUESTED = 732;
2813  ATOM_APEX_INSTALLATION_STAGED = 733;
2814  ATOM_APEX_INSTALLATION_ENDED = 734;
2815  ATOM_APP_SEARCH_SET_SCHEMA_STATS_REPORTED = 385;
2816  ATOM_APP_SEARCH_SCHEMA_MIGRATION_STATS_REPORTED = 579;
2817  ATOM_APP_SEARCH_USAGE_SEARCH_INTENT_STATS_REPORTED = 825;
2818  ATOM_APP_SEARCH_USAGE_SEARCH_INTENT_RAW_QUERY_STATS_REPORTED = 826;
2819  ATOM_ART_DATUM_REPORTED = 332;
2820  ATOM_ART_DEVICE_DATUM_REPORTED = 550;
2821  ATOM_ART_DATUM_DELTA_REPORTED = 565;
2822  ATOM_ART_DEX2OAT_REPORTED = 929;
2823  ATOM_ART_DEVICE_STATUS = 10205;
2824  ATOM_BACKGROUND_DEXOPT_JOB_ENDED = 467;
2825  ATOM_PREREBOOT_DEXOPT_JOB_ENDED = 883;
2826  ATOM_ODREFRESH_REPORTED = 366;
2827  ATOM_ODSIGN_REPORTED = 548;
2828  ATOM_AUTOFILL_UI_EVENT_REPORTED = 603;
2829  ATOM_AUTOFILL_FILL_REQUEST_REPORTED = 604;
2830  ATOM_AUTOFILL_FILL_RESPONSE_REPORTED = 605;
2831  ATOM_AUTOFILL_SAVE_EVENT_REPORTED = 606;
2832  ATOM_AUTOFILL_SESSION_COMMITTED = 607;
2833  ATOM_AUTOFILL_FIELD_CLASSIFICATION_EVENT_REPORTED = 659;
2834  ATOM_CAR_RECENTS_EVENT_REPORTED = 770;
2835  ATOM_CAR_CALM_MODE_EVENT_REPORTED = 797;
2836  ATOM_CAR_WAKEUP_FROM_SUSPEND_REPORTED = 852;
2837  ATOM_PLUGIN_INITIALIZED = 655;
2838  ATOM_BLUETOOTH_HASHED_DEVICE_NAME_REPORTED = 613;
2839  ATOM_BLUETOOTH_L2CAP_COC_CLIENT_CONNECTION = 614;
2840  ATOM_BLUETOOTH_L2CAP_COC_SERVER_CONNECTION = 615;
2841  ATOM_BLUETOOTH_LE_SESSION_CONNECTED = 656;
2842  ATOM_RESTRICTED_BLUETOOTH_DEVICE_NAME_REPORTED = 666;
2843  ATOM_BLUETOOTH_PROFILE_CONNECTION_ATTEMPTED = 696;
2844  ATOM_BLUETOOTH_CONTENT_PROFILE_ERROR_REPORTED = 781;
2845  ATOM_BLUETOOTH_RFCOMM_CONNECTION_ATTEMPTED = 782;
2846  ATOM_REMOTE_DEVICE_INFORMATION_WITH_METRIC_ID = 862;
2847  ATOM_LE_APP_SCAN_STATE_CHANGED = 870;
2848  ATOM_LE_RADIO_SCAN_STOPPED = 871;
2849  ATOM_LE_SCAN_RESULT_RECEIVED = 872;
2850  ATOM_LE_SCAN_ABUSED = 873;
2851  ATOM_LE_ADV_STATE_CHANGED = 874;
2852  ATOM_LE_ADV_ERROR_REPORTED = 875;
2853  ATOM_A2DP_SESSION_REPORTED = 904;
2854  ATOM_BLUETOOTH_CROSS_LAYER_EVENT_REPORTED = 916;
2855  ATOM_BROADCAST_AUDIO_SESSION_REPORTED = 927;
2856  ATOM_BROADCAST_AUDIO_SYNC_REPORTED = 928;
2857  ATOM_BLUETOOTH_RFCOMM_CONNECTION_REPORTED_AT_CLOSE = 982;
2858  ATOM_CAMERA_FEATURE_COMBINATION_QUERY_EVENT = 900;
2859  ATOM_DAILY_KEEPALIVE_INFO_REPORTED = 650;
2860  ATOM_NETWORK_REQUEST_STATE_CHANGED = 779;
2861  ATOM_TETHERING_ACTIVE_SESSIONS_REPORTED = 925;
2862  ATOM_NETWORK_STATS_RECORDER_FILE_OPERATED = 783;
2863  ATOM_CORE_NETWORKING_TERRIBLE_ERROR_OCCURRED = 979;
2864  ATOM_APF_SESSION_INFO_REPORTED = 777;
2865  ATOM_IP_CLIENT_RA_INFO_REPORTED = 778;
2866  ATOM_VPN_CONNECTION_STATE_CHANGED = 850;
2867  ATOM_VPN_CONNECTION_REPORTED = 851;
2868  ATOM_CPU_POLICY = 10199;
2869  ATOM_CREDENTIAL_MANAGER_API_CALLED = 585;
2870  ATOM_CREDENTIAL_MANAGER_INIT_PHASE_REPORTED = 651;
2871  ATOM_CREDENTIAL_MANAGER_CANDIDATE_PHASE_REPORTED = 652;
2872  ATOM_CREDENTIAL_MANAGER_FINAL_PHASE_REPORTED = 653;
2873  ATOM_CREDENTIAL_MANAGER_TOTAL_REPORTED = 667;
2874  ATOM_CREDENTIAL_MANAGER_FINALNOUID_REPORTED = 668;
2875  ATOM_CREDENTIAL_MANAGER_GET_REPORTED = 669;
2876  ATOM_CREDENTIAL_MANAGER_AUTH_CLICK_REPORTED = 670;
2877  ATOM_CREDENTIAL_MANAGER_APIV2_CALLED = 671;
2878  ATOM_CRONET_ENGINE_CREATED = 703;
2879  ATOM_CRONET_TRAFFIC_REPORTED = 704;
2880  ATOM_CRONET_ENGINE_BUILDER_INITIALIZED = 762;
2881  ATOM_CRONET_HTTP_FLAGS_INITIALIZED = 763;
2882  ATOM_CRONET_INITIALIZED = 764;
2883  ATOM_DESKTOP_MODE_UI_CHANGED = 818;
2884  ATOM_DESKTOP_MODE_SESSION_TASK_UPDATE = 819;
2885  ATOM_DEVICE_LOCK_CHECK_IN_REQUEST_REPORTED = 726;
2886  ATOM_DEVICE_LOCK_PROVISIONING_COMPLETE_REPORTED = 727;
2887  ATOM_DEVICE_LOCK_KIOSK_APP_REQUEST_REPORTED = 728;
2888  ATOM_DEVICE_LOCK_CHECK_IN_RETRY_REPORTED = 789;
2889  ATOM_DEVICE_LOCK_PROVISION_FAILURE_REPORTED = 790;
2890  ATOM_DEVICE_LOCK_LOCK_UNLOCK_DEVICE_FAILURE_REPORTED = 791;
2891  ATOM_DEVICE_POLICY_MANAGEMENT_MODE = 10216;
2892  ATOM_DEVICE_POLICY_STATE = 10217;
2893  ATOM_DISPLAY_MODE_DIRECTOR_VOTE_CHANGED = 792;
2894  ATOM_EXTERNAL_DISPLAY_STATE_CHANGED = 806;
2895  ATOM_DND_STATE_CHANGED = 657;
2896  ATOM_DREAM_SETTING_CHANGED = 705;
2897  ATOM_DREAM_SETTING_SNAPSHOT = 10192;
2898  ATOM_EXPRESS_EVENT_REPORTED = 528;
2899  ATOM_EXPRESS_HISTOGRAM_SAMPLE_REPORTED = 593;
2900  ATOM_EXPRESS_UID_EVENT_REPORTED = 644;
2901  ATOM_EXPRESS_UID_HISTOGRAM_SAMPLE_REPORTED = 658;
2902  ATOM_FEDERATED_COMPUTE_API_CALLED = 712;
2903  ATOM_FEDERATED_COMPUTE_TRAINING_EVENT_REPORTED = 771;
2904  ATOM_EXAMPLE_ITERATOR_NEXT_LATENCY_REPORTED = 838;
2905  ATOM_FULL_SCREEN_INTENT_LAUNCHED = 631;
2906  ATOM_BAL_ALLOWED = 632;
2907  ATOM_IN_TASK_ACTIVITY_STARTED = 685;
2908  ATOM_CACHED_APPS_HIGH_WATERMARK = 10189;
2909  ATOM_STYLUS_PREDICTION_METRICS_REPORTED = 718;
2910  ATOM_USER_RISK_EVENT_REPORTED = 725;
2911  ATOM_MEDIA_PROJECTION_STATE_CHANGED = 729;
2912  ATOM_MEDIA_PROJECTION_TARGET_CHANGED = 730;
2913  ATOM_EXCESSIVE_BINDER_PROXY_COUNT_REPORTED = 853;
2914  ATOM_PROXY_BYTES_TRANSFER_BY_FG_BG = 10200;
2915  ATOM_MOBILE_BYTES_TRANSFER_BY_PROC_STATE = 10204;
2916  ATOM_BIOMETRIC_FRR_NOTIFICATION = 817;
2917  ATOM_SENSITIVE_CONTENT_MEDIA_PROJECTION_SESSION = 830;
2918  ATOM_SENSITIVE_NOTIFICATION_APP_PROTECTION_SESSION = 831;
2919  ATOM_SENSITIVE_NOTIFICATION_APP_PROTECTION_APPLIED = 832;
2920  ATOM_SENSITIVE_NOTIFICATION_REDACTION = 833;
2921  ATOM_SENSITIVE_CONTENT_APP_PROTECTION = 835;
2922  ATOM_APP_RESTRICTION_STATE_CHANGED = 866;
2923  ATOM_APPLICATION_GRAMMATICAL_INFLECTION_CHANGED = 584;
2924  ATOM_SYSTEM_GRAMMATICAL_INFLECTION_CHANGED = 816;
2925  ATOM_HDMI_EARC_STATUS_REPORTED = 701;
2926  ATOM_HDMI_SOUNDBAR_MODE_STATUS_REPORTED = 724;
2927  ATOM_HEALTH_CONNECT_API_CALLED = 616;
2928  ATOM_HEALTH_CONNECT_USAGE_STATS = 617;
2929  ATOM_HEALTH_CONNECT_STORAGE_STATS = 618;
2930  ATOM_HEALTH_CONNECT_API_INVOKED = 643;
2931  ATOM_EXERCISE_ROUTE_API_CALLED = 654;
2932  ATOM_HEALTH_CONNECT_UI_IMPRESSION = 623;
2933  ATOM_HEALTH_CONNECT_UI_INTERACTION = 624;
2934  ATOM_HEALTH_CONNECT_APP_OPENED_REPORTED = 625;
2935  ATOM_HOTWORD_EGRESS_SIZE_ATOM_REPORTED = 761;
2936  ATOM_IKE_SESSION_TERMINATED = 678;
2937  ATOM_IKE_LIVENESS_CHECK_SESSION_VALIDATED = 760;
2938  ATOM_NEGOTIATED_SECURITY_ASSOCIATION = 821;
2939  ATOM_KEYBOARD_CONFIGURED = 682;
2940  ATOM_KEYBOARD_SYSTEMS_EVENT_REPORTED = 683;
2941  ATOM_INPUTDEVICE_USAGE_REPORTED = 686;
2942  ATOM_TOUCHPAD_USAGE = 10191;
2943  ATOM_KERNEL_OOM_KILL_OCCURRED = 754;
2944  ATOM_EMERGENCY_STATE_CHANGED = 633;
2945  ATOM_CHRE_SIGNIFICANT_MOTION_STATE_CHANGED = 868;
2946  ATOM_MEDIA_CODEC_RECLAIM_REQUEST_COMPLETED = 600;
2947  ATOM_MEDIA_CODEC_STARTED = 641;
2948  ATOM_MEDIA_CODEC_STOPPED = 642;
2949  ATOM_MEDIA_CODEC_RENDERED = 684;
2950  ATOM_MEDIA_EDITING_ENDED_REPORTED = 798;
2951  ATOM_MTE_STATE = 10181;
2952  ATOM_NFC_OBSERVE_MODE_STATE_CHANGED = 855;
2953  ATOM_NFC_FIELD_CHANGED = 856;
2954  ATOM_NFC_POLLING_LOOP_NOTIFICATION_REPORTED = 857;
2955  ATOM_NFC_PROPRIETARY_CAPABILITIES_REPORTED = 858;
2956  ATOM_ONDEVICEPERSONALIZATION_API_CALLED = 711;
2957  ATOM_COMPONENT_STATE_CHANGED_REPORTED = 863;
2958  ATOM_PDF_LOAD_REPORTED = 859;
2959  ATOM_PDF_API_USAGE_REPORTED = 860;
2960  ATOM_PDF_SEARCH_REPORTED = 861;
2961  ATOM_PERMISSION_RATIONALE_DIALOG_VIEWED = 645;
2962  ATOM_PERMISSION_RATIONALE_DIALOG_ACTION_REPORTED = 646;
2963  ATOM_APP_DATA_SHARING_UPDATES_NOTIFICATION_INTERACTION = 647;
2964  ATOM_APP_DATA_SHARING_UPDATES_FRAGMENT_VIEWED = 648;
2965  ATOM_APP_DATA_SHARING_UPDATES_FRAGMENT_ACTION_REPORTED = 649;
2966  ATOM_ENHANCED_CONFIRMATION_DIALOG_RESULT_REPORTED = 827;
2967  ATOM_ENHANCED_CONFIRMATION_RESTRICTION_CLEARED = 828;
2968  ATOM_PHOTOPICKER_SESSION_INFO_REPORTED = 886;
2969  ATOM_PHOTOPICKER_API_INFO_REPORTED = 887;
2970  ATOM_PHOTOPICKER_UI_EVENT_LOGGED = 888;
2971  ATOM_PHOTOPICKER_MEDIA_ITEM_STATUS_REPORTED = 889;
2972  ATOM_PHOTOPICKER_PREVIEW_INFO_LOGGED = 890;
2973  ATOM_PHOTOPICKER_MENU_INTERACTION_LOGGED = 891;
2974  ATOM_PHOTOPICKER_BANNER_INTERACTION_LOGGED = 892;
2975  ATOM_PHOTOPICKER_MEDIA_LIBRARY_INFO_LOGGED = 893;
2976  ATOM_PHOTOPICKER_PAGE_INFO_LOGGED = 894;
2977  ATOM_PHOTOPICKER_MEDIA_GRID_SYNC_INFO_REPORTED = 895;
2978  ATOM_PHOTOPICKER_ALBUM_SYNC_INFO_REPORTED = 896;
2979  ATOM_PHOTOPICKER_SEARCH_INFO_REPORTED = 897;
2980  ATOM_SEARCH_DATA_EXTRACTION_DETAILS_REPORTED = 898;
2981  ATOM_EMBEDDED_PHOTOPICKER_INFO_REPORTED = 899;
2982  ATOM_ATOM_9999 = 9999;
2983  ATOM_ATOM_99999 = 99999;
2984  ATOM_SCREEN_OFF_REPORTED = 776;
2985  ATOM_SCREEN_TIMEOUT_OVERRIDE_REPORTED = 836;
2986  ATOM_SCREEN_INTERACTIVE_SESSION_REPORTED = 837;
2987  ATOM_SCREEN_DIM_REPORTED = 867;
2988  ATOM_MEDIA_PROVIDER_DATABASE_ROLLBACK_REPORTED = 784;
2989  ATOM_BACKUP_SETUP_STATUS_REPORTED = 785;
2990  ATOM_RKPD_POOL_STATS = 664;
2991  ATOM_RKPD_CLIENT_OPERATION = 665;
2992  ATOM_SANDBOX_API_CALLED = 488;
2993  ATOM_SANDBOX_ACTIVITY_EVENT_OCCURRED = 735;
2994  ATOM_SDK_SANDBOX_RESTRICTED_ACCESS_IN_SESSION = 796;
2995  ATOM_SANDBOX_SDK_STORAGE = 10159;
2996  ATOM_SELINUX_AUDIT_LOG = 799;
2997  ATOM_SETTINGS_SPA_REPORTED = 622;
2998  ATOM_TEST_EXTENSION_ATOM_REPORTED = 660;
2999  ATOM_TEST_RESTRICTED_ATOM_REPORTED = 672;
3000  ATOM_STATS_SOCKET_LOSS_REPORTED = 752;
3001  ATOM_LOCKSCREEN_SHORTCUT_SELECTED = 611;
3002  ATOM_LOCKSCREEN_SHORTCUT_TRIGGERED = 612;
3003  ATOM_LAUNCHER_IMPRESSION_EVENT_V2 = 716;
3004  ATOM_DISPLAY_SWITCH_LATENCY_TRACKED = 753;
3005  ATOM_NOTIFICATION_LISTENER_SERVICE = 829;
3006  ATOM_NAV_HANDLE_TOUCH_POINTS = 869;
3007  ATOM_EMERGENCY_NUMBER_DIALED = 637;
3008  ATOM_CELLULAR_RADIO_POWER_STATE_CHANGED = 713;
3009  ATOM_EMERGENCY_NUMBERS_INFO = 10180;
3010  ATOM_DATA_NETWORK_VALIDATION = 10207;
3011  ATOM_DATA_RAT_STATE_CHANGED = 854;
3012  ATOM_CONNECTED_CHANNEL_CHANGED = 882;
3013  ATOM_QUALIFIED_RAT_LIST_CHANGED = 634;
3014  ATOM_QNS_IMS_CALL_DROP_STATS = 635;
3015  ATOM_QNS_FALLBACK_RESTRICTION_CHANGED = 636;
3016  ATOM_QNS_RAT_PREFERENCE_MISMATCH_INFO = 10177;
3017  ATOM_QNS_HANDOVER_TIME_MILLIS = 10178;
3018  ATOM_QNS_HANDOVER_PINGPONG = 10179;
3019  ATOM_SATELLITE_CONTROLLER = 10182;
3020  ATOM_SATELLITE_SESSION = 10183;
3021  ATOM_SATELLITE_INCOMING_DATAGRAM = 10184;
3022  ATOM_SATELLITE_OUTGOING_DATAGRAM = 10185;
3023  ATOM_SATELLITE_PROVISION = 10186;
3024  ATOM_SATELLITE_SOS_MESSAGE_RECOMMENDER = 10187;
3025  ATOM_CARRIER_ROAMING_SATELLITE_SESSION = 10211;
3026  ATOM_CARRIER_ROAMING_SATELLITE_CONTROLLER_STATS = 10212;
3027  ATOM_CONTROLLER_STATS_PER_PACKAGE = 10213;
3028  ATOM_SATELLITE_ENTITLEMENT = 10214;
3029  ATOM_SATELLITE_CONFIG_UPDATER = 10215;
3030  ATOM_SATELLITE_ACCESS_CONTROLLER = 10219;
3031  ATOM_CELLULAR_IDENTIFIER_DISCLOSED = 800;
3032  ATOM_THREADNETWORK_TELEMETRY_DATA_REPORTED = 738;
3033  ATOM_THREADNETWORK_TOPO_ENTRY_REPEATED = 739;
3034  ATOM_THREADNETWORK_DEVICE_INFO_REPORTED = 740;
3035  ATOM_BOOT_INTEGRITY_INFO_REPORTED = 775;
3036  ATOM_TV_LOW_POWER_STANDBY_POLICY = 679;
3037  ATOM_EXTERNAL_TV_INPUT_EVENT = 717;
3038  ATOM_UWB_ACTIVITY_INFO = 10188;
3039  ATOM_MEDIATOR_UPDATED = 721;
3040  ATOM_SYSPROXY_BLUETOOTH_BYTES_TRANSFER = 10196;
3041  ATOM_SYSPROXY_CONNECTION_UPDATED = 786;
3042  ATOM_MEDIA_ACTION_REPORTED = 608;
3043  ATOM_MEDIA_CONTROLS_LAUNCHED = 609;
3044  ATOM_MEDIA_SESSION_STATE_CHANGED = 677;
3045  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_DEVICE_SCAN_API_LATENCY = 757;
3046  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_SASS_DEVICE_UNAVAILABLE = 758;
3047  ATOM_WEAR_MEDIA_OUTPUT_SWITCHER_FASTPAIR_API_TIMEOUT = 759;
3048  ATOM_WEAR_MODE_STATE_CHANGED = 715;
3049  ATOM_RENDERER_INITIALIZED = 736;
3050  ATOM_SCHEMA_VERSION_RECEIVED = 737;
3051  ATOM_LAYOUT_INSPECTED = 741;
3052  ATOM_LAYOUT_EXPRESSION_INSPECTED = 742;
3053  ATOM_LAYOUT_ANIMATIONS_INSPECTED = 743;
3054  ATOM_MATERIAL_COMPONENTS_INSPECTED = 744;
3055  ATOM_TILE_REQUESTED = 745;
3056  ATOM_STATE_RESPONSE_RECEIVED = 746;
3057  ATOM_TILE_RESPONSE_RECEIVED = 747;
3058  ATOM_INFLATION_FINISHED = 748;
3059  ATOM_INFLATION_FAILED = 749;
3060  ATOM_IGNORED_INFLATION_FAILURES_REPORTED = 750;
3061  ATOM_DRAWABLE_RENDERED = 751;
3062  ATOM_WEAR_ADAPTIVE_SUSPEND_STATS_REPORTED = 619;
3063  ATOM_WEAR_POWER_ANOMALY_SERVICE_OPERATIONAL_STATS_REPORTED = 620;
3064  ATOM_WEAR_POWER_ANOMALY_SERVICE_EVENT_STATS_REPORTED = 621;
3065  ATOM_WS_WEAR_TIME_SESSION = 610;
3066  ATOM_WS_INCOMING_CALL_ACTION_REPORTED = 626;
3067  ATOM_WS_CALL_DISCONNECTION_REPORTED = 627;
3068  ATOM_WS_CALL_DURATION_REPORTED = 628;
3069  ATOM_WS_CALL_USER_EXPERIENCE_LATENCY_REPORTED = 629;
3070  ATOM_WS_CALL_INTERACTION_REPORTED = 630;
3071  ATOM_WS_ON_BODY_STATE_CHANGED = 787;
3072  ATOM_WS_WATCH_FACE_RESTRICTED_COMPLICATIONS_IMPACTED = 802;
3073  ATOM_WS_WATCH_FACE_DEFAULT_RESTRICTED_COMPLICATIONS_REMOVED = 803;
3074  ATOM_WS_COMPLICATIONS_IMPACTED_NOTIFICATION_EVENT_REPORTED = 804;
3075  ATOM_WS_STANDALONE_MODE_SNAPSHOT = 10197;
3076  ATOM_WS_FAVORITE_WATCH_FACE_SNAPSHOT = 10206;
3077  ATOM_WEAR_POWER_MENU_OPENED = 731;
3078  ATOM_WEAR_ASSISTANT_OPENED = 755;
3079  ATOM_WIFI_AWARE_NDP_REPORTED = 638;
3080  ATOM_WIFI_AWARE_ATTACH_REPORTED = 639;
3081  ATOM_WIFI_SELF_RECOVERY_TRIGGERED = 661;
3082  ATOM_SOFT_AP_STARTED = 680;
3083  ATOM_SOFT_AP_STOPPED = 681;
3084  ATOM_WIFI_LOCK_RELEASED = 687;
3085  ATOM_WIFI_LOCK_DEACTIVATED = 688;
3086  ATOM_WIFI_CONFIG_SAVED = 689;
3087  ATOM_WIFI_AWARE_RESOURCE_USING_CHANGED = 690;
3088  ATOM_WIFI_AWARE_HAL_API_CALLED = 691;
3089  ATOM_WIFI_LOCAL_ONLY_REQUEST_RECEIVED = 692;
3090  ATOM_WIFI_LOCAL_ONLY_REQUEST_SCAN_TRIGGERED = 693;
3091  ATOM_WIFI_THREAD_TASK_EXECUTED = 694;
3092  ATOM_WIFI_STATE_CHANGED = 700;
3093  ATOM_PNO_SCAN_STARTED = 719;
3094  ATOM_PNO_SCAN_STOPPED = 720;
3095  ATOM_WIFI_IS_UNUSABLE_REPORTED = 722;
3096  ATOM_WIFI_AP_CAPABILITIES_REPORTED = 723;
3097  ATOM_SOFT_AP_STATE_CHANGED = 805;
3098  ATOM_SCORER_PREDICTION_RESULT_REPORTED = 884;
3099  ATOM_WIFI_AWARE_CAPABILITIES = 10190;
3100  ATOM_WIFI_MODULE_INFO = 10193;
3101  ATOM_WIFI_SETTING_INFO = 10194;
3102  ATOM_WIFI_COMPLEX_SETTING_INFO = 10195;
3103  ATOM_WIFI_CONFIGURED_NETWORK_INFO = 10198;
3104}
3105// End of protos/perfetto/config/statsd/atom_ids.proto
3106
3107// Begin of protos/perfetto/config/statsd/statsd_tracing_config.proto
3108
3109// This file is named 'statsd_tracing_config.proto' rather than
3110// 'statsd_config.proto' (which would be more consistent with the other
3111// config protos) so it doesn't show up and confuse folks looking for
3112// the existing statsd_config.proto for configuring statsd itself.
3113// Same for the config proto itself.
3114message StatsdTracingConfig {
3115  // This is for the common case of the atom id being known in the enum AtomId.
3116  repeated AtomId push_atom_id = 1;
3117
3118  // Escape hatch for Atom IDs that are not yet in the AtomId enum
3119  // (e.g. non-upstream atoms that don't exist in AOSP).
3120  repeated int32 raw_push_atom_id = 2;
3121  repeated StatsdPullAtomConfig pull_config = 3;
3122}
3123
3124message StatsdPullAtomConfig {
3125  repeated AtomId pull_atom_id = 1;
3126  repeated int32 raw_pull_atom_id = 2;
3127
3128  optional int32 pull_frequency_ms = 3;
3129  repeated string packages = 4;
3130}
3131
3132// End of protos/perfetto/config/statsd/statsd_tracing_config.proto
3133
3134// Begin of protos/perfetto/common/sys_stats_counters.proto
3135
3136// When editing entries here remember also to update "sys_stats_counters.h" with
3137// the corresponding string definitions for the actual /proc files parser.
3138
3139// Counter definitions for Linux's /proc/meminfo.
3140enum MeminfoCounters {
3141  MEMINFO_UNSPECIFIED = 0;
3142  MEMINFO_MEM_TOTAL = 1;
3143  MEMINFO_MEM_FREE = 2;
3144  MEMINFO_MEM_AVAILABLE = 3;
3145  MEMINFO_BUFFERS = 4;
3146  MEMINFO_CACHED = 5;
3147  MEMINFO_SWAP_CACHED = 6;
3148  MEMINFO_ACTIVE = 7;
3149  MEMINFO_INACTIVE = 8;
3150  MEMINFO_ACTIVE_ANON = 9;
3151  MEMINFO_INACTIVE_ANON = 10;
3152  MEMINFO_ACTIVE_FILE = 11;
3153  MEMINFO_INACTIVE_FILE = 12;
3154  MEMINFO_UNEVICTABLE = 13;
3155  MEMINFO_MLOCKED = 14;
3156  MEMINFO_SWAP_TOTAL = 15;
3157  MEMINFO_SWAP_FREE = 16;
3158  MEMINFO_DIRTY = 17;
3159  MEMINFO_WRITEBACK = 18;
3160  MEMINFO_ANON_PAGES = 19;
3161  MEMINFO_MAPPED = 20;
3162  MEMINFO_SHMEM = 21;
3163  MEMINFO_SLAB = 22;
3164  MEMINFO_SLAB_RECLAIMABLE = 23;
3165  MEMINFO_SLAB_UNRECLAIMABLE = 24;
3166  MEMINFO_KERNEL_STACK = 25;
3167  MEMINFO_PAGE_TABLES = 26;
3168  MEMINFO_COMMIT_LIMIT = 27;
3169  MEMINFO_COMMITED_AS = 28;
3170  MEMINFO_VMALLOC_TOTAL = 29;
3171  MEMINFO_VMALLOC_USED = 30;
3172  MEMINFO_VMALLOC_CHUNK = 31;
3173  MEMINFO_CMA_TOTAL = 32;
3174  MEMINFO_CMA_FREE = 33;
3175  MEMINFO_GPU = 34;
3176  MEMINFO_ZRAM = 35;
3177  MEMINFO_MISC = 36;
3178  MEMINFO_ION_HEAP = 37;
3179  MEMINFO_ION_HEAP_POOL = 38;
3180}
3181
3182// Counter definitions for Linux's /proc/vmstat.
3183enum VmstatCounters {
3184  VMSTAT_UNSPECIFIED = 0;
3185  VMSTAT_NR_FREE_PAGES = 1;
3186  VMSTAT_NR_ALLOC_BATCH = 2;
3187  VMSTAT_NR_INACTIVE_ANON = 3;
3188  VMSTAT_NR_ACTIVE_ANON = 4;
3189  VMSTAT_NR_INACTIVE_FILE = 5;
3190  VMSTAT_NR_ACTIVE_FILE = 6;
3191  VMSTAT_NR_UNEVICTABLE = 7;
3192  VMSTAT_NR_MLOCK = 8;
3193  VMSTAT_NR_ANON_PAGES = 9;
3194  VMSTAT_NR_MAPPED = 10;
3195  VMSTAT_NR_FILE_PAGES = 11;
3196  VMSTAT_NR_DIRTY = 12;
3197  VMSTAT_NR_WRITEBACK = 13;
3198  VMSTAT_NR_SLAB_RECLAIMABLE = 14;
3199  VMSTAT_NR_SLAB_UNRECLAIMABLE = 15;
3200  VMSTAT_NR_PAGE_TABLE_PAGES = 16;
3201  VMSTAT_NR_KERNEL_STACK = 17;
3202  VMSTAT_NR_OVERHEAD = 18;
3203  VMSTAT_NR_UNSTABLE = 19;
3204  VMSTAT_NR_BOUNCE = 20;
3205  VMSTAT_NR_VMSCAN_WRITE = 21;
3206  VMSTAT_NR_VMSCAN_IMMEDIATE_RECLAIM = 22;
3207  VMSTAT_NR_WRITEBACK_TEMP = 23;
3208  VMSTAT_NR_ISOLATED_ANON = 24;
3209  VMSTAT_NR_ISOLATED_FILE = 25;
3210  VMSTAT_NR_SHMEM = 26;
3211  VMSTAT_NR_DIRTIED = 27;
3212  VMSTAT_NR_WRITTEN = 28;
3213  VMSTAT_NR_PAGES_SCANNED = 29;
3214  VMSTAT_WORKINGSET_REFAULT = 30;
3215  VMSTAT_WORKINGSET_ACTIVATE = 31;
3216  VMSTAT_WORKINGSET_NODERECLAIM = 32;
3217  VMSTAT_NR_ANON_TRANSPARENT_HUGEPAGES = 33;
3218  VMSTAT_NR_FREE_CMA = 34;
3219  VMSTAT_NR_SWAPCACHE = 35;
3220  VMSTAT_NR_DIRTY_THRESHOLD = 36;
3221  VMSTAT_NR_DIRTY_BACKGROUND_THRESHOLD = 37;
3222  VMSTAT_PGPGIN = 38;
3223  VMSTAT_PGPGOUT = 39;
3224  VMSTAT_PGPGOUTCLEAN = 40;
3225  VMSTAT_PSWPIN = 41;
3226  VMSTAT_PSWPOUT = 42;
3227  VMSTAT_PGALLOC_DMA = 43;
3228  VMSTAT_PGALLOC_NORMAL = 44;
3229  VMSTAT_PGALLOC_MOVABLE = 45;
3230  VMSTAT_PGFREE = 46;
3231  VMSTAT_PGACTIVATE = 47;
3232  VMSTAT_PGDEACTIVATE = 48;
3233  VMSTAT_PGFAULT = 49;
3234  VMSTAT_PGMAJFAULT = 50;
3235  VMSTAT_PGREFILL_DMA = 51;
3236  VMSTAT_PGREFILL_NORMAL = 52;
3237  VMSTAT_PGREFILL_MOVABLE = 53;
3238  VMSTAT_PGSTEAL_KSWAPD_DMA = 54;
3239  VMSTAT_PGSTEAL_KSWAPD_NORMAL = 55;
3240  VMSTAT_PGSTEAL_KSWAPD_MOVABLE = 56;
3241  VMSTAT_PGSTEAL_DIRECT_DMA = 57;
3242  VMSTAT_PGSTEAL_DIRECT_NORMAL = 58;
3243  VMSTAT_PGSTEAL_DIRECT_MOVABLE = 59;
3244  VMSTAT_PGSCAN_KSWAPD_DMA = 60;
3245  VMSTAT_PGSCAN_KSWAPD_NORMAL = 61;
3246  VMSTAT_PGSCAN_KSWAPD_MOVABLE = 62;
3247  VMSTAT_PGSCAN_DIRECT_DMA = 63;
3248  VMSTAT_PGSCAN_DIRECT_NORMAL = 64;
3249  VMSTAT_PGSCAN_DIRECT_MOVABLE = 65;
3250  VMSTAT_PGSCAN_DIRECT_THROTTLE = 66;
3251  VMSTAT_PGINODESTEAL = 67;
3252  VMSTAT_SLABS_SCANNED = 68;
3253  VMSTAT_KSWAPD_INODESTEAL = 69;
3254  VMSTAT_KSWAPD_LOW_WMARK_HIT_QUICKLY = 70;
3255  VMSTAT_KSWAPD_HIGH_WMARK_HIT_QUICKLY = 71;
3256  VMSTAT_PAGEOUTRUN = 72;
3257  VMSTAT_ALLOCSTALL = 73;
3258  VMSTAT_PGROTATED = 74;
3259  VMSTAT_DROP_PAGECACHE = 75;
3260  VMSTAT_DROP_SLAB = 76;
3261  VMSTAT_PGMIGRATE_SUCCESS = 77;
3262  VMSTAT_PGMIGRATE_FAIL = 78;
3263  VMSTAT_COMPACT_MIGRATE_SCANNED = 79;
3264  VMSTAT_COMPACT_FREE_SCANNED = 80;
3265  VMSTAT_COMPACT_ISOLATED = 81;
3266  VMSTAT_COMPACT_STALL = 82;
3267  VMSTAT_COMPACT_FAIL = 83;
3268  VMSTAT_COMPACT_SUCCESS = 84;
3269  VMSTAT_COMPACT_DAEMON_WAKE = 85;
3270  VMSTAT_UNEVICTABLE_PGS_CULLED = 86;
3271  VMSTAT_UNEVICTABLE_PGS_SCANNED = 87;
3272  VMSTAT_UNEVICTABLE_PGS_RESCUED = 88;
3273  VMSTAT_UNEVICTABLE_PGS_MLOCKED = 89;
3274  VMSTAT_UNEVICTABLE_PGS_MUNLOCKED = 90;
3275  VMSTAT_UNEVICTABLE_PGS_CLEARED = 91;
3276  VMSTAT_UNEVICTABLE_PGS_STRANDED = 92;
3277  VMSTAT_NR_ZSPAGES = 93;
3278  VMSTAT_NR_ION_HEAP = 94;
3279  VMSTAT_NR_GPU_HEAP = 95;
3280  VMSTAT_ALLOCSTALL_DMA = 96;
3281  VMSTAT_ALLOCSTALL_MOVABLE = 97;
3282  VMSTAT_ALLOCSTALL_NORMAL = 98;
3283  VMSTAT_COMPACT_DAEMON_FREE_SCANNED = 99;
3284  VMSTAT_COMPACT_DAEMON_MIGRATE_SCANNED = 100;
3285  VMSTAT_NR_FASTRPC = 101;
3286  VMSTAT_NR_INDIRECTLY_RECLAIMABLE = 102;
3287  VMSTAT_NR_ION_HEAP_POOL = 103;
3288  VMSTAT_NR_KERNEL_MISC_RECLAIMABLE = 104;
3289  VMSTAT_NR_SHADOW_CALL_STACK_BYTES = 105;
3290  VMSTAT_NR_SHMEM_HUGEPAGES = 106;
3291  VMSTAT_NR_SHMEM_PMDMAPPED = 107;
3292  VMSTAT_NR_UNRECLAIMABLE_PAGES = 108;
3293  VMSTAT_NR_ZONE_ACTIVE_ANON = 109;
3294  VMSTAT_NR_ZONE_ACTIVE_FILE = 110;
3295  VMSTAT_NR_ZONE_INACTIVE_ANON = 111;
3296  VMSTAT_NR_ZONE_INACTIVE_FILE = 112;
3297  VMSTAT_NR_ZONE_UNEVICTABLE = 113;
3298  VMSTAT_NR_ZONE_WRITE_PENDING = 114;
3299  VMSTAT_OOM_KILL = 115;
3300  VMSTAT_PGLAZYFREE = 116;
3301  VMSTAT_PGLAZYFREED = 117;
3302  VMSTAT_PGREFILL = 118;
3303  VMSTAT_PGSCAN_DIRECT = 119;
3304  VMSTAT_PGSCAN_KSWAPD = 120;
3305  VMSTAT_PGSKIP_DMA = 121;
3306  VMSTAT_PGSKIP_MOVABLE = 122;
3307  VMSTAT_PGSKIP_NORMAL = 123;
3308  VMSTAT_PGSTEAL_DIRECT = 124;
3309  VMSTAT_PGSTEAL_KSWAPD = 125;
3310  VMSTAT_SWAP_RA = 126;
3311  VMSTAT_SWAP_RA_HIT = 127;
3312  VMSTAT_WORKINGSET_RESTORE = 128;
3313  VMSTAT_ALLOCSTALL_DEVICE = 129;
3314  VMSTAT_ALLOCSTALL_DMA32 = 130;
3315  VMSTAT_BALLOON_DEFLATE = 131;
3316  VMSTAT_BALLOON_INFLATE = 132;
3317  VMSTAT_BALLOON_MIGRATE = 133;
3318  VMSTAT_CMA_ALLOC_FAIL = 134;
3319  VMSTAT_CMA_ALLOC_SUCCESS = 135;
3320  VMSTAT_NR_FILE_HUGEPAGES = 136;
3321  VMSTAT_NR_FILE_PMDMAPPED = 137;
3322  VMSTAT_NR_FOLL_PIN_ACQUIRED = 138;
3323  VMSTAT_NR_FOLL_PIN_RELEASED = 139;
3324  VMSTAT_NR_SEC_PAGE_TABLE_PAGES = 140;
3325  VMSTAT_NR_SHADOW_CALL_STACK = 141;
3326  VMSTAT_NR_SWAPCACHED = 142;
3327  VMSTAT_NR_THROTTLED_WRITTEN = 143;
3328  VMSTAT_PGALLOC_DEVICE = 144;
3329  VMSTAT_PGALLOC_DMA32 = 145;
3330  VMSTAT_PGDEMOTE_DIRECT = 146;
3331  VMSTAT_PGDEMOTE_KSWAPD = 147;
3332  VMSTAT_PGREUSE = 148;
3333  VMSTAT_PGSCAN_ANON = 149;
3334  VMSTAT_PGSCAN_FILE = 150;
3335  VMSTAT_PGSKIP_DEVICE = 151;
3336  VMSTAT_PGSKIP_DMA32 = 152;
3337  VMSTAT_PGSTEAL_ANON = 153;
3338  VMSTAT_PGSTEAL_FILE = 154;
3339  VMSTAT_THP_COLLAPSE_ALLOC = 155;
3340  VMSTAT_THP_COLLAPSE_ALLOC_FAILED = 156;
3341  VMSTAT_THP_DEFERRED_SPLIT_PAGE = 157;
3342  VMSTAT_THP_FAULT_ALLOC = 158;
3343  VMSTAT_THP_FAULT_FALLBACK = 159;
3344  VMSTAT_THP_FAULT_FALLBACK_CHARGE = 160;
3345  VMSTAT_THP_FILE_ALLOC = 161;
3346  VMSTAT_THP_FILE_FALLBACK = 162;
3347  VMSTAT_THP_FILE_FALLBACK_CHARGE = 163;
3348  VMSTAT_THP_FILE_MAPPED = 164;
3349  VMSTAT_THP_MIGRATION_FAIL = 165;
3350  VMSTAT_THP_MIGRATION_SPLIT = 166;
3351  VMSTAT_THP_MIGRATION_SUCCESS = 167;
3352  VMSTAT_THP_SCAN_EXCEED_NONE_PTE = 168;
3353  VMSTAT_THP_SCAN_EXCEED_SHARE_PTE = 169;
3354  VMSTAT_THP_SCAN_EXCEED_SWAP_PTE = 170;
3355  VMSTAT_THP_SPLIT_PAGE = 171;
3356  VMSTAT_THP_SPLIT_PAGE_FAILED = 172;
3357  VMSTAT_THP_SPLIT_PMD = 173;
3358  VMSTAT_THP_SWPOUT = 174;
3359  VMSTAT_THP_SWPOUT_FALLBACK = 175;
3360  VMSTAT_THP_ZERO_PAGE_ALLOC = 176;
3361  VMSTAT_THP_ZERO_PAGE_ALLOC_FAILED = 177;
3362  VMSTAT_VMA_LOCK_ABORT = 178;
3363  VMSTAT_VMA_LOCK_MISS = 179;
3364  VMSTAT_VMA_LOCK_RETRY = 180;
3365  VMSTAT_VMA_LOCK_SUCCESS = 181;
3366  VMSTAT_WORKINGSET_ACTIVATE_ANON = 182;
3367  VMSTAT_WORKINGSET_ACTIVATE_FILE = 183;
3368  VMSTAT_WORKINGSET_NODES = 184;
3369  VMSTAT_WORKINGSET_REFAULT_ANON = 185;
3370  VMSTAT_WORKINGSET_REFAULT_FILE = 186;
3371  VMSTAT_WORKINGSET_RESTORE_ANON = 187;
3372  VMSTAT_WORKINGSET_RESTORE_FILE = 188;
3373}
3374
3375// End of protos/perfetto/common/sys_stats_counters.proto
3376
3377// Begin of protos/perfetto/config/sys_stats/sys_stats_config.proto
3378
3379// This file defines the configuration for the Linux /proc poller data source,
3380// which injects counters in the trace.
3381// Counters that are needed in the trace must be explicitly listed in the
3382// *_counters fields. This is to avoid spamming the trace with all counters
3383// at all times.
3384// The sampling rate is configurable. All polling rates (*_period_ms) need
3385// to be integer multiples of each other.
3386// OK:     [10ms, 10ms, 10ms],  [10ms, 20ms, 10ms],  [10ms, 20ms, 60ms]
3387// Not OK: [10ms, 10ms, 11ms],  [10ms, 15ms, 20ms]
3388message SysStatsConfig {
3389  // Polls /proc/meminfo every X ms, if non-zero.
3390  // This is required to be > 10ms to avoid excessive CPU usage.
3391  // Cost: 0.3 ms [read] + 0.07 ms [parse + trace injection]
3392  optional uint32 meminfo_period_ms = 1;
3393
3394  // If empty all known counters are reported. Otherwise, only the counters
3395  // specified below are reported.
3396  repeated MeminfoCounters meminfo_counters = 2;
3397
3398  // Polls /proc/vmstat every X ms, if non-zero.
3399  // This is required to be > 10ms to avoid excessive CPU usage.
3400  // Cost: 0.2 ms [read] + 0.3 ms [parse + trace injection]
3401  optional uint32 vmstat_period_ms = 3;
3402  repeated VmstatCounters vmstat_counters = 4;
3403
3404  // Pols /proc/stat every X ms, if non-zero.
3405  // This is required to be > 10ms to avoid excessive CPU usage.
3406  // Cost: 4.1 ms [read] + 1.9 ms [parse + trace injection]
3407  optional uint32 stat_period_ms = 5;
3408  enum StatCounters {
3409    STAT_UNSPECIFIED = 0;
3410    STAT_CPU_TIMES = 1;
3411    STAT_IRQ_COUNTS = 2;
3412    STAT_SOFTIRQ_COUNTS = 3;
3413    STAT_FORK_COUNT = 4;
3414  }
3415  repeated StatCounters stat_counters = 6;
3416
3417  // Polls /sys/devfreq/*/curfreq every X ms, if non-zero.
3418  // This is required to be > 10ms to avoid excessive CPU usage.
3419  // This option can be used to record unchanging values.
3420  // Updates from frequency changes can come from ftrace/set_clock_rate.
3421  optional uint32 devfreq_period_ms = 7;
3422
3423  // Polls /sys/devices/system/cpu/cpu*/cpufreq/cpuinfo_cur_freq every X ms.
3424  // This is required to be > 10ms to avoid excessive CPU usage.
3425  optional uint32 cpufreq_period_ms = 8;
3426
3427  // Polls /proc/buddyinfo every X ms, if non-zero.
3428  // This is required to be > 10ms to avoid excessive CPU usage.
3429  optional uint32 buddyinfo_period_ms = 9;
3430
3431  // Polls /proc/diskstats every X ms, if non-zero.
3432  // This is required to be > 10ms to avoid excessive CPU usage.
3433  optional uint32 diskstat_period_ms = 10;
3434
3435  // Polls /proc/pressure/* every X ms, if non-zero.
3436  // This is required to be > 10ms to avoid excessive CPU usage.
3437  optional uint32 psi_period_ms = 11;
3438
3439  // Polls /sys/class/thermal/* every X ms, if non-zero.
3440  // This is required to be > 10ms to avoid excessive CPU usage.
3441  optional uint32 thermal_period_ms = 12;
3442
3443  // Polls /sys/devices/system/cpu/cpu*/cpuidle/state* every X ms, if non-zero.
3444  // This is required to be > 10ms to avoid excessive CPU usage.
3445  optional uint32 cpuidle_period_ms = 13;
3446
3447  // Polls device-specific GPU frequency info every X ms, if non-zero.
3448  // This is required to be > 10ms to avoid excessive CPU usage.
3449  optional uint32 gpufreq_period_ms = 14;
3450}
3451
3452// End of protos/perfetto/config/sys_stats/sys_stats_config.proto
3453
3454// Begin of protos/perfetto/config/system_info/system_info.proto
3455
3456// This data-source does a one-off recording of system information when
3457// the trace starts.
3458// Currently this includes:
3459// - Values of
3460// /sys/devices/system/cpu/cpu*/cpufreq/scaling_available_frequencies This
3461// datasource has no configuration options at present.
3462message SystemInfoConfig {}
3463
3464// End of protos/perfetto/config/system_info/system_info.proto
3465
3466// Begin of protos/perfetto/config/test_config.proto
3467
3468// The configuration for a fake producer used in tests.
3469message TestConfig {
3470  message DummyFields {
3471    optional uint32 field_uint32 = 1;
3472    optional int32 field_int32 = 2;
3473    optional uint64 field_uint64 = 3;
3474    optional int64 field_int64 = 4;
3475    optional fixed64 field_fixed64 = 5;
3476    optional sfixed64 field_sfixed64 = 6;
3477    optional fixed32 field_fixed32 = 7;
3478    optional sfixed32 field_sfixed32 = 8;
3479    optional double field_double = 9;
3480    optional float field_float = 10;
3481    optional sint64 field_sint64 = 11;
3482    optional sint32 field_sint32 = 12;
3483    optional string field_string = 13;
3484    optional bytes field_bytes = 14;
3485  }
3486
3487  // The number of messages the fake producer should send.
3488  optional uint32 message_count = 1;
3489
3490  // The maximum number of messages which should be sent each second.
3491  // The actual obserced speed may be lower if the producer is unable to
3492  // work fast enough.
3493  // If this is zero or unset, the producer will send as fast as possible.
3494  optional uint32 max_messages_per_second = 2;
3495
3496  // The seed value for a simple multiplicative congruential pseudo-random
3497  // number sequence.
3498  optional uint32 seed = 3;
3499
3500  // The size of each message in bytes. Should be greater than or equal 5 to
3501  // account for the number of bytes needed to encode the random number and a
3502  // null byte for the string.
3503  optional uint32 message_size = 4;
3504
3505  // Whether the producer should send a event batch when the data source is
3506  // is initially registered.
3507  optional bool send_batch_on_register = 5;
3508
3509  optional DummyFields dummy_fields = 6;
3510}
3511
3512// End of protos/perfetto/config/test_config.proto
3513
3514// Begin of protos/perfetto/config/track_event/track_event_config.proto
3515
3516message TrackEventConfig {
3517  // The following fields define the set of enabled trace categories. Each list
3518  // item is a glob.
3519  //
3520  // To determine if category is enabled, it is checked against the filters in
3521  // the following order:
3522  //
3523  //   1. Exact matches in enabled categories.
3524  //   2. Exact matches in enabled tags.
3525  //   3. Exact matches in disabled categories.
3526  //   4. Exact matches in disabled tags.
3527  //   5. Pattern matches in enabled categories.
3528  //   6. Pattern matches in enabled tags.
3529  //   7. Pattern matches in disabled categories.
3530  //   8. Pattern matches in disabled tags.
3531  //
3532  // If none of the steps produced a match:
3533  //  - In the C++ SDK (`perfetto::Category`), categories are enabled by
3534  //  default.
3535  //  - In the C SDK (`PerfettoTeCategory`), categories are disabled by default.
3536  //
3537  // Examples:
3538  //
3539  //  - To enable all non-slow/debug categories:
3540  //
3541  //       enabled_categories: "*"
3542  //
3543  //  - To enable specific categories:
3544  //
3545  //       disabled_categories: "*"
3546  //       enabled_categories: "my_category"
3547  //       enabled_categories: "my_category2"
3548  //
3549  //  - To enable only categories with a specific tag:
3550  //
3551  //       disabled_tags: "*"
3552  //       enabled_tags: "my_tag"
3553  //
3554
3555  // Default: []
3556  repeated string disabled_categories = 1;
3557
3558  // Default: []
3559  repeated string enabled_categories = 2;
3560
3561  // Default: ["slow", "debug"]
3562  repeated string disabled_tags = 3;
3563
3564  // Default: []
3565  repeated string enabled_tags = 4;
3566
3567  // Default: false (i.e. enabled by default)
3568  optional bool disable_incremental_timestamps = 5;
3569
3570  // Allows to specify a custom unit different than the default (ns).
3571  // Also affects thread timestamps if enable_thread_time_sampling = true.
3572  // A multiplier of 1000 means that a timestamp = 3 should be interpreted as
3573  // 3000 ns = 3 us.
3574  // Default: 1 (if unset, it should be read as 1).
3575  optional uint64 timestamp_unit_multiplier = 6;
3576
3577  // Default: false (i.e. debug_annotations is NOT filtered out by default)
3578  // When true, any debug annotations provided as arguments to the
3579  // TRACE_EVENT macros are not written into the trace. Typed arguments will
3580  // still be emitted even if set to true.
3581  optional bool filter_debug_annotations = 7;
3582
3583  // Default : false (i.e. disabled)
3584  // When true, the SDK samples and emits the current thread time counter value
3585  // for each event on the current thread's track. This value represents the
3586  // total CPU time consumed by that thread since its creation. Note that if a
3587  // thread is not scheduled by OS for some duration, that time won't be
3588  // included in thread_time.
3589  // Learn more : "CLOCK_THREAD_CPUTIME_ID" flag at
3590  // https://linux.die.net/man/3/clock_gettime
3591  optional bool enable_thread_time_sampling = 8;
3592
3593  // Default: false (i.e. dynamic event names are NOT filtered out by default)
3594  // When true, event_names wrapped in perfetto::DynamicString will be filtered
3595  // out.
3596  optional bool filter_dynamic_event_names = 9;
3597}
3598
3599// End of protos/perfetto/config/track_event/track_event_config.proto
3600
3601// Begin of protos/perfetto/config/data_source_config.proto
3602
3603// The configuration that is passed to each data source when starting tracing.
3604// Next id: 132
3605message DataSourceConfig {
3606  enum SessionInitiator {
3607    SESSION_INITIATOR_UNSPECIFIED = 0;
3608    // This trace was initiated from a trusted system app has DUMP and
3609    // USAGE_STATS permission. This system app is expected to not expose the
3610    // trace to the user of the device.
3611    // This is determined by checking the UID initiating the trace.
3612    SESSION_INITIATOR_TRUSTED_SYSTEM = 1;
3613  };
3614  // Data source unique name, e.g., "linux.ftrace". This must match
3615  // the name passed by the data source when it registers (see
3616  // RegisterDataSource()).
3617  optional string name = 1;
3618
3619  // The index of the logging buffer where TracePacket(s) will be stored.
3620  // This field doesn't make a major difference for the Producer(s). The final
3621  // logging buffers, in fact, are completely owned by the Service. We just ask
3622  // the Producer to copy this number into the chunk headers it emits, so that
3623  // the Service can quickly identify the buffer where to move the chunks into
3624  // without expensive lookups on its fastpath.
3625  optional uint32 target_buffer = 2;
3626
3627  // Set by the service to indicate the duration of the trace.
3628  // DO NOT SET in consumer as this will be overridden by the service.
3629  optional uint32 trace_duration_ms = 3;
3630
3631  // If true, |trace_duration_ms| should count also time in suspend. This
3632  // is propagated from TraceConfig.prefer_suspend_clock_for_duration.
3633  optional bool prefer_suspend_clock_for_duration = 122;
3634
3635  // Set by the service to indicate how long it waits after StopDataSource.
3636  // DO NOT SET in consumer as this will be overridden by the service.
3637  optional uint32 stop_timeout_ms = 7;
3638
3639  // Set by the service to indicate whether this tracing session has extra
3640  // guardrails.
3641  // DO NOT SET in consumer as this will be overridden by the service.
3642  optional bool enable_extra_guardrails = 6;
3643
3644  // Set by the service to indicate which user initiated this trace.
3645  // DO NOT SET in consumer as this will be overridden by the service.
3646  optional SessionInitiator session_initiator = 8;
3647
3648  // Set by the service to indicate which tracing session the data source
3649  // belongs to. The intended use case for this is checking if two data sources,
3650  // one of which produces metadata for the other one, belong to the same trace
3651  // session and hence should be linked together.
3652  // This field was introduced in Aug 2018 after Android P.
3653  // DO NOT SET in consumer as this will be overridden by the service.
3654  optional uint64 tracing_session_id = 4;
3655
3656  // Keeep the lower IDs (up to 99) for fields that are *not* specific to
3657  // data-sources and needs to be processed by the traced daemon.
3658
3659  // All data source config fields must be marked as [lazy=true]. This prevents
3660  // the proto-to-cpp generator from recursing into those when generating the
3661  // cpp classes and polluting tracing/core with data-source-specific classes.
3662  // Instead they are treated as opaque strings containing raw proto bytes.
3663
3664  // Data source name: linux.ftrace
3665  optional FtraceConfig ftrace_config = 100 [lazy = true];
3666  // Data source name: linux.inode_file_map
3667  optional InodeFileConfig inode_file_config = 102 [lazy = true];
3668  // Data source name: linux.process_stats
3669  optional ProcessStatsConfig process_stats_config = 103 [lazy = true];
3670  // Data source name: linux.sys_stats
3671  optional SysStatsConfig sys_stats_config = 104 [lazy = true];
3672  // Data source name: android.heapprofd
3673  // Introduced in Android 10.
3674  optional HeapprofdConfig heapprofd_config = 105 [lazy = true];
3675  // Data source name: android.java_hprof
3676  // Introduced in Android 11.
3677  optional JavaHprofConfig java_hprof_config = 110 [lazy = true];
3678  // Data source name: android.power
3679  optional AndroidPowerConfig android_power_config = 106 [lazy = true];
3680  // Data source name: android.log
3681  optional AndroidLogConfig android_log_config = 107 [lazy = true];
3682  // TODO(fmayer): Add data source name for this.
3683  optional GpuCounterConfig gpu_counter_config = 108 [lazy = true];
3684  // Data source name: android.game_interventions
3685  optional AndroidGameInterventionListConfig
3686      android_game_intervention_list_config = 116 [lazy = true];
3687  // Data source name: android.packages_list
3688  optional PackagesListConfig packages_list_config = 109 [lazy = true];
3689  // Data source name: linux.perf
3690  optional PerfEventConfig perf_event_config = 111 [lazy = true];
3691  // Data source name: vulkan.memory_tracker
3692  optional VulkanMemoryConfig vulkan_memory_config = 112 [lazy = true];
3693  // Data source name: track_event
3694  optional TrackEventConfig track_event_config = 113 [lazy = true];
3695  // Data source name: android.polled_state
3696  optional AndroidPolledStateConfig android_polled_state_config = 114
3697      [lazy = true];
3698  // Data source name: android.system_property
3699  optional AndroidSystemPropertyConfig android_system_property_config = 118
3700      [lazy = true];
3701  // Data source name: android.statsd
3702  optional StatsdTracingConfig statsd_tracing_config = 117 [lazy = true];
3703  // Data source name: linux.system_info
3704  optional SystemInfoConfig system_info_config = 119;
3705
3706  // Chrome is special as it doesn't use the perfetto IPC layer. We want to
3707  // avoid proto serialization and de-serialization there because that would
3708  // just add extra hops on top of the Mojo ser/des. Instead we auto-generate a
3709  // C++ class for it so it can pass around plain C++ objets.
3710  optional ChromeConfig chrome_config = 101;
3711
3712  // Data source name: code.v8.dev
3713  optional V8Config v8_config = 127 [lazy = true];
3714
3715  // If an interceptor is specified here, packets for this data source will be
3716  // rerouted to the interceptor instead of the main trace buffer. This can be
3717  // used, for example, to write trace data into ETW or for logging trace points
3718  // to the console.
3719  //
3720  // Note that interceptors are only supported by data sources registered
3721  // through the Perfetto SDK API. Data sources that don't use that API (e.g.,
3722  // traced_probes) may not support interception.
3723  optional InterceptorConfig interceptor_config = 115;
3724
3725  // Data source name: android.network_packets.
3726  // Introduced in Android 14 (U).
3727  optional NetworkPacketTraceConfig network_packet_trace_config = 120
3728      [lazy = true];
3729
3730  // Data source name: android.surfaceflinger.layers
3731  optional SurfaceFlingerLayersConfig surfaceflinger_layers_config = 121
3732      [lazy = true];
3733
3734  // Data source name: android.surfaceflinger.transactions
3735  optional SurfaceFlingerTransactionsConfig surfaceflinger_transactions_config =
3736      123 [lazy = true];
3737
3738  // Data source name: android.sdk_sysprop_guard
3739  // Introduced in Android 14 (U) QPR1.
3740  optional AndroidSdkSyspropGuardConfig android_sdk_sysprop_guard_config = 124
3741      [lazy = true];
3742
3743  // Data source name: windows.etw
3744  optional EtwConfig etw_config = 125 [lazy = true];
3745
3746  // Data source name: android.protolog
3747  optional ProtoLogConfig protolog_config = 126 [lazy = true];
3748
3749  // Data source name: android.input.inputevent
3750  optional AndroidInputEventConfig android_input_event_config = 128
3751      [lazy = true];
3752
3753  // Data source name: android.pixel.modem
3754  optional PixelModemConfig pixel_modem_config = 129 [lazy = true];
3755
3756  // Data source name: android.windowmanager
3757  optional WindowManagerConfig windowmanager_config = 130 [lazy = true];
3758
3759  // Data source name: org.chromium.system_metrics
3760  optional ChromiumSystemMetricsConfig chromium_system_metrics = 131 [lazy = true];
3761
3762  // This is a fallback mechanism to send a free-form text config to the
3763  // producer. In theory this should never be needed. All the code that
3764  // is part of the platform (i.e. traced service) is supposed to *not* truncate
3765  // the trace config proto and propagate unknown fields. However, if anything
3766  // in the pipeline (client or backend) ends up breaking this forward compat
3767  // plan, this field will become the escape hatch to allow future data sources
3768  // to get some meaningful configuration.
3769  optional string legacy_config = 1000;
3770
3771  // This field is only used for testing.
3772  optional TestConfig for_testing = 1001;
3773
3774  // Was |for_testing|. Caused more problems then found.
3775  reserved 268435455;
3776}
3777
3778// End of protos/perfetto/config/data_source_config.proto
3779
3780// Begin of protos/perfetto/config/trace_config.proto
3781
3782// The overall config that is used when starting a new tracing session through
3783// ProducerPort::StartTracing().
3784// It contains the general config for the logging buffer(s) and the configs for
3785// all the data source being enabled.
3786//
3787// Next id: 40.
3788message TraceConfig {
3789  message BufferConfig {
3790    optional uint32 size_kb = 1;
3791
3792    // |page_size|, now deprecated.
3793    reserved 2;
3794
3795    // |optimize_for|, now deprecated.
3796    reserved 3;
3797
3798    enum FillPolicy {
3799      UNSPECIFIED = 0;
3800
3801      // Default behavior. The buffer operates as a conventional ring buffer.
3802      // If the writer is faster than the reader (or if the reader reads only
3803      // after tracing is stopped) newly written packets will overwrite old
3804      // packets.
3805      RING_BUFFER = 1;
3806
3807      // Behaves like RING_BUFFER as long as there is space in the buffer or
3808      // the reader catches up with the writer. As soon as the writer hits
3809      // an unread chunk, it stops accepting new data in the buffer.
3810      DISCARD = 2;
3811    }
3812    optional FillPolicy fill_policy = 4;
3813
3814    // When true the buffer is moved (rather than copied) onto the cloned
3815    // session, and an empty buffer of the same size is allocated in the source
3816    // tracing session. This feature will likely get deprecated in the future.
3817    // It been introduced mainly to support the surfaceflinger snapshot dump
3818    // for bugreports, where SF can dumps O(400MB) into the bugreport trace. In
3819    // that case we don't want to retain another in-memory copy of the buffer.
3820    optional bool transfer_on_clone = 5;
3821
3822    // Used in conjunction with transfer_on_clone. When true the buffer is
3823    // cleared before issuing the Flush(reason=kTraceClone). This is to ensure
3824    // that if the data source took too long to write the data in a previous
3825    // clone-related flush, we don't end up with a mixture of leftovers from
3826    // the previous write and new data.
3827    optional bool clear_before_clone = 6;
3828  }
3829  repeated BufferConfig buffers = 1;
3830
3831  message DataSource {
3832    // Filters and data-source specific config. It contains also the unique name
3833    // of the data source, the one passed in the  DataSourceDescriptor when they
3834    // register on the service.
3835    optional protos.DataSourceConfig config = 1;
3836
3837    // Optional. If multiple producers (~processes) expose the same data source
3838    // and either |producer_name_filter| or |producer_name_regex_filter| is set,
3839    // the data source is enabled only for producers whose names match any of
3840    // the filters.
3841    // |producer_name_filter| has to be an exact match, while
3842    // |producer_name_regex_filter| is a regular expression.
3843    // This allows to enable a data source only for specific processes.
3844    // The "repeated" fields have OR semantics: specifying a filter ["foo",
3845    // "bar"] will enable data sources on both "foo" and "bar" (if they exist).
3846    repeated string producer_name_filter = 2;
3847    repeated string producer_name_regex_filter = 3;
3848  }
3849  repeated DataSource data_sources = 2;
3850
3851  // Config for disabling builtin data sources in the tracing service.
3852  message BuiltinDataSource {
3853    // Disable emitting clock timestamps into the trace.
3854    optional bool disable_clock_snapshotting = 1;
3855
3856    // Disable echoing the original trace config in the trace.
3857    optional bool disable_trace_config = 2;
3858
3859    // Disable emitting system info (build fingerprint, cpuinfo, etc).
3860    optional bool disable_system_info = 3;
3861
3862    // Disable emitting events for data-source state changes (e.g. the marker
3863    // for all data sources having ACKed the start of the trace).
3864    optional bool disable_service_events = 4;
3865
3866    // The authoritative clock domain for the trace. Defaults to BOOTTIME. See
3867    // also ClockSnapshot's primary_trace_clock. The configured value is written
3868    // into the trace as part of the ClockSnapshots emitted by the service.
3869    // Trace processor will attempt to translate packet/event timestamps from
3870    // various data sources (and their chosen clock domains) to this domain
3871    // during import. Added in Android R.
3872    optional BuiltinClock primary_trace_clock = 5;
3873
3874    // Time interval in between snapshotting of sync markers, clock snapshots,
3875    // stats, and other periodic service-emitted events. Note that the service
3876    // only keeps track of the first and the most recent snapshot until
3877    // ReadBuffers() is called.
3878    optional uint32 snapshot_interval_ms = 6;
3879
3880    // Hints to the service that a suspend-aware (i.e. counting time in suspend)
3881    // clock should be used for periodic snapshots of service-emitted events.
3882    // This means, if a snapshot *should* have happened during suspend, it will
3883    // happen immediately after the device resumes.
3884    //
3885    // Choosing a clock like this is done on best-effort basis; not all
3886    // platforms (e.g. Windows) expose a clock which can be used for periodic
3887    // tasks counting suspend. If such a clock is not available, the service
3888    // falls back to the best-available alternative.
3889    //
3890    // Introduced in Android S.
3891    // TODO(lalitm): deprecate this in T and make this the default if nothing
3892    // crashes in S.
3893    optional bool prefer_suspend_clock_for_snapshot = 7;
3894
3895    // Disables the reporting of per-trace-writer histograms in TraceStats.
3896    optional bool disable_chunk_usage_histograms = 8;
3897  }
3898  optional BuiltinDataSource builtin_data_sources = 20;
3899
3900  // If specified, the trace will be stopped |duration_ms| after starting.
3901  // This does *not* count the time the system is suspended, so we will run
3902  // for duration_ms of system activity, not wall time.
3903  //
3904  // However in case of traces with triggers, see
3905  // TriggerConfig.trigger_timeout_ms instead.
3906  optional uint32 duration_ms = 3;
3907
3908  // If true, tries to use CLOCK_BOOTTIME for duration_ms rather than
3909  // CLOCK_MONOTONIC (which doesn't count time in suspend). Supported only on
3910  // Linux/Android, no-op on other platforms. This is used when dealing with
3911  // long (e.g. 24h) traces, where suspend can inflate them to weeks of
3912  // wall-time, making them more likely to hit device reboots (and hence loss).
3913  // This option also changes consistently the semantic of
3914  // TriggerConfig.stop_delay_ms.
3915  optional bool prefer_suspend_clock_for_duration = 36;
3916
3917  // This is set when --dropbox is passed to the Perfetto command line client
3918  // and enables guardrails that limit resource usage for traces requested
3919  // by statsd.
3920  optional bool enable_extra_guardrails = 4;
3921
3922  enum LockdownModeOperation {
3923    LOCKDOWN_UNCHANGED = 0;
3924    LOCKDOWN_CLEAR = 1;
3925    LOCKDOWN_SET = 2;
3926  }
3927  // Reject producers that are not running under the same UID as the tracing
3928  // service.
3929  optional LockdownModeOperation lockdown_mode = 5;
3930
3931  message ProducerConfig {
3932    // Identifies the producer for which this config is for.
3933    optional string producer_name = 1;
3934
3935    // Specifies the preferred size of the shared memory buffer. If the size is
3936    // larger than the max size, the max will be used. If it is smaller than
3937    // the page size or doesn't fit pages evenly into it, it will fall back to
3938    // the size specified by the producer or finally the default shared memory
3939    // size.
3940    optional uint32 shm_size_kb = 2;
3941
3942    // Specifies the preferred size of each page in the shared memory buffer.
3943    // Must be an integer multiple of 4K.
3944    optional uint32 page_size_kb = 3;
3945  }
3946
3947  repeated ProducerConfig producers = 6;
3948
3949  // Contains statsd-specific metadata about an alert associated with the trace.
3950  message StatsdMetadata {
3951    // The identifier of the alert which triggered this trace.
3952    optional int64 triggering_alert_id = 1;
3953    // The uid which registered the triggering configuration with statsd.
3954    optional int32 triggering_config_uid = 2;
3955    // The identifier of the config which triggered the alert.
3956    optional int64 triggering_config_id = 3;
3957    // The identifier of the subscription which triggered this trace.
3958    optional int64 triggering_subscription_id = 4;
3959  }
3960
3961  // Statsd-specific metadata.
3962  optional StatsdMetadata statsd_metadata = 7;
3963
3964  // When true && |output_path| is empty, the EnableTracing() request must
3965  // provide a file descriptor. The service will then periodically read packets
3966  // out of the trace buffer and store it into the passed file.
3967  // If |output_path| is not empty no fd should be passed, the service
3968  // will create a new file and write into that (see comment below).
3969  optional bool write_into_file = 8;
3970
3971  // This must point to a non-existing file. If the file exists the service
3972  // will NOT overwrite and will fail instead as a security precaution.
3973  // On Android, when this is used with the system traced, the path must be
3974  // within /data/misc/perfetto-traces/ or the trace will fail.
3975  // This option has been introduced in Android R. Before R write_into_file
3976  // can be used only with the "pass a file descriptor over IPC" mode.
3977  optional string output_path = 29;
3978
3979  // Optional. If non-zero tunes the write period. A min value of 100ms is
3980  // enforced (i.e. smaller values are ignored).
3981  optional uint32 file_write_period_ms = 9;
3982
3983  // Optional. When non zero the periodic write stops once at most X bytes
3984  // have been written into the file. Tracing is disabled when this limit is
3985  // reached, even if |duration_ms| has not been reached yet.
3986  optional uint64 max_file_size_bytes = 10;
3987
3988  // Contains flags which override the default values of the guardrails inside
3989  // Perfetto.
3990  message GuardrailOverrides {
3991    // Override the default limit (in bytes) for uploading data to server within
3992    // a 24 hour period.
3993    // On R-, this override only affected userdebug builds. Since S, it also
3994    // affects user builds.
3995    // In 24Q3+ (V+), this override is a noop because upload guardrail logic
3996    // was removed from Perfetto.
3997    optional uint64 max_upload_per_day_bytes = 1 [deprecated = true];
3998
3999    // Overrides the guardrail for maximum trace buffer size.
4000    // Available on U+
4001    optional uint32 max_tracing_buffer_size_kb = 2;
4002  }
4003  optional GuardrailOverrides guardrail_overrides = 11;
4004
4005  // When true, data sources are not started until an explicit call to
4006  // StartTracing() on the consumer port. This is to support early
4007  // initialization and fast trace triggering. This can be used only when the
4008  // Consumer explicitly triggers the StartTracing() method.
4009  // This should not be used in a remote trace config via statsd, doing so will
4010  // result in a hung trace session.
4011  optional bool deferred_start = 12;
4012
4013  // When set, it periodically issues a Flush() to all data source, forcing them
4014  // to commit their data into the tracing service. This can be used for
4015  // quasi-real-time streaming mode and to guarantee some partial ordering of
4016  // events in the trace in windows of X ms.
4017  optional uint32 flush_period_ms = 13;
4018
4019  // Wait for this long for producers to acknowledge flush requests.
4020  // Default 5s.
4021  optional uint32 flush_timeout_ms = 14;
4022
4023  // Wait for this long for producers to acknowledge stop requests.
4024  // Default 5s.
4025  optional uint32 data_source_stop_timeout_ms = 23;
4026
4027  // |disable_clock_snapshotting| moved.
4028  reserved 15;
4029
4030  // Android-only. If set, sends an intent to the Traceur system app when the
4031  // trace ends to notify it about the trace readiness.
4032  optional bool notify_traceur = 16;
4033
4034  // This field was introduced in Android S.
4035  // Android-only. If set to a value > 0, marks the trace session as a candidate
4036  // for being attached to a bugreport. This field effectively acts as a z-index
4037  // for bugreports. When Android's dumpstate runs perfetto
4038  // --save-for-bugreport, traced will pick the tracing session with the highest
4039  // score (score <= 0 is ignored) and:
4040  // On Android S, T:  will steal its contents, save the trace into
4041  //     a known path and stop prematurely.
4042  // On Android U+: will create a read-only snapshot and save that into a known
4043  //     path, without stoppin the original tracing session.
4044  // When this field is set the tracing session becomes eligible to be cloned
4045  // by other UIDs.
4046  optional int32 bugreport_score = 30;
4047
4048  // When set, defines name of the file that will be saved under
4049  // /data/misc/perfetto-traces/bugreport/ when using --save-all-for-bugreport.
4050  // If omitted, traces will be named systrace.pftrace, systrace_1.pftrace, etc,
4051  // starting from the highest `bugreport_score`.
4052  // Introduced in v42 / Android V.
4053  optional string bugreport_filename = 38;
4054
4055  // Triggers allow producers to start or stop the tracing session when an event
4056  // occurs.
4057  //
4058  // For example if we are tracing probabilistically, most traces will be
4059  // uninteresting. Triggers allow us to keep only the interesting ones such as
4060  // those traces during which the device temperature reached a certain
4061  // threshold. In this case the producer can activate a trigger to keep
4062  // (STOP_TRACING) the trace, otherwise it can also begin a trace
4063  // (START_TRACING) because it knows something is about to happen.
4064  message TriggerConfig {
4065    enum TriggerMode {
4066      UNSPECIFIED = 0;
4067
4068      // When this mode is chosen, data sources are not started until one of the
4069      // |triggers| are received. This supports early initialization and fast
4070      // starting of the tracing system. On triggering, the session will then
4071      // record for |stop_delay_ms|. However if no trigger is seen
4072      // after |trigger_timeout_ms| the session will be stopped and no data will
4073      // be returned.
4074      START_TRACING = 1;
4075
4076      // When this mode is chosen, the session will be started via the normal
4077      // EnableTracing() & StartTracing(). If no trigger is ever seen
4078      // the session will be stopped after |trigger_timeout_ms| and no data will
4079      // be returned. However if triggered the trace will stop after
4080      // |stop_delay_ms| and any data in the buffer will be returned to the
4081      // consumer.
4082      STOP_TRACING = 2;
4083
4084      // 3 was taken by CLONE_SNAPSHOT but that has been moved to 4.
4085      // The early implementation of CLONE_SNAPSHOT had various bugs
4086      // (b/290798988, b/290799105) and made it into Android U. The number
4087      // change is to make sure nobody rolls out a config that hits the broken
4088      // behaviour.
4089      reserved 3;
4090
4091      // When this mode is chosen, this causes a snapshot of the current tracing
4092      // session to be created after |stop_delay_ms| while the current tracing
4093      // session continues undisturbed (% an extra flush). This mode can be
4094      // used only when the tracing session is handled by the "perfetto" cmdline
4095      // client (which is true in 90% of cases). Part of the business logic
4096      // necessary for this behavior, and ensuing file handling, lives in
4097      // perfetto_cmd.cc . On other consumers, this causes only a notification
4098      // of the trigger through a CloneTriggerHit ObservableEvent. The custom
4099      // consumer is supposed to call CloneSession() itself after the event.
4100      // Use use_clone_snapshot_if_available=true when targeting older versions
4101      // of perfetto.
4102      CLONE_SNAPSHOT = 4;
4103
4104      // NOTE: CLONE_SNAPSHOT should be used only when we targeting Android V+
4105      // (15+) / Perfetto v38+. A bug in older versions of the tracing service
4106      // might cause indefinitely long tracing sessions (see b/274931668).
4107    }
4108    optional TriggerMode trigger_mode = 1;
4109
4110    // This flag is really a workaround for b/274931668. This is needed only
4111    // when deploying configs to different versions of the tracing service.
4112    // When this is set to true this has the same effect of setting trigger_mode
4113    // to CLONE_SNAPSHOT on newer versions of the service. This boolean has been
4114    // introduced to allow to have configs that use CLONE_SNAPSHOT on newer
4115    // versions of Android and fall back to STOP_TRACING on older versions where
4116    // CLONE_SNAPSHOT did not exist.
4117    // When using this flag, trigger_mode must be set to STOP_TRACING.
4118    optional bool use_clone_snapshot_if_available = 5;
4119
4120    // DEPRECATED, was use_clone_snapshot_if_available in U. See the comment
4121    // around CLONE_SNAPSHOT.
4122    reserved 4;
4123
4124    message Trigger {
4125      // The producer must specify this name to activate the trigger.
4126      optional string name = 1;
4127
4128      // An std::regex that will match the producer that can activate this
4129      // trigger. This is optional. If unset any producers can activate this
4130      // trigger.
4131      optional string producer_name_regex = 2;
4132
4133      // After a trigger is received either in START_TRACING or STOP_TRACING
4134      // mode then the trace will end |stop_delay_ms| after triggering.
4135      // In CLONE_SNAPSHOT mode, this is the delay between the trigger and the
4136      // snapshot.
4137      // If |prefer_suspend_clock_for_duration| is set, the duration will be
4138      // based on wall-clock, counting also time in suspend.
4139      optional uint32 stop_delay_ms = 3;
4140
4141      // Limits the number of traces this trigger can start/stop in a rolling
4142      // 24 hour window. If this field is unset or zero, no limit is applied and
4143      // activiation of this trigger *always* starts/stops the trace.
4144      optional uint32 max_per_24_h = 4;
4145
4146      // A value between 0 and 1 which encodes the probability of skipping a
4147      // trigger with this name. This is useful for reducing the probability
4148      // of high-frequency triggers from dominating trace finaization. If this
4149      // field is unset or zero, the trigger will *never* be skipped. If this
4150      // field is greater than or equal to 1, this trigger will *always* be
4151      // skipped i.e. it will be as if this trigger was never included in the
4152      // first place.
4153      // This probability check is applied *before* any other limits. For
4154      // example, if |max_per_24_h| is also set, first we will check if the
4155      // probability bar is met and only then will we check the |max_per_24_h|
4156      // limit.
4157      optional double skip_probability = 5;
4158    }
4159    // A list of triggers which are related to this configuration. If ANY
4160    // trigger is seen then an action will be performed based on |trigger_mode|.
4161    repeated Trigger triggers = 2;
4162
4163    // Required and must be positive if a TriggerConfig is specified. This is
4164    // how long this TraceConfig should wait for a trigger to arrive. After this
4165    // period of time if no trigger is seen the TracingSession will be cleaned
4166    // up.
4167    optional uint32 trigger_timeout_ms = 3;
4168  }
4169  optional TriggerConfig trigger_config = 17;
4170
4171  // When this is non-empty the perfetto command line tool will ignore the rest
4172  // of this TraceConfig and instead connect to the perfetto service as a
4173  // producer and send these triggers, potentially stopping or starting traces
4174  // that were previous configured to use a TriggerConfig.
4175  repeated string activate_triggers = 18;
4176
4177  // Configuration for trace contents that reference earlier trace data. For
4178  // example, a data source might intern strings, and emit packets containing
4179  // {interned id : string} pairs. Future packets from that data source can then
4180  // use the interned ids instead of duplicating the raw string contents. The
4181  // trace parser will then need to use that interning table to fully interpret
4182  // the rest of the trace.
4183  message IncrementalStateConfig {
4184    // If nonzero, notify eligible data sources to clear their incremental state
4185    // periodically, with the given period. The notification is sent only to
4186    // data sources that have |handles_incremental_state_clear| set in their
4187    // DataSourceDescriptor. The notification requests that the data source
4188    // stops referring to past trace contents. This is particularly useful when
4189    // tracing in ring buffer mode, where it is not exceptional to overwrite old
4190    // trace data.
4191    //
4192    // Warning: this time-based global clearing is likely to be removed in the
4193    // future, to be replaced with a smarter way of sending the notifications
4194    // only when necessary.
4195    optional uint32 clear_period_ms = 1;
4196  }
4197  optional IncrementalStateConfig incremental_state_config = 21;
4198
4199  // No longer needed as we unconditionally allow tracing on user builds.
4200  optional bool allow_user_build_tracing = 19 [deprecated = true];
4201
4202  // If set the tracing service will ensure there is at most one tracing session
4203  // with this key.
4204  optional string unique_session_name = 22;
4205
4206  // Compress trace with the given method. Best effort.
4207  enum CompressionType {
4208    COMPRESSION_TYPE_UNSPECIFIED = 0;
4209    COMPRESSION_TYPE_DEFLATE = 1;
4210  }
4211  optional CompressionType compression_type = 24;
4212
4213  // DEPRECATED, was compress_from_cli.
4214  reserved 37;
4215
4216  // Android-only. Not for general use. If set, saves the trace into an
4217  // incident. This field is read by perfetto_cmd, rather than the tracing
4218  // service. This field must be set when passing the --upload flag to
4219  // perfetto_cmd.
4220  message IncidentReportConfig {
4221    // In this message, either:
4222    //  * all of |destination_package|, |destination_class| and |privacy_level|
4223    //    must be set.
4224    //  * |skip_incidentd| must be explicitly set to true.
4225
4226    optional string destination_package = 1;
4227    optional string destination_class = 2;
4228    // Level of filtering in the requested incident. See |Destination| in
4229    // frameworks/base/core/proto/android/privacy.proto.
4230    optional int32 privacy_level = 3;
4231
4232    // If true, then skips saving the trace to incidentd.
4233    //
4234    // This flag is useful in testing (e.g. Perfetto-statsd integration tests)
4235    // or when we explicitly don't want traces to go to incidentd even when they
4236    // usually would (e.g. configs deployed using statsd but only used for
4237    // inclusion in bugreports using |bugreport_score|).
4238    //
4239    // The motivation for having this flag, instead of just not setting
4240    // |incident_report_config|, is prevent accidents where
4241    // |incident_report_config| is omitted by mistake.
4242    optional bool skip_incidentd = 5;
4243
4244    // If true, do not write the trace into dropbox (i.e. incident only).
4245    // Otherwise, write to both dropbox and incident.
4246    // TODO(lalitm): remove this field as we no longer use Dropbox.
4247    optional bool skip_dropbox = 4 [deprecated = true];
4248  }
4249  optional IncidentReportConfig incident_report_config = 25;
4250
4251  enum StatsdLogging {
4252    STATSD_LOGGING_UNSPECIFIED = 0;
4253    STATSD_LOGGING_ENABLED = 1;
4254    STATSD_LOGGING_DISABLED = 2;
4255  }
4256
4257  // Android-only. Not for general use. If specified, sets the logging to statsd
4258  // of guardrails and checkpoints in the tracing service. perfetto_cmd sets
4259  // this to enabled (if not explicitly set in the config) when specifying
4260  // --upload.
4261  optional StatsdLogging statsd_logging = 31;
4262
4263  // DEPRECATED. Was trace_uuid, use trace_uuid_msb and trace_uuid_lsb instead.
4264  reserved 26;
4265
4266  // An identifier clients can use to tie this trace to other logging.
4267  // DEPRECATED as per v32. See TracePacket.trace_uuid for the authoritative
4268  // Trace UUID. If this field is set, the tracing service will respect the
4269  // requested UUID (i.e. TracePacket.trace_uuid == this field) but only if
4270  // gap-less snapshotting is not used.
4271  optional int64 trace_uuid_msb = 27 [deprecated = true];
4272  optional int64 trace_uuid_lsb = 28 [deprecated = true];
4273
4274  // When set applies a post-filter to the trace contents using the filter
4275  // provided. The filter is applied at ReadBuffers() time and works both in the
4276  // case of IPC readback and write_into_file. This filter can be generated
4277  // using `tools/proto_filter -s schema.proto -F filter_out.bytes` or
4278  // `-T filter_out.escaped_string` (for .pbtx). See go/trace-filtering for
4279  // design.
4280  //
4281  // Introduced in Android S, but it was broken (b/195065199). Reintroduced in
4282  // Android T with a different field number. Updated in Android U with a new
4283  // bytecode version which supports string filtering.
4284  message TraceFilter {
4285    // =========================
4286    // Filter bytecode.
4287    // =========================
4288
4289    // The bytecode as implemented in Android T.
4290    optional bytes bytecode = 1;
4291
4292    // The bytecode as implemented in Android U. Adds support for string
4293    // filtering.
4294    optional bytes bytecode_v2 = 2;
4295
4296    // =========================
4297    // String filtering
4298    // =========================
4299
4300    // The principles and terminology of string filtering is heavily inspired by
4301    // iptables. A "rule" decide how strings should be filtered. Each rule
4302    // contains a "policy" which indicates the algorithm to use for filtering.
4303    // A "chain" is a list of rules which will be sequentially checked against
4304    // each string.
4305    //
4306    // The first rule which applies to the string terminates filtering for that
4307    // string. If no rules apply, the string is left unchanged.
4308
4309    // A policy specifies which algorithm should be used for filtering the
4310    // string.
4311    enum StringFilterPolicy {
4312      SFP_UNSPECIFIED = 0;
4313
4314      // Tries to match the string field against |regex_pattern|. If it
4315      // matches, all matching groups are "redacted" (i.e. replaced with a
4316      // constant string) and filtering is terminated (i.e. no further rules are
4317      // checked). If it doesn't match, the string is left unchanged and the
4318      // next rule in chain is considered.
4319      SFP_MATCH_REDACT_GROUPS = 1;
4320
4321      // Like |SFP_MATCH_REDACT_GROUPS| but tries to do some pre-work before
4322      // checking the regex. Specifically, it tries to parse the string field as
4323      // an atrace tracepoint and checks if the post-tgid field starts with
4324      // |atrace_post_tgid_starts_with|. The regex matching is only performed if
4325      // this check succeeds.
4326      SFP_ATRACE_MATCH_REDACT_GROUPS = 2;
4327
4328      // Tries to match the string field against |regex_pattern|. If it
4329      // matches, filtering is terminated (i.e. no further rules are checked).
4330      // If it doesn't match, the string is left unchanged and the next rule in
4331      // chain is considered.
4332      SFP_MATCH_BREAK = 3;
4333
4334      // Like |SFP_MATCH_BREAK| but tries to do some pre-work before checking
4335      // the regex. Specifically, it tries to parse the string field as an
4336      // atrace tracepoint and checks if the post-tgid field starts with
4337      // |atrace_post_tgid_starts_with|. The regex matching is only performed if
4338      // this check succeeds.
4339      SFP_ATRACE_MATCH_BREAK = 4;
4340
4341      // Tries to repeatedly search (i.e. find substrings of) the string field
4342      // with |regex_pattern|. For each match, redacts any matching groups (i.e.
4343      // replaced with a constant string). Once there are no further matches,
4344      // filtering is terminated (i.e. no further rules are checked).
4345      //
4346      // Note that this is policy is a "search" policy not a "match" policy
4347      // unlike the above policies:
4348      //  * Match policies require matching the full string i.e. there is an
4349      //    implicit leading `^` and trailing `$`.
4350      //  * Search policies perform repeated partial matching of the string
4351      //    e.g.
4352      //      - String: `foo=aaa,bar=123,foo=bbb,baz=456`
4353      //      - Pattern: `foo=(\d+)`
4354      //      - Output: `foo=P6O,bar=123,foo=P6O,baz=456`
4355      //    where P6O is the redaction string
4356      //
4357      // All of this is only performed after some pre-work where we try to parse
4358      // the string field as an atrace tracepoint and check if the post-tgid
4359      // field starts with |atrace_post_tgid_starts_with|.
4360      //
4361      // If there are no partial matches, the string is left unchanged and the
4362      // next rule in chain is considered.
4363      SFP_ATRACE_REPEATED_SEARCH_REDACT_GROUPS = 5;
4364    }
4365
4366    // A rule specifies how strings should be filtered.
4367    message StringFilterRule {
4368      // The policy (i.e. algorithm) dictating how strings matching this rule
4369      // should be handled.
4370      optional StringFilterPolicy policy = 1;
4371
4372      // The regex pattern used to match against each string.
4373      optional string regex_pattern = 2;
4374
4375      // The string which should appear after the tgid in atrace tracepoint
4376      // strings.
4377      optional string atrace_payload_starts_with = 3;
4378    }
4379
4380    // A chain is a list of rules which string will be sequentially checked
4381    // against.
4382    message StringFilterChain {
4383      repeated StringFilterRule rules = 1;
4384    }
4385    optional StringFilterChain string_filter_chain = 3;
4386  }
4387  // old field number for trace_filter
4388  reserved 32;
4389  optional TraceFilter trace_filter = 33;
4390
4391  // Android-only. Not for general use. If set, reports the trace to the
4392  // Android framework. This field is read by perfetto_cmd, rather than the
4393  // tracing service. This field must be set when passing the --upload flag to
4394  // perfetto_cmd.
4395  message AndroidReportConfig {
4396    // In this message, either:
4397    //  * |reporter_service_package| and |reporter_service_class| must be set.
4398    //  * |skip_reporting| must be explicitly set to true.
4399
4400    optional string reporter_service_package = 1;
4401    optional string reporter_service_class = 2;
4402
4403    // If true, then skips reporting the trace to Android framework.
4404    //
4405    // This flag is useful in testing (e.g. Perfetto-statsd integration tests)
4406    // or when we explicitly don't want to report traces to the framework even
4407    // when they usually would (e.g. configs deployed using statsd but only
4408    // used for inclusion in bugreports using |bugreport_score|).
4409    //
4410    // The motivation for having this flag, instead of just not setting
4411    // |framework_report_config|, is prevent accidents where
4412    // |framework_report_config| is omitted by mistake.
4413    optional bool skip_report = 3;
4414
4415    // If true, will direct the Android framework to read the data in trace
4416    // file and pass it to the reporter class over a pipe instead of passing
4417    // the file descriptor directly.
4418    //
4419    // This flag is needed because the Android test framework does not
4420    // currently support priv-app helper apps (in terms of SELinux) and we
4421    // really don't want to add an allow rule for untrusted_app to receive
4422    // trace fds.
4423    //
4424    // Because of this, we instead will direct the framework to create a new
4425    // pipe and pass this to the reporter process instead. As the pipe is
4426    // created by the framework, we won't have any problems with SELinux
4427    // (system_server is already allowed to pass pipe fds, even
4428    // to untrusted apps).
4429    //
4430    // As the name suggests this option *MUST* only be used for testing.
4431    // Note that the framework will reject (and drop) files which are too
4432    // large both for simplicity and to be minimize the amount of data we
4433    // pass to a non-priv app (note that the framework will still check
4434    // manifest permissions even though SELinux permissions are worked around).
4435    optional bool use_pipe_in_framework_for_testing = 4;
4436  }
4437  optional AndroidReportConfig android_report_config = 34;
4438
4439  // If set, delays the start of tracing by a random duration. The duration is
4440  // chosen from a uniform distribution between the specified minimum and
4441  // maximum.
4442  // Note: this delay is implemented by perfetto_cmd *not* by traced so will
4443  // not work if you communicate with traced directly over the consumer API.
4444  // Introduced in Android T.
4445  message CmdTraceStartDelay {
4446    optional uint32 min_delay_ms = 1;
4447    optional uint32 max_delay_ms = 2;
4448  }
4449  optional CmdTraceStartDelay cmd_trace_start_delay = 35;
4450
4451  // When non-empty, ensures that for a each semaphore named `name at most
4452  // `max_other_session_count`` *other* sessions (whose value is taken of the
4453  // minimum of all values specified by this config or any already-running
4454  // session) can be be running.
4455  //
4456  // If a semaphore "acquisition" fails, EnableTracing will return an error
4457  // and the tracing session will not be started (or elgible to start in
4458  // the case of deferred sessions).
4459  //
4460  // This is easiest to explain with an example. Suppose the tracing service has
4461  // the following active tracing sessions:
4462  //   S1 = [{name=foo, max_other_session_count=2},
4463  //         {name=bar, max_other_session_count=0}]
4464  //   S2 = [{name=foo, max_other_session_count=1},
4465  //         {name=baz, max_other_session_count=1}]
4466  //
4467  // Then, for a new session, the following would be the expected behaviour of
4468  // EnableSession given the state of `session_semaphores`.
4469  //   Q: session_semaphores = []
4470  //   A: Allowed because it does not specify any semaphores. Will be allowed
4471  //      no matter the state of any other tracing session.
4472  //   Q: session_semaphores = [{name=baz, max_other_session_count=1}]
4473  //   A: Allowed because both S2 and this config specify
4474  //      max_other_session_count=1 for baz.
4475  //   Q: session_semaphores = [{name=foo, max_other_session_count=3}]
4476  //   A: Denied because S2 specified max_other_session_count=1 for foo and S1
4477  //      takes that slot.
4478  //   Q: session_semaphores = [{name=bar, max_other_session_count=0}]
4479  //   A: Denied because S1 takes the the slot specified by both S1 and
4480  //      this config.
4481  //
4482  // Introduced in 24Q3 (Android V).
4483  message SessionSemaphore {
4484    // The name of the semaphore. Acts as a unique identifier across all
4485    // tracing sessions (including the one being started).
4486    optional string name = 1;
4487
4488    // The maximum number of *other* sesssions which specify the same semaphore
4489    // which can be active. The minimum of this value across all tracing
4490    // sessions and the value specified by the config is used when deciding
4491    // whether the tracing session can be started.
4492    optional uint64 max_other_session_count = 2;
4493  }
4494  repeated SessionSemaphore session_semaphores = 39;
4495}
4496
4497// End of protos/perfetto/config/trace_config.proto
4498