概要

Datadog Agent や OpenTelemetry Collector を必要とすることなく、サーバーレスワークロードから HTTP/protobuf 経由でトレースを Datadog へ直接送信します。プラットフォームがマネージドプラットフォームテーブルに表示されている場合は、代わりに専用のエンドポイントを使用してください。

サーバーレスワークロードは、一般的な OTLP ログおよび OTLP メトリクスインテークエンドポイント経由でログとメトリクスを送信することもできます。このページのリソース属性は、アプリケーションがエクスポートするすべてのシグナルに適用されます。

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

  • AWS: Lambda、ECS Fargate
  • Azure: Container Apps、Web Apps (App Service)、Azure Functions
  • GCP: Cloud Run、Cloud Run Functions、GKE Autopilot
Collector の実行が現実的でない場合、直接インジェストを使用します (Lambda など)。Collector を実行できる場合は、メタデータのエンリッチメント、正規化、および集中サンプリングの OpenTelemetry Collector を参照してください。

前提条件

以下の設定はすべてのプラットフォームに適用されます。

プロトコル: http/protobuf または http/json。grpc はサポート対象外です。

必須ヘッダー:

  • dd-api-key: Datadog API キー。
  • dd-otlp-source: serverless に設定します。
  • compute_stats: true に設定します。トレースメトリクスに必要です。

サービス名: OTEL_SERVICE_NAME を設定してサービスを識別します。これがない場合、トレースは unknown_service として表示されます。

リソース属性: OTEL_RESOURCE_ATTRIBUTES を使用してプラットフォーム固有の属性を設定します。必須属性およびオプション属性については、以下の各クラウドプロバイダータブを参照してください。

host.name ではなく、このページのプラットフォーム属性を使用してワークロードを識別します。ダイレクト OTLP インテークのホスト名の推奨事項については、ホスト名とタグ付けをご覧ください。

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=""
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-service"

セットアップ

利用している Datadog サイトである次に基づく: : 次の例では ${YOUR_ENDPOINT} を に置き換えます。

プラットフォーム固有のリソース属性設定を行うクラウドプロバイダーを選択します。

Lambda

AWS Distro for OpenTelemetry (ADOT) Lambda レイヤーは、Lambda 関数の自動インスツルメンテーションとリソース検出を提供します。

ADOT レイヤーを Lambda 関数に追加し、以下の環境変数を設定します。

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-lambda-function"

ADOT レイヤーはリソース属性の検出を自動的に処理します。ADOT を使用していない場合は、リソース属性を手動で設定してください。cloud.provider は必須です。完全なプラットフォーム識別を行うには faas.id (解析可能な Lambda ARN) を設定します。faas.id が利用できない場合は、代わりに cloud.platform=aws_lambda を設定してください。

export OTEL_RESOURCE_ATTRIBUTES="cloud.provider=aws,faas.id=arn:aws:lambda:us-east-1:123456789012:function:my-function"
属性必須説明
cloud.providerYes設定: aws
faas.id推奨Lambda 関数 ARN (プラットフォーム識別に推奨)
cloud.platform条件付きfaas.id が設定されていない場合は aws_lambda に設定します
cloud.regionNoAWS リージョン
faas.nameNo関数名
faas.versionNo関数バージョン
faas.instanceNoインスタンス識別子
faas.max_memoryNo設定された最大メモリ (バイト)
aws.log.group.namesNoCloudWatch ロググループ名 (トレースログの相関付けを有効にする)
aws.log.stream.namesNoCloudWatch ログストリーム名

ECS Fargate

