Note
The Viztracer project does the same thing this project aims to do, but is much more complete, so check it out first.
Perfnetto wraps the Perfetto tracing SDK to make it possible to trace Python code.
Note
This is a very new project and certainly rough around the edges. Please report any issues you find – I hope it's useful in any case.
Prebuilt binary wheels are available for Linux and macOS for recent versions of Python on PyPI,
so you can use pip or uv pip to install it.
Source packages are not available on PyPI (so pip install perfnetto won't work out of the box)
because of the submodule dependency on the Perfetto SDK.
The high-level API is the with perfnetto.tracing() as ctx: context manager.
Code run within this block is traced into a perfnetto-(TIME).dump file, unless you specify another name.
Perfnetto will log the name of the output file onto the standard Python logger as it finishes.
When tracing, you can use with perfnetto.region(name): to mark a region.
You can also set instant marks with perfnetto.instant(name).
Once you have a dump file, view it with ui.perfetto.dev.
Since the majority of this code is a wrapper around the Perfetto library, it is licensed under the same license.
This project is licensed under the Apache License, Version 2.0.
See the LICENSE file for more details.
