1Unreleased: 2 Tracing service and probes: 3 * 4 Trace Processor: 5 * 6 UI: 7 * 8 SDK: 9 * 10 11 12v15.0 - 2021-05-05: 13 Tracing service and probes: 14 * Added support for {host,target}=aarch64 standalone builds. 15 * Added --background cmdline switch to traced and traced_probes services. 16 * Changed trigger_perfetto to ignore unknown command line arguments to 17 preserve forward compatibility. 18 * Added -a / --app cmdline argument to tools/record_android_trace. 19 Trace Processor: 20 * Added sanitisation of keys in nested debug annotation dictionaries. 21 * Changed Android startup metric: count CPU time of JIT thread pool, report 22 timestamp of activities during startup. 23 * Changed android_surfaceflinger metric, added missed frame counters. 24 * Changed version of SQLite to 3.35.4. 25 * Fixed importing of JSON traces with decimal (sub-us) timestamp. 26 * Fixed prepending "debug." prefix to debug annotations with non-interned 27 names. 28 UI: 29 * Added support to visualize the lifetime of individual dmabuf allocations 30 as async slices (datasource: already existing ftrace dmabuf event). 31 * Fixed visualization of unfinished slices to extend to the end of the 32 viewport. 33 SDK: 34 * Added support for passing arbitrary number of debug annotations to 35 TRACE_EVENT and combining them with lambdas. 36 * Added support for writing typed TrackEvent arguments using TRACE_EVENT 37 inline without lambdas. 38 * Changed ConvertTimestampToTraceTimeNs to be a member of 39 TraceTimestampTraits<T> struct instead of a standalone function. 40 * Changed TracedValue to use nested DebugAnnotation proto instead of 41 DebugAnnotation::NestedValue. 42 43 44v14.0 - 2021-04-01: 45 Tracing service and probes: 46 * Added support for polling power rails on Android from the newer 47 IPowerStats AIDL interface (previously using only the HAL interface). 48 * Fixed native heap profiler crash when ABI of heapprofd and profiled 49 process mismatch. 50 * Changed encoding format of Anroid managed heap profiler to reduce heap 51 dump sizes by delta-encoding object IDs. 52 Trace Processor: 53 * Added activity create/resume, layout inflation and resource timings to 54 the Android startup metric. 55 * Added chrome metadata key/value pairs (e.g. chrome version) into the 56 `metadata` table with 'cr-' prefixed keys. 57 * Added dma-buf-based memory metrics reporting total/avg/min/max dmabuf 58 allocation per-dmabuf-heap and per-process. 59 * Removed |force_full_sort| flag from config. This has been replaced 60 by setting the sorting mode to force a full sort. 61 UI: 62 * Added tools/symbolize-ui-crash script to resolve crash reports via 63 TypeScript source maps. 64 * Fixed newlines when copying Android event log lines into the clipboard. 65 * Fixed crash when selecting "Did not finish" slices. 66 * Fixed OOM dialog to give actionable instructions when opening large traces 67 rather than suggesting to file a bug. 68 SDK: 69 * Added /meson.build for bundling /sdk/perfetto.{cc,h} in Meson builds. 70 * Added support for counter trace points with the TRACE_COUNTER macro. 71 72 73v13.0 - 2021-03-01: 74 Tracing service and probes: 75 * Added ability to sample callstacks using kernel tracepoints as timebase. 76 * Added abililty to record the perf timebase counter values into the trace, 77 both combined callstack+counter or counter-only. 78 * Added abillity to trigger traces based on VM pressure on Android. Requires 79 a dedicated tracing instance in $tracefs/instances/mm_events. 80 Trace Processor: 81 * Added sorting mode to trace processor config to specify how trace 82 processor should sort events. The |force_full_sort| flag has been 83 deprecated (with replacement) and will be removed in the next version. 84 * Added ingestion of frame timeline events into the 85 {expected,actual}_frame_timeline_slice tables. 86 * Added support for Mali's trace_marker_write ftrace event. 87 * Added memory metric based on newer android_fastrpc kernel events. 88 UI: 89 * Added flow events support for instant events and async tracks. 90 * Added support for Android frame timeline events. They allow inspecting 91 end-to-end expected vs actual app-to-surfaceflinger frame times. 92 * Added ability to switch between Canary and Stable channels in the UI. 93 * Added ability to drag&drop to open trace files. 94 * Changed UI serving infrastructure, old ui versions can be now retrieved by 95 directly opening https://ui.perfetto.dev/v12.1.269/ . 96 * Removed thread state track for threads that have no activity. 97 SDK: 98 * Use process start time hashed with the process id as a unique process 99 identifier, allowing multiple independent users of the SDK in the same 100 process to interleave their events on shared tracks. 101 * Record process and thread names into the trace. 102 * Add ring buffer tracing support, i.e., periodic clearing of incremental 103 state. 104 Misc: 105 * Convert python scripts to python3. 106 107 108v12.1 - 2021-02-01: 109 Misc: 110 * Fixed CHANGELOG which was missed in the 12.0 branch cut, causing 111 mis-labeling of the version code in the v12.x branch as v11.0..N 112 113 114v12.0 - 2021-02-01: 115 Tracing service and probes: 116 * Added more helpful error messages if the client library is used without 117 having been initialized. 118 * Added //tools/record_android_trace script to facilitate recording traces 119 from Android devices, automating start + stop-via-ctrl+c + pull + open. 120 * Added auto-attachment of traces to Android bugreports if dumpstate is 121 invoked when a trace with bugreport_score > 0 is running. 122 SDK: 123 * Added ability to customize the timestamp of events via 124 ConvertTimestampToTraceTimeNs(). 125 * Fixed support for category names that contain a space. 126 Trace Processor: 127 * Added ingestion and query support for Android end-to-end frame timing 128 events through the {actual, expected}_frame_timeline_slice tables. 129 * Added time-to-reportFullyDrawn (Android's API) to startup metrics. 130 * Fixed excessive memory usage when decoding traces containing callstacks 131 (https://github.com/google/perfetto/issues/83). 132 UI: 133 * Added ability to inspect the full trace config string from the 134 'Info and stats' page. 135 * Fixed 'TABLE/VIEW XXX already exists' in the Metrics page when running the 136 same metric twice. 137 * Fixed sorting of tracks using numeric sorting instead of lexicographic: 138 Thread {1, 2, 10, 11, 20} rather than Thread {1, 10, 11, 2, 20}. 139 * Fixed CSP-related bug that was preventing the UI to work on Firefox. 140 * Changed max zoom resolution to allow to zoom to sub-us events. 141 142 143v11.0 - 2021-01-01: 144 Tracing service and probes: 145 * Added trace packet interceptor API for rerouting trace data into 146 non-Perfetto systems. 147 * Added support for printing track events to the console. 148 * Added a way to observe track event tracing sessions starting and 149 stopping. 150 Trace Processor: 151 * Added "ancestor_slice" and "experimental_ancestor_stack_profile_callsite" 152 table functions to look up ancestors of CPU stack samples in profiler 153 tables. 154 * Added power metric reporting suspend/resume time periods. 155 UI: 156 * Fixed CPU time calculation in example queries. 157 * Added tracks to debug Android SystemUI jank. 158 159 160v10.0 - 2020-12-01: 161 Tracing service and probes: 162 * Fixed crash of tracing service if a client is unresponsive on the IPC 163 channel. Clients are disconnected if they don't respond to IPCs for 10s. 164 * Added cmdline arguments for integration within ChromeOS system image 165 (--{producer,consumer}-socket-{group,mode} for chmod-ing sockets). 166 * Changed path lookup logic for traced socket. /run/perfetto/ is used if the 167 directory exists, falling back on /tmp/ otherwise. 168 * Added support for kernel frame symbolization to the traced_perf callstack 169 sampler. 170 * Added support for resolving ftrace event arguments that require 171 symbolization against printk_format. 172 Trace Processor: 173 * Added .read command to inject a SQL query file, similar to the -q cmdline. 174 * Added trace-based metrics to root cause jank in Android System UI. 175 * Added symbolization support for ELF files on Windows for heap and 176 callstack profilers. 177 * Added support for symbolizing names of workqueue ftrace events. 178 * Improved Android startup metric with activity restart time. 179 UI: 180 * Added support for navigating flows with Ctrl+[ / Ctr+]. 181 * Improved query result panel, moved to the bottom group allowing 182 simultaneous query result and timeline views. 183 * Fixed data corruption when recording traces via the WebUSB-based Record 184 page in the UI. 185 186 187v9.0 - 2020-11-01: 188 Tracing service and probes: 189 * Added support for recording traces from a system service through the 190 client API. 191 * The client library now reconnects producers automatically if the 192 connection to the tracing service is lost. Also fixed crashes in ongoing 193 tracing sessions when a disconnect occurs. 194 * Added support for dpu and g2d ftrace events. 195 * Enabled commit batching and producer side patching of chunks. 196 * Add support for symbolizing kernel symbols for ftrace events. 197 Trace Processor: 198 * Fixed type affinity of string columns. 199 UI: 200 * Added initial support for running metrics from the UI. 201 * Added support for displaying all flows when a slice or area is selected. 202 * Highlight nodes that match the 'focus' string in the flamegraph. 203 * Added search within slice args. 204 * Fixed details panel height and moved query panel into details panel. 205 * Enabled re-sharing of postMessage traces by echoing back the original URL. 206 * Improved record page error messages. 207 208 209v8.0 - 2020-10-01: 210 Tracing service and probes: 211 * Added API for querying registered data sources and their capabilities. 212 * Added support for profiling heap allocations on Linux via LD_PRELOAD. 213 * Fixed possible race when initializing the consumer library. 214 * Fixed subtle bugs on systems with 16KB system pages. 215 Trace Processor: 216 * Added a table which lists available metrics. 217 * Added Python bindings on PyPi in the 'perfetto' package. 218 * Added support for running trace_processor_shell on Android. 219 * Added per-process metrics for GPU memory usage. 220 * Added support for exporting flow events to JSON. 221 * Added dynamic tables for navigating between slices of flows. 222 UI: 223 * Changed time marking: horizontal selection doesn't gray out anymore, 224 pressing 'm' marks the range. 225 * Added initial support for displaying flow event arrows. 226 * Improved ordering of all thread tracks under process grouping. 227 * Fixed UI crashes due to metric errors 228 * Fixed selection of thread state slices. 229 230 231v7.0 - 2020-09-01: 232 Tracing service and probes: 233 * Added auto-reconnection to the SDK. Tracing::Initialize() now retries in 234 the background, instead of failing, if the tracing service is unrechable. 235 * Added support for recording cpuhp (CPU hotplug) ftrace events. 236 * Fixed heap profiling unwinding on multi-ABI systems. 237 * Fixed reporting of live objects in the native heap profiler when using 238 --dump-at-max. 239 * Fixed crash when writing trace events with field nesting level > 10. 240 Trace Processor: 241 * Added Python bindings, see 242 https://perfetto.dev/docs/analysis/trace-processor#python-api . 243 * Added ingestion for Chrome instant events and Chrome flow events. 244 * Added ingestion for Android GPU memory events and sched_blocked_reason. 245 * Added WebView power metric. 246 * Added support for WSL1 where Async I/O is not available. 247 * Improved detection of Android suspend/resume events. 248 UI: 249 * Added GPU memory recording controls and ingestion code. Requires a recent 250 Android 12+ kernel. 251 * Added details panel for flow events, showed when the user selects a slice 252 involved in a flow (arrows in the UI are still being worked on). 253 * Added instant events rendering. 254 * Added Google Analytics. 255 * Fixed I/O thread-states in 4.14 kernels to deal with the removal of 256 wake-kill using sched_blocked_reason. 257 * Fixed "Perfetto UI started debugging this browser" showing when opening 258 the UI and the Chrome extension is installed. 259 Misc: 260 * Update language to comply with Android's inclusive language guidance. 261 262 263v6.0 - 2020-08-01: 264 Tracing service and probes: 265 * Added ftrace thermal events. 266 * Added support for custom allocators to the heap profiler. Allows 267 developers to report memory allocations that are not done through malloc. 268 * Added detailed timestamping of key tracing session events. 269 * Added support for building tracing services on CrOS (system-wide tracing). 270 * Fixed filtering out of stale ftrace data that predates the beginning of 271 the tracing session. 272 Trace Processor: 273 * Improved profile symbolizer. PERFETTO_SYMBOLIZER_MODE=index discovers 274 symbol files by build id rather than name. 275 * Added screen-state Android metrics. 276 UI: 277 * Added 'Info and stats' page to debug data losses and trace stats. 278 * Added full cmdline to process detail panel. 279 * Improved performance of async tracks using quantized queries. 280 * Improved performance of counter and slice tracks for long traces by 281 pre-caching quantized track data. 282 * Improved actionablility of crash dialog when the Wasm module OOMs. 283 284 285v5.0 - 2020-07-01: 286 Tracing service and probes: 287 * Added gpu_mem_total ftrace event. 288 * Added TrustZone (scm start/end) event. 289 * Added protos for GPU memory tracking and updated render stages proto. 290 * Added time_in_state probe for Android (CPU time broken down by frequency). 291 292 Trace Processor: 293 * Added ingestion of IRQ and SoftIRQ events. 294 * Added ingestion of workqueue events. KAddr symbolization still missing. 295 * Added ingestion of voltage regulators and board clock change events. 296 * Added ingestion of new ION ion_buffer_create/destroy events. 297 * Added ingestion of TrustZone (scm start/end) events. 298 * Added SurfaceFlinger derived events (tracking of missed frames). 299 * Changed parsing of scheduler task state on 4.14 kernels. 300 * Changed importing of Java heap graphs: allow partial dumps. 301 * Improved performance of the SQL query engine. 302 303 UI: 304 * Added dedicated query page for custom SQL queries. 305 * Added navigation links for Binder slices. 306 * Removed overview summary mode when zoomed out. 307 * Fixed recording page when targeting Android P. 308 * Improved slice pan/zoom performance by quantizing. 309