Struct SzTracer 

pub struct SzTracer { /* private fields */ }

Implementations

impl SzTracer

pub fn new(service_name: impl Into<String>) -> SzTracer

pub fn generate_trace_id() -> String

pub fn generate_span_id() -> String

pub fn get_spans(&self) -> Vec<Span>

pub fn clear(&self)

impl SzTracer

pub fn inject_legacy(&self, span: &Span) -> HashMap<String, String>

注入 legacy 自定义 header（向后兼容）

v0.2.2 修复 P2-2：保留旧版 header 格式以兼容旧客户端。 新代码应使用 Tracer::inject（W3C TraceContext）。

pub fn extract_legacy(&self, headers: &HashMap<String, String>) -> Option<Span>

仅从 legacy header 中提取 Span（向后兼容）

v0.2.2 修复 P2-2：保留旧版 header 解析以兼容旧客户端。 新代码应使用 Tracer::extract（自动优先 W3C，回退 legacy）。

Trait Implementations

impl Default for SzTracer

fn default() -> SzTracer

Returns the “default value” for a type.

impl Tracer for SzTracer

fn inject(&self, span: &Span) -> HashMap<String, String>

注入 W3C TraceContext traceparent header

v0.2.2 修复 P2-2：从自定义 trace-id/span-id/parent-span-id header 升级为 W3C TraceContext 标准的 traceparent header。

格式：00-<trace_id>-<span_id>-<trace_flags>

• 00：版本号（W3C 规范固定为 00）
• trace_id：32 字符 hex（16 字节）
• span_id：16 字符 hex（8 字节）
• trace_flags：2 字符 hex（01 表示 sampled，00 表示未采样）

同时保留 parent-span-id header 以向后兼容旧版本的 extract。

fn extract(&self, headers: &HashMap<String, String>) -> Option<Span>

从 headers 中提取 Span

v0.2.2 修复 P2-2：优先解析 W3C TraceContext traceparent header， 若不存在则回退到 legacy 自定义 header（trace-id/span-id）。

W3C traceparent 格式：00-<trace_id>-<span_id>-<trace_flags>

• 版本号必须为 00
• trace_id 必须为 32 字符 hex
• span_id 必须为 16 字符 hex
• trace_flags 必须为 2 字符 hex

fn start_span(&self, operation_name: &str) -> Span

fn end_span(&self, span: Span)