OpenTelemetry 导出
OpenClaw 通过官方的 diagnostics-otel 插件使用 OTLP/HTTP(protobuf) 导出诊断信息。日志也可以以 stdout JSONL 格式写入,用于容器和沙箱日志管道。任何接受 OTLP/HTTP 的收集器或后端都无需修改代码即可工作。有关本地文件日志,请参阅日志。
- 诊断事件是网关和捆绑插件针对模型运行、消息流、会话、队列和 exec 发出的结构化进程内记录。
diagnostics-otel订阅这些事件,并通过 OTLP/HTTP 将它们导出为 OpenTelemetry 指标、追踪和日志,还可以将日志记录镜像到 stdout JSONL。- Provider 调用在 provider 传输接受自定义 header 时,会从实际的当前 OpenTelemetry 模型调用 span 中接收 W3C
traceparentheader。诊断 ID 仍作为本地关联键,插件发出的追踪上下文不会被传播。 - 仅当诊断接口和插件均被启用时,导出器才会附加,因此默认情况下进程内开销几乎为零。
本页是一个索引。OpenTelemetry 导出文档分为五页,每页对应一个读者任务。请打开与您的任务匹配的页面。
| 页面 | 阅读时机 |
|---|---|
| 设置 OpenTelemetry 导出 | 您想安装插件、启用导出、检查导出器健康状态或将其关闭。 |
| OpenTelemetry 配置 | 您需要 diagnostics.otel 字段、OTEL_* 变量,或采样和刷新设置。 |
| 隐私和追踪上下文 | 您需要了解哪些内容会离开进程,或想延续上游追踪。 |
| 模型调用和导出的指标 | 您在构建仪表盘或告警,需要确切的指标名称和属性。 |
| 导出的 span 和诊断事件 | 您在读取追踪或将插件订阅到诊断事件。 |
各部分迁移位置¶
旧单页版本中的每个章节标题都在此处保留锚点,因此诸如 /gateway/opentelemetry#gateway-rpc 之类的现有链接仍然有效。每个条目都指向当前包含对应内容的页面。
- 快速开始
- 导出的信号
- 哪些进程会导出
- 导出器健康
- 配置参考
- 环境变量
- 延续上游 WebSocket 追踪
- 隐私和内容捕获
- 采样和刷新
- 模型调用观测单元
- Claude Code CLI 模型调用保真度
- 导出的指标
- 网关 RPC
- 模型用量
- 消息流
- 对话
- 队列和会话
- 会话活跃度遥测
- 网关事件循环观测窗口
- Harness 生命周期
- 工具执行和循环检测
- Exec
- 诊断内部机制(内存、负载、导出器健康)
- 导出的 span
- 诊断事件目录
- 无导出器时
- 禁用
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw