Toc

Overview

• What is Perfetto?
• What is Tracing?
• How do I start using Perfetto?

Getting Started

• Tutorials

  • System Tracing {.tag-android .tag-linux}
  • In-App Tracing {.tag-cpp-rust}
  • Rust SDK {.tag-cpp-rust}
  • Memory Profiling {.tag-android .tag-linux}
  • CPU Profiling {.tag-android .tag-linux}
  • Instrumenting with atrace {.tag-android}
  • Instrumenting with ftrace {.tag-linux .tag-android}
  • Recording Chrome Traces {.tag-chrome}
  • Importing Other Formats {.tag-perf}
  • Converting Data to Perfetto {.tag-perf}

• Cookbooks

  • Recording Android Traces Locally {.tag-android}
  • Analyzing Android Traces {.tag-android}
  • Analyzing Traces from the Command Line {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
  • Tracing on Linux {.tag-linux}
  • Capturing Periodic Trace Snapshots {.tag-android .tag-linux}
  • Using AI with Perfetto {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

• Case Studies

  • Debugging Memory Usage {.tag-android}
  • Scheduling Blockages {.tag-android .tag-linux}

• Contributing

  • Getting Started {.tag-contrib}
  • Common Tasks {.tag-contrib}

Learning More

• Concepts

  • Service Model {.tag-android .tag-linux .tag-cpp-rust}
  • Buffers and Dataflow {.tag-android .tag-linux .tag-cpp-rust .tag-chrome}
  • Trace Configuration {.tag-android .tag-linux .tag-cpp-rust .tag-chrome}
  • Clock Synchronization {.tag-android .tag-linux .tag-cpp-rust .tag-chrome}
  • Trace merging {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
  • Concurrent Sessions {.tag-android .tag-linux .tag-cpp-rust}

• Recording

  • Tracing in Background {.tag-android .tag-linux}
  • Advanced Android Tracing {.tag-android}
  • Symbolization and Deobfuscation {.tag-android .tag-linux}
  • Tracing across Reboots {.tag-android .tag-linux}
  • Custom Proto Extensions {.tag-cpp-rust .tag-android .tag-perf}
  • heapprofd API {.tag-cpp-rust}
  • Multi-machine recording {.tag-android .tag-linux}

• Data Sources

  • System

    • CPU Scheduling {.tag-android .tag-linux}
    • System Calls {.tag-android .tag-linux}
    • CPU Frequency {.tag-android .tag-linux}
    • Function Graph {.tag-android .tag-linux}
    • GPU {.tag-android .tag-linux .tag-perf}

  • Memory

    • Memory Counters {.tag-android .tag-linux}
    • Allocation Profiler {.tag-android .tag-linux}
    • ART Heap Dumps {.tag-android}

  • Android

    • ATrace {.tag-android}
    • Logcat {.tag-android}
    • Frame Timeline {.tag-android}
    • Battery & Power {.tag-android}
    • Android Game Interventions {.tag-android}
    • Android Aflags {.tag-android}
    • Screen Recording {.tag-android}

• Tracing SDK

  • Tracing SDK {.tag-cpp-rust}
  • Track Events {.tag-cpp-rust}

• Visualization

  • Perfetto UI {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Merging traces in the UI {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Data Explorer {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Opening Large Traces {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Deep Linking {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Embedding the UI {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Debug Tracks {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Heap Dump Explorer {.tag-android}

  • Extending the UI

    • Overview {.tag-android .tag-linux .tag-cpp-rust .tag-perf}
    • UI Automation {.tag-android .tag-linux .tag-cpp-rust .tag-perf}
    • Commands Reference {.tag-android .tag-linux .tag-cpp-rust .tag-perf}
    • Extension Servers {.tag-android .tag-linux .tag-cpp-rust .tag-perf}

• Trace Analysis

  • Getting Started {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • PerfettoSQL

    • Getting Started {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Syntax {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Standard Library {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Style Guide {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Backwards Compatibility {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Trace Processor

    • C++ Library {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Python Library {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Batch Trace Processor {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Merging traces from the command line {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Trace Summarization {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Converting from Perfetto {.tag-android .tag-linux .tag-cpp-rust .tag-chrome}

• FAQ {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

Diving Deep

• CLI Tools

  • perfetto {.tag-android .tag-linux}
  • traced {.tag-android .tag-linux}
  • traced_probes {.tag-android .tag-linux}
  • heap_profile {.tag-android .tag-linux}
  • tracebox {.tag-android .tag-linux}

• Reference

  • Protos

    • Trace Config {.tag-android .tag-linux .tag-cpp-rust .tag-chrome}
    • Trace Packet {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • PerfettoSQL

    • Prelude Tables {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Built-in Functions {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}
    • Stats Table {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Synthetic Track Events {.tag-perf}

  • Kernel Track Events {.tag-android .tag-linux}

  • Trace manifest format {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Extension Server Protocol {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Embedding API {.tag-android .tag-linux .tag-cpp-rust .tag-chrome .tag-perf}

  • Android Version Notes {.tag-android}

• Advanced Topics

  • Detached Mode {.tag-android}
  • Interceptors {.tag-cpp-rust}
  • Legacy (v1) Metrics {.tag-android}
  • Multi-machine architecture {.tag-android .tag-linux}
  • BigTrace (Single Machine) {.tag-android .tag-perf}
  • BigTrace on Kubernetes {.tag-android .tag-perf}

• Contributing

  • Building {.tag-contrib}

  • Testing {.tag-contrib}

  • Developer Tools {.tag-contrib}

  • UI Development

    • Getting Started {.tag-contrib}
    • Plugins {.tag-contrib}

  • Releases

    • SDK Release {.tag-contrib}
    • Python Release {.tag-contrib}
    • UI Release {.tag-contrib}

  • Become a Committer {.tag-contrib}

  • Chrome Branches {.tag-contrib}

  • SQLite Upgrade {.tag-contrib}

• Design Documents

  • Core

    • API and ABI Surface {.tag-contrib}
    • Life of a Tracing Session {.tag-contrib}
    • Security Model {.tag-contrib}
    • Trace Buffer V2 {.tag-contrib}

  • Infrastructure

    • ProtoZero {.tag-contrib}
    • LockFreeTaskRunner {.tag-contrib}

  • Trace Processor

    • Architecture {.tag-contrib}
    • Batch Trace Processor {.tag-contrib}

  • UI

    • Data Explorer Architecture {.tag-contrib}

  • Profiling

    • Heapprofd Design {.tag-contrib}
    • Heapprofd Wire Protocol {.tag-contrib}
    • Heapprofd Sampling {.tag-contrib}
    • pprof Support {.tag-contrib}

  • Other

    • Statsd Checkpoint Atoms {.tag-contrib}
    • Perfetto CI {.tag-contrib}