跳转至

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 traceparent header。诊断 ID 仍作为本地关联键,插件发出的追踪上下文不会被传播。
  • 仅当诊断接口和插件均被启用时,导出器才会附加,因此默认情况下进程内开销几乎为零。

本页是一个索引。OpenTelemetry 导出文档分为五页,每页对应一个读者任务。请打开与您的任务匹配的页面。

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

各部分迁移位置

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

  • 日志 - 文件日志、控制台输出、CLI 尾部跟踪以及 Control UI 日志选项卡
  • 网关日志内部机制 - WS 日志样式、子系统前缀和控制台捕获
  • 诊断标志 - 定向调试日志标志
  • 诊断导出 - 运维支持包工具(与 OTEL 导出分开)
  • 配置参考 - 完整的 diagnostics.* 字段参考
  • Prometheus 指标 - 通过 diagnostics-prometheus 插件将诊断信息以 Prometheus 文本指标形式暴露
  • 审计历史 - 与这些追踪并列的审计账本

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