Purpose

Soft-profiling event. Every operation traced by the PerfTracer emits one wr_perf_trace action carrying the measured deltas. Subscribe to ship traces to a log, dashboard or telemetry pipeline — the renderer does not need to know about the consumers.

Usage

add_action( 'wr_perf_trace', array( $this, 'on_perf_trace' ) );

Parameters

  • $trace (PerfTrace): Value object with:
    • operation (string): Name of the traced operation.
    • wallMs (float): Wall-clock duration in milliseconds.
    • peakDeltaMb (int): Peak-memory delta in MB.
    • currentDeltaMb (int): Current-memory delta in MB.
    • queryDelta (int): Number of database queries issued during the operation.

Traces are additionally buffered in-process (bounded ring buffer) for the self-check surface.