Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo di una pipeline di OpenSearch Ingestion con Collector OpenTelemetry

È possibile utilizzare OpenTelemetry Collector per inserire log, tracce e metriche nelle pipeline di Ingestion. OpenSearch È possibile utilizzare una singola pipeline per importare tutti i log, le tracce e le metriche in diversi indici su un dominio o una raccolta. Puoi anche utilizzare le pipeline per importare solo log, tracce o metriche singolarmente.

Prerequisiti

Durante l'impostazione del file OpenTelemetry di configurazione, è necessario configurare quanto segue affinché avvenga l'inserimento:

extensions:
    sigv4auth:
        region: "region"
        service: "osis"

exporters:
    otlphttp:
        logs_endpoint: "https://pipeline-endpoint.us-east-1.osis.amazonaws.com/v1/logs"
        metrics_endpoint: "https://pipeline-endpoint.us-east-1.osis.amazonaws.com/v1/metrics"
        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]
            

Fase 1: Configurare il ruolo della pipeline

Dopo aver impostato la configurazione del OpenTelemetry raccoglitore, imposta il ruolo della pipeline che desideri utilizzare nella configurazione della pipeline. Il ruolo della pipeline non richiede autorizzazioni specifiche per l'origine OTLP, ma solo autorizzazioni per concedere alle pipeline l'accesso al dominio o alla raccolta. OpenSearch

Passaggio 2: creare la pipeline

È quindi possibile configurare una pipeline OpenSearch di ingestione come la seguente, che specifica OTLP come origine. Puoi anche configurare OpenTelemetry log, metriche e tracce come singole fonti.

Configurazione della pipeline di origine OTLP:

version: 2
otlp-pipeline:
    source:
        otlp:
            logs_path: /otlp-pipeline/v1/logs
            traces_path: /otlp-pipeline/v1/traces
            metrics_path: /otlp-pipeline/v1/metrics
    sink:
        - opensearch:
            hosts: ["https://search-mydomain.region.es.amazonaws.com"]
            index: "ss4o_metrics-otel-%{yyyy.MM.dd}"
            index_type: custom
            aws:
                region: "region"
            

OpenTelemetry Configurazione della pipeline dei log:

version: 2
otel-logs-pipeline:
  source:
    otel_logs_source:
        path: /otel-logs-pipeline/v1/logs
  sink:
    - opensearch:
        hosts: ["https://search-mydomain.region.es.amazonaws.com"]
        index: "ss4o_metrics-otel-%{yyyy.MM.dd}"
        index_type: custom
        aws:
            region: "region"
            

OpenTelemetry Configurazione della pipeline di metriche:

version: 2
otel-metrics-pipeline:
  source:
    otel_metrics_source:
        path: /otel-metrics-pipeline/v1/metrics
  sink:
    - opensearch:
        hosts: ["https://search-mydomain.region.es.amazonaws.com"]
        index: "ss4o_metrics-otel-%{yyyy.MM.dd}"
        index_type: custom
        aws:
            region: "region"
            

OpenTelemetry Configurazione della pipeline di Traces:

version: 2
otel-trace-pipeline:
  source:
    otel_trace_source:
        path: /otel-traces-pipeline/v1/traces
  sink:
    - opensearch:
        hosts: ["https://search-mydomain.region.es.amazonaws.com"]
        index: "ss4o_metrics-otel-%{yyyy.MM.dd}"
        index_type: custom
        aws:
            region: "region"
            

È possibile utilizzare un blueprint preconfigurato per creare questa pipeline. Per ulteriori informazioni, consulta Lavorare con i progetti.

Cross-account Connettività

OpenSearch Le pipeline di ingestione con OpenTelemetry sorgenti sono dotate di funzionalità di inserimento su più account. Amazon OpenSearch Ingestion consente di condividere le pipeline Account AWS da un cloud privato virtuale (VPC) a un endpoint di pipeline in un VPC separato. Per ulteriori informazioni, consulta Configurazione delle pipeline OpenSearch di ingestione per l'ingestione tra account.

Limitazioni

La pipeline OpenSearch Ingestion non può ricevere richieste superiori a 20 MB. Questo valore è configurato dall'utente nell'opzione. max_request_length Il valore predefinito di questa opzione è 10 MB.

Allarmi consigliati CloudWatch per le sorgenti OpenTelemetry

Le seguenti CloudWatch metriche sono consigliate per monitorare le prestazioni della pipeline di ingestione. Queste metriche possono aiutarvi a identificare la quantità di dati elaborati dalle esportazioni, la quantità di eventi elaborati dagli stream, gli errori nell'elaborazione delle esportazioni e degli eventi di streaming e il numero di documenti scritti nella destinazione. È possibile impostare CloudWatch allarmi per eseguire un'azione quando una di queste metriche supera un valore specificato per un determinato periodo di tempo.

Le CloudWatch metriche per la fonte OTLP sono formattate come. {pipeline-name}.otlp.{logs | traces | metrics}.{metric-name} Ad esempio, otel-pipeline.otlp.metrics.requestTimeouts.count.

Nel caso di utilizzo di una singola OpenTelemetry fonte, le metriche verranno formattate come. {pipeline-name}.{source-name}.{metric-name} Ad esempio, trace-pipeline.otel_trace_source.requestTimeouts.count.

Tutti e tre OpenTelemetry i tipi di dati avranno le stesse metriche, ma per brevità le metriche verranno elencate solo nella tabella seguente per i dati del tipo di registro di origine OTLP.