observedAxisArgKey property
Trace-event arg key holding the detector-observed axis value,
stamped by the detector via PerformanceIssue.extraTraceArgs (e.g.
'observedCount' for PlatformChannelDetector's frequency axis).
When non-null, the audit gate cross-checks the capture's
expectedMagnitude.observed (a SEND-side estimate computed by
the capture-helper screen) against this trace-event arg using
observedAxisTolerance, rejecting captures whose send-side and
detector-observed magnitudes diverge enough to cross a bracket
band boundary. Null when the detector does not export a
cross-checkable observed value (most non-frequency detectors).
Backward compatibility: pre-v0.19.5 captures recorded before detectors started exporting observed-axis values lack the arg and the cross-check is skipped per-record. The metadata setting stays harmless for legacy captures.
Declaration alone does not guarantee the cross-check is active —
the schema's per-record gate skips silently when capture records
lack the arg. The audit invariant
checkCapturesCarryObservedAxisArg (in
test/validation/_support/audit_invariants.dart) enforces capture
fidelity for non-allowlisted runtimeVerified+ brackets; entries in
legacyObservedAxisAllowlist (typed manifest in same file) are
exempt pending capture re-record with a consumeBy deadline.
Implementation
final String? observedAxisArgKey;