Struct TraceConfig 

#[non_exhaustive]
pub struct TraceConfig {
    pub capture_body: bool,
    pub max_body_bytes: usize,
    pub header_redaction: HeaderRedactionMode,
    pub header_denylist: Vec<String>,
    pub header_allowlist: Vec<String>,
}

Trace-channel behaviour configuration (RFC 023, extended by RFC 040).

Configurable today only at this Rust level — the trace channel has no config-file or CLI surface yet (RFC 040’s own Motivation notes this; RFC 023’s [trace] TOML section was never wired to this struct). TraceEmitter::new() always uses TraceConfig::default().

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

capture_body: bool

Capture the JSON request body in each event. Default: false.

max_body_bytes: usize

Maximum serialised body size in bytes. Bodies larger than this are omitted and body_truncated = true is set. Default: 8 192.

header_redaction: HeaderRedactionMode

Denylist or allowlist by default. Default: Denylist. Governs headers, query-string parameters, and JSON body keys alike (RFC 073 S-05) — see DEFAULT_HEADER_DENYLIST’s doc comment.

header_denylist: Vec<String>

Names redacted when header_redaction is Denylist — header names, query-string parameter names, and JSON body object keys alike (RFC 073 S-05). Compared case-insensitively. Default: DEFAULT_HEADER_DENYLIST.

header_allowlist: Vec<String>

Names captured when header_redaction is Allowlist; every other name (header, query parameter, or body key) is redacted. Compared case-insensitively. Default: empty, i.e. allowlist mode redacts everything until configured — the safe direction for a fail-closed mode.

Trait Implementations

impl Clone for TraceConfig

fn clone(&self) -> TraceConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceConfig

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

Formats the value using the given formatter.

impl Default for TraceConfig

fn default() -> Self

Returns the “default value” for a type.