Comment surveiller l'utilisation de mes appels d'API AWS avec Amazon CloudWatch ?

Brève description

Le nombre d'appels d'API AWS que vous pouvez effectuer par seconde est limité. Une fois que vous dépassez cette limite, vous recevez un message d'erreur « Taux dépassé » et le reste des appels d'API sont limités. Pour plus d'informations sur la détermination de l'appel d'API à l'origine d'une erreur « Taux dépassé », consultez Comment savoir quel appel d'API AWS est à l'origine d'une erreur « Taux dépassé » ?

Si vous utilisez des appels d'API dans l'automatisation, une bonne pratique consiste à surveiller votre utilisation pour éviter les messages d'erreur « Taux dépassé ». Amazon CloudWatch collecte des métriques qui réalisent le suivi de l'utilisation de certains services AWS. Ces métriques correspondent aux quotas de service AWS. Suivez les étapes décrites dans cet article pour représenter graphiquement ces métriques et visualiser votre utilisation.

Résolution

Utilisez cette méthode pour vérifier et surveiller votre utilisation de toutes les ressources AWS qui publient des métriques d'utilisation. Cet exemple utilise PutMetricData.

1. Vérifiez les limites par défaut de l'appel d'API PutMetricData dans la documentation sur les quotas de service CloudWatch. Vous pouvez également vérifier la limite appliquée à votre compte à l'aide de la console Service Quotas.
2. Ouvrez la console CloudWatch.
3. Dans le panneau de navigation de la console, choisissez Metrics (Métriques), puis All Metrics (Toutes les métriques).
4. Les métriques d'utilisation sont publiées dans l'espace de noms AWS/Usage. Choisissez cet espace de noms, puis filtrez l'appel d'API que vous souhaitez représenter graphiquement. Dans ce cas, choisissez PutMetricData.
5. Choisissez la métriqueCallCount. Cette métrique indique le nombre de fois qu'une opération d'API est effectuée.
6. Choisissez Graphed metrics (Métriques graphiques), puis choisissez la période pour laquelle vous souhaitez vérifier votre utilisation. Dans ce cas, choisissez la période dans laquelle vous avez reçu un message d'erreur « Taux dépassé ».
7. Pour Period (Période), choisissez 1 minute (1 minute), et pour Statistic (statistiques), choisissez SUM (SOMME). Cela vous donne le nombre total d'appels d'API effectués chaque minute. Remarque : La plupart des appels d'API ont une limite pour le nombre d'appels d'API effectués par seconde. Cela est mesuré en Transactions par seconde (TPS). Pour PutMetricData, la limite est de 150 TPS.
8. Pour afficher votre utilisation actuelle, choisissez Add math (Ajouter math), puis Start with empty expression (Démarrer avec une expression vide).
9. Dans une nouvelle ligne, saisissez les informations suivantes :

SERVICE_QUOTA(m1)

Informations connexes

Métriques d'utilisation CloudWatch

Visualisation de vos quotas de service