OTLP 取り込みはデフォルトで無効です。datadog.yaml ファイルの構成を更新するか、環境変数を設定して有効化できます。以下の datadog.yaml の構成は、デフォルトポートでエンドポイントを有効にします。有効にすると、メトリクスとトレースの取り込みがデフォルトで有効になります。ログの取り込みは、予定外のログへの課金を防ぐためにデフォルトで無効になっています。

gRPC の場合、デフォルトは 4317 番ポートです。

otlp_config:
  receiver:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
  logs:
    enabled: false

HTTP の場合、デフォルトは 4318 番ポートです。

otlp_config:
  receiver:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
  logs:
    enabled: false

または、環境変数でポートを指定して、エンドポイントを構成します。

• gRPC の場合 (localhost:4317): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT
• HTTP の場合 (localhost:4318): DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT

これらは、コア Agent とトレース Agent の両方のプロセスに渡す必要があります。コンテナ化された環境で実行している場合は、ローカル以外のインターフェイスでもサーバーを使用できるよう、localhost の代わりに 0.0.0.0 を使用してください。

この機能には、gRPC または HTTP のいずれかを構成してください。こちらに 両方の構成を示すアプリケーション例 があります。

1. Datadog Docker Agent のセットアップ に従います。

2. Datadog Agent コンテナでは、以下のエンドポイント環境変数を設定し、対応するポートを公開します。

   • gRPC の場合: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT を 0.0.0.0:4317 に設定し、ポート 4317 を公開します。
   • HTTP の場合: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT を 0.0.0.0:4318 に設定し、ポート 4318 を公開します。

1. 基本インストール用の Kubernetes Agent のセットアップ に従います。

2. Operator の datadog-agent.yaml マニフェストで gRPC または HTTP のうち、使用するプロトコルを有効にします。

   gRPC の場合:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     # (...)
     features:
       otlp:
         receiver:
           protocols:
             grpc:
               enabled: true
   

   For HTTP:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     # (...)
     features:
       otlp:
         receiver:
           protocols:
             http:
               enabled: true
   

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

これは、各プロトコルをデフォルトのポート (OTLP/gRPC は 4317、OTLP/HTTP は 4318) で有効にするものです。メトリクスとトレースはデフォルトで有効になっています。

1. 基本インストール用の Kubernetes Agent のセットアップ に従います。

2. Helm の datadog-values.yaml ファイルで gRPC または HTTP のうち、使用するプロトコルを有効にします。

   gRPC の場合:

   datadog:
     # (...)
     otlp:
       receiver:
         protocols:
           grpc:
             enabled: true
   

   For HTTP:

   datadog:
     # (...)
     otlp:
       receiver:
         protocols:
           http:
             enabled: true
   

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

これは、各プロトコルをデフォルトのポート (OTLP/gRPC は 4317、OTLP/HTTP は 4318) で有効にするものです。メトリクスとトレースはデフォルトで有効になっています。

1. 基本インストール用の Kubernetes の手動インストールガイド に従います。

2. trace-agent コンテナとコア agent コンテナの両方で、以下の環境変数を構成します。

   gRPC の場合:

   name: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT # enables gRPC receiver on port 4317
   value: "0.0.0.0:4317"
   

   For HTTP:

   name: DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT # enables HTTP receiver on port 4318
   value: "0.0.0.0:4318"
   

3. コンテナポート 4317 または 4318 をコア agent コンテナのホストポートにマッピングします。

   gRPC の場合:

   ports:
     - containerPort: 4317
       hostPort: 4317
       name: traceportgrpc
       protocol: TCP
   

   For HTTP

   ports:
     - containerPort: 4318
       hostPort: 4318
       name: traceporthttp
       protocol: TCP
   

AWS Lambda と Datadog で OpenTelemetry を使用するための詳細な手順は、次のとおりです。

• OpenTelemetry を使用して Lambda 関数をインスツルメントする
• Datadog SDK 内での OpenTelemetry API サポートを使用する
• OpenTelemetry トレースを Datadog Lambda Extension に送信する

詳細は、Serverless ドキュメントの AWS Lambda および OpenTelemetry を参照してください。

1. ホスト Agent のログ収集のセットアップ に従って、ログ収集を有効にします。

   logs_enabled: true
   

2. otlp_config.logs.enabledを true に設定します。

   otlp_config:
     logs:
       enabled: true
   

Datadog Agent コンテナで次の環境変数を設定します。

• DD_LOGS_ENABLED=true
• DD_OTLP_CONFIG_LOGS_ENABLED=true

datadog-agent.yaml ファイルで、次のように設定します。

spec:
  # (...)
  features:
    otlp:
      #(... enable gRPC or HTTP ingestion...)
    logCollection:
      enabled: true
  override:
    nodeAgent:
      containers:
        agent:
          env:
            - name: DD_OTLP_CONFIG_LOGS_ENABLED
              value: "true"

After making your changes, apply the new configuration by using the following command:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

datadog-values.yaml ファイルで、次のように設定します。

datadog:
  # (...)
  otlp:
    #(... enable gRPC or HTTP ingestion...)
    logs:
      enabled: true
  logs:
    enabled: true

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

コア Agent コンテナで次の環境変数を設定します。

- name: DD_LOGS_ENABLED
  value: "true"
- name: DD_OTLP_CONFIG_LOGS_ENABLED
  value: "true"

詳細は、DaemonSet によるログの収集 を参照してください。

ご使用のアプリケーションの環境で OTEL_EXPORTER_OTLP_ENDPOINT 環境変数を設定します。

gRPC の場合:

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317"

HTTP の場合:

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

1. アプリケーションコンテナで、Datadog Agent コンテナを指すように環境変数 OTEL_EXPORTER_OTLP_ENDPOINT を設定します。たとえば、次のようにします。

   OTEL_EXPORTER_OTLP_ENDPOINT=http://<datadog-agent>:4318
   

2. 両方のコンテナは同じブリッジネットワーク内に定義されている必要があります。これは、Docker Compose を使用している場合は自動的に処理されます。そうでない場合は、Docker アプリケーションのトレース の Docker の例に従って、ブリッジネットワークに適切なポートを設定してください。

アプリケーションのデプロイメントファイルで、環境変数 OTEL_EXPORTER_OTLP_ENDPOINT を使用して OpenTelemetry クライアントがトレースを送信するエンドポイントを構成します。

gRPC の場合:

env:
 - name: HOST_IP
   valueFrom:
     fieldRef:
       fieldPath: status.hostIP
 - name: OTEL_EXPORTER_OTLP_ENDPOINT
   value: "http://$(HOST_IP):4317" # sends to gRPC receiver on port 4317

HTTP の場合:

env:
 - name: HOST_IP
   valueFrom:
     fieldRef:
       fieldPath: status.hostIP
 - name: OTEL_EXPORTER_OTLP_ENDPOINT
   value: "http://$(HOST_IP):4318" # sends to HTTP receiver on port 4318

注: Custom Metrics のコンテナタグを充実させるには、OTLP メトリクスを生成するアプリケーションコード内で適切なリソース属性を設定します。たとえば、container.id リソース属性に Pod の UID を設定します。