0xMiden / 0xMiden/note-transport-service

Docs and CHANGELOG reference telemetry env vars/flags the code doesn't read

未关闭
#134 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
documentation production-readiness
主要语言
Rust
星标
3
派生
10
平均合并
2 小时 23 分钟
30 天内合并 PR
4

描述

Severity: medium (documentation).

### Summary

Operator docs (`docs/src/operator/monitoring.md:5-7,78-84`, `docs/external/src/operators.md:55-60`) document `OTEL_ENABLED` / `OTEL_TRACES_ENDPOINT`, but the code only reads `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` / `OTEL_EXPORTER_OTLP_ENDPOINT` (`crates/node/src/logging.rs:41-50`). The CHANGELOG (v0.4.1) additionally claims `--enable-otel`/`--otel-endpoint` CLI flags that do not exist (`bin/node/src/main.rs:11-39`).

### Impact

An operator following the published docs gets zero telemetry, silently — compounded by the exporter build error being swallowed at `logging.rs:96` (a malformed endpoint disables tracing with no log).

### Recommendation

Fix both doc trees and the changelog to the actual `OTEL_EXPORTER_OTLP_*` variables; log a warning (or fail startup) when an explicitly-requested OTEL exporter fails to build.

---
Part of #114.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。