Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden einer OpenSearch Ingestion-Pipeline mit Collector OpenTelemetry

Sie können den OpenTelemetry Collector verwenden, um Logs, Traces und Metriken in OpenSearch Ingestion-Pipelines aufzunehmen. Eine einzige Pipeline kann verwendet werden, um alle Logs, Traces und Metriken in verschiedene Indizes in einer Domain oder Sammlung aufzunehmen. Sie können Pipelines auch verwenden, um nur Protokolle, Traces oder Metriken einzeln zu erfassen.

Voraussetzungen

Beim Einrichten der OpenTelemetry Konfigurationsdatei müssen Sie Folgendes konfigurieren, damit die Aufnahme erfolgt:

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]
            

Schritt 1: Konfigurieren Sie die Pipeline-Rolle

Richten Sie nach dem Einrichten der OpenTelemetry Collector-Konfiguration die Pipeline-Rolle ein, die Sie in Ihrer Pipeline-Konfiguration verwenden möchten. Es gibt keine spezifischen Berechtigungen, die die Pipeline-Rolle für die OTLP-Quelle benötigt, sondern nur Berechtigungen, um Pipelines Zugriff auf die OpenSearch Domain oder Sammlung zu gewähren.

Schritt 2: Erstellen Sie die Pipeline

Sie können dann eine OpenSearch Ingestion-Pipeline wie die folgende konfigurieren, die OTLP als Quelle angibt. Sie können auch OpenTelemetry Protokolle, Metriken und Traces als einzelne Quellen konfigurieren.

Konfiguration der OTLP-Quellpipeline:

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 Protokolliert die Pipeline-Konfiguration:

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 Konfiguration der Metrik-Pipeline:

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 Verfolgt die Pipeline-Konfiguration:

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"
            

Sie können einen vorkonfigurierten Blueprint verwenden, um diese Pipeline zu erstellen. Weitere Informationen finden Sie unter Mit Blueprints arbeiten.

Cross-account Konnektivität

OpenSearch Pipelines mit OpenTelemetry Quellen können kontoübergreifend aufgenommen werden. Amazon OpenSearch Ingestion ermöglicht es Ihnen, Pipelines AWS-Konten von einer Virtual Private Cloud (VPC) bis zu einem Pipeline-Endpunkt in einer separaten VPC gemeinsam zu nutzen. Weitere Informationen finden Sie unter Konfiguration von OpenSearch Ingestion-Pipelines für die kontoübergreifende Erfassung.

Einschränkungen

Die OpenSearch Ingestion-Pipeline kann keine Anfragen empfangen, die größer als 20 MB sind. Dieser Wert wird vom Benutzer in der Option konfiguriert. max_request_length Diese Option ist standardmäßig auf 10 MB eingestellt.

Empfohlene CloudWatch Alarme für Quellen OpenTelemetry

Die folgenden CloudWatch Messwerte werden für die Überwachung der Leistung Ihrer Aufnahme-Pipeline empfohlen. Mithilfe dieser Metriken können Sie die Menge der bei Exporten verarbeiteten Daten, die Anzahl der aus Streams verarbeiteten Ereignisse, die Fehler bei der Verarbeitung von Exporten und Stream-Ereignissen sowie die Anzahl der an das Ziel geschriebenen Dokumente ermitteln. Sie können CloudWatch Alarme einrichten, um eine Aktion auszuführen, wenn eine dieser Metriken einen bestimmten Wert für einen bestimmten Zeitraum überschreitet.

Die CloudWatch Metriken für die OTLP-Quelle sind formatiert als. {pipeline-name}.otlp.{logs | traces | metrics}.{metric-name} Beispiel, otel-pipeline.otlp.metrics.requestTimeouts.count.

Bei Verwendung einer einzelnen OpenTelemetry Quelle werden die Metriken als formatiert. {pipeline-name}.{source-name}.{metric-name} Beispiel, trace-pipeline.otel_trace_source.requestTimeouts.count.

Alle drei OpenTelemetry Datentypen haben dieselben Metriken, aber der Kürze halber werden die Metriken in der folgenden Tabelle nur für Daten vom Typ OTLP-Quellprotokoll aufgeführt.