TrackEvent: Add category tags and groups

This patch makes it possible to classify a single trace point to
multiple categories:

  TRACE_EVENT("benchmark,input", "Name);

Each category group must be registered at build time:

  PERFETTO_DEFINE_CATEGORIES(
    perfetto::Category::Group("benchmark,input")
  );

Additionally, we introduce a builder pattern for adding properties
such as tags and descriptions to categories:

  PERFETTO_DEFINE_CATEGORIES(
    perfetto::Category("moon_lander")
        .SetDescription("Events from the moon lander module"),
    perfetto::Category("moon_lander.verbose")
        .SetDescription("Verbose events from the moon lander module")
        .SetTags("slow")
  );

Design doc: https://docs.google.com/document/d/1YSmRh1g8QuyxHQxN26m_uUNN-F-RzwHidARbWvPeApY/

Bug: 148779455
Change-Id: I453a7b1539894361d4a72200154cc8bf8f43823a
14 files changed
tree: 819e65fcbf5903e1f19cf15ec6f90ed2755346ed
  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. LICENSE
  26. MODULE_LICENSE_APACHE2
  27. NOTICE
  28. OWNERS
  29. perfetto.rc
  30. PRESUBMIT.py
  31. README.chromium
  32. README.md
  33. TEST_MAPPING
  34. traced_perf.rc
  35. 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.

Contributing

See /docs/contributing.md for instructions.

The source-of-truth repo is Android's Gerrit. The GitHub repo is a read-only mirror.

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.