Amazon EC2
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Amazon EC2

Crawler Crawler

Présentation

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.

Implémentation

Installation

Si vous ne l’avez pas déjà fait, configurez d’abord l’intégration Amazon Web Services.

Configuration

  1. 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.

  2. 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 AWSDescription
    ec2:DescribeInstanceStatusUtilisé 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:DescribeSecurityGroupsAjoute des tags personnalisés et des noms SecurityGroup aux instances EC2.
    ec2:DescribeInstancesAjoute des tags aux instances EC2 et aux métriques EC2 CloudWatch.
  3. 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.

Désactivation automatique pour EC2

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 :

Installer l’Agent avec AWS Systems Manager

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.

Parameter Store

Dans le Parameter Store, créez un paramètre ayant les propriétés suivantes :

  • Name : dd-api-key-for-ssm
  • Description : (facultatif)
  • Type : SecureString
  • KMS key source : My current account
  • KMS Key ID : utilisez la valeur sélectionnée par défaut.
  • Valeur : votre clé d’API Datadog

Systems Manager

Documents

Dans le Systems Manager, créez un Document :

  • Name : dd-agent-install
  • Target type : (facultatif)
  • Document type : Command document
  • Content : JSON

Si 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.

Run Command

Sous Run Command, cliquez sur le bouton Run command et suivez les étapes ci-dessous :

  • Command document :
    • Cliquez sur la zone de recherche et sélectionnez Owner -> Owned by me.
    • Cliquez sur la case d’option correspondant à votre document.
    • Si besoin, sélectionnez le paramètre Document version.
  • Targets :
    • Sélectionnez l’instance EC2 à cibler.
  • Output options (facultatif) :
    • Cochez la case CloudWatch output pour loguer les éventuels problèmes.
  • *Autres sections (facultatif) :
    • Modifiez les autres sections en fonction de votre configuration si vous le souhaitez.

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.

Collecte de logs

Utilisez l’Agent Datadog ou un autre log shipper pour envoyer vos logs vers Datadog.

Données collectées

Métriques

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.

Checks de service

L’intégration AWS EC2 n’inclut aucun check de service.

Événements

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 :

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin