TrackEvent: Add support for dynamically enabled tracing categories

This patch introduces support for annotating track events with named
tracing categories. Each category can be individually enabled or
disabled using a trace config.

The set of categories is defined at compile time using a macro:

  PERFETTO_DEFINE_CATEGORIES(
      PERFETTO_CATEGORY(cat1),
      PERFETTO_CATEGORY(cat2),
      PERFETTO_CATEGORY(cat3));

We also introduce a set of macros for efficiently emitting track events
with category annotation:

  TRACE_EVENT_BEGIN("cat1", "EventName");
  TRACE_EVENT_END();

The trace point implementation replaces the per-data source instance
enable bitmap with a per-category bitmap in order to avoid doing any
extra work for categories that aren't enabled for tracing.

Bug: 132678367
Change-Id: I84cdb13fc2608a23f311f49a3402640c92199909
24 files changed
tree: 2591a6639da2b8b039f953190432dae004a6cebf
  1. bazel/
  2. build_overrides/
  3. buildtools/
  4. debian/
  5. docs/
  6. gn/
  7. include/
  8. infra/
  9. protos/
  10. src/
  11. test/
  12. tools/
  13. ui/
  14. .clang-format
  15. .gitignore
  16. .gn
  17. .style.yapf
  18. Android.bp
  19. Android.bp.extras
  20. BUILD
  21. BUILD.extras
  22. BUILD.gn
  23. codereview.settings
  24. heapprofd.rc
  25. MODULE_LICENSE_APACHE2
  26. NOTICE
  27. OWNERS
  28. perfetto.rc
  29. PRESUBMIT.py
  30. README.chromium
  31. README.md
  32. TEST_MAPPING
  33. WORKSPACE
README.md

Perfetto - Performance instrumentation and tracing

Perfetto is an open-source project for performance instrumentation and tracing of Linux/Android/Chrome platforms and user-space apps.

See www.perfetto.dev for docs.

Bugs

  • For bugs affecting Android or the tracing internals use the internal bug tracker (go/perfetto-bugs).
  • For bugs affecting Chrome use http://crbug.com, Component:Speed>Tracing label:Perfetto.

Community

You can reach us on our Discord channel. If you prefer using IRC we have an experimental Discord <> IRC bridge synced with #perfetto-dev on Freenode.