Struct DirectiveSet 

pub struct DirectiveSet { /* private fields */ }

The set of active directives, evaluated per request. Cheap to evaluate (a filtered scan); typically a handful of directives are active at once.

Implementations

impl DirectiveSet

pub fn new() -> Self

An empty set, every request evaluates to DiagLevel::Off.

pub fn from_directives(directives: Vec<DiagnosticsDirective>) -> Self

Builds a set from active directives.

pub fn len(&self) -> usize

How many directives the set holds.

pub fn is_empty(&self) -> bool

Whether the set is empty (every request evaluates to Off).

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

The effective level for a request: the highest level among the directives that apply (target matches, not expired, in sample), or DiagLevel::Off if none do.

pub fn wants_ring_buffer( &self, attrs: &RequestAttrs<'_>, now: Instant, request: &RequestId, ) -> bool

Whether any applying directive requests local ring-buffer capture.

pub fn wants_capture( &self, attrs: &RequestAttrs<'_>, now: Instant, request: &RequestId, ) -> bool

Whether any applying directive turns on fleet traffic capture for this request. The runtime gate for capture-on-demand: with no matching directive (the baseline), this is false and nothing is teed.

pub fn introspect(&self, now: Instant) -> Value

A well-defined, shape-only introspection of the active settings: for each directive, what it targets, at what verbosity and sample, whether it captures to the ring buffer, and whether it has expired at now.

This is the read side of the control-plane store, an agent fetches it to see exactly what an instance is applying. The schema mirrors the publish body (crate::DirectiveSet decoding), except the relative ttl_secs is reported as a computed expired flag, since expiry is held as an absolute monotonic instant that has no portable numeric form. Value-free throughout: the only strings are operator-authored ids and targeting selectors.

Trait Implementations

impl Clone for DirectiveSet

fn clone(&self) -> DirectiveSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirectiveSet

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

Formats the value using the given formatter.

impl Default for DirectiveSet

fn default() -> DirectiveSet

Returns the “default value” for a type.