How to View Resource Utilization Plots

Generate interactive visualizations of CPU and memory usage over time.

Prerequisites

Enable time series monitoring in your workflow specification:

resource_monitor:
  granularity: "time_series"
  sample_interval_seconds: 2

This creates a SQLite database with resource samples at regular intervals.

After your workflow completes, generate plots from the collected data:

torc plot-resources output/resource_utilization/resource_metrics_*.db -o plots/

This creates:

Individual job plots — CPU, memory, and process count over time for each job
Overview plots — Comparison across all jobs
Summary dashboard — Bar charts of peak and average usage

Generate plots for only certain jobs:

torc plot-resources output/resource_utilization/resource_metrics_*.db \
  -o plots/ \
  --job-ids 15,16

Open the generated HTML files in your browser:

open plots/job_15_resources.html

For custom analysis, query the SQLite database:

sqlite3 -table output/resource_utilization/resource_metrics_1_1.db

-- View samples for a specific job
SELECT timestamp, cpu_percent, memory_bytes
FROM job_resource_samples
WHERE job_id = 1
ORDER BY timestamp;