observedAxisArgKey property

String? observedAxisArgKey
final

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;