xai-tracing

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

安全、扩展与运维

xai-tracing

提供跨模块共享的结构化 tracing 基础设施。

8生产文件

8Rust 文件总数

847生产代码行

30收录公开符号

职责与架构位置

xai-tracing 位于“安全、扩展与运维”层。它的首要职责是：提供跨模块共享的结构化 tracing 基础设施。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/common/xai-tracing，清单位于 Cargo.toml。

关键入口

SOURCElib.rscrates/common/xai-tracing/src/lib.rs:1–1120 行 · 模块入口↗SOURCETracedChannelcrates/common/xai-tracing/src/grpc_client.rs:13–23389 行 · 公开符号入口↗SOURCEattach_trace_to_http_requestcrates/common/xai-tracing/src/http_client.rs:7–17156 行 · 公开符号入口↗SOURCEinit_fastracecrates/common/xai-tracing/src/fastrace.rs:10–2084 行 · 公开符号入口↗SOURCEOtelTestEnvcrates/common/xai-tracing/src/testing.rs:9–1966 行 · 公开符号入口↗SOURCETimercrates/common/xai-tracing/src/timer.rs:4–1463 行 · 公开符号入口↗

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

直接依赖

无一方 crate 依赖

直接调用者

xai-computer-hub-sdkxai-grok-workspace

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型	符号	文件与行号
fn	dispatcher_active	crates/common/xai-tracing/src/dispatch.rs:23
fn	init_fastrace	crates/common/xai-tracing/src/fastrace.rs:12
fn	current_trace_id	crates/common/xai-tracing/src/fastrace.rs:38
fn	local_or_random_span_ctx	crates/common/xai-tracing/src/fastrace.rs:42
fn	enter_span_with_traceparent	crates/common/xai-tracing/src/fastrace.rs:46
type	FastraceChannel	crates/common/xai-tracing/src/fastrace.rs:56
fn	fastrace_channel	crates/common/xai-tracing/src/fastrace.rs:58
struct	TraceparentMiddleware	crates/common/xai-tracing/src/fastrace.rs:69
type	TracedChannel	crates/common/xai-tracing/src/grpc_client.rs:15
fn	traced_channel	crates/common/xai-tracing/src/grpc_client.rs:32
struct	MakeClientSpan	crates/common/xai-tracing/src/grpc_client.rs:41
struct	InjectTraceContextLayer	crates/common/xai-tracing/src/grpc_client.rs:61
struct	InjectTraceContextService	crates/common/xai-tracing/src/grpc_client.rs:72
fn	attach_trace_to_grpc_request_mut	crates/common/xai-tracing/src/grpc_client.rs:96
fn	attach_trace_to_grpc_request	crates/common/xai-tracing/src/grpc_client.rs:105
struct	MetadataInjector	crates/common/xai-tracing/src/grpc_client.rs:113
struct	HeaderExtractor	crates/common/xai-tracing/src/grpc_client.rs:131
fn	attach_trace_to_http_request	crates/common/xai-tracing/src/http_client.rs:9
type	TracedHttpClient	crates/common/xai-tracing/src/http_client.rs:16
fn	traced_client	crates/common/xai-tracing/src/http_client.rs:18
fn	traced_client_new	crates/common/xai-tracing/src/http_client.rs:22
fn	traced_client_from_builder	crates/common/xai-tracing/src/http_client.rs:26
struct	OtelTestEnv	crates/common/xai-tracing/src/testing.rs:11
fn	install	crates/common/xai-tracing/src/testing.rs:18
fn	finished_spans	crates/common/xai-tracing/src/testing.rs:39
fn	parse_traceparent	crates/common/xai-tracing/src/testing.rs:45
fn	otel_span_id_hex	crates/common/xai-tracing/src/testing.rs:53
fn	otel_trace_id_hex	crates/common/xai-tracing/src/testing.rs:60
struct	Timer	crates/common/xai-tracing/src/timer.rs:6
fn	new	crates/common/xai-tracing/src/timer.rs:19

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

Telemetry、Mixpanel、Tracing 与 Macros区分产品事件、错误上报、内部 tracing 和计时宏。

完整 Rust 文件索引

共 8 个 Rust 文件，其中 8 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

生产源码crates/common/xai-tracing/src/dispatch.rs46 行 · 1 个公开符号生产源码crates/common/xai-tracing/src/fastrace.rs84 行 · 7 个公开符号生产源码crates/common/xai-tracing/src/grpc_client.rs389 行 · 9 个公开符号生产源码crates/common/xai-tracing/src/http_client.rs156 行 · 5 个公开符号生产源码crates/common/xai-tracing/src/lib.rs20 行 · 0 个公开符号生产源码crates/common/xai-tracing/src/testing.rs66 行 · 6 个公开符号生产源码crates/common/xai-tracing/src/timer.rs63 行 · 4 个公开符号生产源码crates/common/xai-tracing/src/tokio.rs23 行 · 1 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/common/xai-tracing，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。