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 ingestione con Collector OpenTelemetry

Puoi usare 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 di un dominio o di una raccolta. Puoi anche utilizzare le pipeline per importare solo log, tracce o metriche singolarmente.

Prerequisiti

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

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 pipeline non richiede autorizzazioni specifiche per l'origine OTLP, ma solo autorizzazioni per concedere alle pipeline l'accesso al dominio o alla raccolta. OpenSearch

Fase 2: Creare la pipeline

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

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 Registra la configurazione della pipeline:

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 delle 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.

Connettività tra account

OpenSearch Le pipeline di ingestione con OpenTelemetry sorgenti hanno una capacità di ingestione tra account. Amazon OpenSearch Ingestion ti 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 fonti OpenTelemetry

Le seguenti CloudWatch metriche sono consigliate per monitorare le prestazioni della pipeline di ingestione. Queste metriche possono aiutarti 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 sorgente 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 di tipo di registro di origine OTLP.