Powerlog

A command-line tool that measures the CPU and GPU energy consumed by an unmodified program.

pip install powerlog
powerlog ./my_program --arg value

Powerlog launches the target as a subprocess and samples per-GPU power from NVML and CPU-package power from RAPL in lockstep, time-stamping both against the same wall clock. Nothing is recompiled and no source is instrumented, so the trace spans I/O, host-device transfers, kernel launches and synchronization — the energy per-kernel tools miss. Measuring only the GPU is not enough either: the CPU package is frequently a large, workload-dependent share of the total.

Any domain the platform does not expose is reported as n/a rather than failing the run.

• Installation
  • What you need
  • From source
• Quick Start
  • Give the run enough time
  • Common invocations
• Command Line Reference
  • Options
  • Exit status
  • Examples
• Example Applications
  • Parameters
  • Running them
  • Datalog case study
• Backends
  • GPU
  • CPU
  • Selecting
  • Troubleshooting
• Methodology
  • How a measurement runs
  • Energy computation
  • Choosing a sampling interval
  • Accuracy and known biases
• Output
  • Reading the summary block
  • Summary CSV
  • Samples CSV
  • Working with the output
• Python API Reference
  • Measurement
  • Reporting
  • Backends
  • Command line
  • Constants
• Changelog
  • 0.1.2 (unreleased)
  • 0.1.1 (2026-09-15)
  • 0.1.0
  • 0.0.2 (2025-07-10)
  • 0.0.1 (2025-07-01)

• Index

• Search Page