Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Surveillance des métriques CloudWatch pour les API HTTP dans API Gateway

Mode de mise au point
Surveillance des métriques CloudWatch pour les API HTTP dans API Gateway - Amazon API Gateway

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.

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.

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é detailedMetricsEnabled sur true. Sinon, vous pouvez appeler la commande update-stage de l’AWS CLI pour mettre à jour la propriété DetailedMetricsEnabled sur true. L’activation de ces métriques implique des frais supplémentaires pour votre compte. Pour plus d’informations, consultez Tarification Amazon CloudWatch.

Rubrique suivante :

Journalisation

Rubrique précédente :

Surveiller
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.