Benutze das X-Ray API - AWS X-Ray

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.

Benutze das X-Ray API

Wenn X-Ray Ihre Programmiersprache SDK nicht unterstützt, können Sie entweder X-Ray APIs direkt oder AWS Command Line Interface (AWS CLI) verwenden, um API X-Ray-Befehle aufzurufen. Verwenden Sie die folgenden Anleitungen, um zu entscheiden, wie Sie mit dem interagieren möchtenAPI:

  • Verwenden Sie AWS CLI zur einfacheren Syntax die, indem Sie vorformatierte Befehle oder Optionen in Ihrer Anfrage verwenden.

  • Verwenden Sie X-Ray API direkt für maximale Flexibilität und Anpassung an Anfragen, die Sie an X-Ray stellen.

Wenn Sie das X-Ray API direkt anstelle von verwenden AWS CLI, müssen Sie Ihre Anfrage im richtigen Datenformat parametrisieren und möglicherweise auch die Authentifizierung und Fehlerbehandlung konfigurieren.

Das folgende Diagramm zeigt eine Anleitung zur Auswahl der Interaktion mit dem X-RayAPI:

X-Ray zeigt detaillierte Informationen zu Bewerbungsanfragen an.

Verwenden Sie das X-RayAPI, um Trace-Daten direkt an X-Ray zu senden. Das X-Ray API unterstützt alle im X-Ray verfügbaren FunktionenSDK, einschließlich der folgenden allgemeinen Aktionen:

  • PutTraceSegments— Lädt Segmentdokumente auf X-Ray hoch.

  • BatchGetTraces— Ruft eine Liste von Traces in einer Trace-Liste ab. IDs Jeder abgerufene Trace ist eine Sammlung von Segmentdokumenten aus einer einzigen Anfrage.

  • GetTraceSummaries— Ruft IDs Traces ab und kommentiert sie. Sie können a angebenFilterExpression, um eine Teilmenge der Trace-Zusammenfassungen abzurufen.

  • GetTraceGraph— Ruft ein Service-Diagramm für eine bestimmte Trace-ID ab.

  • GetServiceGraph— Ruft ein JSON formatiertes Dokument ab, das Dienste beschreibt, die eingehende Anfragen verarbeiten und nachgelagerte Anfragen aufrufen.

Sie können auch das AWS Command Line Interface (AWS CLI) in Ihrem Anwendungscode verwenden, um programmgesteuert mit X-Ray zu interagieren. Das AWS CLI unterstützt alle Funktionen, die im X-Ray verfügbar sindSDK, einschließlich der Funktionen für andere AWS-Services. Die folgenden Funktionen sind Versionen der zuvor aufgeführten API Operationen mit einem einfacheren Format:

  • put-trace-segments— Lädt Segmentdokumente auf X-Ray hoch.

  • batch-get-traces— Ruft eine Liste von Traces in einer Trace-Liste ab. IDs Jeder abgerufene Trace ist eine Sammlung von Segmentdokumenten aus einer einzigen Anfrage.

  • get-trace-summaries— Ruft IDs Traces ab und kommentiert sie. Sie können a angebenFilterExpression, um eine Teilmenge der Trace-Zusammenfassungen abzurufen.

  • get-trace-graph— Ruft ein Service-Diagramm für eine bestimmte Trace-ID ab.

  • get-service-graph— Ruft ein JSON formatiertes Dokument ab, das Dienste beschreibt, die eingehende Anfragen verarbeiten und nachgelagerte Anfragen aufrufen.

Um zu beginnen, müssen Sie das AWS CLIfür Ihr Betriebssystem installieren. AWS LinuxUnterstützungen macOS und Windows Betriebssysteme. Weitere Informationen zur Liste der X-Ray-Befehle finden Sie in der AWS CLI Befehlsreferenz für X-Ray.

Themen