跳转至

OpenTelemetry 导出

OpenClaw 通过官方 diagnostics-otel 插件、使用 OTLP/HTTP（protobuf） 导出诊断信息。日志也可以写为 stdout JSONL，供容器和沙箱日志管道使用。任何接受 OTLP/HTTP 的收集器或后端都可以在无需修改代码的情况下工作。有关本地文件日志，请参阅日志记录。

  • 诊断事件是由 Gateway 和捆绑插件发出的结构化进程内记录，涵盖模型运行、消息流、会话、队列和执行（exec）。
  • diagnostics-otel 订阅这些事件，并通过 OTLP/HTTP 将其作为 OpenTelemetry 指标、追踪和日志导出，同时可以将日志记录镜像到 stdout JSONL。
  • 提供方调用会在提供方传输接受自定义标头时，从当前实际的 OpenTelemetry 模型调用 span 接收 W3C traceparent 标头。诊断 ID 仍作为本地关联键，插件发出的追踪上下文不会被传播。
  • 导出器仅在诊断接口和插件都启用时才会接入，因此默认情况下进程内开销几乎为零。

本页是一个索引。OpenTelemetry 导出文档分为五个页面，每个页面面向一种读者任务。请打开与你任务匹配的页面。

页面 何时阅读
设置 OpenTelemetry 导出 你想安装插件、开启导出、检查导出器健康状况，或将其关闭。
OpenTelemetry 配置 你需要 diagnostics.otel 字段、OTEL_* 变量，或采样和刷新设置。
隐私与追踪上下文 你需要了解哪些内容会离开进程，或想延续上游追踪。
模型调用与导出的指标 你在构建仪表盘或告警，需要确切的指标名称和属性。
导出的 Span 与诊断事件 你在阅读追踪，或正在让插件订阅诊断事件。

各章节迁移位置

上一版单页文档中的每个章节标题都在此处保留其锚点，因此诸如 /gateway/opentelemetry#gateway-rpc 之类的现有链接仍然有效。每个条目都指向现在包含对应内容的页面。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw