Struct TracingField 

pub struct TracingField { /* private fields */ }

Unified tracing metadata for a context key.

Controls two behaviors:

• Extract: populate a context variable from a tracing span field
• Enrich: include the context value in log output

Created via TracingFieldBuilder:

use dcontext_tracing::TracingField;

builder.register_with::<String>("request_id", |opts| {
    opts.cached().with_metadata(
        TracingField::builder("rid")
            .extract_from_str(|s| Some(s.to_string()))
            .enrich_display::<String>()
            .build()
    )
});

Implementations

impl TracingField

pub fn builder(log_name: &'static str) -> TracingFieldBuilder

Start building a TracingField with the given log field name.

The log_name is the field name used in log output (enrichment direction). It can differ from the context key.

pub fn log_name(&self) -> &'static str

The field name used in log output.

pub fn span_field(&self) -> Option<&'static str>

The span field name to extract from, if extraction is enabled.

pub fn has_extract(&self) -> bool

Whether this field has extraction enabled.

pub fn has_enrich(&self) -> bool

Whether this field has enrichment enabled.

pub fn format(&self, any_val: &dyn Any) -> Option<String>

Format a type-erased value for log enrichment. Returns None if enrichment is not enabled or the type doesn’t match.