跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

OpenTelemetry 导出

最后更新 查看 MarkdownAgent 设置

Cloudflare 可将遥测数据导出到支持 OpenTelemetry Protocol (OTLP) 的目标。将这些目标与 Cloudflare 遥测数据以及现有可观测性工具配合使用。

支持的遥测数据

你可以导出以下遥测类型:

  • Cloudflare Traces - 显示生产请求在 Cloudflare 中路径的跟踪
  • Workers Traces - 显示请求在 Workers 及关联服务中流转的跟踪
  • Workers Logs - 应用和系统日志,包括 console.log() 输出

可用目标

这些端点格式覆盖常见可观测性提供商。请查阅提供商文档,了解当前的身份验证要求。

提供商 跟踪端点 日志端点
Honeycomb https://api.honeycomb.io/v1/traces https://api.honeycomb.io/v1/logs
Grafana Cloud https://otlp-gateway-<REGION>.grafana.net/otlp/v1/traces https://otlp-gateway-<REGION>.grafana.net/otlp/v1/logs
Firetiger ↗ https://ingest.cloud.firetiger.com/v1/traces https://ingest.cloud.firetiger.com/v1/logs
Axiom https://api.axiom.co/v1/traces https://api.axiom.co/v1/logs
Sentry https://<HOST>/api/<PROJECT_ID>/integration/otlp/v1/traces https://<HOST>/api/<PROJECT_ID>/integration/otlp/v1/logs
Sematext ↗ https://otlp-receiver.sematext.com (US)、https://otlp-receiver.eu.sematext.com (EU) https://otlp-receiver.sematext.com (US)、https://otlp-receiver.eu.sematext.com (EU)
PostHog 不支持 https://<REGION>.i.posthog.com/i/v1/logs
Datadog ↗ https://cloudflare.integrations.otlp.<DD_SITE>/v1/traces https://cloudflare.integrations.otlp.<DD_SITE>/v1/logs
New Relic ↗ https://otlp.nr-data.net/v1/traces https://otlp.nr-data.net/v1/logs
Splunk Observability ↗ https://ingest.<REALM>.signalfx.com/v2/trace/otlp 不适用
Splunk Platform ↗ http://splunk.internal:4318/v1/traces http://splunk.internal:4318/v1/logs
SigNoz ↗ https://ingest.<region>.signoz.cloud:443/v1/traces https://ingest.<region>.signoz.cloud:443/v1/logs

创建目标

首先创建账户级的 Cloudflare Observability 目标。

Observability Destinations 仪表板,显示已配置的 Grafana 和 Honeycomb 目标及其端点和状态
  1. 在 Cloudflare 仪表板中,前往 Observability > Destinations(目标)。

    前往 OpenTelemetry ↗
  2. 选择 Add destination(添加目标)。

  3. 配置目标:

    • Destination name(目标名称) - 输入描述性名称,例如 grafana-traces。
    • Destination type(目标类型) - 选择 Traces 或 Logs。
    • OTLP endpoint(OTLP 端点) - 输入对应遥测类型的提供商端点。
    • Custom headers(自定义标头) - 添加提供商所需的身份验证标头。
  4. 选择 Save(保存)。

Edit Destination 对话框,显示 Honeycomb 跟踪配置,包括目标名称、类型选择、OTLP 端点和自定义标头

为 Cloudflare Traces 启用导出

在域名设置的 Export destinations(导出目标) 下添加目标。请参阅 Cloudflare Traces 配置。

为 Worker 启用 OpenTelemetry 导出

创建目标后,配置并重新部署 Worker。请参阅 Workers OpenTelemetry 导出。

检查目标状态

仪表板会显示每个目标的投递状态。该状态反映最近一次投递尝试。

状态 说明 故障排除
Last: n minutes ago Cloudflare 最近已成功投递数据。 无需操作
Never run Cloudflare 尚未投递数据。 检查源流量、导出设置和采样率
Error Cloudflare 无法投递数据。 检查 OTLP 端点和身份验证标头

已知限制

部分提供商并非支持所有 OTLP 遥测类型。请查看可用目标以及提供商文档。

这篇文档对您有帮助吗?