SuperAPI AI 工具集

axum-impl-tracing

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:为 Axum 服务添加结构化日志与请求追踪。可观测性依赖 tracing(埋点门面)与 tracing-subscriber(收集、过滤、格式化、导出),二者在 main 中于服务器启动前装配一次。

主要能力:用 registry 加多个 Layer 组合订阅者(过滤、控制台格式化、OTLP 导出);用 TraceLayer::new_for_http() 以一行代码覆盖全部请求生命周期;用 make_span_with 自定义请求 span 字段,并应从扩展读取 MatchedPath 以按路由模板分组,避免按具体 URL 产生无限 span 基数;在处理器内用 tracing::info!(field = value, "msg") 等宏输出结构化字段,% 使用 Display、? 使用 Debug;用 #[instrument] 或 Future::instrument 为异步函数与 future 生成安全 span;可选接入 tracing_opentelemetry::layer() 导出到分布式追踪后端。

必要用法:依赖 tracing = "0.1",tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt", "registry"] },tower-http = { version = "0.6", features = ["trace"] };OpenTelemetry 导出需额外 crate。订阅者在 main 中 .init(),且只能调用一次;过滤可用 EnvFilter::try_from_default_env() 配合回退,例如 unwrap_or_else(|_| "info".into())。

限制与注意:绝不可跨 .await 持有 Span::enter() 的 drop guard,异步代码应改用 #[instrument] 或 .instrument(span);不要用 format! 把值拼进消息;未在创建时声明为 tracing::field::Empty 的字段,后续 record 会被静默忽略;#[instrument] 必须 skip 连接池、请求体与含密钥参数;TraceLayer 默认日志为 DEBUG 级,需让 RUST_LOG 允许 tower_http=debug 才可见;优雅关停时需刷新导出器以免丢失缓冲 span。