• Docker
• Docker Compose v2.0.0+
• Make (オプション)

• Kubernetes 1.24+
• Helm 3.9+
• 接続用に構成された kubectl を備えたアクティブな Kubernetes クラスター

1. デモのリポジトリを開きます。ルートフォルダーに docker-compose.override.yml という名前のファイルを作成します。

2. 作成されたファイルを開きます。以下の内容を貼り付けて、Datadog サイト および Datadog API キー 環境変数を設定します。

   services:
     otel-collector:
       command:
         - "--config=/etc/otelcol-config.yml"
         - "--config=/etc/otelcol-config-extras.yml"
         - "--feature-gates=datadog.EnableOperationAndResourceNameV2"
       environment:
         - DD_SITE_PARAMETER=<Your API Site>
         - DD_API_KEY=<Your API Key>
   

3. OpenTelemetry Collector を構成するには、src/otel-collector/otelcol-config-extras.yml を開き、ファイルに以下を追加します。

   extensions:
     datadog/extension:
       api:
         site: ${env:DD_SITE_PARAMETER}
         key: ${env:DD_API_KEY}
       http:
         endpoint: "localhost:9875"
         path: "/metadata"
   
   exporters:
     datadog:
       traces:
         compute_stats_by_span_kind: true
         trace_buffer: 500
       api:
         site: ${env:DD_SITE_PARAMETER}
         key: ${env:DD_API_KEY}
       sending_queue:
         batch:
           min_size: 10
           max_size: 100
           flush_timeout: 10s
   
   processors:
     resource:
       attributes:
         - key: deployment.environment.name
           value: "otel"
           action: upsert
   
   connectors:
     datadog/connector:
       traces:
         compute_stats_by_span_kind: true
   
   service:
     extensions: [datadog/extension]
     pipelines:
       traces:
         receivers: [otlp]
         processors: [resourcedetection, memory_limiter, resource, transform/sanitize_spans]
         exporters: [otlp_grpc/jaeger, debug, spanmetrics, datadog, datadog/connector]
       metrics:
         receivers: [datadog/connector, docker_stats, httpcheck/frontend-proxy, hostmetrics, nginx, otlp, postgresql, redis, spanmetrics]
         processors: [resourcedetection, memory_limiter, resource]
         exporters: [otlp_http/prometheus, debug, datadog]
       logs:
         receivers: [otlp]
         processors: [resourcedetection, memory_limiter, resource]
         exporters: [opensearch, debug, datadog]
   

   By default, the collector in the demo application merges the configuration from two files:

   • src/otel-collector/otelcol-config.yml: contains the default configuration for the collector.
   • src/otel-collector/otelcol-config-extras.yml: used to add extra configuration to the collector.
   YAML 値をマージする場合、オブジェクトはマージされ、配列は置換されます。 そのため、実際に構成されているものよりも多くのコンポーネントがパイプラインで指定されています。 以前の構成は、メイン otelcol-config ファイルで構成された値を置換しません。

1. Datadog サイトおよび API キーのシークレットを保存するには、dd-secrets という名前のシークレットを作成します。

   kubectl create secret generic dd-secrets --from-literal="DD_SITE_PARAMETER=<Your API Site>" --from-literal="DD_API_KEY=<Your API Key>"
   

2. OpenTelemetry Demo を管理およびデプロイするには、OpenTelemetry Helm チャート をリポジトリに追加します。

   helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
   

3. 以下の内容で、my-values-file.yml という名前のファイルを作成します。

   opentelemetry-collector:
     extraEnvsFrom:
       - secretRef:
           name: dd-secrets
     config:
       extensions:
         datadog/extension:
           api:
             site: ${env:DD_SITE_PARAMETER}
             key: ${env:DD_API_KEY}
           http:
             endpoint: "localhost:9875"
             path: "/metadata"
       exporters:
         datadog:
           traces:
             compute_stats_by_span_kind: true
             trace_buffer: 500
           hostname: "otelcol-helm"
           api:
             site: ${env:DD_SITE_PARAMETER}
             key: ${env:DD_API_KEY}
           sending_queue:
             batch:
               min_size: 10
               max_size: 100
               flush_timeout: 10s
   
       processors:
         resource:
           attributes:
             - key: deployment.environment.name
               value: "otel"
               action: upsert
   
       connectors:
         datadog/connector:
           traces:
             compute_stats_by_span_kind: true
   
       service:
         extensions: [health_check, datadog/extension]
         pipelines:
           traces:
             processors: [memory_limiter, resource, resourcedetection, transform]
             exporters: [otlp/jaeger, debug, spanmetrics, datadog, datadog/connector]
           metrics:
             receivers: [datadog/connector, otlp, spanmetrics]
             processors: [memory_limiter, resource, resourcedetection, transform]
             exporters: [otlphttp/prometheus, debug, datadog]
           logs:
             processors: [memory_limiter, resource, resourcedetection, transform]
             exporters: [opensearch, debug, datadog]
   

   YAML 値をマージする場合、オブジェクトはマージされ、配列は置換されます。 そのため、実際に構成されているものよりも多くのコンポーネントがパイプラインで指定されています。 以前の構成は、メイン otelcol-config ファイルで構成された値を置換しません。

make がインストールされている場合は、次のコマンドを使用してデモを開始できます。

make start

make がインストールされていない場合は、docker compose コマンドを直接使用できます。

docker compose --env-file .env --env-file .env.override up --force-recreate --remove-orphans --detach

Helm を使用して Kubernetes にデモアプリケーションをデプロイするには、次のコマンドを実行します。

helm install my-otel-demo open-telemetry/opentelemetry-demo --values my-values-file.yml

http://localhost:8080 に移動します。

1. ローカルクラスターを実行している場合は、フロントエンドプロキシをポートフォワードする必要があります。

   kubectl port-forward svc/my-otel-demo-frontendproxy 8080:8080
   

2. http://localhost:8080 に移動します。