A multi-thread aware profiler package, with an API similar to that of the standard cProfile module. Profiling data generated by mtprof is in the same format as that generated by cProfile and can therefore be analyzed using the same tools (such as pstats, snakeviz, etc.).

Python 3 is required, and only POSIX systems (Linux, etc.) are currently supported.

This is a pure Python package, so pip install mtprof should generally work everywhere.

python -m mtprof provides an interface similar to python -m cProfile and allows you to profile scripts, modules or entire applications.

The mtprof.Profile class has an API similar to cProfile.Profile.

Due to the way Python profiling works, mtprof is only able to exploit profiling stats from threads whose lifetime is a subset of the profiler's lifetime. A thread started before profiling was started, or ended after profiling was stopped, cannot have its statistics collected.

Due to this limitation, it is probably easier to use the command-line interface, which is similar to that of cProfile: just run python -m mtprof --help to get a view of the available options.

Only threads created using the standard threading.Thread interface are recognized. For most use cases this should not be an issue.

This package is experimental.