マネージドプラットフォーム向け OTLP インテーク

概要

Datadog はマネージドプラットフォーム専用の OTLP エンドポイントを提供しており、トレース、メトリクス、ログを最小限の構成で Datadog に直接送信できます。サポート対象の各プラットフォームには、独自の OTLP サブドメインがあります (例: cloudflare.integrations.otlp.datadoghq.com)。これらの専用エンドポイントにより、Datadog はトラフィックソースを特定し、プラットフォーム固有の処理と属性を適用できます。汎用 OTLP エンドポイントはホストが存在することを前提としているため、マネージドプラットフォームのトラフィックでは予期しない動作が発生する可能性があります。

Datadog Agent や OpenTelemetry Collector のインストールが困難なマネージドプラットフォームでワークロードを実行する場合は、このオプションを使用してください。お使いのプラットフォームが以下の表になく、AWS、Azure、または GCP のサーバーレスコンピューティングで実行している場合は、Serverless を参照してください。

マネージドプラットフォームのエンドポイントに送信されたホストメタデータは、インフラストラクチャーホストリストには反映されません。

ダイレクトOTLPインテークに関するホスト名の推奨については、Hostname and Tagging を参照してください。

各エンドポイントは、以下のシグナルパスをサポートしています。

シグナルパス
トレース/v1/traces
メトリクス/v1/metrics
ログ/v1/logs

シグナル固有の構成 (メトリクスの変換、ログ処理) については、ログ および メトリクス エンドポイントのページを参照してください。

構成

マネージドプラットフォームのエンドポイント経由で OTLP データを Datadog に送信するには、以下の環境変数を使用して OpenTelemetry エクスポーターを構成します。{platform} をサポート対象のプラットフォームのテーブルにあるプラットフォームのサブドメインに置き換えてください。

export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://{platform}.integrations.otlp."
export OTEL_EXPORTER_OTLP_HEADERS="dd-api-key=${DD_API_KEY}"

トレースのみを送信する場合:

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://{platform}.integrations.otlp./v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY}"
マネージドプラットフォームのエンドポイントは、 dd-otlp-source ヘッダーを使用しません。汎用 OTLP エンドポイントから移行する場合は、構成からこのヘッダーを削除してください。

サポート対象のプラットフォーム

すべてのエンドポイントは https://{subdomain}.integrations.otlp./ というパターンに従います。

プラットフォームサブドメインセットアップガイド
AWXawx—
Claudeclaude—
CloudflarecloudflareCloudflare Workers の監視可能性
Criblcribl—
GitHub Actionsgithub-actions—
GrafbasegrafbaseGrafbase の監視可能性
HerokuherokuHeroku テレメトリ
IBMibm—
LangSmithlangsmith—
LiveCloudKitlivekit—
ModalmodalModal OpenTelemetry
MuleSoftmulesoftMuleSoft Telemetry Exporter
Netlifynetlify—
OpenTofuopentofu—
RetoolretoolRetool パフォーマンスモニタリング
RWXrwxRWX OpenTelemetry
Salesforcesfdc—
Shopifyshopify—
Solacesolace—
Spaceliftspacelift—
Supabasesupabase—
Svixsvix—
Trigger.devtriggerdev—
VercelvercelVercel Marketplace

上記に記載されていないマネージドプラットフォームから OTLP エクスポートを有効にするには、カスタマーサクセスマネージャーにお問い合わせください。

制限事項

メタデータのリッチ化なし

コレクターやエージェントがない場合、テレメトリはホストメタデータでリッチ化されません。このメタデータに依存する機能 (例: インフラストラクチャーホストリスト) は使用できません。影響を受ける機能の一覧については、OpenTelemetry 互換性リスト を参照してください。

限定的な正規化

コレクターや Agent が自動的に実行する一部のシグナル処理は、ダイレクトインジェストでは行われません。例えば、累積-デルタメトリクス変換には、ステートフルなコンポーネントが必要です。プラットフォームが累積メトリクスをエクスポートする場合は、デルタ一時性をエクスポートするように SDK またはパイプラインを構成してください。

トレースメトリクス

トレースメトリクス は、マネージドプラットフォームエンドポイントに対してデフォルトで計算されます。マネージドプラットフォームはエクスポート前にトラフィックをサンプリングする場合があり、これがトレースメトリクスの精度に影響を与える可能性があります。

サンプリング

コレクターで使用可能なサンプリング制御 (テールベースサンプリング、確率的サンプリング) は、ダイレクトインジェストでは使用できません。マネージドプラットフォームは、エクスポート前に独自のサンプリングを適用する場合があります。

参考資料

役立つドキュメント、リンク、記事:

Datadog における OpenTelemetry の互換性ドキュメント more more Datadog OTLP インテークエンドポイントドキュメント more more