Surveillez les EC2 API demandes Amazon à l'aide d'Amazon CloudWatch - Amazon Elastic Compute Cloud

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.

Surveillez les EC2 API demandes Amazon à l'aide d'Amazon CloudWatch

Vous pouvez suivre les EC2 API demandes Amazon à l'aide d'Amazon CloudWatch, qui collecte les données brutes et les traite en indicateurs lisibles en temps quasi réel. Ces statistiques fournissent un moyen simple de suivre l'utilisation et les résultats des EC2 API opérations Amazon au fil du temps. Ces informations vous donnent une meilleure idée des performances de vos applications Web et vous permettent d'identifier et de diagnostiquer divers problèmes. Vous pouvez également définir des alarmes qui surveillent certains seuils et envoyer des notifications ou prendre des mesures spécifiques lorsque ces seuils sont atteints.

Pour plus d'informations CloudWatch, consultez le guide de CloudWatch l'utilisateur Amazon.

Important

Amazon EC2 API Metrics est une fonctionnalité optionnelle. Vous devez demander l'accès à cette fonctionnalité. Pour de plus amples informations, veuillez consulter Activer les EC2 API métriques Amazon.

Activer les EC2 API métriques Amazon

Utilisez la procédure suivante pour demander l'accès à cette fonctionnalité pour votre Compte AWS.

Pour demander l'accès à cette fonctionnalité
  1. AWS Support Centre ouvert.

  2. Choisissez Create case (Créer une demande).

  3. Choisissez Compte et facturation.

  4. Pour le service, sélectionnez Informations générales et Mise en route.

  5. Dans Catégorie, choisissez Utilisation AWS et services.

  6. Choisissez Next step: Additional information (Étape suivante : informations supplémentaires).

  7. Pour Subject (Objet), saisissez Request access to Amazon EC2 API metrics.

  8. Pour Description, saisissez Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html. Indiquez également la région à laquelle vous devez avoir accès.

  9. Choisissez Next step: Solve now or contact us (Étape suivante : résolvez maintenant ou contactez-nous).

  10. Dans l'onglet Contactez-nous, choisissez la langue de contact et le mode de contact que vous préférez.

  11. Sélectionnez Envoyer.

EC2APIMétriques et dimensions d'Amazon

Métriques

Les EC2 API métriques Amazon sont contenues dans l'espace de AWS/EC2/API noms. Les tableaux suivants répertorient les statistiques disponibles pour les EC2 API demandes Amazon.

Métrique Description

ClientErrors

Le nombre de API demandes ayant échoué en raison d'erreurs du client.

Ces erreurs sont généralement causées par une action du client, telle que la spécification d'un paramètre incorrect ou non valide dans la demande, ou l'utilisation d'une action ou d'une ressource pour le compte d'un utilisateur qui n'est pas autorisé à utiliser l'action ou la ressource.

Unité : nombre

RequestLimitExceeded

Le nombre de fois que le taux de demandes maximal autorisé par Amazon EC2 APIs a été dépassé pour votre compte.

Les EC2 API demandes Amazon sont limitées afin de maintenir les performances du service. Si vos demandes ont été limitées, le message d'erreur s'affiche. Client.RequestLimitExceeded

Unité : nombre

ServerErrors

Le nombre de API demandes ayant échoué en raison d'erreurs internes au serveur.

Ces erreurs sont généralement causées par une erreur, une exception ou une défaillance AWS côté serveur.

Unité : nombre

SuccessfulCalls

Le nombre de API demandes réussies.

Unité : nombre

Dimensions

Les données EC2 métriques d'Amazon peuvent être filtrées pour toutes les EC2 API actions. Pour plus d'informations sur les dimensions, consultez Amazon CloudWatch Concepts.

Conservation des données métriques

Les EC2 API métriques Amazon sont envoyées à des CloudWatch intervalles d'une minute. CloudWatch conserve les données métriques comme suit :

  • Les points de données d'une durée de 60 secondes (1 minute) sont disponibles pendant 15 jours

  • Les points de données d'une durée de 300 secondes (5 minutes) sont disponibles pendant 63 jours.

  • Les points de données d'une période de 3 600 secondes (1 heure) sont disponibles pendant 455 jours (15 mois).

Suivi des demandes effectuées en votre nom

APIles demandes effectuées par les AWS services en votre nom, telles que les demandes effectuées par des rôles liés à un service, ne sont pas prises en compte dans vos limites de API limitation et n'envoient pas de statistiques à Amazon CloudWatch pour votre compte. Ces demandes ne peuvent pas être surveillées à l'aide de CloudWatch.

