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.
Surveillance des métriques CloudWatch pour les API HTTP dans API Gateway
Vous pouvez surveiller l’exécution de l’API avec CloudWatch, qui recueille les données brutes d’API Gateway et les traite en métriques lisibles et disponibles presque en temps réel. Ces statistiques sont enregistrées pour une durée de 15 mois et, par conséquent, vous pouvez accéder aux informations historiques et acquérir un meilleur point de vue de la façon dont votre service ou application web s’exécute. Par défaut, les données des métriques API Gateway sont automatiquement envoyées à CloudWatch toutes les minutes. Pour surveiller vos métriques, créez un tableau de bord CloudWatch pour votre API. Pour plus d’informations sur la façon de créer un tableau de bord CloudWatch, consultez Création d’un tableau de bord CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch. Pour plus d’informations, consultez la rubrique Qu’est-ce qu’Amazon CloudWatch ? du Guide de l’utilisateur Amazon CloudWatch.
Les métriques suivantes sont prises en charge pour les API HTTP. Vous pouvez également activer des métriques détaillées pour écrire des métriques de niveau route sur Amazon CloudWatch.
| Métrique | Description |
|---|---|
| 4xx | Nombre d’erreurs côté client capturées dans une période donnée. |
| 5xx | Nombre d’erreurs côté serveur capturées dans une période donnée. |
| Nombre | Nombre total de demandes d’API sur une période donnée. |
| IntegrationLatency | Délai entre le moment de la transmission de la demande au backend par API Gateway et celui de la réception de la réponse du backend. |
| Latence | Délai entre le moment de la réception par API Gateway d’une demande d’un client et celui du renvoi de la réponse au client. La latence prend en compte la latence d’intégration et autres surcharges d’API Gateway. |
| Données traitées | Quantité de données traitées en octets. |
Vous pouvez utiliser les dimensions du tableau suivant pour filtrer les métriques API Gateway.
| Dimension | Description |
|---|---|
| ApiId | Filtre les métriques API Gateway pour une API avec l’ID d’API spécifié. |
| ApiId, Stage | Filtre les métriques API Gateway pour trouver une étape d’API portant l’ID d’API et l’ID d’étape spécifiés. |
| ApiId, Method, Resource, Stage |
Filtre les métriques API Gateway pour trouver une méthode d’API portant l’ID d’API, l’ID d’étape, le chemin de ressource et l’ID de routage spécifiés. API Gateway n’envoie pas ces métriques à moins que vous n’ayez explicitement activé les métriques CloudWatch détaillées. Pour ce faire, appelez l’action UpdateStage de l’API REST d’API Gateway V2 pour mettre à jour la propriété |
