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](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html) avec API Gateway.
**Topics**
+ [Exemple de carte de service X-Ray](#apigateway-using-xray-maps-active)
+ [Exemple de vue de suivi X-Ray](#apigateway-using-xray-trace-view-active)
## 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 APIs l'intégration à 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 possède deux intégrations Lambda. Les nœuds représentent le service API Gateway et les deux fonctions Lambda.
Pour une explication détaillée de la structure des cartes de service, consultez [Use the X-Ray trace map](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-servicemap).
![\[Exemple de carte de service d’une étape d’API API Gateway\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/apigateway-xray-servicemap-2.png)
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](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html).
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 obtenir une explication détaillée des histogrammes de distribution des latences, consultez [Use Latency Histograms](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-histograms).
![\[Histogramme X-Ray d’une étape d’API API Gateway\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/apigateway-xray-histogram-1.png)
## Exemple de vue de suivi X-Ray
Le schéma suivant présente une vue du suivi générée pour l’exemple d’API décrit ci-dessus, avec une fonction de backend 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 [View traces and trace details](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-traces).
![\[API Gateway avec suivi actif activé\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/apigateway-xray-traceview-1.png)