An automation-focused entry in TopGit's GitHub warehouse: google/perfetto, 6.8k stars, Automation, C++. Production-grade client-side tracing, profiling, and analysis for complex software systems.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Record, explore and query traces of complex software.
Try the demo ·
Quick start ·
What can you do with it? ·
Documentation ·
Discord
What is Perfetto?
Perfetto is an open-source suite of tools for recording, visualizing and
analyzing traces: timelines of what software and the system under it were
doing. It is the default tracing system for Android and Chromium.
System-wide recording works on Android and Linux. The tracing SDK, the UI and
Trace Processor also run on macOS and Windows.
Record the whole system. Scheduling, CPU frequency, memory, syscalls and
any kernel tracepoint on Android and Linux, plus Android framework events,
callstack sampling and Java and native heap profiles.
Instrument your own code. Add trace points with the
C++ or
Rust SDKs and see them
next to everything else.
Open traces from other tools. Chrome JSON, Linux perf, Firefox
Profiler, macOS Instruments, pprof, systrace, Fuchsia and
more.
Explore multi-GB traces in the browser. The
Perfetto UI needs no install and runs fully
locally: traces are not uploaded anywhere.
Query everything with SQL.
Trace Processor turns
any trace into tables, with a standard library for common analyses. Use it
from the command line, Python or C++.
Bring your AI agent. The
Perfetto AI skill
teaches coding agents to record and analyze traces.
Try it in your browser
Open an example Android trace
without installing anything, or drag your own trace file onto
ui.perfetto.dev.
For Chrome, use the recording page
in the UI. To trace your own app, see
in-app tracing.
Query it with SQL
curl -LO https://get.perfetto.dev/trace_processor && chmod +x trace_processor
./trace_processor query trace.pftrace \
"SELECT name, COUNT(*) AS cnt FROM slice GROUP BY name ORDER BY cnt DESC LIMIT 10"
Or from Python:
pip install perfetto
from perfetto.trace_processor import TraceProcessor
tp = TraceProcessor(trace='trace.pftrace')
print(tp.query('SELECT ts, dur, name FROM slice LIMIT 10').as_pandas_dataframe())
What can you do with it?
Android app and platform developers: root-cause slow startups, jank,
ANRs and low memory kills, and profile Java/Kotlin and native memory.
(Android guides)
C, C++ and Rust developers: instrument your code to see where time goes
across threads and processes.
(In-app tracing)
Linux kernel and systems developers: visualize scheduling, syscalls,
interrupts and custom tracepoints. Perfetto is an efficient userspace daemon
for ftrace.
(Linux cookbook)
Chromium developers: Perfetto is the tracing backend behind
chrome://tracing, for debugging the browser, V8 and Blink.
(Chrome tracing)
Performance engineers: analyze traces from many tools in one place and
automate the analysis with SQL across thousands of traces.
(Trace analysis)
Not sure where to start? How do I start using Perfetto?
picks a path based on what you want to do.
How it fits together
Perfetto is a collection of components that work together:
Tracing daemons (traced, traced_probes) collect data from many
processes and the kernel into a single trace file.
The tracing SDK writes your app's trace points with low overhead.
The Perfetto UI visualizes traces on a timeline.
Trace Processor parses traces into a SQL database for analysis.
See the documentation for the full picture.
Community and Support
Discord: ask questions in #help, chat with
the team and community, and follow releases.
GitHub issues: report bugs.
Mailing list: if
you prefer email.
See Community and getting help for
more. We follow
Google's Open Source Community Guidelines.
Contributing
Contributions are welcome. The
contributor guide
covers building, testing and sending pull requests.
Packages
The Debian packaging of Perfetto is maintained in the
Debian Perfetto Salsa repository.
TopGit's last sync did not record any GitHub topics for google/perfetto. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on google/perfetto?
The most recent commit recorded on google/perfetto was 9 days ago, based on the GitHub push timestamp. The repository has 943 forks — one of the better signals of community interest.
Is google/perfetto open source?
Yes — google/perfetto ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/google/perfetto.
What license does google/perfetto use?
google/perfetto is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where can I see google/perfetto in action?
The project maintains a homepage at https://www.perfetto.dev. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about google/perfetto?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/google/perfetto is the definitive source.
Read full README in the tab above.
Still deciding about perfetto?
One click hands the question to an AI along with this page — see what it says about perfetto.