This tutorial walks through how to register a Fuchsia component to paticipate
in tracing and add tracing events in the component's code. Once a component
is configured for tracing, you can use the ffx trace start
command to record a trace on a Fuchsia device and visualize the trace results
for analysis.
The Fuchsia tracing system provides a mechanism for collecting and visualizing diagnostic tracing information from user space processes and the Zircon kernel on a Fuchsia device. The Fuchsia tracing system is made up of a trace manager, a memory buffer, and one or more trace providers. A trace provider is a component that generates trace data as it runs on the device.
Many existing Fuchsia components are already registered as trace providers, whose trace data often provide a sufficient overview of the system. For this reason, if you only need to record a general trace (for instance, to include details in a bug report), you may skip directly to the Record and visualize a trace step. However, if you want to collect additional, customized trace events from a specific component, complete the tutorial from the start.
The steps are: