Grafana Cloud へのエクスポート

Grafana Cloud は、テレメトリデータの可視化、アラート、分析を提供するフルマネージドのオブザーバビリティプラットフォームです。Cloudflare Workers のテレメトリを Grafana Cloud にエクスポートすると、次のことができます。

• Grafana Tempo で分散トレースを可視化し、リクエストの流れとパフォーマンスのボトルネックを把握できます
• Grafana Loki でログをクエリ・分析し、トレースとあわせて確認できます

このガイドでは、OpenTelemetry 準拠のトレースとログを Grafana Cloud スタックへエクスポートするよう、Cloudflare Workers を設定する手順を説明します。

始める前に、次を用意してください。

• 有効な 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 エンドポイント、認証ヘッダー、認証値をコピーします

• OTEL エンドポイントは https://otlp-gateway-prod-us-east-2.grafana.net/otlp のような形式です（トレースは /v1/traces、ログは /v1/logs を末尾に付けます）
• カスタムヘッダーには次を含めます。
  • 認証ヘッダー名 Authorization
  • 認証ヘッダー値 Basic MTMxxx...

ダッシュボードで送信先を作成したら、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 をデプロイします。