Trace Analytics für Amazon OpenSearch Service

Sie können Trace Analytics verwenden, das Teil des OpenSearch Observability-Plug-ins ist, um Trace-Daten aus verteilten Anwendungen zu analysieren. Trace Analytics erfordert OpenSearch Elasticsearch 7.9 oder höher.

In einer verteilten Anwendung kann ein einzelner Vorgang, z. B. das Klicken eines Benutzers auf eine Schaltfläche, eine erweiterte Reihe von Ereignissen auslösen. Das Anwendungs-Front-End kann beispielsweise einen Backend-Dienst aufrufen, der einen anderen Dienst aufruft, der eine Datenbank abfragt, die Abfrage verarbeitet und ein Ergebnis zurückgibt. Dann sendet der erste Backend-Dienst eine Bestätigung an das Front-End, das die Benutzeroberfläche aktualisiert.

Sie können Spurenanalytik verwenden, um diesen Ereignisfluss zu visualisieren und Leistungsprobleme zu identifizieren.

Anmerkung

Diese Dokumentation bietet einen kurzen Überblick über Trace Analytics. Eine umfassende Dokumentation finden Sie unter Trace Analytics in der OpenSearch Open-Source-Dokumentation.

Voraussetzungen

Für Trace Analytics müssen Sie Ihrer Anwendung Instrumente hinzufügen und Trace-Daten mithilfe einer OpenTelemetry unterstützten Bibliothek wie Jaeger oder Zipkin generieren. Dieser Schritt erfolgt vollständig außerhalb von Service. OpenSearch Die OpenTelemetry Dokumentation zur AWS Distribution enthält Beispielanwendungen für viele Programmiersprachen, die Ihnen den Einstieg erleichtern können, darunter Java, Python, Go und JavaScript.

Nachdem Sie Ihrer Anwendung Instrumentierung hinzugefügt haben, empfängt der OpenTelemetryCollector Daten von der Anwendung und formatiert sie in OpenTelemetry Daten. Die Liste der Empfänger finden Sie unter GitHub. AWS Distro for OpenTelemetry enthält einen Empfänger für. AWS X-Ray

Schließlich können Sie diese OpenTelemetry Daten für OpenSearch Einnahme durch Amazon die Verwendung mit OpenSearch formatieren.

OpenTelemetry Collector-Beispielkonfiguration

Um den OpenTelemetry Collector mit zu verwenden OpenSearch Einnahme durch Amazon, probieren Sie die folgende Beispielkonfiguration aus:

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/opentelemetry.proto.collector.trace.v1.TraceService/Export"
    auth:
      authenticator: sigv4auth
    compression: none
 
service:
  extensions: [sigv4auth]
  pipelines:
    traces:
      receivers: [jaeger]
      exporters: [otlphttp]

OpenSearch Beispielkonfiguration für die Aufnahme

Um Trace-Daten an eine OpenSearch Service-Domain zu senden, probieren Sie die folgende Beispielkonfiguration für die OpenSearch Ingestion-Pipeline aus. Anweisungen zum Erstellen einer Pipeline finden Sie unter. Amazon OpenSearch Ingestion-Pipelines erstellen

version: "2"
otel-trace-pipeline:
  source:
    otel_trace_source:
      "/${pipelineName}/ingest"
  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://domain-endpoint"]
        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://domain-endpoint"]
        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"

Die Pipeline-Rolle, die Sie in der sts_role_arn Option angeben, muss über Schreibberechtigungen für die Senke verfügen. Anweisungen zum Konfigurieren von Berechtigungen für die Pipeline-Rolle finden Sie unterRollen und Benutzer in Amazon OpenSearch Ingestion einrichten.

Spurendaten untersuchen

Die Dashboard-Ansicht gruppiert Spuren nach HTTP-Methode und -Pfad, sodass Sie die durchschnittliche Latenz, Fehlerrate und Trends im Zusammenhang mit einem bestimmten Vorgang sehen können. Versuchen Sie für eine fokussiertere Ansicht, nach Spurengruppennamen zu filtern.

Um einen Drilldown zu den Spuren durchzuführen, die eine Spuren-Gruppe bilden, wählen Sie die Anzahl der Spuren in der rechten Spalte. Wählen Sie dann eine einzelne Spur für eine detaillierte Zusammenfassung aus.

Die Ansicht Services listet alle Dienste in der Anwendung sowie eine interaktive Karte auf, die zeigt, wie die verschiedenen Dienste miteinander verbunden sind. Im Gegensatz zum Dashboard (das hilft, Probleme nach Betrieb zu identifizieren), hilft Ihnen die Service Map, Probleme nach Service zu identifizieren. Versuchen Sie, nach Fehlerrate oder Latenz zu sortieren, um ein Gefühl für potenzielle Problembereiche Ihrer Anwendung zu erhalten.