Verwenden Sie die X-Ray-API

Fokusmodus

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.

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

Verwenden Sie die AWS CLI einfachere Syntax mit vorformatierten Befehlen oder mit Optionen in Ihrer Anfrage.
Verwenden Sie die X-Ray-API direkt für maximale Flexibilität und Anpassung bei Anfragen, die Sie an X-Ray stellen.

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 Bewerbungsanfragen an.

Verwenden Sie die X-Ray-API, um Trace-Daten direkt an X-Ray zu senden. Die X-Ray-API unterstützt alle Funktionen, die im X-Ray SDK verfügbar sind, 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 eine ab JSON formatiertes Dokument, 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 SDK verfügbar sind, einschließlich der Funktionen für andere AWS-Services. Bei den folgenden Funktionen handelt es sich um 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 unterstützt Linux, macOS and Windows Betriebssysteme. Weitere Informationen zur Liste der X-Ray-Befehle finden Sie in der AWS CLI Befehlsreferenz für X-Ray.