# Tutorial on Fuchsia tracing

Tracing is a powerful observability tool that can assist in quickly getting a
high level overview of a running system to find and diagnose issues. You can
think of tracing like visualizable, queryable, and toggleable printf debugging.

![A Busy Fuchsia Trace](https://fuchsia.dev/static/fuchsia-src/development/tracing/tutorial/images/perfetto-overview.png "A busy Fuchsia trace displayed in the Perfetto Viewer")

By enabling various categories, you can visualize the following (and more):

- High granularity breakdown of which threads are scheduled on each core
- Customizable per component trace events and spans
- FIDL calls between processes and threads
- A record of every single syscall
- Network and file system activity
- High level understanding of how a component operates and communicates

Step 1 of this tutorial walks through through how to take a trace, what's
available to trace, and how to visualize it.

You can unlock deeper analysis by adding custom trace points to your component
as well. Steps 2 and 3 explain how to add new trace points to a component.

1. [Record and visualize a trace](https://fuchsia.dev/docs/development/tracing/tutorial/record-and-visualize-a-trace).
2. [Register a trace provider](https://fuchsia.dev/docs/development/tracing/tutorial/register-a-trace-provider).
3. [Add tracing in your code](https://fuchsia.dev/docs/development/tracing/tutorial/add-tracing-in-code).

[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/development/tracing/tutorial/README.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/development/tracing/tutorial/README.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/development/tracing/tutorial/README.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/development/tracing/tutorial/README.md "Edit the source code of this page")