Skip to content

Repository files navigation

tool-procstat

CI Actions Status

Collects and post-processes files from the /proc filesystem for the crucible performance testing framework.

Data Collected

Procstat periodically snapshots /proc files during test execution. The default set is:

/proc File Data
interrupts Per-CPU interrupt counts (post-processed into interrupt rates)
vmstat Virtual memory statistics
slabinfo Kernel slab allocator statistics
softirqs Software interrupt counts
meminfo System memory usage
schedstat Scheduler statistics
net/softnet_stat Per-CPU packet processing, dropped, and time-squeeze counts (post-processed into rates)

Configuration

The start script accepts two parameters:

  • --files <list> — Comma-separated list of /proc files to collect (default: interrupts,vmstat,slabinfo,softirqs,meminfo,schedstat,net/softnet_stat)
  • --interval <seconds> — Collection interval in seconds (default: 3)

Integration

Procstat runs as a profiler tool on endpoint nodes. It is allowed on profiler, master, and worker collector roles but blocked on client and server roles. The post-processor (procstat-post-process) derives interrupt-rate metrics from the raw snapshots using parallel processing.

rickshaw.json

Defines how procstat integrates with rickshaw: which files to deploy to engines, which endpoint/collector-type combinations are allowed or blocked, and the post-processing script.

About

Tool subproject to facilitate collection and post-processing of data in /proc

Resources

Stars

1 star

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages