OpenTelemetry Collector OpenSearch での取り込みパイプラインの使用

このサンプルOpenTelemetry 設定ファイルは、コレクタから OpenTelemetryトレースデータをエクスポートし、 OpenSearch 取り込みパイプラインに送信します。トレースデータの取り込みの詳細については、Data Prepper ドキュメントの「トレース分析」を参照してください。

次の点に注意してください。

• endpoint の値にはパイプラインエンドポイントを含める必要があります。例えば、https://pipeline-endpoint.us-east-1.osis.amazonaws.com と指定します。

• service の値は osis にする必要があります。

• OTLP/HTTP Exporter compressionのオプションは、パイプラインの OpenTelemetry ソースcompressionのオプションと一致する必要があります。

extensions:
  sigv4auth:
    region: "us-east-1"
    service: "osis"
 
receivers:
  jaeger:
    protocols:
      grpc:
 
exporters:
  otlphttp:
    traces_endpoint: "https://pipeline-endpoint.us-east-1.osis.amazonaws.com/v1/traces"
    auth:
      authenticator: sigv4auth
    compression: none
 
service:
  extensions: [sigv4auth]
  pipelines:
    traces:
      receivers: [jaeger]
      exporters: [otlphttp]

その後、次のような OpenSearch 取り込みパイプラインを設定できます。これにより、OTelトレースプラグインをソースとして指定します。

version: "2"
otel-trace-pipeline:
  source:
    otel_trace_source:
      path: "/v1/traces"
  processor:
    - trace_peer_forwarder:
  sink:
    - pipeline:
        name: "trace-pipeline"
    - pipeline:
        name: "service-map-pipeline"
trace-pipeline:
  source:
    pipeline:
      name: "otel-trace-pipeline"
  processor:
    - otel_traces:
  sink:
    - opensearch:
        hosts: ["https://search-domain-endpoint.us-east-1.es.amazonaws.com"]
        index_type: trace-analytics-raw
        aws:
          # IAM role that OpenSearch Ingestion assumes to access the domain sink   
          sts_role_arn: "arn:aws:iam::{account-id}:role/pipeline-role"
          region: "us-east-1"
        
service-map-pipeline:
  source:
    pipeline:
      name: "otel-trace-pipeline"
  processor:
    - service_map:
  sink:
    - opensearch:
        hosts: ["https://search-domain-endpoint.us-east-1.es.amazonaws.com"]
        index_type: trace-analytics-service-map
        aws:
          # IAM role that the pipeline assumes to access the domain sink   
          sts_role_arn: "arn:aws:iam::{account-id}:role/pipeline-role"
          region: "us-east-1"

パイプラインの別の例については、「事前設定済みトレース分析のブループリント」を参照してください。詳細については、「ブループリントを使用したパイプラインの作成」を参照してください。