package perfetto.protos
Get desktop application:
View/edit binary Protocol Buffers messages
message
perfetto_merged_metrics.proto:91Used in:
repeated battery_counters = 1
Battery counters info for each ts of the trace. This should only be extracted for short traces.
optional battery_aggregates = 2
repeated suspend_period = 3
Used in:
optional int64 total_screen_off_ns = 1
Field numbers for these 3 == the int values from Android
optional int64 total_screen_on_ns = 2
optional int64 total_screen_doze_ns = 3
optional int64 total_wakelock_ns = 4
Total time a wakelock was held
optional int64 sleep_ns = 5
Amount of time the device was suspended. Depends on the ftrace source "power/suspend_resume".
optional int64 sleep_screen_off_ns = 6
optional int64 sleep_screen_on_ns = 7
optional int64 sleep_screen_doze_ns = 8
message
perfetto_merged_metrics.proto:92Used in:
optional int64 timestamp_ns = 1
Timestamp measured from boot time [ns].
optional double charge_counter_uah = 2
Fields 2-5 are the same as in BatteryCounters proto in TracePacket.
optional float capacity_percent = 3
optional double current_ua = 4
optional double current_avg_ua = 5
Period of time during the trace that the device went to sleep completely.
Used in:
optional int64 timestamp_ns = 1
optional int64 duration_ns = 2
This metric provides per-process Binder statistics for traces with binder_driver enabled Specifically, transactions are categorized and counted
Used in:
repeated process_breakdown = 1
Used in:
optional string process_name = 1
optional uint32 pid = 2
optional string slice_name = 3
optional uint32 count = 4
Used in:
optional gc_rss_and_dma = 1
Counter for the sum of DMA and RSS across GCA, cameraserver and HAL. This provides a single number for the memory pressure using the camera is putting on the rest of the system. Note: this number assumes that all DMA pressure is coming from the camera as this is usually a pretty good approximation. Being more accurate here would increase the complexity of the metric significantly. Note: if there are multiple GCA/cameraserver/HAL processes in the trace, this metric will simply take the latest one in the trace and ignore the others.
Used in:
optional double min = 1
optional double max = 2
optional double avg = 3
Used in:
repeated gc_rss_and_dma = 1
Timeseries for the sum of DMA and RSS across GCA, cameraserver and HAL. This provides a single number for the memory pressure using the camera is putting on the rest of the system. Note: this number assumes that all DMA pressure is coming from the camera as this is usually a pretty good approximation. Being more accurate here would increase the complexity of the metric significantly. Note: if there are multiple GCA/cameraserver/HAL processes in the trace, this metric will simply take the latest one in the trace and ignore the others.
Used in:
optional int64 ts = 1
optional double value = 2
Used in:
repeated process_info = 1
Next id: 7
Used in: ,
optional uint32 id = 1
optional metrics = 6
Next id: 3
Used in: ,
optional string type = 1
optional metrics = 2
Next id: 6
Used in: , , ,
optional int64 mcycles = 1
CPU megacycles (i.e. cycles divided by 1e6).
optional int64 runtime_ns = 2
Total time the thread was running for this breakdown in nanoseconds.
optional int64 min_freq_khz = 3
Min/max/average CPU frequency weighted by the time the CPU was running at each frequency in this breakdown.
optional int64 max_freq_khz = 4
optional int64 avg_freq_khz = 5
Next id: 8
Used in:
optional string name = 1
optional metrics = 4
repeated threads = 6
Breakdowns of above metrics.
repeated core = 7
repeated core_type = 5
Next id: 7
Used in:
optional string name = 1
optional metrics = 4
repeated core = 2
Breakdowns of above metrics.
repeated core_type = 5
Used in:
optional uint32 total_duplicate_frames = 1
Stat that reports the number of duplicate frames submitted to the display for rendering. That is frames that have the same pixels values but where still submitted. It is tracked based on comparing the MISR of the current frame vs previous frame.
optional uint32 duplicate_frames_logged = 2
Stat reports whether there is any duplicate_frames tracked
optional uint32 total_dpu_underrun_count = 3
Stat that reports the number of dpu underrrun occurs count.
optional uint32 refresh_rate_switches = 4
Calculate the total number of refresh rate changes
repeated refresh_rate_stats = 5
The statistics for each refresh rate value
Used in:
optional uint32 refresh_rate_fps = 1
The refresh rate value (the number of frames per second)
optional uint32 count = 2
Calculate the number of refresh rate switches to this fps
optional double total_dur_ms = 3
Calculate the total duration of refresh rate stays at this fps
optional double avg_dur_ms = 4
Calculate the average duration of refresh rate stays at this fps
dma-buf heap memory stats on Android.
Used in:
optional double avg_size_bytes = 1
optional double min_size_bytes = 2
optional double max_size_bytes = 3
optional double total_alloc_size_bytes = 4
Total allocation size. Essentially the sum of positive allocs.
Used in:
repeated freq_residencies = 1
Frequency residency metrics from clock_set_rate ftrace event.
Used in:
optional int32 freq_value = 1
Operating frequency
optional double percentage = 2
Percentage of duration in this operating frequency compared to all frequencies
optional int64 duration_ns = 3
Total duration in ns when the state was in this operating frequency
Used in:
optional string freq_name = 1
Frequency representative name
repeated band_stat = 2
Each band statistics meta
fastrpc memory stats on Android.
Used in:
repeated subsystem = 1
Used in:
optional string name = 1
optional double avg_size_bytes = 2
optional double min_size_bytes = 3
optional double max_size_bytes = 4
optional double total_alloc_size_bytes = 5
Total allocation size. Essentially the sum of positive allocs.
message
perfetto_merged_metrics.proto:52Used in:
optional int64 total_frames = 4
optional int64 missed_app_frames = 5
repeated process = 2
message
perfetto_merged_metrics.proto:53Used in:
optional process = 3
optional int64 total_frames = 4
optional int64 missed_frames = 5
optional int64 missed_app_frames = 6
optional int64 missed_sf_frames = 7
optional int64 frame_dur_max = 8
optional int64 frame_dur_avg = 9
optional int64 frame_dur_p50 = 10
optional int64 frame_dur_p90 = 11
optional int64 frame_dur_p95 = 12
optional int64 frame_dur_p99 = 13
Used in:
repeated processes = 1
GPU metric for processes using GPU.
optional int64 mem_max = 2
max/min/avg GPU memory used by the entire system.
optional int64 mem_min = 3
optional int64 mem_avg = 4
repeated freq_metrics = 5
GPU frequency metric for each gpu_id
Used in:
optional uint32 gpu_id = 1
Identifier for GPU in a multi-gpu device.
optional int64 freq_max = 2
max/min/avg GPU frequency for this gpu_id the calculation of avg is weighted by the duration of each frequency
optional int64 freq_min = 3
optional double freq_avg = 4
repeated used_freqs = 5
Metrics for each used GPU frequency
Used in:
optional int64 freq = 1
Used frequency
optional double dur_ms = 2
Total duration in ms when the state of GPU was in this frequency
optional double percentage = 3
Percentage of duration in this frequency compared to all frequencies in this gpu_id
Used in:
optional string name = 1
Process name.
optional int64 mem_max = 2
max/min/avg GPU memory used by this process.
optional int64 mem_min = 3
optional int64 mem_avg = 4
Used in:
optional double composition_total_layers = 1
Counts the number of composition total layers in the trace. (non-weighted average)
optional double composition_dpu_layers = 2
Counts the number of composition dpu layers in the trace. (non-weighted average)
optional double composition_gpu_layers = 3
Counts the number of composition gpu layers in the trace. (non-weighted average)
optional double composition_dpu_cached_layers = 4
Counts the number of composition dpu cached layers in the trace. (non-weighted average)
optional double composition_sf_cached_layers = 5
Counts the number of composition surfaceflinger cached layers in the trace. (non-weighted average)
optional int32 skipped_validation_count = 6
Counts how many times validateDisplay is skipped.
optional int32 unskipped_validation_count = 7
Counts how many times validateDisplay cannot be skipped.
optional int32 separated_validation_count = 8
Counts how many times validateDisplay is already separated from presentDisplay since the beginning.
optional int32 unknown_validation_count = 9
Counts how many unhandled validation cases which might be caused by errors.
optional double avg_all_execution_time_ms = 10
the average of overall hwcomposer execution time.
optional double avg_skipped_execution_time_ms = 11
the average of hwcomposer execution time for skipped validation cases.
optional double avg_unskipped_execution_time_ms = 12
the average of hwcomposer execution time for unskipped validation cases.
optional double avg_separated_execution_time_ms = 13
the average of hwcomposer execution time for separated validation cases.
repeated dpu_vote_metrics = 14
DPU Vote Metrics for each thread track
Used in:
optional uint32 tid = 1
the thread ID that handles this track
optional double avg_dpu_vote_clock = 2
the weighted average of DPU Vote Clock
optional double avg_dpu_vote_avg_bw = 3
the weighted average of DPU Vote Avg Bandwidth
optional double avg_dpu_vote_peak_bw = 4
the weighted average of DPU Vote Peak Bandwidth
optional double avg_dpu_vote_rt_bw = 5
the weighted average of DPU Vote RT (Real Time) Bandwidth
Used in:
repeated process_info = 1
HWUI metrics for processes that have a RenderThread.
ion memory stats on Android.
Used in:
repeated buffer = 1
Used in:
optional string name = 1
optional double avg_size_bytes = 2
optional double min_size_bytes = 3
optional double max_size_bytes = 4
optional double total_alloc_size_bytes = 5
Total allocation size. Essentially the sum of positive allocs (-> new buffers).
measure max IRQ runtime and IRQ tasks running over threshold.
Used in:
optional hw_irq = 1
metrics for hardirq and softirq
optional sw_irq = 2
Used in:
optional int64 max_runtime = 1
max runtime of IRQ tasks
optional int64 total_count = 2
total IRQ tasks
optional threshold_metric = 3
over threshold metric
repeated longest_irq_slices = 4
information for top 10 IRQ tasks
Used in:
optional string irq_name = 1
IRQ name
optional int64 ts = 2
timestamp
optional int64 dur = 3
runtime of IRQ task
Used in:
optional string threshold = 1
Threshold value
optional int64 over_threshold_count = 2
over threshold count
optional double anomaly_ratio = 3
anomaly ratio (over threshold count / total count)
Used in:
repeated cuj = 1
Next id: 11
Used in:
optional int32 id = 1
ID of the CUJ that is unique within the trace.
optional string name = 2
Name of the CUJ, extracted from the CUJ trace marker. For example SHADE_EXPAND_COLLAPSE from J<SHADE_EXPAND_COLLAPSE>.
optional process = 3
Details about the process (uid, version, etc)
optional int64 ts = 4
ts of the CUJ trace marker slice.
optional int64 dur = 5
dur of the CUJ trace marker slice.
repeated frame = 6
Details about each of the frames within the CUJ.
repeated sf_frame = 10
Details about each of the SF frames within the CUJ.
optional counter_metrics = 7
Metrics extracted from the counters output by FrameTracker Does not contain the frame_dur percentile information.
optional timeline_metrics = 8
Metrics extracted from the frame timeline.
optional trace_metrics = 9
Metrics extracted from the trace slices.
Next id: 8
Used in:
optional int64 frame_number = 1
Index of the frame within the single user journey.
optional int64 vsync = 2
VSYNC ID of the frame.
optional int64 ts = 3
optional int64 dur = 4
optional int64 dur_expected = 7
optional bool app_missed = 5
Whether the app process missed the frame deadline. Only set for the App frames. Always left unset for SF frames.
optional bool sf_missed = 6
Whether SF missed the frame deadline.
Next id: 12
Used in:
optional int64 total_frames = 1
Overall number of frames within the CUJ.
optional int64 missed_frames = 2
Number of missed frames.
optional int64 missed_app_frames = 3
Number of frames missed due to the app missing the deadline.
optional int64 missed_sf_frames = 4
Number of frames missed due to SF.
optional int64 missed_frames_max_successive = 5
Number of successive frames missed. Not available in timeline_metrics and trace_metrics.
optional int64 frame_dur_max = 6
Max frame duration. Not available in counter_metrics.
optional int64 frame_dur_avg = 7
Average frame duration. Not available in counter_metrics.
optional int64 frame_dur_p50 = 8
Median frame duration. Not available in counter_metrics.
optional int64 frame_dur_p90 = 9
P90 frame duration. Not available in counter_metrics.
optional int64 frame_dur_p95 = 10
P95 frame duration. Not available in counter_metrics.
optional int64 frame_dur_p99 = 11
P99 frame duration. Not available in counter_metrics.
LMK stats on Android.
Used in:
optional int32 total_count = 1
Total count of LMK events observed in the trace.
repeated by_oom_score = 2
optional int32 oom_victim_count = 3
OOM reaper kills. Enabled via the oom/mark_victim point. Should never happen.
Used in:
optional int32 oom_score_adj = 1
optional int32 count = 2
Global process state at LMK time, used to identify potential culprits. TODO: rename to AndroidLmkProcessState
Used in:
repeated lmks = 1
LMKs present in the trace, ordered on their timestamp.
Used in:
optional int32 oom_score_adj = 1
OOM score adj of the LMK'ed process.
optional int64 ion_heaps_bytes = 4
Total size of the ION heap in bytes during this LMK.
optional int64 system_ion_heap_size = 2
Deprecated. Prefer ion_heaps_bytes.
repeated processes = 3
Processes present during this LMK.
Used in:
optional process = 1
optional int32 oom_score_adj = 2
OOM score adj of the process.
optional int64 size = 3
RSS + swap.
optional int64 file_rss_bytes = 4
optional int64 anon_rss_bytes = 5
optional int64 shmem_rss_bytes = 6
optional int64 swap_bytes = 7
Memory metrics on Android.
Used in:
repeated process_metrics = 1
Process metrics, grouped by process name
Used in:
optional double min = 1
optional double max = 2
optional double avg = 3
optional double delta = 4
Memory growth observed in the counter sequence. In case of multiple processes with the same name, break ties using max.
Used in:
optional string priority = 1
optional counters = 2
Used in: ,
optional anon_rss = 1
optional file_rss = 2
optional swap = 3
optional anon_and_swap = 4
optional java_heap = 5
Available when ART trace events are available.
Used in:
optional string process_name = 1
optional total_counters = 2
repeated priority_breakdown = 3
Unaggregated memory metrics on Android.
Used in:
repeated process_values = 1
Process metrics for every process instance in trace.
Used in:
repeated anon_rss = 1
repeated file_rss = 2
repeated swap = 3
repeated anon_and_swap = 4
Used in:
optional string process_name = 1
optional mem_values = 2
Used in:
optional int64 ts = 1
optional int32 oom_score = 2
optional double value = 3
Metrics for Multiuser events, such as switching users.
Used in:
optional user_switch = 1
Metrics for a user switch.
Holds the data for a Multiuser event.
Used in:
optional int32 duration_ms = 1
Duration of the event (in milliseconds).
repeated cpu_usage = 2
CPU usage of each process during the event.
Used in:
optional int32 user_id = 1
The userId of the process (e.g. 0 or 10).
optional string process_name = 2
The name of the process.
optional int32 cpu_mcycles = 3
The number of CPU cycles (in megacycles) spent by that process during the event.
optional float cpu_percentage = 4
The ratio of this process's cycles to the total for all processes, expressed as a percentage.
optional string identifier = 5
General identifier for this usage source: determined from the process name, user, etc. Should be stable across multiple runs (i.e. does not print the user_id directly).
Used in:
repeated net_devices = 1
Network device metrics.
optional net_rx_action = 2
SoftIrq NET_RX action metrics.
optional double retransmission_rate = 3
Packet retransmission rate.
optional double kfree_skb_rate = 4
Kfree Skb rate (i.e. kfree_skb count divided by the packet count from all net devices).
optional net_tx_action = 5
SoftIrq NET_TX action metrics.
optional ipi_action = 6
SoftIrq IPI action metrics.
Used in:
optional uint32 id = 1
optional net_rx_action_statistic = 2
Used in:
optional uint32 id = 1
optional net_tx_action_statistic = 2
Used in: ,
optional uint32 id = 1
optional packet_statistic = 2
Used in:
optional total = 1
Total IPI action statistics.
Used in:
optional int64 count = 1
SoftIrq IPI action count.
optional double runtime_ms = 2
SoftIrq IPI action was running in millisecond.
optional double avg_runtime_ms = 3
SoftIrq IPI action average running time.
Used in:
optional string name = 1
Network device name.
optional rx = 2
Ingress traffic statistic.
optional tx = 3
Egress traffic statistic
Used in:
optional total = 1
Total NET_RX action statistics.
repeated core = 2
Per core NET_RX action statistics.
optional double avg_interstack_latency_ms = 3
The average packet time moves through the kernel stack.
Used in: ,
optional int64 count = 1
SoftIrq NET_RX action count.
optional double runtime_ms = 2
SoftIrq NET_RX action was running in millisecond.
optional double avg_runtime_ms = 3
SoftIrq NET_RX action average running time.
optional int64 mcycles = 4
CPU megacycles (i.e. cycles divided by 1e6).
optional int64 avg_freq_khz = 5
Average weighted CPU frequency by the time the NET_RX Action running at each frequency.
Used in:
optional total = 1
Total NET_TX action statistics.
repeated core = 2
Per core NET_TX action statistics.
Used in: ,
optional int64 count = 1
SoftIrq NET_TX action count.
optional double runtime_ms = 2
SoftIrq NET_TX action was running in millisecond.
optional double avg_runtime_ms = 3
SoftIrq NET_TX action average running time.
optional int64 mcycles = 4
CPU megacycles (i.e. cycles divided by 1e6).
optional int64 avg_freq_khz = 5
Average weighted CPU frequency by the time the NET_TX Action running at each frequency.
Used in: , ,
optional int64 packets = 1
Packet count.
optional int64 bytes = 2
Packet Bytes.
optional int64 first_packet_timestamp_ns = 3
Timestamp when first packet received or transmitted.
optional int64 last_packet_timestamp_ns = 4
Timestamp when last packet received or transmitted.
optional int64 interval_ns = 5
Interval between first & last packet. The minimum interval is 10ms.
optional double data_rate_kbps = 6
Data Speed.
Used in:
optional total = 1
Total packets statistic.
repeated core = 2
Per core packets statistic.
optional string gro_aggregation_ratio = 3
GRO aggregation ratio.
Used in:
optional total = 1
Total packets statistic.
repeated core = 2
Per core packets statistic.
Used in:
repeated string finalized_traces_uuid = 1
Uuids of other traces being finalized while the current trace was being recorded.
Used in:
repeated packages = 1
Used in:
optional string package_name = 1
optional int64 uid = 2
optional int64 version_code = 3
Used in:
repeated power_rails = 1
Energy data per Power Rail.
optional double avg_total_used_power_mw = 2
The average used power between the first and last sampled rail across all the rails in milliwatts (mw).
Energy data per Power Rail at given ts.
Used in:
optional int64 timestamp_ms = 1
Time since device boot(CLOCK_BOTTOMTIME) in milli-seconds.
optional double energy_uws = 2
Accumulated energy since device boot in microwatt-seconds(uws).
Used in:
optional string name = 1
Name of the rail.
repeated energy_data = 2
Energy data for given rail and for all samples in the trace.
optional double avg_used_power_mw = 3
The average used power between the first and the last sampled energy data in miliwatt (mw)
message
perfetto_merged_metrics.proto:18Used in: , , , , , , ,
optional string name = 1
Process name. Usually, cmdline or <package_name>(:<custom_name>)?.
optional int64 uid = 2
User id under which this process runs.
optional package = 7
Package that this process belongs to. If this process shares its uid (see `packages_for_uid` field), the package is determined based on the process name and package name. If there is no match this field is empty.
repeated packages_for_uid = 8
All packages using this uid. Shared uid documentation: https://developer.android.com/guide/topics/manifest/manifest-element#uid
message
perfetto_merged_metrics.proto:26Package metadata from Android package list.
Used in:
optional string package_name = 1
optional int64 apk_version_code = 2
optional bool debuggable = 3
measure max RT runtime and RT tasks running over 5ms.
Used in:
optional int64 max_runtime = 1
max runtime of RT tasks
optional int64 over_5ms_count = 2
how many RT tasks are over 5ms.
repeated longest_rt_slices = 3
information for top 10 RT tasks
Used in:
optional string tname = 1
thread name
optional int64 ts = 2
timestamp
optional int64 dur = 3
runtime of RT task
Metric that stores information related to atrace events generated by simpleperf tool
Used in:
optional double urgent_ratio = 1
repeated events = 2
Used in:
optional string name = 1
Simpleperf event name
repeated processes = 2
Metrics for each process
optional double total = 3
Total counter value over all processes and threads
Used in:
optional int32 pid = 1
Process ID
optional string name = 2
Process name
repeated threads = 3
Metrics for each thread in this process.
optional double total = 4
Total counter value over all threads in this process
Used in:
optional int32 tid = 1
Thread ID
optional string name = 2
Thread name
optional int32 cpu = 3
CPU ID
optional double total = 4
Total counter value
Android app startup metrics.
Used in:
repeated startup = 1
Used in:
optional string name = 1
optional string method = 2
optional int64 ts_method_start = 4
Used in:
optional duration = 1
optional string thread = 2
optional string destination_thread = 3
optional string destination_process = 4
optional string flags = 5
From https://cs.android.com/android/platform/superproject/+/master:external/perfetto/protos/perfetto/trace/ftrace/binder.proto;l=15;drc=7b6a788162a30802f4c9d8d7a30a54e25edd30f1
optional string code = 6
From https://cs.android.com/android/platform/superproject/+/master:external/perfetto/protos/perfetto/trace/ftrace/binder.proto;l=14;drc=7b6a788162a30802f4c9d8d7a30a54e25edd30f1
optional int64 data_size = 7
From https://cs.android.com/android/platform/superproject/+/master:external/perfetto/protos/perfetto/trace/ftrace/binder.proto;l=37;drc=7b6a788162a30802f4c9d8d7a30a54e25edd30f1
Contains timestamps of important events which occurred during the startup.
Used in:
optional int64 intent_received = 1
optional int64 first_frame = 2
Metrics about startup which were developed by looking at experiments using high-speed cameras (HSC).
Used in:
optional full_startup = 1
The duration of the full "startup" as defined by HSC tests.
Used in:
optional int64 little = 1
optional int64 big = 2
optional int64 bigger = 3
optional int64 unknown = 4
Metrics with information about the status of odex files and the outcome of the loading process. Multiple files might be loaded for a single startup. Platform might also decide to discard an odex file and instead load a fallback, for example in case the OS or apk were updated.
Used in:
optional string odex_status = 1
optional string compilation_filter = 2
optional string compilation_reason = 3
optional string location = 4
Used in: , , ,
optional int64 dur_ns = 1
optional double dur_ms = 2
Next id: 18
Used in:
optional uint32 startup_id = 1
Random id uniquely identifying an app startup in this trace.
optional string startup_type = 16
Startup type (cold / warm / hot)
optional string package_name = 2
Name of the package launched
optional string process_name = 3
Name of the process launched
repeated activities = 11
Details about the activities launched
repeated long_binder_transactions = 14
Details about slow binder transactions during the startup. The definition of a slow transaction is an implementation detail.
optional bool zygote_new_process = 4
Did we ask the zygote for a new process
optional uint32 activity_hosting_process_count = 6
Number of processes hosting the activity involved in the launch. This will usually be 1. If it is 0, it is indicative of a data / process error. If > 1, the process died during startup and the system respawned it.
optional event_timestamps = 13
Contains timestamps of important events which happened during the startup.
optional to_first_frame = 5
Timing information spanning the intent received by the activity manager to the first frame drawn.
optional process = 7
Details about the process (uid, version, etc)
optional hsc = 8
Metrics about startup which were developed by looking at experiments using high-speed cameras (HSC).
optional report_fully_drawn = 9
The time taken in the startup from intent received to the start time of the reportFullyDrawn slice. This should be longer than the time to first frame as the application decides this after it starts rendering.
repeated optimization_status = 12
Contains information about the status of odex files.
optional system_state = 15
Contains information about the state of the rest of the system during the startup. This is useful for getting context about why a startup might be slow beyond just what the app is doing.
repeated string slow_start_reason = 17
A list of identified potential causes for slow startup. Optional.
Contains information about the state of a system during the app startup. Useful to put the startup in context.
Used in:
optional bool dex2oat_running = 1
Whether the dex2oat64 process was running concurrent to the startup.
optional bool installd_running = 2
Whether the installd process was running concurrent to the startup.
optional int64 broadcast_dispatched_count = 3
The number of broadcasts dispatched by the system during the app launch.
optional int64 broadcast_received_count = 4
The number of broadcasts received by an app or the system during the app launch. Note that multiple packages can be subscribed to the same broadcast so a single dsipatch can cause multiple packages to receive and process a broadcast.
repeated string most_active_non_launch_processes = 5
The most active (i.e. consuming the most mcycles) processes during the app launch excluding the process(es) being launched. Note: the exact number of returned is an implementation detail and will likely change over time.
A simplified view of the task state durations for a thread and a span of time.
Used in:
optional int64 running_dur_ns = 1
optional int64 runnable_dur_ns = 2
optional int64 uninterruptible_sleep_dur_ns = 3
optional int64 interruptible_sleep_dur_ns = 4
Timing information spanning the intent received by the activity manager to the first frame drawn. Next id: 33.
Used in:
optional int64 dur_ns = 1
The duration between the intent received and first frame.
optional double dur_ms = 17
optional main_thread_by_task_state = 2
Breakdown of time to first frame by task state for the main thread of the process starting up.
optional mcycles_by_core_type = 26
The mcycles taken by this startup across all CPUs (broken down by core type).
optional uint32 other_processes_spawned_count = 3
In this timespan, how many processes (apart from the main activity) were spawned.
optional time_activity_manager = 4
Total time spent in activity manager between the initial intent and the end of the activity starter.
optional time_activity_thread_main = 5
The following slices follow the typical steps post-fork.
optional time_bind_application = 6
optional time_activity_start = 7
optional time_activity_resume = 8
optional time_activity_restart = 21
optional time_choreographer = 9
optional time_inflate = 22
optional time_get_resources = 23
optional time_before_start_process = 10
If we are starting a new process, record the duration from the intent being received to the time we call the zygote.
optional time_during_start_process = 11
The actual duration of the process start (based on the zygote slice).
optional to_post_fork = 18
optional to_activity_thread_main = 19
optional to_bind_application = 20
optional time_post_fork = 16
optional time_dex_open = 24
The total time spent on opening dex files.
optional time_verify_class = 25
Total time spent verifying classes during app startup.
optional uint32 jit_compiled_methods = 27
Number of methods that were compiled by JIT during app startup.
optional time_jit_thread_pool_on_cpu = 28
Time spent running CPU on jit thread pool.
optional time_gc_total = 29
Time spent on garbage collection.
optional time_gc_on_cpu = 30
optional time_lock_contention_thread_main = 31
Time spent in lock contention on the main thread of the process being started up. This includes *all* types of lock contention not just monitor contention.
optional time_monitor_contention_thread_main = 32
Time spent in monitor lock contention on the main thread of the process being started up. This will be a subset of the time counted by |time_lock_contention_thread_main|.
Used in:
optional uint32 missed_frames = 1
Counts the number of missed frames in the trace.
optional uint32 missed_hwc_frames = 2
Counts the number of missed HWC frames in the trace.
optional uint32 missed_gpu_frames = 3
Counts the number of missed GPU frames in the trace.
optional double missed_frame_rate = 4
Calculate the number of missed frames divided by total frames
optional double missed_hwc_frame_rate = 5
Calculate the number of missed HWC frames divided by total HWC frames
optional double missed_gpu_frame_rate = 6
Calculate the number of missed GPU frames divided by total GPU frames
optional uint32 gpu_invocations = 7
Count the number of times SurfaceFlinger needs to invoke GPU for rendering some layers
optional double avg_gpu_waiting_dur_ms = 8
Calculate the average duration of GPU request by SurfaceFlinger since it enters the FenceMonitor's queue until it gets completed
optional double total_non_empty_gpu_waiting_dur_ms = 9
Calculate the total duration when there is at least one GPU request by SurfaceFlinger that is still waiting for GPU to complete the request. This also equals to the total duration of "waiting for GPU completion <fence_num>" in SurfaceFlinger.
Metric that stores frame information and potential jank root causes for a single Android system UI interaction/user journey.
Used in:
repeated frames = 1
A list of all frames within the SysUi user journey.
optional string cuj_name = 2
optional int64 cuj_start = 3
optional int64 cuj_dur = 4
optional process = 5
Details about the process (uid, version, etc)
Used in:
optional int64 number = 1
Index of the frame within the single user journey.
optional int64 vsync = 5
optional int64 ts = 2
optional int64 dur = 3
repeated string jank_cause = 4
A list of identified potential causes for jank. Optional.
Used in:
repeated process = 1
Used in:
optional int64 pid = 1
optional string process_name = 2
Process name.
repeated string thread_name = 3
Names of all threads for this process.
optional int64 uid = 4
User id under which this process runs.
repeated string uid_package_name = 5
Packages matching the process uid.
Metric which checks the data in the trace processor tables is "reasonble" (i.e. we would expect to see it from a real device). This is useful to reject traces which may be valid (so no stat would be recorded) but a human would find the trace nonsensical.
Used in:
repeated failures = 1
Used in:
optional string name = 1
The name of the failed check.
message
perfetto_merged_metrics.proto:85Metric used to generate a simplified view of the Trusty kworker events.
Used in:
(message has no fields)
message
trace_processor.proto:134Used in:
optional int64 total_bytes_parsed = 1
optional string error = 2
message
trace_processor.proto:226Input for the /compute_metric endpoint.
Used in:
repeated string metric_names = 1
optional ComputeMetricArgs.ResultFormat format = 2
Used in:
BINARY_PROTOBUF = 0
TEXTPROTO = 1
message
trace_processor.proto:236Output for the /compute_metric endpoint.
Used in:
oneof result
bytes metrics = 1
This is meant to contain a perfetto.protos.TraceMetrics. We're using bytes instead of the actual type because we do not want to generate protozero code for the metrics protos. We always encode/decode metrics using a reflection based mechanism that does not require the compiled C++ code. This allows us to read in new protos at runtime.
string metrics_as_prototext = 3
A perfetto.protos.TraceMetrics formatted as prototext.
optional string error = 2
message
descriptor.proto:55Describes a message type.
Used in: ,
optional string name = 1
repeated field = 2
repeated extension = 6
repeated nested_type = 3
repeated enum_type = 4
repeated oneof_decl = 8
repeated reserved_range = 9
repeated string reserved_name = 10
Reserved field names, which may not be used by fields in the same message. A given name may only be reserved once.
message
descriptor.proto:73Range of reserved tag numbers. Reserved tag numbers may not be used by fields or extension ranges in the same message. Reserved ranges may not overlap.
Used in:
optional int32 start = 1
Inclusive.
optional int32 end = 2
Exclusive.
message
trace_processor.proto:271Convenience wrapper for multiple descriptors, similar to FileDescriptorSet in descriptor.proto.
Used in:
repeated descriptors = 1
message
trace_processor.proto:259Input for the /disable_and_read_metatrace endpoint.
(message has no fields)
message
trace_processor.proto:262Output for the /disable_and_read_metatrace endpoint.
Used in:
optional bytes metatrace = 1
Bytes of perfetto.protos.Trace message. Stored as bytes to avoid adding a dependency on trace.proto.
optional string error = 2
message
trace_processor.proto:253Input for the /enable_metatrace endpoint.
(message has no fields)
message
trace_processor.proto:256Output for the /enable_metatrace endpoint.
(message has no fields)
message
descriptor.proto:172Describes an enum type.
Used in: ,
optional string name = 1
repeated value = 2
repeated string reserved_name = 5
Reserved enum value names, which may not be reused. A given name may only be reserved once.
message
descriptor.proto:186Describes a value within an enum.
Used in:
optional string name = 1
optional int32 number = 2
message
descriptor.proto:86Describes a field within a message.
Used in: ,
optional string name = 1
optional int32 number = 3
optional FieldDescriptorProto.Label label = 4
optional FieldDescriptorProto.Type type = 5
If type_name is set, this need not be set. If both this and type_name are set, this must be one of TYPE_ENUM, TYPE_MESSAGE or TYPE_GROUP.
optional string type_name = 6
For message and enum types, this is the name of the type. If the name starts with a '.', it is fully-qualified. Otherwise, C++-like scoping rules are used to find the type (i.e. first the nested types within this message are searched, then within the parent, on up to the root namespace).
optional string extendee = 2
For extensions, this is the name of the type being extended. It is resolved in the same manner as type_name.
optional string default_value = 7
For numeric types, contains the original text representation of the value. For booleans, "true" or "false". For strings, contains the default text contents (not escaped in any way). For bytes, contains the C escaped value. All bytes >= 128 are escaped. TODO(kenton): Base-64 encode?
optional int32 oneof_index = 9
If set, gives the index of a oneof in the containing type's oneof_decl list. This field is a member of that oneof.
Used in:
LABEL_OPTIONAL = 1
0 is reserved for errors
LABEL_REQUIRED = 2
LABEL_REPEATED = 3
Used in:
TYPE_DOUBLE = 1
0 is reserved for errors. Order is weird for historical reasons.
TYPE_FLOAT = 2
TYPE_INT64 = 3
Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT64 if negative values are likely.
TYPE_UINT64 = 4
TYPE_INT32 = 5
Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT32 if negative values are likely.
TYPE_FIXED64 = 6
TYPE_FIXED32 = 7
TYPE_BOOL = 8
TYPE_STRING = 9
TYPE_GROUP = 10
Tag-delimited aggregate. Group type is deprecated and not supported in proto3. However, Proto3 implementations should still be able to parse the group wire format and treat group fields as unknown fields.
TYPE_MESSAGE = 11
Length-delimited aggregate.
TYPE_BYTES = 12
New in version 2.
TYPE_UINT32 = 13
TYPE_ENUM = 14
TYPE_SFIXED32 = 15
TYPE_SFIXED64 = 16
TYPE_SINT32 = 17
Uses ZigZag encoding.
TYPE_SINT64 = 18
Uses ZigZag encoding.
message
descriptor.proto:29Describes a complete .proto file.
Used in:
optional string name = 1
file name, relative to root of source tree
optional string package = 2
e.g. "foo", "foo.bar", etc.
repeated string dependency = 3
Names of files imported by this file.
repeated int32 public_dependency = 10
Indexes of the public imported files in the dependency list above.
repeated int32 weak_dependency = 11
Indexes of the weak imported files in the dependency list. For Google-internal migration only. Do not use.
repeated message_type = 4
All top-level definitions in this file.
repeated enum_type = 5
repeated extension = 7
message
descriptor.proto:24The protocol compiler can output a FileDescriptorSet containing the .proto files it parses.
repeated file = 1
Used in:
optional g2d_hw = 1
optional g2d_sw = 2
Used in:
optional string name = 1
G2d name.
optional uint32 frame_count = 5
optional uint32 error_count = 6
optional double max_dur_ms = 7
optional double min_dur_ms = 8
optional double avg_dur_ms = 9
Used in:
repeated instances = 1
G2D Metric for each G2D Instance.
optional uint32 frame_count = 5
the number of frames processed by G2D
optional uint32 error_count = 6
the number of error events
optional double max_dur_ms = 7
max/min/avg G2d frame durations for all instances.
optional double min_dur_ms = 8
optional double avg_dur_ms = 9
Used in:
repeated instance_stats = 1
Heap stats per process. One sample per dump (with continuous dump you can have more samples differentiated by ts).
Used in:
optional uint32 upid = 1
optional process = 2
repeated samples = 3
Used in:
optional int64 ts = 1
repeated type_count = 2
Next id: 9
Used in:
optional string type_name = 1
optional string category = 4
optional uint32 obj_count = 2
optional uint32 reachable_obj_count = 3
optional uint32 size_kb = 5
optional uint32 reachable_size_kb = 6
optional uint32 native_size_kb = 7
optional uint32 reachable_native_size_kb = 8
Used in:
repeated instance_stats = 1
Used in:
optional string root_type = 1
optional string type_name = 2
optional int64 obj_count = 3
Heap stats per process. One sample per dump (can be > 1 if continuous dump is enabled).
Used in:
optional uint32 upid = 1
optional process = 2
repeated samples = 3
Next id: 10
Used in:
optional int64 ts = 1
optional int64 heap_size = 2
Size of the Java heap in bytes
optional int64 heap_native_size = 8
Native size of all the objects (not included in heap_size)
optional int64 obj_count = 4
optional int64 reachable_heap_size = 3
Size of the reachable objects in bytes.
optional int64 reachable_heap_native_size = 9
Native size of all the reachable objects (not included in reachable_heap_size)
optional int64 reachable_obj_count = 5
optional int64 anon_rss_and_swap_size = 6
Sum of anonymous RSS + swap pages in bytes.
repeated roots = 7
ART root objects
message
descriptor.proto:166Describes a oneof.
Used in:
optional string name = 1
optional options = 2
message
descriptor.proto:193Used in:
(message has no fields)
Android HWUI graphics performance and graphics memory usage metrics.
Used in:
optional string process_name = 1
Name of the package launched
optional int64 rt_cpu_time_ms = 2
CPU time spent on RenderThread in milliseconds.
optional uint32 draw_frame_count = 3
Number of frames drawn on RenderThread, followed by max/min/avg CPU time to draw a frame in nanoseconds.
optional int64 draw_frame_max = 4
optional int64 draw_frame_min = 5
optional double draw_frame_avg = 6
optional uint32 flush_count = 7
Number of GPU commands flushes and max/min/avg time per flush in nanoseconds.
optional int64 flush_max = 8
optional int64 flush_min = 9
optional double flush_avg = 10
optional uint32 prepare_tree_count = 11
Number of View tree preparation counts and max/min/avg time to traverse the tree in nanoseconds.
optional int64 prepare_tree_max = 12
optional int64 prepare_tree_min = 13
optional double prepare_tree_avg = 14
optional uint32 gpu_completion_count = 15
Number of times the GPU rendered a frame and max/min/avg time for GPU to finish rendering in in nanoseconds.
optional int64 gpu_completion_max = 16
optional int64 gpu_completion_min = 17
optional double gpu_completion_avg = 18
optional uint32 ui_record_count = 19
Number of times a frame was recorded/serialized in a display list on the UI thread with max/min/avg time in nanoseconds.
optional int64 ui_record_max = 20
optional int64 ui_record_min = 21
optional double ui_record_avg = 22
optional uint32 shader_compile_count = 23
number of unique shader programs that were used to render frames, followed by total and average times to prepare a shader in nanoseconds.
optional int64 shader_compile_time = 24
optional double shader_compile_avg = 25
optional uint32 cache_hit_count = 26
number of shader programs loaded from the disk cache, followed by total time and average time to prepare a shader in nanoseconds.
optional int64 cache_hit_time = 27
optional double cache_hit_avg = 28
optional uint32 cache_miss_count = 29
number of shader programs compiled/linked, followed by total time and average time to prepare a shader in nanoseconds.
optional int64 cache_miss_time = 30
optional double cache_miss_avg = 31
optional int64 graphics_cpu_mem_max = 32
max/min/avg CPU memory used for graphics by HWUI at the end of a frame.
optional int64 graphics_cpu_mem_min = 33
optional double graphics_cpu_mem_avg = 34
optional int64 graphics_gpu_mem_max = 35
max/min/avg GPU memory used by HWUI at the end of a frame excluding textures.
optional int64 graphics_gpu_mem_min = 36
optional double graphics_gpu_mem_avg = 37
optional int64 texture_mem_max = 38
max/min/avg memory used for GPU textures by HWUI at the end of a frame.
optional int64 texture_mem_min = 39
optional double texture_mem_avg = 40
optional int64 all_mem_max = 41
max/min/avg memory used by HWUI at the end of a frame. This is a sum of previous 3 categories.
optional int64 all_mem_min = 42
optional double all_mem_avg = 43
Used in:
repeated instance = 1
Used in:
optional process = 1
repeated mappings = 2
Used in:
optional string path = 1
optional int32 size_kb = 2
optional int32 private_dirty_kb = 3
optional int32 swap_kb = 4
message
trace_processor.proto:139Used in:
optional string sql_query = 1
message
trace_processor.proto:155Output for the /query endpoint. Returns a query result set, grouping cells into batches. Batching allows a more efficient encoding of results, at the same time allowing to return O(M) results in a pipelined fashion, without full-memory buffering. Batches are split when either a large number of cells (~thousands) is reached or the string/blob payload becomes too large (~hundreds of KB). Data is batched in cells, scanning results by row -> column. e.g. if a query returns 3 columns and 2 rows, the cells will be emitted in this order: R0C0, R0C1, R0C2, R1C0, R1C1, R1C2.
Used in:
repeated string column_names = 1
This determines the number and names of columns.
optional string error = 2
If non-emty the query returned an error. Note that some cells might still be present, if the error happened while iterating.
repeated batch = 3
optional uint32 statement_count = 4
The number of statements in the provided SQL.
optional uint32 statement_with_output_count = 5
The number of statements which produced output rows in the provided SQL.
message
trace_processor.proto:169A batch contains an array of cell headers, stating the type of each cell. The payload of each cell is stored in the corresponding xxx_cells field below (unless the cell is NULL). So if |cells| contains: [VARINT, FLOAT64, VARINT, STRING], the results will be available as: [varint_cells[0], float64_cells[0], varint_cells[1], string_cells[0]].
Used in:
repeated CellsBatch.CellType cells = 1
repeated int64 varint_cells = 2
repeated double float64_cells = 3
repeated bytes blob_cells = 4
optional string string_cells = 5
The string cells are concatenated in a single field. Each cell is NUL-terminated. This is because JS incurs into a non-negligible overhead when decoding strings and one decode + split('\0') is measurably faster than decoding N strings. See goto.google.com/postmessage-benchmark .
optional bool is_last_batch = 6
If true this is the last batch for the query result.
Used in:
CELL_INVALID = 0
CELL_NULL = 1
CELL_VARINT = 2
CELL_FLOAT64 = 3
CELL_STRING = 4
CELL_BLOB = 5
message
trace_processor.proto:206Input for the /status endpoint.
(message has no fields)
message
trace_processor.proto:209Output for the /status endpoint.
Used in:
optional string loaded_trace_name = 1
If present and not empty, a trace is already loaded already. This happens when using the HTTP+RPC mode nad passing a trace file to the shell, via trace_processor_shell -D trace_file.pftrace .
optional string human_readable_version = 2
Typically something like "v11.0.123", but could be just "v11" or "unknown", for binaries built from Bazel or other build configurations. This is for human presentation only, don't attempt to parse and reason on it.
optional int32 api_version = 3
The API version is incremented every time a change that the UI depends on is introduced (e.g. adding a new table that the UI queries).
Stats counters for the trace. Defined in src/trace_processor/storage/stats.h
Used in:
repeated stat = 1
Used in:
SEVERITY_UNKNOWN = 0
SEVERITY_INFO = 1
SEVERITY_DATA_LOSS = 2
SEVERITY_ERROR = 3
Used in:
SOURCE_UNKNOWN = 0
SOURCE_TRACE = 1
SOURCE_ANALYSIS = 2
Used in:
optional string name = 1
optional uint32 idx = 2
optional Severity severity = 3
optional Source source = 4
optional int64 count = 5
Trace processor metadata
Used in:
optional int64 trace_duration_ns = 2
optional string trace_uuid = 3
optional string android_build_fingerprint = 4
optional int64 statsd_triggering_subscription_id = 5
optional int64 trace_size_bytes = 6
repeated string trace_trigger = 7
optional string unique_session_name = 8
optional string trace_config_pbtxt = 9
optional int64 sched_duration_ns = 10
Root message for all Perfetto-based metrics. Next id: 49
optional android_batt = 5
Battery counters metric on Android.
optional android_cpu = 6
CPU usage per trace, process and thread.
optional android_mem = 1
Memory metrics on Android (owned by the Android Telemetry team).
optional android_mem_unagg = 11
Memory metrics on Android in unaggregated form. (owned by the Android Telemetry team). Note: this generates a lot of data so should not be requested unless it is clear that this data is necessary.
optional android_package_list = 12
Package list.
optional android_ion = 9
ion buffer memory metrics.
optional android_fastrpc = 31
fastrpc subsystem memory metrics.
optional android_lmk = 8
Statistics about low memory kills.
optional android_powrails = 7
Power Rails metrics on Android.
optional android_startup = 2
Startup metrics on Android (owned by the Android Telemetry team).
optional trace_metadata = 3
Trace metadata (applicable to all traces).
optional trace_stats = 33
Trace stats (applicable to all traces).
optional unsymbolized_frames = 15
Returns stack frames missing symbols.
optional java_heap_stats = 17
If the trace contains a heap graph, output allocation statistics.
optional java_heap_histogram = 21
If the trace contains a heap graph, output histogram.
optional android_lmk_reason = 18
Metrics used to find potential culprits of low-memory kills.
optional android_hwui_metric = 20
optional display_metrics = 22
optional android_task_names = 23
optional android_surfaceflinger = 25
Metric associated with surfaceflinger.
optional android_gpu = 26
GPU metrics on Android.
optional android_sysui_cuj = 27
Frame timing and jank root causes for system UI interactions.
optional android_jank_cuj = 48
Interaction and frame timings for CUJs (important UI transitions).
optional android_hwcomposer = 28
Metric associated with hwcomposer.
optional g2d = 30
G2D metrics.
optional android_dma_heap = 32
Dmabuf heap metrics.
optional android_trace_quality = 34
Metric to verify the quality of the trace.
optional profiler_smaps = 35
Profiler smaps
optional android_multiuser = 36
Multiuser - metrics for switching users.
optional android_simpleperf = 37
Metrics related to simpleperf tool
optional android_camera = 38
Metrics for the Camera team.
optional android_dvfs = 39
Metrics for dynamic voltage and frequency scaling.
optional android_netperf = 40
Metrics for network performance.
optional android_camera_unagg = 41
Metrics for the Camera team. Note: this generates a lot of data so should not be requested unless it is clear that this data is necessary.
optional android_rt_runtime = 42
Metrics for RT runtime.
optional android_irq_runtime = 43
Metrics for IRQ runtime.
optional android_trusty_workqueues = 44
Metrics for the Trusty team.
optional android_other_traces = 45
Summary of other concurrent trace recording.
optional android_binder = 46
Per-process Binder transaction metrics.
optional android_frame_timeline_metric = 47
Metrics for app deadline missed.
TRACE_PROCESSOR_CURRENT_API_VERSION = 5
This variable has been introduced in v15 and is used to deal with API mismatches between UI and trace_processor_shell --httpd. Increment this every time a new feature that the UI depends on is being introduced (e.g. new tables, new SQL operators, metrics that are required by the UI). See also StatusResult.api_version (below).
message
trace_processor.proto:57Used in:
optional int64 seq = 1
A monotonic counter used only for debugging purposes, to detect if the underlying stream is missing or duping data. The counter starts at 0 on each side of the pipe and is incremented on each message. Do NOT expect that a response has the same |seq| of its corresponding request: some requests (e.g., a query returning many rows) can yield more than one response message, bringing the tx and rq seq our of sync.
optional string fatal_error = 5
This is returned when some unrecoverable error has been detected by the peer. The typical case is TraceProcessor detecting that the |seq| sequence is broken (e.g. when having two tabs open with the same --httpd instance).
oneof type
TraceProcessorRpc.TraceProcessorMethod request = 2
Client -> TraceProcessor requests.
TraceProcessorRpc.TraceProcessorMethod response = 3
TraceProcessor -> Client responses.
TraceProcessorRpc.TraceProcessorMethod invalid_request = 4
This is sent back instead of filling |response| when the client sends a |request| which is not known by the TraceProcessor service. This can happen when the client is newer than the service.
oneof args
TraceProcessorMethod request args.
bytes append_trace_data = 101
For TPM_APPEND_TRACE_DATA.
query_args = 103
For TPM_QUERY_STREAMING.
compute_metric_args = 105
For TPM_COMPUTE_METRIC.
append_result = 201
TraceProcessorMethod response args. For TPM_APPEND_TRACE_DATA.
query_result = 203
For TPM_QUERY_STREAMING.
metric_result = 205
For TPM_COMPUTE_METRIC.
metric_descriptors = 206
For TPM_GET_METRIC_DESCRIPTORS.
metatrace = 209
For TPM_DISABLE_AND_READ_METATRACE.
status = 210
For TPM_GET_STATUS.
Used in:
TPM_UNSPECIFIED = 0
TPM_APPEND_TRACE_DATA = 1
TPM_FINALIZE_TRACE_DATA = 2
TPM_QUERY_STREAMING = 3
TPM_COMPUTE_METRIC = 5
TPM_GET_METRIC_DESCRIPTORS = 6
TPM_RESTORE_INITIAL_TABLES = 7
TPM_ENABLE_METATRACE = 8
TPM_DISABLE_AND_READ_METATRACE = 9
TPM_GET_STATUS = 10
message
trace_processor.proto:53repeated msg = 1
Used in:
repeated frames = 1
Used in:
optional string module = 1
optional string build_id = 2
optional int64 address = 3
optional string google_lookup_id = 4
In some cases (Chrome/Webview) the ID that should be used to query symbols in Google's internal tera-scale symbolization service is != `build_id` and requires some mangling. This field is == 'build_id` for non-chromium cases, and is the breakpad module ID (with lowercase hex digics) for chromium cases.