Struct DiagnosticsDirective 

pub struct DiagnosticsDirective {
    pub id: String,
    pub match_: DirectiveMatch,
    pub level: DiagLevel,
    pub sample_per_mille: u16,
    pub expires_at: Instant,
    pub ring_buffer: bool,
    pub capture: bool,
}

One diagnostics directive: target, verbosity, sampling, and expiry.

Fields

id: String

A stable id for management/correlation (never a tenant value).

match_: DirectiveMatch

What this directive targets.

level: DiagLevel

The verbosity to apply to matching requests.

sample_per_mille: u16

Fraction of matching requests to record, in 0..=1 (scaled to per-mille so the directive stays Eq/Hash-friendly; 1000 = always).

expires_at: Instant

Absolute expiry: a request at or after this instant does not match (the TTL was applied when the directive was created).

ring_buffer: bool

Single-instance break-glass: capture into the local ring buffer.

capture: bool

Fleet traffic capture: tee the matching exchanges to the configured capture sink (e.g. Kafka). The runtime on/off switch for capture, off in the baseline, flipped on by publishing a directive, so capture is on demand and fleet-wide with no restart. Distinct from Self::ring_buffer, which is the single-instance forensic tape.

Implementations

impl DiagnosticsDirective

pub fn level_if_applies( &self, attrs: &RequestAttrs<'_>, now: Instant, request: &RequestId, ) -> Option<DiagLevel>

This directive’s DiagLevel if it applies to attrs at now for request (target matches, not expired, in sample), else None. Used to fold a single-request (signed-header) directive into the evaluation.

Trait Implementations

impl Clone for DiagnosticsDirective

fn clone(&self) -> DiagnosticsDirective

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DiagnosticsDirective

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for DiagnosticsDirective

impl PartialEq for DiagnosticsDirective

fn eq(&self, other: &DiagnosticsDirective) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DiagnosticsDirective