View a markdown version of this page

Verwenden Sie AWS X-Ray Service Maps und Trace-Views mit API Gateway - Amazon API Gateway

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 AWS X-Ray Service Maps und Trace-Views mit API Gateway

In diesem Abschnitt finden Sie detaillierte Informationen zur Verwendung von AWS X-Ray-Service-Übersichten und Nachverfolgungsansichten mit API Gateway.

Beispiel für eine X-Ray Service-Map

AWS X-Ray Service Maps zeigen Informationen zu Ihrer API und all ihren nachgelagerten Diensten. Wenn für eine API-Phase in API Gateway aktiviert X-Ray ist, sehen Sie einen Knoten in der Service-Map, der Informationen über die Gesamtzeit enthält, die im API Gateway Gateway-Dienst verbracht wurde. Sie erhalten detaillierte Informationen über den Antwortstatus und ein Histogramm der API-Reaktionszeit für den ausgewählten Zeitraum. Bei APIs, die in AWS Dienste wie AWS Lambda Amazon DynamoDB integriert sind, werden Sie mehr Knoten sehen, die Leistungskennzahlen für diese Dienste bereitstellen. Es wird eine Service-Übersicht für jede API-Stufe geben.

Das folgende Beispiel zeigt eine Service-Übersicht für die test Stufe einer aufgerufenen API xray. Diese API hat zwei Lambda-Integrationen. Die Knoten stellen den API-Gateway-Service und die beiden Lambda-Funktionen dar.

Eine ausführliche Erläuterung der Struktur der Service Map finden Sie unter Verwenden der X-Ray Trace-Map.

Service-Übersicht-Beispiel für eine API Gateway-API-Stufe

Sie können die Service-Übersicht vergrößern und eine Ansicht der Nachverfolgung für die API-Stufe anzeigen. Die Nachverfolgung zeigt detaillierte Informationen zu Ihrer API an, die als Segmente und Untersegmente dargestellt werden. Beispiel: Die Ablaufverfolgung für die Service-Übersicht umfasst die oben gezeigten Segmente für den Lambda-Service und die Lambda-Funktion. Weitere Informationen finden Sie unter AWS Lambda und AWS X-Ray.

Wenn Sie einen Knoten oder eine Kante auf einer X-Ray Service Map auswählen, zeigt die X-Ray Konsole ein Histogramm der Latenzverteilung an. Sie können ein Latenzhistogramm verwenden, um zu sehen, wie lange es dauert, bis ein Service seine Anforderungen erfüllt. Es folgt ein Histogramm der API Gateway-Stufe, die in der vorherigen Service-Übersicht xray/test benannt wurde. Eine detaillierte Erklärung der Latenz-Verteilungshistogramme finden Sie unter Verwenden von Latenzhistogrammen.

X-Ray Histogramm einer API-Gateway-API-Stufe

Beispiel für eine X-Ray Trace-Ansicht

Das folgende Diagramm zeigt eine Ablaufverfolgungsansicht, die für die oben beschriebene Beispiel-API mit einer Lambda-Backend-Funktion generiert wurde. Eine erfolgreiche API-Methodenanforderung wird mit einem Antwortcode von 200 angezeigt.

Eine detaillierte Erläuterung der Ablaufverfolgungsansichten finden Sie unter Anzeigen von Ablaufverfolgungsdetails.

API Gateway mit aktivierter Ablaufverfolgung