Add CPU time to telemetry

[sebastianbergmann]

Every emitted event now carries CPU time information (user, system, and total) alongside wall-clock time, memory usage, and garbage collector status. This makes it possible to distinguish CPU-bound from I/O-bound test work, wall-clock time alone conflates the two.

The Telemetry value object that is part of each Event emitted now exposes user, system, and total CPU time, plus deltas since the test run started and since the previous event (mirroring how duration and memory usage are already exposed).

The <phpunit:resourceUsage> element of Open Test Reporting XML gains three new attributes (userCpuTime, systemCpuTime, cpuTime) for both test and test-suite entries. The schema is updated accordingly.

JUnit XML and TeamCity output formats as well as other outputs are unchanged.

[github-actions]

API Surface Changes

If any of the additions below are not intended as public API, mark them with @internal in the docblock.

New API Surface

Classes

• PHPUnit\Event\Telemetry\CpuTime — class PHPUnit\Event\Telemetry\CpuTime

Methods

• PHPUnit\Event\Telemetry\CpuTime::fromSecondsAndNanoseconds — static public function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds): self
• PHPUnit\Event\Telemetry\CpuTime::seconds — public function seconds(): int
• PHPUnit\Event\Telemetry\CpuTime::nanoseconds — public function nanoseconds(): int
• PHPUnit\Event\Telemetry\CpuTime::asFloat — public function asFloat(): float
• PHPUnit\Event\Telemetry\CpuTime::add — public function add(self $other): self
• PHPUnit\Event\Telemetry\CpuTime::diff — public function diff(self $other): self
• PHPUnit\Event\Telemetry\Info::userCpuTime — public function userCpuTime(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::systemCpuTime — public function systemCpuTime(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::totalCpuTime — public function totalCpuTime(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::userCpuTimeSinceStart — public function userCpuTimeSinceStart(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::systemCpuTimeSinceStart — public function systemCpuTimeSinceStart(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::totalCpuTimeSinceStart — public function totalCpuTimeSinceStart(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::userCpuTimeSincePrevious — public function userCpuTimeSincePrevious(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::systemCpuTimeSincePrevious — public function systemCpuTimeSincePrevious(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Info::totalCpuTimeSincePrevious — public function totalCpuTimeSincePrevious(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Snapshot::userCpuTime — public function userCpuTime(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Snapshot::systemCpuTime — public function systemCpuTime(): PHPUnit\Event\Telemetry\CpuTime
• PHPUnit\Event\Telemetry\Snapshot::totalCpuTime — public function totalCpuTime(): PHPUnit\Event\Telemetry\CpuTime

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.86%. Comparing base (53effd8) to head (cf4af52).
⚠️ Report is 6 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #6611      +/-   ##
============================================
+ Coverage     96.84%   96.86%   +0.01%     
- Complexity     8476     8510      +34     
============================================
  Files           861      863       +2     
  Lines         26126    26283     +157     
============================================
+ Hits          25301    25458     +157     
  Misses          825      825              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.