/proc Tracer
This is the developer/maintainer documentation. For user documentation, go to https://github.com/david-kracht/proctracer
Setup
You can run proctracer from source in Windows, MacOS, and Linux:
-
Install pip following pip docs.
-
Clone proctracer repository:
$ git clone https://github.com/david-kracht/proctracer.git- Install in editable mode
$ cd proctracer && sudo pip install -e .- You are ready, try to run proctracer:
$ proctracer --help
usage: /proc Tracer (Daemon) [-h] [-c CONFIG] [-o OUTPUT_PATH] [-n REPORT_NAME] [-f] {start,stop,restart,message} ...
positional arguments:
{start,stop,restart,message}
start Start Tracer
stop Stop Tracer
restart Restart Tracer
message Message to Running Tracer
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Path to /proc Tracer config yaml.
-o OUTPUT_PATH, --output_path OUTPUT_PATH
Output path for report.
-n REPORT_NAME, --report_name REPORT_NAME
Name of the report file.
-f, --foreground Start Tracer in foreground, not daemonized.- Examplary usage and result:
$ proctracer -o ~/1/2 -n proc_report start
Start /proc Tracer (Daemon)...
Output will be written to: /root/1/2
$ proctracer message first
Message to running /proc Tracer (Daemon) ...
$ proctracer message 2nd
Message to running /proc Tracer (Daemon) ...
$ proctracer message 2nd
Message to running /proc Tracer (Daemon) ...
$ proctracer message 3rd
Message to running /proc Tracer (Daemon) ...
$ stress -c 1 -t 5
stress: info: [514601] dispatching hogs: 1 cpu, 0 io, 0 vm, 0 hdd
stress: info: [514601] successful run completed in 5s
$ proctracer stop
Stop /proc Tracer (Daemon).
$ tree ~/1
/home/user/1
└── 2
└── proc_report.pdf- Package and Upload
Place token in
~/.pypirc, i.e
[pypi] username = token password = pypi-AgEIcHlwa0A5vasXU4w
$ chmod 600 ~/.pypirc
$ sudo pip install twine
$ python3 setup.py sdist bdist_wheel
$ twine upload dist/*
