Verwenden von AWS X-Ray-Service-Übersichten und Ablaufverfolgungsansichten in API Gateway - Amazon API Gateway

Verwenden von AWS X-Ray-Service-Übersichten und Ablaufverfolgungsansichten in 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-Übersicht

AWS X-Ray-Service-Übersichten zeigen Informationen über Ihre API und alle zugehörigen Downstream-Services. Wenn X-Ray für eine API-Stufe in API Gateway aktiviert ist, wird in der Service-Übersicht ein Knoten angezeigt, der Informationen zur Gesamtzeit enthält, die im API Gateway-Service 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-Services wie AWS Lambda und Amazon DynamoDB integriert sind, sehen Sie mehr Knoten, die Leistungsmetriken für diese Services 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 detaillierte Erläuterung der Service-Übersichtsstruktur 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 erhalten Sie unter AWS Lambda und AWS X-Ray.

Wenn Sie einen Knoten oder ein Edge in einer X-Ray-Service-Übersicht auswählen, zeigt die X-Ray-Konsole ein Histogramm der Latenzverteilung. 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-Ablaufverfolgungsansicht

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