Struct XRayTraceHeader 

pub struct XRayTraceHeader {
    pub root: String,
    pub parent: Option<String>,
    pub sampled: Option<bool>,
}

Parsed X-Ray trace header components.

Fields

root: String

The X-Ray Root trace ID (e.g., “1-5759e988-bd862e3fe1be46a994272793”).

parent: Option<String>

The parent segment ID (e.g., “53995c3f42cd8ad8”).

sampled: Option<bool>

Whether sampling is enabled (1) or disabled (0).

Implementations

impl XRayTraceHeader

pub fn parse(header: &str) -> Option<Self>

Parses an X-Ray trace header string.

The format is: Root=1-{timestamp}-{random};Parent={parent_id};Sampled={0|1}

Arguments

• header - The X-Ray trace header string

Returns

Returns Some(XRayTraceHeader) if parsing succeeds, None otherwise.

Examples

use opentelemetry_lambda_extension::XRayTraceHeader;

let header = "Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1";
let parsed = XRayTraceHeader::parse(header).unwrap();
assert_eq!(parsed.root, "1-5759e988-bd862e3fe1be46a994272793");
assert_eq!(parsed.parent, Some("53995c3f42cd8ad8".to_string()));
assert_eq!(parsed.sampled, Some(true));

pub fn to_w3c(&self) -> Option<W3CTraceContext>

Converts the X-Ray trace header to W3C trace context format.

Returns a tuple of (trace_id, span_id, trace_flags) suitable for use with OpenTelemetry span context.

Returns

Returns Some((trace_id, span_id, sampled)) if conversion succeeds.

• trace_id is a 32-character hex string (16 bytes)
• span_id is a 16-character hex string (8 bytes)
• sampled indicates whether the trace is sampled

Returns None if the parent is not present or conversion fails.

pub fn to_header_string(&self) -> String

Returns the raw X-Ray trace header string.

Trait Implementations

impl Clone for XRayTraceHeader

fn clone(&self) -> XRayTraceHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XRayTraceHeader

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

Formats the value using the given formatter.

impl Display for XRayTraceHeader

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

Formats the value using the given formatter.

impl PartialEq for XRayTraceHeader

fn eq(&self, other: &XRayTraceHeader) -> 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 Eq for XRayTraceHeader

impl StructuralPartialEq for XRayTraceHeader