blob: 382f4689f99d5cbb2ece961654cc1dd169d89d0f [file] [log] [blame]
Primiano Tucci2ab19f62020-07-01 21:28:31 +01001Unreleased:
2 Tracing service and probes:
Primiano Tucci06dab692022-03-15 15:32:33 +00003 * Added prebuilts for mac-arm64.
Lalit Maganti8d6d7c12022-02-24 20:35:23 +00004 * Removed merged trace and config protos from Bazel. Embedder should
5 instead depend on the non-merged proto targets.
Ryan Savitski3167ea02022-03-21 20:26:36 +00006 * Added FtraceConfig.disable_generic_events. If set, the ftrace data source
7 will not emit events for which it doesn't have a compile-time proto
8 message.
Primiano Tuccife6c2e32022-02-08 20:59:11 +00009 Trace Processor:
Primiano Tucci06dab692022-03-15 15:32:33 +000010 * Added prebuilts for mac-arm64.
Lalit Maganti68e649c2022-03-31 00:01:31 +010011 * Changed LIKE comparisions to be case-insenstive. This reverts the change
12 introduced in v22. GLOB should be used where case senstive searches are
13 desired; built-in metrics continue to require the use of GLOB.
Ryan Savitskie65c4052022-03-24 18:22:19 +000014 * Added an optional dependency from trace processor onto a subset of
15 sources from llvm-project for function name demangling. Bazel embedders
16 might need to update their PERFETTO_CONFIG in perfetto_cfg.bzl to opt in
17 or out of the new dependency. See
18 perfetto/bazel/standalone/perfetto_cfg.bzl for details.
Primiano Tuccife6c2e32022-02-08 20:59:11 +000019 UI:
Lalit Maganti6b515622022-02-15 14:42:18 +000020 * Added flow arrows between binder transaction pairs (request/reply
21 and async send/async recv).
Primiano Tuccife6c2e32022-02-08 20:59:11 +000022 SDK:
Alexander Timin94204c62022-03-14 16:57:32 +000023 * Added support for writing typed proto messages inside DebugAnnotations.
Mohit Saini5a7403c2022-03-14 18:24:43 +000024 * Added support for delta encoding of timestamps for TrackEvents.
25 To disable it, refer to `disable_incremental_timestamps` flag in
26 `track_event_config.proto`.
Primiano Tuccife6c2e32022-02-08 20:59:11 +000027
28
Primiano Tuccid5184022022-02-10 16:41:56 +000029v24.2 - 2022-02-10:
30 SDK:
31 * Revert of incremental timestamps, introduced in v24.0.
32 Some clients were depending on non-incremental timestamps.
33 Future releases will re-enable this but offer an opt-out.
34
35
Primiano Tuccid59e9de2022-02-09 10:42:14 +000036v24.1 - 2022-02-09:
37 Tracing service and probes:
38 * Fixed build failures on Windows.
39 Trace Processor:
40 * Fixed build failures on Windows.
Primiano Tuccid59e9de2022-02-09 10:42:14 +000041
42
Primiano Tuccife6c2e32022-02-08 20:59:11 +000043v24.0 - 2022-02-08:
44 Tracing service and probes:
45 * Added "cpufreq_period_ms" in data source "linux.sys_stats" to poll
46 /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq periodically.
47 * Added support for Trusty TEE workqueue events.
48 * Added support for more PMU events in traced_perf.
Primiano Tucci24df3232022-01-26 19:15:17 +000049 * Changed output format of perfetto --query. Made the output more compact
50 and added a summary of ongoing tracing sessions for the caller UID.
Primiano Tuccife6c2e32022-02-08 20:59:11 +000051 * Changed timeout for traced stall detection from 2s to 4s.
52 * Changed internal buffer management to split trace filtering in smaller
53 tasks and avoid too large memory allocation when filtering.
54 * Fixed a bug that could cause producers to see Flush() requests after an
55 OnStop() and mis-behave if the tracing session is extremely short.
Primiano Tuccie9e81c02021-12-03 18:02:58 +000056 Trace Processor:
Primiano Tuccife6c2e32022-02-08 20:59:11 +000057 * Added support for passing multiple SQL statements to ExecuteQuery(). All
58 queries will be executed fully, with the returned iterator yielding rows
59 for the final statement.
60 * Added support for multi-line SQL comments; previously only single line
Lalit Maganti95465982022-01-27 22:41:15 +000061 comments were supported.
Primiano Tucci4f997ef2022-01-11 20:22:47 +000062 UI:
Primiano Tuccife6c2e32022-02-08 20:59:11 +000063 * Added support for parsing instant events from legacy systrace formats.
64 * Added ingestion and visualization for inet_sock_set_state and
65 tcp_retransmit_skb events, showing TCP connections on dedicated tracks.
Primiano Tucci2b2236f2022-01-28 10:50:43 +000066 * Changed HTTP+RPC to use the /websocket endpoint available in newer
67 versions of trace_processor --httpd.
Primiano Tuccife6c2e32022-02-08 20:59:11 +000068 * Changed text selection/copy: now allowed by default for DOM elements.
69 * Changed search to also lookup slices by ID when the term is a number.
70 * Changed postMessage() API, suppressed confirmation dialog when the opener
71 is in the same origin, for cases when the UI is self-hosted.
Primiano Tucci4f997ef2022-01-11 20:22:47 +000072 SDK:
Primiano Tuccid5184022022-02-10 16:41:56 +000073 * Changed timestamps emitted by the SDK to be incremental by default, using
74 ClockSnapshot + TracePacketDefaults.
Primiano Tucci4f997ef2022-01-11 20:22:47 +000075
76
77v23.0 - 2022-01-11:
78 Tracing service and probes:
79 * Added workaround for a kernel ftrace bug causing some "comm" fields to be
80 not null-terminated. https://github.com/torvalds/linux/commit/f0a5157803 .
81 * Added ability to talk to the newer AIDL-based health hal in traced_probes.
82 It still falls back on the older HIDL interface for older devices.
83 Trace Processor:
Primiano Tucci1d518b42022-01-11 19:09:45 +000084 * Changed the argument for the trace path in constructor of TraceProcessor
85 in the Python API from |file_path| to |trace|.
Lalit Maganticb8e0ff2022-01-11 15:36:37 +000086 |file_path| is deprecated and may be removed in the future.
Primiano Tucci1d518b42022-01-11 19:09:45 +000087 * Changed the Python API constructor. Now it takes a TraceProcessorConfig
Lalit Maganticb8e0ff2022-01-11 15:36:37 +000088 instead of passing parameters directly. This may break existing code
89 but migration should be trivial (all current options are still
90 supported).
Primiano Tucci1d518b42022-01-11 19:09:45 +000091 * Fixed a HTTP keepalive bug in trace_processor --httpd. The bug, introduced
92 in v22.0, caused each RPC request to close the connection, effectively
93 defeating the 'Connection: Keep-Alive', after each query made by the UI.
Primiano Tucci4f997ef2022-01-11 20:22:47 +000094 * Added parsing of netif_receive_skb events from proto traces.
95 * Added android_netperf metric based on netif events.
96 * Fixed a bug that would cause fetch errors when loading traces > 32 MB when
97 using trace_processor --httpd.
98 * Added a workaround to tokenize properly /proc/pid/cmdline for chrome
99 processes on Linux/CrOS. Chrome rewrites its cmdline replacing \0 -> ' '.
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000100 UI:
101 *
102 SDK:
103 *
104
105
Primiano Tucci26e2acb2021-12-07 20:27:53 +0000106v22.1 - 2021-12-07:
107 Tracing service and probes:
108 * Added workaround for a Linux kernel bug causing some ftrace strings to
109 be non-null-terminated (https://github.com/torvalds/linux/commit/f0a5157).
110 Trace Processor:
111 * Fixed build failures on Windows.
112
113
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000114v22.0 - 2021-12-03:
115 Tracing service and probes:
Lalit Maganti7030e782021-11-08 13:12:42 +0000116 * Added Android SDK version to the SystemInfo trace packet.
Primiano Tucci2277f062021-11-08 22:24:05 +0000117 * Changed compiler flags. Assume recent x64 CPUs (-msse4.2 -mavx -mpopcnt).
118 This behavior affects only standalone builds and can be changed by setting
119 enable_perfetto_x64_cpu_opt=false in the GN args.
Daniele Di Proietto4d9665b2021-11-24 18:25:46 +0000120 * The java heap profiler now rescans all the processes every time for
121 continous_dump_config. The scan_pids_only_on_start can be used to restore
122 the old behavior.
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000123 * Added support for building on ARM Macs.
124 * Added support for the rss_stat_throttled event on Android via
125 FtraceConfig.throttle_rss_stat. In newer Android kernels the base rss_stat
126 event is now unthrottled. rss_stat used to be throttled by a downstream
127 kernel change, unnecessary after https://lkml.org/lkml/2021/10/25/1411 .
128 atrace.rc configures throttling from userspace at boot.
129 * Fixed a bug that caused IPCs to stall traced and hit the watchdog if in
130 the middle of a suspend/resume. Switched from SND_TIMEO to poll(POLLOUT).
131 * Added "linux.sysfs_power" data source to poll /sys/class/power_supply/
132 and report periodically battery charge and drain rate if supported.
Lalit Maganti33928bc2022-01-27 17:30:08 +0000133 * Add snapshotting for non-BOOTTIME ftrace clocks. This fixes handling of
134 ftrace events from old Linux kernel versions (i.e. 3.x) and adds
135 proper support for using the "global" clock rather than "boot".
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100136 Trace Processor:
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000137 * Speeded up proto trace ingestion by 2x (~20 MB/s -> ~40 MB/s).
Lalit Maganti1cf65eb2021-11-10 16:13:48 +0000138 * Changed LIKE comparisions to be case-senstive. This may break existing
139 queries but was a necessary from a performance perspective.
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000140 Going forward, GLOB must be used, instead of LIKE, for checked in metrics
141 to avoid unnecessary slowdowns.
Primiano Tucci2277f062021-11-08 22:24:05 +0000142 * Changed compiler flags, assume recent x64 CPUs (see above).
Hector Dearmanee80bcb2021-11-30 13:51:30 +0000143 * Changed how displayTimeUnit is handled in JSON traces to match catapult.
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000144 * Added websocket endpoint to RPC interface to reduce query latency.
145 * Added support for hot-reloading metrics (see //docs/analysis/metrics.md).
Lalit Maganti33928bc2022-01-27 17:30:08 +0000146 * Added ingestion support for non-BOOTTIME ftrace clocks.
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100147 UI:
Primiano Tuccie9e81c02021-12-03 18:02:58 +0000148 * Added ability to save/restore record config. Remember last used config.
149 * Fixed bug causing the recording page to hold onto the USB interface making
150 adb unusable after a recording session.
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100151 SDK:
Primiano Tucci360f0232021-11-04 13:41:08 +0000152 * Added UpdateDataSource() descriptor IPC endpoint to allow updates of the
153 data source capabilities (e.g., category list for track event).
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100154
155
Primiano Tucciea727872021-11-02 21:42:05 +0000156v21.0 - 2021-11-01:
157 Tracing service and probes:
158 * Added reporting of last 8 PERFETTO_LOG() entries and crash keys to
159 crash tombstones on Android.
160 * Changed kallsym parser to save 100ms for starting a tracing session with
161 enable_ksyms=true.
162 * Removed advertisement of the built-in data sources "android.heapprofd",
163 "android.java_hprof", "linux.perf" on Linux and other platforms. Built-in
164 data sources are only used to lazy-start daemons on Android OS.
165 * Changed ACL files on Android atrace.rc to support to up to 24 ftrace cpus.
166 No change on Linux which remains unlimited.
167 Trace Processor:
168 * Changed protobuf decoders to use less stack and fall back on heap sooner
169 (before: 16KB of stack per decoder, after: 1.6KB). It caused problems with
170 some embedders which use smaller per-thread stacks.
171 * Added support for SPAN OUTER JOIN on unpartitioned tables.
172 * Improved performance of as_pandas_dataframe() in the Python API by 16x.
173 UI:
174 * Added visualization of direct_reclaim ftrace events.
175 SDK:
176 * Added perfetto::{Flow,TerminatingFlow} to the track-event library.
177
178
Primiano Tuccia94219a2021-10-05 10:38:24 +0100179v20.1 - 2021-10-05:
180 Tracing service and probes:
181 * Fixed standalone Windows build. Updated the llvm-win toolchain.
182
183
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100184v20.0 - 2021-10-03:
185 Tracing service and probes:
Primiano Tucci5eabf6f2021-09-07 14:49:48 +0100186 * Removed DCHECK that would cause crashes when a debug build of the service
187 is used with a producer built with -DNDEBUG.
Daniele Di Proiettoa4c180e2021-09-15 15:42:34 +0000188 * Changed the service-side field-level filtering configuration protobuf
189 field number, because the feature had a bug. This is effectively
190 equivalent to deprecating the feature and reintroducing it under a
191 different name.
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100192 * Added support for boot tracing on Android. Early kernel tracing (prior to
193 the point when /data is mounted) is not yet supported. For instructions
194 see /docs/case-studies/android-boot-tracing.md .
Primiano Tucci5f303142021-06-02 10:28:50 +0100195 Trace Processor:
Lalit Maganti09002982021-09-10 17:04:08 +0100196 * Added reqiurement of separating queries by semi-colon (;) followed by
197 new-line when specifying a query file with -q to trace processor shell.
Zaina Al-Mashni5ed83f92021-09-09 09:08:38 +0000198 * Added "ancestor_slice_by_stack" and "descendant_slice_by_stack" table
199 functions to walk up and down the slice stacks.
Lalit Maganti09e840c2021-09-22 15:23:17 +0100200 * Overhauled windowed sorting to be based on packet ordering and
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100201 lifecycle events inside the trace instead of time-based ordering.
202 * Removed |SortingMode::kForceFlushPeriodWindowedSort| due to changes to the
203 sorting algorithm, which is now based on Flush events rather than time.
204 Embedders should switch to |SortingMode::kDefaultHeuristics|. Other
205 SortingMode enum values are no-ops and will be removed in future versions.
Primiano Tucci876be6d2021-08-02 20:58:06 +0100206 UI:
Primiano Tucci6a46cc72021-10-04 18:57:12 +0100207 * Added initial flamegraph support for traced_perf callstack samples.
208 * Added initial Pivot table for aggregation of userspace slices. The feature
209 is disabled by default for and requires manual enabling via
210 https://ui.perfetto.dev/#!/flags .
Primiano Tucci876be6d2021-08-02 20:58:06 +0100211 SDK:
Primiano Tucci1a69d012021-09-07 14:52:27 +0100212 * Changed DCHECK and DLOGs to be always disabled in SDK builds, regardless
213 of NDEBUG.
Primiano Tucci876be6d2021-08-02 20:58:06 +0100214
215
Primiano Tuccie356c102021-09-07 11:47:47 +0100216v19.0 - 2021-09-02:
217 Tracing service and probes:
218 * Added ftrace clock reporting to the trace.
219 Trace Processor:
220 * Added support for longs/doubles to RUN_METRIC.
221 * Added power profile data for sunfish, redfin, and bramble.
222 * Added experimental Python library for computing slice breakdowns.
223 * Fixed parsing of JSON escape sequences.
224 * Fixed JSON trace detection.
225 UI:
226 * Added local cacheing of traces. Traces are reloaded in case of refresh or
227 tab being discarded by the browser.
228 * Added icon to distinguish metric-derived tracks.
229 * Added release channel selector to feature flags page.
230 * Fixed crash with null slice names.
231 SDK:
232 * Added some missing NESTABLE_ASYNC legacy trace macros.
233 * Fixed reporting of producer uid in --query.
234 * Fixed version numbering scheme for minor versions. Previously versions
235 were numbered as like v19.0.42 where 42 represented the number of commits
236 since the last major version release. This was ambiguous in the presence
237 of branches. Now versions are numbered like v19.0-ab12cd34 where ab12cd34
238 is the shortened Git commit-ish.
239
240
Primiano Tucci876be6d2021-08-02 20:58:06 +0100241v18.0 - 2021-08-02:
242 Tracing service and probes:
243 * Added cross-compiler toolchains for Linux-{arm,64} based on Debian Sid.
244 These will be used for generating monthly releases' prebuilts via LUCI.
245 Trace Processor:
246 * Added 'android_gpu' metric to report residency information for each GPU
247 frequency (via `trace_processor_shell --run-metrics android_gpu`).
Primiano Tuccie2422be2021-07-20 18:19:45 +0100248 * Removed the RawQuery RPC interface.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100249 UI:
Primiano Tuccie2422be2021-07-20 18:19:45 +0100250 * Added a highlighted section to thread slices to visualize CPU time
Zaina Al-Mashni3911f612021-07-13 18:09:34 +0000251 (darker) verses wall time (lighter).
Primiano Tucci876be6d2021-08-02 20:58:06 +0100252 * Added global counter tracks for perf counters (e.g. "CPU 0 cycles", "CPU 0
253 instructions") when the 'linux.perf' data source (traced_perf) is used.
254 * Added a (feature) 'Flags' page to enable/disable individual metrics.
255 * Fixed races that could cause occasional crashes when loading a trace
256 from a permalink.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100257 SDK:
Primiano Tuccie2422be2021-07-20 18:19:45 +0100258 * Fix undefined reference on ~TracingMuxerFake when building the SDK.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100259
260
261v17.0 - 2021-07-02:
262 Tracing service and probes:
Ryan Savitski6444aad2021-07-02 16:30:57 +0100263 * Fixed a bug in ftrace parsing of absolute timestamps
264 (RINGBUF_TYPE_TIME_STAMP), encountered on Linux kernels 5.9+.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100265 * Fixed a bug in --save-for-bugreport causing 0-length traces if the
266 selected trace declared one or more triggers in the config.
267 * Fixed a bug in tracebox causing the PERFETTO_PRODUCER_SOCK_NAME env
268 var to be ignored.
269 Trace Processor:
Primiano Tucci728230d2021-06-16 15:38:35 +0100270 * Changed CORS headers of --httpd mode to allow only https://ui.perfetto.dev
271 and http://localhost:10000. This affects only CORS-aware browser clients.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100272 * Added GPU frequency metrics.
Primiano Tucci5f303142021-06-02 10:28:50 +0100273 UI:
Primiano Tuccice51d522021-06-03 14:57:45 +0100274 * Fixed ADB connection issues ("unable to reset device") on Windows and Mac.
Primiano Tucci50199ce2021-07-02 14:50:53 +0100275 * Added caching of tracing in the cache storage so that the trace is
276 re-opened if a tab is killed (Chrome tab discarding or accidental CTRL+W).
Primiano Tucci5f303142021-06-02 10:28:50 +0100277 SDK:
Sami Kyostilac687c2e2021-06-03 13:00:45 +0100278 * Added support for writing track events using custom clock timestamps.
Primiano Tucci5f303142021-06-02 10:28:50 +0100279
280
Primiano Tucci5ca51f92021-06-08 10:29:35 +0100281v16.1 - 2021-06-08:
282 Tracing service and probes:
283 * Cherry-pick of r.android.com/1716718 which missed the v16 branch cut and
284 fixed MSVC 2019 builds.
285
286
Primiano Tucci5f303142021-06-02 10:28:50 +0100287v16.0 - 2021-06-01:
288 Tracing service and probes:
Primiano Tucci235610f2021-05-24 20:22:43 +0100289 * Added support for building most targets (including traced, SDK and
290 trace_processor_shell) from Windows using either clang-cl or MSVC 2019.
291 * Added tracebox, a monolithic binary to capture traces with one command
292 on Linux and older versions of Android (tested on Android Oreo).
Primiano Tucci5f303142021-06-02 10:28:50 +0100293 * Added support for service-side field-level filtering of traces. The
294 consumer can pass a filter bytecode and ensure that non-allowed fields
295 are never emitted in output.
296 * Added reporting of service version and producer SDK version into the trace
297 and `perfetto --query`.
298 * Fixed compatibility with Android versions older than Pie (for sideloading)
299 which cause failures when trying to enable atrace categories.
Primiano Tucci96755912021-01-05 12:15:17 +0100300 Trace Processor:
Primiano Tucci5f303142021-06-02 10:28:50 +0100301 * Added new RPC interface based on a bidirectional binary pipe. This allows
302 to simplify integration with out-of-process users. The existing --httpd
303 interface now exposes a single /rpc endpoint. Older endpoints are still
304 available for legacy clients.
305 * Added support for counters and instant events in JSON traces.
306 * Fixed support of displayTimeUnit in JSON traces.
Primiano Tuccie60b7c82021-03-03 14:09:35 +0000307 UI:
Primiano Tucci41327402021-06-01 20:28:00 +0100308 * Added warning dialog when trying to use a trace_processor_shell --httpd
309 which is too old.
310 * Added warning dialog when trying to use a trace_processor_shell --httpd
311 RPC instance from more than one tab.
Primiano Tucci5f303142021-06-02 10:28:50 +0100312 * Added links to convert the trace to JSON or systrace directly from the UI.
313 * Changed track sorting logic. Tracks are now sorted in groups (e.g.,
314 scheduling tracks, summary tracks, frame timeline tracks).
315 * Fixed crashes happening flakily when pushing traces via window.open().
Primiano Tucci8220de22021-05-05 09:53:37 +0100316
317
318v15.0 - 2021-05-05:
319 Tracing service and probes:
320 * Added support for {host,target}=aarch64 standalone builds.
321 * Added --background cmdline switch to traced and traced_probes services.
322 * Changed trigger_perfetto to ignore unknown command line arguments to
323 preserve forward compatibility.
324 * Added -a / --app cmdline argument to tools/record_android_trace.
325 Trace Processor:
326 * Added sanitisation of keys in nested debug annotation dictionaries.
327 * Changed Android startup metric: count CPU time of JIT thread pool, report
328 timestamp of activities during startup.
329 * Changed android_surfaceflinger metric, added missed frame counters.
330 * Changed version of SQLite to 3.35.4.
331 * Fixed importing of JSON traces with decimal (sub-us) timestamp.
332 * Fixed prepending "debug." prefix to debug annotations with non-interned
333 names.
334 UI:
335 * Added support to visualize the lifetime of individual dmabuf allocations
336 as async slices (datasource: already existing ftrace dmabuf event).
337 * Fixed visualization of unfinished slices to extend to the end of the
338 viewport.
339 SDK:
Alexander Timin129bdcf2021-04-16 11:36:37 +0000340 * Added support for passing arbitrary number of debug annotations to
341 TRACE_EVENT and combining them with lambdas.
342 * Added support for writing typed TrackEvent arguments using TRACE_EVENT
343 inline without lambdas.
Primiano Tucci8220de22021-05-05 09:53:37 +0100344 * Changed ConvertTimestampToTraceTimeNs to be a member of
345 TraceTimestampTraits<T> struct instead of a standalone function.
346 * Changed TracedValue to use nested DebugAnnotation proto instead of
347 DebugAnnotation::NestedValue.
Primiano Tucci7454e1a2021-04-01 13:03:19 +0100348
349
350v14.0 - 2021-04-01:
351 Tracing service and probes:
352 * Added support for polling power rails on Android from the newer
353 IPowerStats AIDL interface (previously using only the HAL interface).
354 * Fixed native heap profiler crash when ABI of heapprofd and profiled
355 process mismatch.
356 * Changed encoding format of Anroid managed heap profiler to reduce heap
357 dump sizes by delta-encoding object IDs.
358 Trace Processor:
359 * Added activity create/resume, layout inflation and resource timings to
360 the Android startup metric.
361 * Added chrome metadata key/value pairs (e.g. chrome version) into the
362 `metadata` table with 'cr-' prefixed keys.
363 * Added dma-buf-based memory metrics reporting total/avg/min/max dmabuf
364 allocation per-dmabuf-heap and per-process.
365 * Removed |force_full_sort| flag from config. This has been replaced
366 by setting the sorting mode to force a full sort.
367 UI:
368 * Added tools/symbolize-ui-crash script to resolve crash reports via
369 TypeScript source maps.
370 * Fixed newlines when copying Android event log lines into the clipboard.
371 * Fixed crash when selecting "Did not finish" slices.
372 * Fixed OOM dialog to give actionable instructions when opening large traces
373 rather than suggesting to file a bug.
Sami Kyostilaedf7c862021-03-11 13:33:35 +0000374 SDK:
Primiano Tucci7454e1a2021-04-01 13:03:19 +0100375 * Added /meson.build for bundling /sdk/perfetto.{cc,h} in Meson builds.
376 * Added support for counter trace points with the TRACE_COUNTER macro.
377
Primiano Tuccie60b7c82021-03-03 14:09:35 +0000378
379v13.0 - 2021-03-01:
380 Tracing service and probes:
381 * Added ability to sample callstacks using kernel tracepoints as timebase.
382 * Added abililty to record the perf timebase counter values into the trace,
383 both combined callstack+counter or counter-only.
384 * Added abillity to trigger traces based on VM pressure on Android. Requires
385 a dedicated tracing instance in $tracefs/instances/mm_events.
386 Trace Processor:
Lalit Maganti88eb6982021-03-01 14:28:51 +0000387 * Added sorting mode to trace processor config to specify how trace
388 processor should sort events. The |force_full_sort| flag has been
389 deprecated (with replacement) and will be removed in the next version.
Primiano Tuccie60b7c82021-03-03 14:09:35 +0000390 * Added ingestion of frame timeline events into the
391 {expected,actual}_frame_timeline_slice tables.
392 * Added support for Mali's trace_marker_write ftrace event.
393 * Added memory metric based on newer android_fastrpc kernel events.
Primiano Tucci96755912021-01-05 12:15:17 +0100394 UI:
Primiano Tuccie60b7c82021-03-03 14:09:35 +0000395 * Added flow events support for instant events and async tracks.
396 * Added support for Android frame timeline events. They allow inspecting
397 end-to-end expected vs actual app-to-surfaceflinger frame times.
398 * Added ability to switch between Canary and Stable channels in the UI.
399 * Added ability to drag&drop to open trace files.
400 * Changed UI serving infrastructure, old ui versions can be now retrieved by
401 directly opening https://ui.perfetto.dev/v12.1.269/ .
402 * Removed thread state track for threads that have no activity.
Sami Kyostilae8c0ff52021-02-16 11:26:16 +0000403 SDK:
404 * Use process start time hashed with the process id as a unique process
405 identifier, allowing multiple independent users of the SDK in the same
406 process to interleave their events on shared tracks.
Sami Kyostila86b10c52021-02-16 16:50:42 +0000407 * Record process and thread names into the trace.
Sami Kyostila67cdc662021-02-26 16:42:14 +0000408 * Add ring buffer tracing support, i.e., periodic clearing of incremental
409 state.
Primiano Tuccie60b7c82021-03-03 14:09:35 +0000410 Misc:
411 * Convert python scripts to python3.
Primiano Tucci96755912021-01-05 12:15:17 +0100412
413
Primiano Tucci71a92392021-02-01 23:45:28 +0100414v12.1 - 2021-02-01:
415 Misc:
416 * Fixed CHANGELOG which was missed in the 12.0 branch cut, causing
417 mis-labeling of the version code in the v12.x branch as v11.0..N
418
419
Primiano Tucci9c294a42021-02-01 18:04:23 +0100420v12.0 - 2021-02-01:
421 Tracing service and probes:
422 * Added more helpful error messages if the client library is used without
423 having been initialized.
424 * Added //tools/record_android_trace script to facilitate recording traces
425 from Android devices, automating start + stop-via-ctrl+c + pull + open.
426 * Added auto-attachment of traces to Android bugreports if dumpstate is
427 invoked when a trace with bugreport_score > 0 is running.
428 SDK:
429 * Added ability to customize the timestamp of events via
430 ConvertTimestampToTraceTimeNs().
431 * Fixed support for category names that contain a space.
432 Trace Processor:
433 * Added ingestion and query support for Android end-to-end frame timing
434 events through the {actual, expected}_frame_timeline_slice tables.
435 * Added time-to-reportFullyDrawn (Android's API) to startup metrics.
436 * Fixed excessive memory usage when decoding traces containing callstacks
437 (https://github.com/google/perfetto/issues/83).
438 UI:
439 * Added ability to inspect the full trace config string from the
440 'Info and stats' page.
441 * Fixed 'TABLE/VIEW XXX already exists' in the Metrics page when running the
442 same metric twice.
443 * Fixed sorting of tracks using numeric sorting instead of lexicographic:
444 Thread {1, 2, 10, 11, 20} rather than Thread {1, 10, 11, 2, 20}.
445 * Fixed CSP-related bug that was preventing the UI to work on Firefox.
446 * Changed max zoom resolution to allow to zoom to sub-us events.
447
448
Primiano Tucci96755912021-01-05 12:15:17 +0100449v11.0 - 2021-01-01:
450 Tracing service and probes:
Sami Kyostilaae504d42020-12-02 12:00:25 +0000451 * Added trace packet interceptor API for rerouting trace data into
452 non-Perfetto systems.
Sami Kyostila6c151262020-12-15 18:48:51 +0000453 * Added support for printing track events to the console.
Sami Kyostila2778ac82020-12-21 16:12:27 +0000454 * Added a way to observe track event tracing sessions starting and
455 stopping.
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000456 Trace Processor:
Primiano Tucci96755912021-01-05 12:15:17 +0100457 * Added "ancestor_slice" and "experimental_ancestor_stack_profile_callsite"
458 table functions to look up ancestors of CPU stack samples in profiler
459 tables.
460 * Added power metric reporting suspend/resume time periods.
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000461 UI:
Primiano Tucci96755912021-01-05 12:15:17 +0100462 * Fixed CPU time calculation in example queries.
463 * Added tracks to debug Android SystemUI jank.
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000464
Primiano Tucci5d2be3a2020-12-01 20:42:45 +0100465
466v10.0 - 2020-12-01:
467 Tracing service and probes:
468 * Fixed crash of tracing service if a client is unresponsive on the IPC
469 channel. Clients are disconnected if they don't respond to IPCs for 10s.
470 * Added cmdline arguments for integration within ChromeOS system image
471 (--{producer,consumer}-socket-{group,mode} for chmod-ing sockets).
472 * Changed path lookup logic for traced socket. /run/perfetto/ is used if the
473 directory exists, falling back on /tmp/ otherwise.
474 * Added support for kernel frame symbolization to the traced_perf callstack
475 sampler.
476 * Added support for resolving ftrace event arguments that require
477 symbolization against printk_format.
478 Trace Processor:
479 * Added .read command to inject a SQL query file, similar to the -q cmdline.
480 * Added trace-based metrics to root cause jank in Android System UI.
481 * Added symbolization support for ELF files on Windows for heap and
482 callstack profilers.
483 * Added support for symbolizing names of workqueue ftrace events.
484 * Improved Android startup metric with activity restart time.
485 UI:
486 * Added support for navigating flows with Ctrl+[ / Ctr+].
487 * Improved query result panel, moved to the bottom group allowing
488 simultaneous query result and timeline views.
489 * Fixed data corruption when recording traces via the WebUSB-based Record
490 page in the UI.
491
492
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000493v9.0 - 2020-11-01:
494 Tracing service and probes:
Sami Kyostilaf99230f2020-10-15 10:38:32 +0000495 * Added support for recording traces from a system service through the
496 client API.
497 * The client library now reconnects producers automatically if the
498 connection to the tracing service is lost. Also fixed crashes in ongoing
499 tracing sessions when a disconnect occurs.
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000500 * Added support for dpu and g2d ftrace events.
501 * Enabled commit batching and producer side patching of chunks.
502 * Add support for symbolizing kernel symbols for ftrace events.
Primiano Tucci2ab19f62020-07-01 21:28:31 +0100503 Trace Processor:
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000504 * Fixed type affinity of string columns.
Primiano Tucci2ab19f62020-07-01 21:28:31 +0100505 UI:
Lalit Maganti09549602020-10-01 16:47:00 +0100506 * Added initial support for running metrics from the UI.
Isabelle Taylor8546cee2020-10-30 14:43:53 +0000507 * Added support for displaying all flows when a slice or area is selected.
508 * Highlight nodes that match the 'focus' string in the flamegraph.
509 * Added search within slice args.
510 * Fixed details panel height and moved query panel into details panel.
511 * Enabled re-sharing of postMessage traces by echoing back the original URL.
512 * Improved record page error messages.
Lalit Maganti09549602020-10-01 16:47:00 +0100513
514
515v8.0 - 2020-10-01:
516 Tracing service and probes:
517 * Added API for querying registered data sources and their capabilities.
518 * Added support for profiling heap allocations on Linux via LD_PRELOAD.
519 * Fixed possible race when initializing the consumer library.
520 * Fixed subtle bugs on systems with 16KB system pages.
521 Trace Processor:
522 * Added a table which lists available metrics.
523 * Added Python bindings on PyPi in the 'perfetto' package.
524 * Added support for running trace_processor_shell on Android.
525 * Added per-process metrics for GPU memory usage.
526 * Added support for exporting flow events to JSON.
527 * Added dynamic tables for navigating between slices of flows.
528 UI:
529 * Changed time marking: horizontal selection doesn't gray out anymore,
530 pressing 'm' marks the range.
531 * Added initial support for displaying flow event arrows.
532 * Improved ordering of all thread tracks under process grouping.
533 * Fixed UI crashes due to metric errors
534 * Fixed selection of thread state slices.
Primiano Tucci2ab19f62020-07-01 21:28:31 +0100535
536
Primiano Tucci816506e2020-09-01 18:13:12 +0200537v7.0 - 2020-09-01:
538 Tracing service and probes:
539 * Added auto-reconnection to the SDK. Tracing::Initialize() now retries in
540 the background, instead of failing, if the tracing service is unrechable.
541 * Added support for recording cpuhp (CPU hotplug) ftrace events.
542 * Fixed heap profiling unwinding on multi-ABI systems.
543 * Fixed reporting of live objects in the native heap profiler when using
544 --dump-at-max.
545 * Fixed crash when writing trace events with field nesting level > 10.
546 Trace Processor:
547 * Added Python bindings, see
548 https://perfetto.dev/docs/analysis/trace-processor#python-api .
549 * Added ingestion for Chrome instant events and Chrome flow events.
550 * Added ingestion for Android GPU memory events and sched_blocked_reason.
551 * Added WebView power metric.
552 * Added support for WSL1 where Async I/O is not available.
553 * Improved detection of Android suspend/resume events.
554 UI:
555 * Added GPU memory recording controls and ingestion code. Requires a recent
556 Android 12+ kernel.
557 * Added details panel for flow events, showed when the user selects a slice
558 involved in a flow (arrows in the UI are still being worked on).
559 * Added instant events rendering.
560 * Added Google Analytics.
561 * Fixed I/O thread-states in 4.14 kernels to deal with the removal of
562 wake-kill using sched_blocked_reason.
563 * Fixed "Perfetto UI started debugging this browser" showing when opening
564 the UI and the Chrome extension is installed.
565 Misc:
566 * Update language to comply with Android's inclusive language guidance.
567
568
Primiano Tucci6d7badc2020-07-31 19:03:27 +0200569v6.0 - 2020-08-01:
570 Tracing service and probes:
571 * Added ftrace thermal events.
572 * Added support for custom allocators to the heap profiler. Allows
573 developers to report memory allocations that are not done through malloc.
574 * Added detailed timestamping of key tracing session events.
575 * Added support for building tracing services on CrOS (system-wide tracing).
576 * Fixed filtering out of stale ftrace data that predates the beginning of
577 the tracing session.
578 Trace Processor:
579 * Improved profile symbolizer. PERFETTO_SYMBOLIZER_MODE=index discovers
580 symbol files by build id rather than name.
581 * Added screen-state Android metrics.
582 UI:
583 * Added 'Info and stats' page to debug data losses and trace stats.
584 * Added full cmdline to process detail panel.
585 * Improved performance of async tracks using quantized queries.
586 * Improved performance of counter and slice tracks for long traces by
587 pre-caching quantized track data.
588 * Improved actionablility of crash dialog when the Wasm module OOMs.
589
590
Primiano Tucci2ab19f62020-07-01 21:28:31 +0100591v5.0 - 2020-07-01:
592 Tracing service and probes:
593 * Added gpu_mem_total ftrace event.
594 * Added TrustZone (scm start/end) event.
595 * Added protos for GPU memory tracking and updated render stages proto.
596 * Added time_in_state probe for Android (CPU time broken down by frequency).
597
598 Trace Processor:
599 * Added ingestion of IRQ and SoftIRQ events.
600 * Added ingestion of workqueue events. KAddr symbolization still missing.
601 * Added ingestion of voltage regulators and board clock change events.
602 * Added ingestion of new ION ion_buffer_create/destroy events.
603 * Added ingestion of TrustZone (scm start/end) events.
604 * Added SurfaceFlinger derived events (tracking of missed frames).
605 * Changed parsing of scheduler task state on 4.14 kernels.
606 * Changed importing of Java heap graphs: allow partial dumps.
607 * Improved performance of the SQL query engine.
608
609 UI:
610 * Added dedicated query page for custom SQL queries.
611 * Added navigation links for Binder slices.
612 * Removed overview summary mode when zoomed out.
613 * Fixed recording page when targeting Android P.
614 * Improved slice pan/zoom performance by quantizing.