APIles demandes effectuées en votre nom par des fournisseurs de services tiers sont prises en compte dans le calcul de vos limites de API limitation et ils envoient des statistiques à Amazon CloudWatch pour votre compte. Ces demandes peuvent être surveillées à l'aide de CloudWatch.

Facturation

CloudWatch Les prix et frais standard s'appliquent. Aucun frais supplémentaire n'est appliqué pour l'utilisation des EC2 API statistiques Amazon. Pour plus d'informations, consultez Amazon CloudWatch Pricing.

Travailler avec Amazon CloudWatch

Afficher CloudWatch les métriques

Suivez la procédure suivante pour consulter les EC2 API statistiques Amazon.

Prérequis

Vous devez activer l'accès aux EC2 API statistiques Amazon pour votre compte. Pour de plus amples informations, veuillez consulter Activer les EC2 API métriques Amazon.

Pour consulter les EC2 API statistiques Amazon à l'aide de la console
  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le volet de navigation, choisissez Metrics, All metrics.

  3. Dans l'onglet Parcourir, choisissez l'espace de noms EC2/APImetric.

  4. Pour afficher les métriques, sélectionnez la dimension de métrique.

Pour consulter les EC2 API métriques Amazon à l'aide de la ligne de commande

Utilisez l’une des commandes suivantes :

Création d' CloudWatch alarmes

Vous pouvez créer une CloudWatch alarme qui envoie un SNS message Amazon lorsque l'alarme change d'état. Une alarme surveille une seule métrique pendant la période que vous spécifiez. Il envoie une notification à un SNS sujet en fonction de la valeur de la métrique par rapport à un seuil donné sur un certain nombre de périodes.

Par exemple, vous pouvez créer une alarme qui surveille le nombre de DescribeInstances API demandes qui échouent en raison d'erreurs côté serveur. L'alarme suivante envoie une notification par e-mail lorsque le nombre d'échecs de DescribeInstances API demande atteint un seuil de 10 erreurs côté serveur sur une période de 5 minutes.

Prérequis

Vous devez activer l'accès aux EC2 API statistiques Amazon pour votre compte. Pour de plus amples informations, veuillez consulter Activer les EC2 API métriques Amazon.

Pour créer une alarme en cas d'erreur du serveur de EC2 DescribeInstances API requêtes Amazon
  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, choisissez Alarms (alertes), All alarms (Toutes les alertes).

  3. Choisissez Create alarm (Créer une alerte).

  4. Choisissez Sélectionner une métrique, puis spécifiez les éléments suivants :

    1. Choisissez EC2/API.

    2. Choisissez Per-Action Metrics.

    3. Cochez la case à côté de celle-ci DescribeInstancesqui se trouve sur la même ligne que le nom de la ServerErrorsmétrique.

    4. Choisissez Select metric (Sélectionner une métrique).

  5. La page Specify metric and conditions (Spécifier les métriques et les conditions) apparaît, présentant un graphique et d'autres informations sur la métrique et la statistique que vous avez sélectionnées.

    1. Sous Métrique, spécifiez les éléments suivants :

      1. Pour Statistics (Statistique), choisissez Sum (Somme).

      2. Pour Période, vérifiez que 5 minutes sont sélectionnées.

    2. Sous Conditions, spécifiez les éléments suivants :

      1. Pour Threshold type (Type de seuil), choisissez Static (Statique).

      2. Pour Whenever ServerErrors is, choisissez Greater/Equal >=.

      3. Pour que... , entrez 10.

    3. Choisissez Suivant.

  6. La page Configure actions (Configurer des actions) apparait.

    1. Sous Notification, spécifiez les éléments suivants :

      1. Pour le déclencheur de l'état d'alarme, choisissez En alarme.

      2. Pour Sélectionner un SNS sujet, choisissez Sélectionner un SNS sujet existant ou Créer un nouveau sujet, puis complétez les champs obligatoires pour la notification.

      3. Choisissez Suivant.

  7. La page Ajouter un nom et une description apparaît.

    1. Dans Nom de l'alarme, entrez le nom de votre alarme. Le nom ne doit contenir que des ASCII caractères.

    2. Dans Description de l'alarme, entrez une description facultative pour votre alarme.

    3. Choisissez Suivant.

  8. La page de prévisualisation et de création apparaît. Vérifiez que les informations sont correctes, puis choisissez Créer une alarme.

Pour plus d'informations, consultez la section Utilisation des CloudWatch alarmes Amazon dans le guide de CloudWatch l'utilisateur Amazon.