OpenTelemetry データのエクスポート

Cloudflare Workers は、OpenTelemetry (OTel) 準拠のテレメトリデータを、OTel エンドポイントがある任意の送信先へエクスポートできます。既存の監視・可観測性スタックと連携できます。

次の種類のテレメトリデータをエクスポートできます。

• トレース - Worker と接続先サービスを通るリクエストの流れを示すトレース
• ログ - console.log() の出力とシステム生成ログを含むアプリケーションログ

注: Worker のメトリクスとカスタムメトリクスのエクスポートには、まだ対応していません。

よく使う可観測性プロバイダーの OTLP エンドポイント形式を次に示します。詳細と認証要件は、各プロバイダーのドキュメントを参照してください。

送信先へのデータ送信を始めるには、Cloudflare ダッシュボードで送信先を作成します。

1. アカウントのダッシュボードで Workers Observability ↗ を開きます
2. 送信先の追加をクリックします。
3. 送信先を設定します。
   • Destination Name - わかりやすい名前（例: "Grafana-tracing"、"Honeycomb-Logs"）
   • Destination Type - "Traces" または "Logs" を選びます
   • OTLP Endpoint - 可観測性プラットフォームが OTLP データを受け付ける URL
   • Custom Headers（任意） - 認証ヘッダーや、プロバイダーが求めるその他のヘッダー
4. 送信先を保存します

ダッシュボードで送信先を設定したあと、Wrangler 設定を更新して、Worker からテレメトリデータをエクスポートします。設定ファイルの送信先名は、ダッシュボードで設定した送信先と同じにしてください。

{
	"observability": {
		"traces": {
			"enabled": true,
			"destinations": ["tracing-destination-name"],

			// traces sample rate of 5%
			"head_sampling_rate": 0.05,

			// (optional) set to false to only export traces to your
			// destination without persisting them in the Cloudflare dashboard
			"persist": false
		},
		"logs": {
			"enabled": true,
			"destinations": ["logs-destination-name"],
			// logs sample rate of 60%
			"head_sampling_rate": 0.6,

			// (optional) set to false to only export logs to your
			// destination without persisting them in the Cloudflare dashboard
			"persist": false
		}
	}
}

[observability.traces]
enabled = true
destinations = [ "tracing-destination-name" ]
head_sampling_rate = 0.05
persist = false

[observability.logs]
enabled = true
destinations = [ "logs-destination-name" ]
head_sampling_rate = 0.6
persist = false

Wrangler 設定ファイルを更新したら、Worker を再デプロイして新しい設定を反映します。イベントが送信先に届くまで、数分かかることがあります。

送信先を作成したあと、Cloudflare ダッシュボードで健全性と配信状況を確認できます。各送信先には、直近でデータが正常に配信されたかを示すステータスが表示されます。

OTel データのエクスポートは、早期ベータ期間中、Workers Paid 以上の契約であれば現在 無料 です。ただし、2026年10月1日 以降、トレーシングは Workers Paid プランまたは契約の利用量として課金されます。

制限と料金は次のとおりです。

OpenTelemetry データのエクスポートは、現在ベータです。次の制限に注意してください。

• メトリクスのエクスポートには未対応: Worker インフラのメトリクスとカスタムメトリクスを OpenTelemetry でエクスポートする機能は、現在ありません。メトリクス対応は今後追加する予定です。
• 一部プロバイダーの OTLP 対応が限定的: 一部の可観測性プロバイダーは、OTLP エンドポイント対応をまだ展開中です。現在の対応状況は、上の 利用できる OpenTelemetry の送信先 表を確認してください。