Amazon Elastic Compute Cloud (Amazon EC2) est un service Web qui fournit une capacité de calcul adaptative dans le cloud. Ce service est conçu pour faciliter le cloud computing à l’échelle du Web pour les développeurs.
Activez cette intégration pour visualiser dans Datadog toutes vos métriques EC2 ainsi que des événements supplémentaires, tels que des maintenances planifiées.
Si vous ne l’avez pas déjà fait, configurez d’abord l’intégration Amazon Web Services.
Dans le carré d’intégration AWS, assurez-vous que l’option EC2 est cochée dans la section concernant la collecte des métriques.
Ajoutez les autorisations suivantes à votre stratégie IAM Datadog afin de recueillir des métriques Amazon EC2. Pour en savoir plus sur les stratégies EC2, consultez la documentation du site Web d’AWS.
| Autorisation AWS | Description |
|---|---|
ec2:DescribeInstanceStatus | Utilisé par l’intégration ELB pour assurer l’intégrité d’une l’instance et par l’intégration EC2 pour décrire l’intégrité de toutes les instances. |
ec2:DescribeSecurityGroups | Ajoute des tags personnalisés et des noms SecurityGroup aux instances EC2. |
ec2:DescribeInstances | Ajoute des tags aux instances EC2 et aux métriques EC2 CloudWatch. |
Installez l'intégration Datadog/AWS EC2.
Remarque : si vous souhaitez surveiller un sous-ensemble de vos instances EC2 avec Datadog, appliquez un tag AWS, comme datadog:true, à ces instances EC2. Ajoutez ensuite ce tag dans la zone de texte Optionally limit metrics collection de votre carré d’intégration Datadog/AWS.
En cas d’arrêt manuel d’instances EC2 et de résiliation d’instances déclenchée par la mise à l’échelle automatique d’AWS, Datadog peut désactiver de façon proactive des monitors en fonction des statuts des hosts selon l’API Cloudwatch. Les instances EC2 automatiquement désactivées sont énumérées sur la page Monitor Downtime lorsque vous cochez l’option Show automatically muted hosts.
Sachez que l’intégration EC2 doit être installée pour activer la désactivation automatique. Si la collecte de métriques est limitée aux hosts avec des tags, seules les instances correspondant aux tags sont automatiquement désactivées.
Pour désactiver les monitors lors des arrêts planifiés de l’instance EC2, cochez la case EC2 automuting dans le carré d’intégration AWS :
Suivez les étapes ci-dessous pour installer l’Agent Datadog sur une instance EC2 à l’aide d’AWS Systems Manager. Consultez la section Pourquoi installer l’Agent Datadog sur mes instances cloud ? pour découvrir les avantages de l’installation de l’Agent sur vos instances AWS EC2.
Dans le Parameter Store, créez un paramètre ayant les propriétés suivantes :
dd-api-key-for-ssmSecureStringMy current accountDans le Systems Manager, créez un Document :
dd-agent-installCommand documentJSONSi vous utilisez le site américain de Datadog, utilisez le fichier dd-agent-install-us-site.json après y avoir spécifié votre <RÉGION_AWS> sous runCommand (p. ex., us-east-1). Si vous êtes sur le site européen de Datadog, utilisez plutôt le fichier dd-agent-install-eu-site.json.
Sous Run Command, cliquez sur le bouton Run command et suivez les étapes ci-dessous :
Cliquez sur le bouton Run ; une page de confirmation montrant le statut s’affiche alors. Patientez jusqu’à la fin, puis vérifiez la liste d’infrastructures dans Datadog.
Utilisez l'Agent Datadog ou un autre log shipper pour envoyer vos logs vers Datadog.
| aws.ec2.cpucredit_balance (gauge) | Number of CPU credits that an instance has accumulated. Shown as unit |
| aws.ec2.cpucredit_usage (gauge) | Number of CPU credits consumed. Shown as unit |
| aws.ec2.cpusurplus_credit_balance (gauge) | The number of surplus credits that have been spent by an unlimited instance when its CPUCreditBalance value is zero. Shown as unit |
| aws.ec2.cpusurplus_credits_charged (gauge) | The number of spent surplus credits that are not paid down by earned CPU credits, and which thus incur an additional charge. Shown as unit |
| aws.ec2.cpuutilization (gauge) | Average percentage of allocated EC2 compute units that are currently in use on the instance. Shown as percent |
| aws.ec2.cpuutilization.maximum (gauge) | Maximum percentage of allocated EC2 compute units that are currently in use on the instance. Shown as percent |
| aws.ec2.disk_read_bytes (gauge) | Bytes read from all ephemeral disks available to the instance. Shown as byte |
| aws.ec2.disk_read_ops (gauge) | Completed read operations from all ephemeral disks available to the instance. Shown as operation |
| aws.ec2.disk_write_bytes (gauge) | Bytes written to all ephemeral disks available to the instance. Shown as byte |
| aws.ec2.disk_write_ops (gauge) | Completed write operations to all ephemeral disks available to the instance. Shown as operation |
| aws.ec2.ebsbyte_balance (gauge) | Available only for the smaller instance sizes. Provides information about the percentage of throughput credits remaining in the burst bucket. This metric is available for basic monitoring only. Shown as percent |
| aws.ec2.ebsiobalance (gauge) | Available only for the smaller instance sizes. Provides information about the percentage of I/O credits remaining in the burst bucket. This metric is available for basic monitoring only. Shown as percent |
| aws.ec2.ebsread_bytes (gauge) | Bytes read from all EBS volumes attached to the instance in a specified period of time. Shown as byte |
| aws.ec2.ebsread_ops (count) | Completed read operations from all Amazon EBS volumes attached to the instance in a specified period of time. Shown as operation |
| aws.ec2.ebswrite_bytes (gauge) | Bytes written to all EBS volumes attached to the instance in a specified period of time. Shown as byte |
| aws.ec2.ebswrite_ops (count) | Completed write operations to all EBS volumes attached to the instance in a specified period of time. Shown as operation |
| aws.ec2.host_ok (gauge) | 1 if the instance's system status is ok. |
| aws.ec2.instance_age (gauge) | Time since instance launch Shown as second |
| aws.ec2.network_in (gauge) | Average number of bytes received on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_in.maximum (gauge) | Maximum number of bytes received on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_out (gauge) | Average number of bytes sent out on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_out.maximum (gauge) | Maximum number of bytes sent out on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_packets_in (gauge) | Number of packets received on all network interfaces by the instance Shown as packet |
| aws.ec2.network_packets_out (gauge) | Number of packets sent out on all network interfaces by the instance Shown as packet |
| aws.ec2.status_check_failed_instance (gauge) | 0 if the instance has passed the EC2 instance status check. |
| aws.ec2.status_check_failed_system (gauge) | 0 if the instance has passed the EC2 system status check. |
| aws.ec2.status_check_failed (gauge) | 1 if one of the status checks failed. |
Chacune des métriques récupérées à partir d’AWS se voit assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s’y limiter, le hostname et les groupes de sécurité.
Remarque : aws.ec2.instance_age n’est pas recueillie par défaut avec l’intégration Datadog/EC2. Contactez-nous pour activer la collecte de cette métrique.
L’intégration AWS EC2 n’inclut aucun check de service.
L’intégration AWS EC2 comprend des événements pour les maintenances planifiées et à venir ainsi que des avertissements d’instance. Vous trouverez ci-dessous des exemples d’événements :
Besoin d’aide ? Contactez l’assistance Datadog.
