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 les demandes d' EC2 API 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 opérations de l' EC2 API 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
Les métriques de EC2 l'API Amazon sont une fonctionnalité optionnelle. Vous devez demander l'accès à cette fonctionnalité. Pour de plus amples informations, veuillez consulter Activer les métriques de EC2 l'API Amazon.
Table des matières
Activer les métriques de EC2 l'API Amazon
Utilisez la procédure suivante pour demander l'accès à cette fonctionnalité pour votre Compte AWS.
Pour demander l'accès à cette fonctionnalité
-
AWS Support Centre
ouvert. -
Choisissez Create case (Créer une demande).
-
Choisissez Compte et facturation.
-
Pour le service, sélectionnez Informations générales et Mise en route.
-
Dans Catégorie, choisissez Utilisation AWS et services.
-
Choisissez Next step: Additional information (Étape suivante : informations supplémentaires).
-
Pour Subject (Objet), saisissez
Request access to Amazon EC2 API metrics. -
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. -
Choisissez Next step: Solve now or contact us (Étape suivante : résolvez maintenant ou contactez-nous).
-
Dans l'onglet Contactez-nous, choisissez la langue de contact et le mode de contact que vous préférez.
-
Sélectionnez Envoyer.
Mesures et dimensions de l' EC2 API Amazon
Métriques
Les métriques de EC2 l'API Amazon sont contenues dans l'espace de AWS/EC2/API noms. Les tableaux suivants répertorient les métriques disponibles pour les demandes EC2 d'API Amazon.
| Métrique | Description |
|---|---|
|
|
Le nombre de demandes d'API 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 |
|
|
Le nombre de fois que le taux de demandes maximal autorisé par Amazon EC2 APIs a été dépassé pour votre compte. Les demandes EC2 d'API Amazon sont limitées afin de maintenir les performances du service. Si vos demandes ont été limitées, le message d'erreur s'affiche. Unité : nombre |
|
|
Le nombre de demandes d'API 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 |
|
|
Le nombre de demandes d'API réussies. Unité : nombre |
Dimensions
Les données EC2 métriques d'Amazon peuvent être filtrées pour toutes les actions de EC2 l'API. Pour plus d'informations sur les dimensions, consultez Amazon CloudWatch Concepts.
Conservation des données métriques
Les métriques de EC2 l'API 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
Les demandes d'API 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 le calcul de vos limites d'API et n'envoient pas de statistiques à Amazon CloudWatch pour votre compte. Ces demandes ne peuvent pas être surveillées à l'aide de CloudWatch.
Les demandes d'API effectuées en votre nom par des fournisseurs de services tiers sont prises en compte dans le calcul de vos limites de limitation des API et ils envoient des métriques à 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 métriques de EC2 l'API Amazon. Pour plus d'informations, consultez Amazon CloudWatch Pricing
Travailler avec Amazon CloudWatch
Table des matières
Afficher CloudWatch les métriques
Utilisez la procédure suivante pour consulter les métriques de l' EC2 API Amazon.
Prérequis
Vous devez activer l'accès aux métriques de EC2 l'API Amazon pour votre compte. Pour de plus amples informations, veuillez consulter Activer les métriques de EC2 l'API Amazon.
Pour consulter les métriques de l' EC2 API Amazon à l'aide de la console
Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/
. Dans le volet de navigation, choisissez Metrics, All metrics.
-
Dans l'onglet Parcourir, sous Métriques, sélectionnez la région souhaitée pour afficher les métriques.
-
Choisissez l'espace de noms de la EC2métrique.
Pour afficher les métriques, sélectionnez la dimension métrique, telle que les métriques par instance.
Note
Les métriques sont masquées après deux semaines d'inactivité. S'ils ne reçoivent aucun nouveau point de données au cours des deux dernières semaines, ils n'apparaissent plus dans la console, ne s'affichent pas lorsque vous tapez leur nom de métrique ou de dimension dans le champ de recherche de la console et ne sont pas renvoyés par la commande list-metrics AWS CLI . Pour récupérer ces métriques, utilisez les get-metric-statisticscommandes get-metric-dataor.
Pour consulter les métriques de EC2 l'API Amazon à l'aide de la ligne de commande
Utilisez l’une des commandes suivantes :
-
liste-métriques ()AWS CLI
aws cloudwatch list-metrics --namespace "AWS/EC2/API" -
Obtenir la CWMetric liste (AWS Tools for Windows PowerShell)
Get-CWMetricList -Namespace "AWS/EC2/API"
Création d' CloudWatch alarmes
Vous pouvez créer une CloudWatch alarme qui envoie un message Amazon SNS 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 sujet SNS 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 demandes d' DescribeInstancesAPI qui échouent en raison d'erreurs côté serveur. L'alarme suivante envoie une notification par e-mail lorsque le nombre d'échecs de demandes d' DescribeInstances API 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 métriques de EC2 l'API Amazon pour votre compte. Pour de plus amples informations, veuillez consulter Activer les métriques de EC2 l'API Amazon.
Pour créer une alarme en cas d'erreur du serveur de requêtes d' EC2 DescribeInstances API Amazon
Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/
. -
Dans le panneau de navigation, choisissez Alarms (alertes), All alarms (Toutes les alertes).
-
Choisissez Create alarm (Créer une alerte).
-
Choisissez Sélectionner une métrique, puis spécifiez les éléments suivants :
-
Choisissez EC2/API.
-
Choisissez Per-Action Metrics.
-
Cochez la case à côté de celle-ci DescribeInstancesqui se trouve sur la même ligne que le nom de la ServerErrorsmétrique.
-
Choisissez Select metric (Sélectionner une métrique).
-
-
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.
-
Sous Métrique, spécifiez les éléments suivants :
-
Pour Statistics (Statistique), choisissez Sum (Somme).
-
Pour Période, vérifiez que 5 minutes sont sélectionnées.
-
-
Sous Conditions, spécifiez les éléments suivants :
-
Pour Threshold type (Type de seuil), choisissez Static (Statique).
-
Pour Whenever ServerErrors is, choisissez Greater/Equal >=.
-
Pour que... , entrez 10.
-
-
Choisissez Suivant.
-
-
La page Configure actions (Configurer des actions) apparait.
-
Sous Notification, spécifiez les éléments suivants :
-
Pour le déclencheur de l'état d'alarme, choisissez En alarme.
-
Pour Sélectionner un sujet SNS, choisissez Sélectionner un sujet SNS existant ou Créer un nouveau sujet, puis complétez les champs obligatoires pour la notification.
-
Choisissez Suivant.
-
-
-
La page Ajouter un nom et une description apparaît.
-
Dans Nom de l'alarme, entrez le nom de votre alarme. Le nom ne doit contenir que des caractères ASCII.
-
Dans Description de l'alarme, entrez une description facultative pour votre alarme.
-
Choisissez Suivant.
-
-
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.
