Surveiller CloudWatch les métriques pour HTTP APIs in API Gateway - APIPasserelle Amazon

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.

Surveiller CloudWatch les métriques pour HTTP APIs in API Gateway

Vous pouvez surveiller API l'exécution en utilisant CloudWatch, qui collecte et traite les données brutes de API Gateway en near-real-time métriques lisibles. 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 métriques de API Gateway sont automatiquement envoyées par CloudWatch intervalles d'une minute. Pour surveiller vos indicateurs, créez un CloudWatch tableau de bord pour votreAPI. Pour plus d'informations sur la création d'un CloudWatch tableau de bord, consultez la section Création d'un CloudWatch tableau de bord dans le guide de CloudWatch l'utilisateur Amazon. Pour plus d'informations, consultez Qu'est-ce qu'Amazon CloudWatch ? dans le guide de CloudWatch l'utilisateur Amazon.

Les mesures suivantes sont prises en charge pour HTTPAPIs. Vous pouvez également activer les métriques détaillées pour écrire des métriques au niveau de l'itinéraire à 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 Le nombre total de API demandes au cours d'une période donnée.
IntegrationLatency Le délai entre le moment où API Gateway transmet une demande au backend et le moment où il reçoit une réponse du backend.
Latence Le délai entre le moment où API Gateway reçoit une demande d'un client et le moment où il renvoie une réponse au client. La latence inclut la latence d'intégration et les autres surcharges de la API passerelle.
DataProcessed Quantité de données traitées en octets.

Vous pouvez utiliser les dimensions du tableau suivant pour filtrer les métriques de API Gateway.

Dimension Description
ApiId Filtre les métriques de API Gateway pour les API fichiers dotés de l'APIID spécifié.
ApiId, Scène Filtre les métriques de API Gateway pour une API étape avec l'APIID et l'ID d'étape spécifiés.
ApiId, Méthode, ressource, étape

Filtre les métriques de API passerelle pour une API méthode avec l'ID, l'APIID d'étape, le chemin de ressource et l'ID de route spécifiés.

APIGateway n'enverra pas ces métriques à moins que vous n'ayez explicitement activé CloudWatch les métriques détaillées. Vous pouvez le faire en appelant l'UpdateStageaction du API Gateway V2 REST API pour mettre à jour la detailedMetricsEnabled propriété entrue. Vous pouvez également appeler la AWS CLI commande update-stage pour mettre à jour la DetailedMetricsEnabled propriété en. true L'activation de ces métriques implique des frais supplémentaires pour votre compte. Pour plus d'informations sur les tarifs, consultez Amazon CloudWatch Pricing.