导出到 Grafana Cloud

Grafana Cloud 是一个完全托管的可观测性平台，为遥测数据提供可视化、告警和分析。将 Cloudflare Workers 遥测导出到 Grafana Cloud 后，您可以：

• 在 Grafana Tempo 中可视化分布式追踪，了解请求流程和性能瓶颈
• 在 Grafana Loki 中查询和分析日志，并与追踪关联

本指南将引导您配置 Cloudflare Workers，将符合 OpenTelemetry 标准的追踪和日志导出到 Grafana Cloud 栈。

开始之前，请确保您拥有：

• 有效的 Grafana Cloud 账户 ↗（提供免费套餐）
• 要监控的已部署 Worker

1. 登录 Grafana Cloud 门户 ↗
2. 从组织主页导航到 Connections（连接） → Add new connection（添加新连接）
3. 搜索 "OpenTelemetry" 并选择 OpenTelemetry (OTLP)
4. 选择 Quickstart（快速入门），然后选择 JavaScript
5. 点击 Create a new token（创建新令牌）
6. 输入令牌名称（例如 cloudflare-workers-otel）并点击 create token（创建令牌）
7. 点击 Close（关闭），无需复制令牌
8. 复制并保存 Environment variables 代码块中 OTEL_EXPORTER_OTLP_ENDPOINT 和 OTEL_EXPORTER_OTLP_HEADERS 的值，分别作为 OTel 端点和 Auth 标头值

1. 导航到 Cloudflare 账户的 Workers Observability ↗ 部分
2. 点击 Add destination（添加目标） 并配置目标名称（例如 grafana-tracing）
3. 从 Grafana 复制 Otel 端点、auth 标头和 auth 值

• OTEL 端点格式类似 https://otlp-gateway-prod-us-east-2.grafana.net/otlp（追踪追加 /v1/traces，日志追加 /v1/logs）
• 自定义标头应包括：
  • Auth 标头名称 Authorization
  • Auth 标头值 Basic MTMxxx...

在 Cloudflare 仪表板中创建目标后，更新 Worker 配置以启用遥测导出。

{
  "observability": {
    "traces": {
      "enabled": true,
      // Must match the destination name in the dashboard
      "destinations": ["grafana-traces"]
    },
    "logs": {
      "enabled": true,
      // Must match the destination name in the dashboard
      "destinations": ["grafana-logs"]
    }
  }
}

[observability.traces]
enabled = true
destinations = [ "grafana-traces" ]

[observability.logs]
enabled = true
destinations = [ "grafana-logs" ]

更新配置后，部署 Worker 以使更改生效。