View a markdown version of this page

Verwenden Sie die 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.

Verwenden Sie die X-Ray API

Wenn das X-Ray SDK Ihre Programmiersprache nicht unterstützt, können Sie entweder die X-Ray APIs direkt oder die AWS Command Line Interface (AWS CLI) verwenden, um X-Ray API-Befehle aufzurufen. Verwenden Sie die folgende Anleitung, um auszuwählen, wie Sie mit der API interagieren:

  • Verwenden Sie die, AWS CLI um die Syntax zu vereinfachen, indem Sie vorformatierte Befehle oder Optionen in Ihrer Anfrage verwenden.

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

Wenn Sie die 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 der X-Ray API:

X-Ray zeigt detaillierte Informationen zu Anwendungsanfragen an.

Verwenden Sie die X-Ray API, um Trace-Daten direkt an zu senden X-Ray. Die X-Ray API unterstützt alle im X-Ray SDK verfügbaren Funktionen, einschließlich der folgenden allgemeinen Aktionen:

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

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

  • GetTraceSummaries— Ruft IDs und Anmerkungen für Traces ab. 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 damit zu interagieren. X-Ray Das AWS CLI unterstützt alle im X-Ray SDK verfügbaren Funktionen, einschließlich derer für andere. AWS-Services Die folgenden Funktionen sind Versionen der zuvor aufgeführten API-Operationen in einem einfacheren Format:

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

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

  • get-trace-summaries — Ruft IDs und Anmerkungen für Traces ab. Sie können a angeben, FilterExpression um eine Teilmenge von 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 Downstream-Anfragen aufrufen.

Um loszulegen, müssen Sie das AWS CLI für Ihr Betriebssystem installieren. AWS unterstützt Linux macOS und Windows Betriebssysteme. Weitere Informationen zur X-Ray Befehlsliste finden Sie in der AWS CLI Befehlsreferenz für X-Ray.

Themen