Cirron measures a piece of Python code and report back several performance counters: CPU instruction count, branch misses, page faults and time spent measuring. It uses the Linux perf events interface or @ibireme's KPC demo on OSX.
It can also trace syscalls using strace, Linux only!
- Linux with perf events support / Apple ARM OSX
- C++
- Python 3.x
Clone the repository:
git clone https://github.com/s7nfo/Cirron.git
pip install ./CirronThe Python wrapper automatically compiles the C++ library (cirronlib.cpp) on first use.
from cirron import Collector
# Start collecting performance metrics
with Collector() as collector:
# Your code here
# ...
# Retrieve the metrics
print(collector.counters)
from cirron import Tracer, to_tef
with Tracer() as tracer:
# Your code here
# ...
# Stop collecting and retrieve the trace
print(tracer.trace)
# Save the trace for ingesting to Perfetto
open("/tmp/trace", "w").write(to_tef(trace))