hyb-oa/docs/ops/tracing.md

Tracing Strategy

OpenTelemetry Integration

为了未来能进行细粒度的分布式追踪监控，后台程序目前内嵌了 OpenTelemetry (OTel) 的 sdk-node 及自动集成框架 auto-instrumentations-node。

• OTel 的启动是 Fail-Safe 的。所有链路追踪功能受环境变量硬闸 OTEL_TRACES_ENABLED 控制。
• 该环境变量默认情况为关闭。开启 OTEL_TRACES_ENABLED=true 时，应用将自动在 Console 输出现行 Span。在将来亦可快速配置通过 OTLP 格式投递到远端拓扑分析平台（如 Jaeger、DataDog 等）。

验证与试运行

• 可执行 cd server && node --check src/observability/tracing.js 验证基础语法挂载。
• 在开发态下，如配置 OTEL_TRACES_ENABLED=true启动服务，则客户端发出的接口请求均会在服务端控制台打印包含 Trace ID、Span ID 的追踪结果日志。由此表明 HTTP 拦截器正在正确解析和处理 traceparent 协议报文头。