watson / trace-context

Extract and inject W3C TraceContext headers in Rust

trace-context

Extract and inject W3C TraceContext headers.

• Documentation
• Crates.io

Installation

cargo add trace-context

Example usage

let mut headers = http::HeaderMap::new();
headers.insert(
  "traceparent",
  "00-0af7651916cd43dd8448eb211c80319c-00f067aa0ba902b7-01".parse().unwrap()
);

let context = trace_context::TraceContext::extract(&headers).unwrap();

let trace_id = u128::from_str_radix("0af7651916cd43dd8448eb211c80319c", 16);
let parent_id = u64::from_str_radix("00f067aa0ba902b7", 16);

assert_eq!(context.trace_id(), trace_id.unwrap());
assert_eq!(context.parent_id(), trace_id.ok());
assert_eq!(context.sampled(), true);

Safety

This crate uses #![deny(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

License

MIT OR Apache-2.0

trace-context's Issues

Support constructing a TraceContext from a string and not just a HeaderMap

This crate would be more useful if the interface to consturct a TraceContext didn't assume a HeaderMap as input, as all its doing is extracting the string value of the header and then parsing.

I'm happy to raise a PR to implement this but wanted to get your thoughts on how you'd like it implemented. The idomatic way might be to have a FromStr impl such as TraceContex::from_str()?.