Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisez des cartes AWS X-Ray de service et des vues de traçage avec API Gateway
Dans cette section, vous trouverez des informations détaillées sur l'utilisation des cartes de service et des vues de suivi AWS X-Ray avec API Gateway.
Exemple de carte de service X-Ray
AWS X-Ray les cartes de service affichent des informations sur votre API et tous ses services en aval. Quand X-Ray est activé pour une étape d'API dans API Gateway, un nœud contenant des informations sur le temps total passé dans le service API Gateway s'affiche dans la carte de service. 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 à AWS des services tels qu' AWS Lambda Amazon DynamoDB, vous verrez davantage de nœuds fournissant des indicateurs de performance liés à 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 a une intégration Lambda avec une fonction 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 carte des services, voir Utiliser la carte de suivi X-Ray.
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, le suivi de la carte de service présentée ci-dessus inclut des segments pour le service Lambda et la fonction Lambda. Pour plus d'informations, reportez-vous AWS Lambda aux sections et AWS X-Ray.
Si vous sélectionnez un nœud ou un arc sur une carte de service 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 d'API Gateway nommée xray/test dans la précédente carte de service. Pour une explication détaillée des histogrammes de distribution de latence, voir Utiliser des histogrammes de latence.
Exemple de vue 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 une explication détaillée des vues de trace, voir Afficher les traces et les détails des traces.
