Skip to main content

official plugins for viztracer

Project description


build coverage pypi support-version license commit

official plugins for VizTracer; currently support tracing cpu and memory usage through psutil.


The prefered way to install vizplugins is via pip

pip install vizplugins

Basic Usage

The vizplugin should be used with viztracer.

You can use VizTracer and the plugin by

viztracer --plugin vizplugins.cpu_usage -- arg1 arg2

which will record the cpu percent of the process and generate a result.html file in the directory you run this command, which you can open with Chrome.

The plugin samples cpu usage per 0.02s by default, but you can explicitly indicate the desired frequency at which to sample data per second

viztracer --plugin "vizplugins.cpu_usage -f 20" -- arg1 arg2

which will sample data approximately 20 times per second, with a sampling interval of 0.05 second.

You can also trace the memory usage and cpu usage by

viztracer --plugin vizplugins --cpu_usage --memory_usage -- arg1 arg2

which will record both the cpu and memory usage.


The below image is an example of the resulting html, which is called on an recursively defined fibonacci funtion.

The "cpu_usage" on the top indicates the corresponding cpu usage at each time period. The "memory_usage" have two colors, representing rss(Resident Set Size, the non-swapped physical memory) and vms(Virtual Memory Size). You can see the details by clicking on one of the periods.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vizplugins-0.1.3.tar.gz (9.2 kB view hashes)

Uploaded source

Built Distribution

vizplugins-0.1.3-py3-none-any.whl (10.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page