Utilisation de AWS X-Ray Service Maps et Trace Views avec API Gateway - Amazon API Gateway

Utilisation de AWS X-Ray Service Maps et Trace Views avec API Gateway

Dans cette section, vous trouverez des informations détaillées sur la façon d'utiliser la cartographie des services AWS X-Ray et les vues de suivi avec API Gateway.

Pour plus d'informations sur la cartographie des services et les vues de suivi et leur interprétation, consultez la section AWS X-Ray Console.

Exemple de cartographie des services X-Ray

La cartographie des services AWS X-Ray présente des informations sur votre API et tous ses services en aval. Lorsque X-Ray est activé pour une étape d'API API Gateway, un nœud contenant des informations sur le temps total passé dans le service API Gateway s'affiche dans la cartographie des services. Vous pouvez obtenir des informations détaillées sur le statut de réponse et un histogramme du temps de réponse de l'API pour la période sélectionnée. Pour les API intégrées aux services AWS, comme AWS Lambda et Amazon DynamoDB, vous verrez plusieurs nœuds fournissant des métriques de performances concernant ces services. Une cartographie des services est disponible pour chaque étape de l'API.

L'exemple suivant montre une cartographie des services pour l'étape test d'une API appelée xray. Cette API possède une intégration Lambda avec une fonction de mécanisme d'autorisation Lambda et une fonction de backend Lambda. Les nœuds représentent le service API Gateway, le service Lambda, et les deux fonctions Lambda.

Pour une explication détaillée de la structure de la cartographie des services, consultez la section Affichage de la cartographie des services.


                Exemple de cartographie des services d'une étape d'API API Gateway

Depuis la cartographie des services, vous pouvez zoomer afin de consulter un suivi de votre étape d'API. Le suivi affiche des informations détaillées concernant votre API, sous la forme de segments et de sous-segments. Par exemple, la trace de la cartographie des services présentée ci-dessus inclut des segments pour le service Lambda et la fonction Lambda. Pour plus d'informations, consultez la section Lambda comme suivi AWS X-Ray.

Si vous sélectionnez un nœud ou un arc sur une cartographie de services X-Ray, la console X-Ray affiche un histogramme de distribution des latences. Vous pouvez utiliser un histogramme de latence pour voir de combien de temps a besoin un service pour traiter ses requêtes. Voici un histogramme de l'étape API Gateway nommée xray/test dans la cartographie des services précédente. Pour obtenir une explication détaillée des histogrammes de distribution de la latence, consultez la section Utilisation d'histogrammes des latences dans la console AWS X-Ray.


                Histogramme X-Ray d'une étape d'API API Gateway

Exemple de suivi X-Ray

Le schéma suivant présente une vue de suivi générée pour l'exemple d'API décrit ci-dessus, avec une fonction de backend Lambda et une fonction de mécanisme d'autorisation Lambda. Une demande de méthode d'API réussie s'affiche avec le code de réponse 200.

Pour obtenir une explication détaillée des vues de suivi, consultez la section Affichage des suivis.


                Suivi actif activé sur API Gateway