12 行
978 B
Markdown
12 行
978 B
Markdown
# 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` 协议报文头。
|