Struct Traceparent

pub struct Traceparent {
    pub trace_id: TraceId,
    pub span_id: SpanId,
}

A container for OpenTelemetry trace parent information used in testing.

This struct holds a trace ID and span ID pair that represents a trace context relationship. It’s commonly used for generating test trace headers and validating trace propagation in integration tests.

Example

use telemetry_rust::test::{Traceparent, TracingHeaderKind};

// Generate a new trace parent for testing
let traceparent = Traceparent::generate();

// Create HTTP headers for trace propagation
let headers = traceparent.get_headers(TracingHeaderKind::Traceparent);

// Use in HTTP request testing
let mut req = hyper::Request::new(());
for (key, value) in headers {
    if let Some(header_name) = key {
        req.headers_mut().insert(header_name, value);
    }
}

Fields

trace_id: TraceId

The OpenTelemetry trace ID

span_id: SpanId

The OpenTelemetry span ID

Implementations

impl Traceparent

pub fn generate() -> Self

Generates a new random trace parent with random trace and span IDs.

This method creates a new trace parent with randomly generated IDs, useful for creating test scenarios with unique trace contexts.

Returns

A new Traceparent with randomly generated trace and span IDs

Examples

use telemetry_rust::test::Traceparent;

let traceparent = Traceparent::generate();
println!("Trace ID: {}", traceparent.trace_id);

pub fn get_headers(&self, kind: TracingHeaderKind) -> HeaderMap

Generates HTTP headers containing trace context in the specified format.

This method creates HTTP headers with trace context information formatted according to the specified tracing header kind. This is useful for testing trace propagation with different header formats.

Arguments

• kind: The format to use for the trace headers

Returns

A HeaderMap containing the appropriately formatted trace headers

Examples

use telemetry_rust::test::{Traceparent, TracingHeaderKind};

let traceparent = Traceparent::generate();
let headers = traceparent.get_headers(TracingHeaderKind::Traceparent);

Panics

This function will panic if the trace ID or span ID cannot be converted to a valid HTTP header value format.