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