ECS Fargate の識別は、cloud.provider または cloud.platform ではなく、タスク ARN と起動タイプによって行われます。OpenTelemetry SDK を設定して、ECS タスクから直接トレースをエクスポートします。

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-ecs-service"
export OTEL_RESOURCE_ATTRIBUTES="aws.ecs.task.arn=arn:aws:ecs:us-east-1:123456789012:task/my-cluster/1234567890abcdef,aws.ecs.launchtype=fargate"
属性必須説明
aws.ecs.task.arnYesECS タスク ARN
aws.ecs.launchtypeYesfargate に設定します (大文字と小文字は区別しません)
cloud.providerNoデフォルト: aws
cloud.platformNoデフォルト: aws_ecs
cloud.regionNoAWS リージョン
cloud.availability_zoneNoアベイラビリティーゾーン
aws.ecs.cluster.arnNoクラスター ARN
aws.ecs.task.familyNoタスク定義ファミリー
aws.ecs.task.idNoタスク ID
aws.ecs.task.revisionNoタスク定義リビジョン
aws.log.group.namesNoCloudWatch ロググループ名 (トレースログの相関付けを有効にする)
aws.log.stream.namesNoCloudWatch ログストリーム名
OpenTelemetry Collector の Azure リソース検出プロセッサーは、VM のみに対応しています。SDK レベルの Azure リソース検出機能は一部のプラットフォーム (Web Apps、Functions) に対応していますが、カバレッジは言語 SDK によって異なります。すべての Azure サーバーレスプラットフォームにおける信頼性の高いパスとして、 cloud.provider、cloud.platform、および cloud.resource_id を手動で設定します。

Container Apps

Container Apps の Azure リソース検出機能サポートは、言語 SDK によって異なります。リソース属性を手動で設定する:

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-container-app"
export OTEL_RESOURCE_ATTRIBUTES="cloud.provider=azure,cloud.platform=azure.container_apps,cloud.resource_id=/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/containerApps/{appName}"

Web Apps (App Service)

Azure リソース検出機能 SDK パッケージを使用する (言語 SDK によってカバレッジが異なります)、または OTEL_RESOURCE_ATTRIBUTES を手動で設定します。

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-web-app"
export OTEL_RESOURCE_ATTRIBUTES="cloud.provider=azure,cloud.platform=azure.app_service,cloud.resource_id=/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}"

Azure Functions

Azure リソース検出機能 SDK パッケージを使用する (言語 SDK によってカバレッジが異なります)、または OTEL_RESOURCE_ATTRIBUTES を手動で設定します。

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-azure-function"
export OTEL_RESOURCE_ATTRIBUTES="cloud.provider=azure,cloud.platform=azure.functions,cloud.resource_id=/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{functionAppName}"

リソース属性リファレンス

プラットフォームcloud.providercloud.platformcloud.resource_id
Container Appsazureazure.container_apps/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/containerApps/{appName}
Web Appsazureazure.app_service/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}
Azure Functionsazureazure.functions/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{functionAppName}

GCP リソース検出は、GCP リソース検出機能 SDK パッケージで自動的に機能します。アプリケーションの依存関係に追加すると、手動で設定しなくてもリソース属性が設定されます。

Cloud Run および Cloud Run 関数

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-cloud-run-service"

GCP リソース検出機能 SDK は、cloud.account.id、cloud.platform、cloud.provider、cloud.region、faas.id、faas.instance、faas.name、faas.version を自動的に設定します。

GKE Autopilot

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="${YOUR_ENDPOINT}"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},dd-otlp-source=serverless,compute_stats=true"
export OTEL_SERVICE_NAME="my-gke-service"

GCP リソース検出機能 SDK は、cloud.account.id、cloud.platform、cloud.provider、cloud.region、host.id、k8s.cluster.name を自動的に設定します。

リソース属性リファレンス

プラットフォームGCP リソース検出機能によって設定される属性
Cloud Run / Cloud Run 関数cloud.account.id、cloud.platform、cloud.provider、cloud.region、faas.id、faas.instance、faas.name、faas.version
GKE Autopilotcloud.account.id、cloud.platform、cloud.provider、cloud.region、host.id、k8s.cluster.name

参考資料