跳转到内容
CrewAI 中文文档

导出 OpenTelemetry

CrewAI AMP 可以将部署中的 OpenTelemetry traces 和 logs 直接导出到你自己的收集器。这使你能够使用现有的可观测性栈来监控智能体性能、跟踪 LLM 调用并排查问题。

遥测数据遵循 OpenTelemetry GenAI semantic conventions 以及额外的 CrewAI 专属属性。

前提条件

Section titled “前提条件”

CrewAI AMP 账号

你的组织必须拥有有效的 CrewAI AMP 账号。

OpenTelemetry 收集器

你需要一个兼容 OpenTelemetry 的收集器终端节点（例如你自己的 OTel Collector、Datadog、Grafana 或任何兼容 OTLP 的后端）。

设置收集器

Section titled “设置收集器”
  1. 在 CrewAI AMP 中，前往 Settings > OpenTelemetry Collectors。
  2. 点击 Add Collector。
  3. 选择一个集成：
    • OpenTelemetry Traces 和 OpenTelemetry Logs - 导出到任何兼容 OTLP 的收集器或后端。
    • Datadog - 直接将 traces 发送到 Datadog 的 OTLP intake，无需单独的收集器或 Datadog Agent。
  4. 配置连接。字段取决于你选择的集成：
OpenTelemetry Traces / Logs

OpenTelemetry Traces 和 OpenTelemetry Logs 是两个独立的集成，但它们共用同一组字段 - 选择与你要导出的信号相匹配的项。

  • Endpoint - 你的收集器 OTLP 终端节点，例如 https://otel-collector.example.com:4317。
  • Service Name - 用于在可观测性平台中标识该服务的名称。
  • Custom Headers (optional) - 以键值对形式添加认证或路由请求头。
  • Certificate (optional) - 如果你的收集器需要 TLS 证书，请提供。
OpenTelemetry collector configuration
Datadog

关于 Datadog 的设置，请参阅专门的 Datadog Integration 指南 - 其中同时覆盖 Datadog Agent 路径（推荐，日志量成本更低）以及 Datadog 的 OTLP intake 和完整的收集器配置步骤。

  1. (optional) 点击 Test Connection，验证 CrewAI 能否使用你提供的凭据访问该终端节点。
  2. 点击 Save。