Comment puis-je utiliser l'agent CloudWatch sur un serveur Windows pour consulter les métriques du moniteur de performance ?

Résolution

Pour installer et configurer l'agent CloudWatch sur votre serveur Windows et consulter les métriques de Windows Performance Monitor, procédez comme suit.

Prérequis :

• Une instance Amazon Elastic Compute Cloud (Amazon EC2) sur un sous-réseau public avec accès à Internet. Ou une instance EC2 sur un sous-réseau privé avec accès aux points de terminaison Amazon Virtual Private Cloud (Amazon VPC).
• Un profil et un rôle AWS Identity and Access Management (IAM) pour l'instance.
• Agent AWS Systems Manager (agent SSM).
• L’agent CloudWatch.

Démarrer votre instance

Procédez comme suit :

1. Démarrez votre instance.
2. Utilisez un protocole RDP (Remote Desktop Protocol) pour vous connecter à votre instance.
   Remarque : L'agent CloudWatch prend en charge Windows Servers 2016, 2019 et les versions 64 bits de Windows Server 2022

Installer l'agent CloudWatch

Pour installer l'agent CloudWatch, téléchargez-le automatiquement ou manuellement.

Télécharger automatiquement l'agent CloudWatch

Pour utiliser le package AWS-ConfigureAWS afin d'installer l'agent, consultez la section Installation de l'agent CloudWatch sur les instances EC2 à l'aide de la configuration de votre agent.

Télécharger manuellement l'agent CloudWatch

Pour télécharger manuellement l’agent CloudWatch, exécutez la commande suivante :

Invoke-WebRequest -Uri  
 https://s3.amazonaws.com/amazoncloudwatch-agent/windows/amd64/latest/amazon-cloudwatch-agent.msi  
 -OutFile $env:USERPROFILE\Downloads\amazon-cloudwatch-agent.msi   
-UseBasicParsing  
Invoke-Item $env:USERPROFILE\Downloads\amazon-cloudwatch-agent.msi

Créer le fichier de configuration

Après avoir téléchargé le fichier .msi, utilisez l'assistant pour créer le fichier de configuration JSON. Vous pouvez également créer manuellement le fichier de configuration.

Utilisez l'assistant pour créer le fichier de configuration de l'agent CloudWatch.

1. Utilisez amazon-cloudwatch-agent-config-wizard pour créer le fichier de configuration de l'agent CloudWatch.
   Exemple de fichier :

   {  
      "logs": {
       "logs_collected": {
         "files": {
           "collect_list": [
             {
               "file_path": "C:\\Users\\Administrator\\Desktop\\CWMetricsLogs",
               "log_group_name": "CWMetricsLogs",
               "log_stream_name": "{instance_id}",
               "retention_in_days": -1
             }
           ]
         },
         "windows_events": {
           "collect_list": [
             {
               "event_format": "xml",
               "event_levels": [
                 "VERBOSE",
                 "INFORMATION",
                 "WARNING",
                 "ERROR",
                 "CRITICAL"
               ],
               "event_name": "CloudWatchAgent",
               "log_group_name": "CloudWatchAgent",
               "log_stream_name": "{instance_id}",
               "retention_in_days": -1
             }
           ]
         }
       }
     },
     "metrics": {
       "aggregation_dimensions": [
         [
           "InstanceId"
         ]
       ],
       "append_dimensions": {
         "AutoScalingGroupName": "${aws:AutoScalingGroupName}",
         "ImageId": "${aws:ImageId}",
         "InstanceId": "${aws:InstanceId}",
         "InstanceType": "${aws:InstanceType}"
       },
       "metrics_collected": {
         "LogicalDisk": {
           "measurement": [
             "% Free Space"
           ],
           "metrics_collection_interval": 30,
           "resources": [
             "*"
           ]
         },
         "Memory": {
           "measurement": [
             "% Committed Bytes In Use"
           ],
           "metrics_collection_interval": 30
         },
         "Paging File": {
           "measurement": [
             "% Usage"
           ],
           "metrics_collection_interval": 30,
           "resources": [
             "*"
           ]
         },
         "PhysicalDisk": {
           "measurement": [
             "% Disk Time",
             "Disk Write Bytes/sec",
             "Disk Read Bytes/sec",
             "Disk Writes/sec",
             "Disk Reads/sec"
           ],
           "metrics_collection_interval": 30,
           "resources": [
             "*"
           ]
         },
         "Processor": {
           "measurement": [
             "% User Time",
             "% Idle Time",
             "% Interr\upt Time"
           ],
           "metrics_collection_interval": 30,
           "resources": [
             "*"
           ]
         },
         "TCPv4": {
           "measurement": [
             "Connections Established"
           ],
           "metrics_collection_interval": 30
         },
         "TCPv6": {
           "measurement": [
             "Connections Established"
           ],
           "metrics_collection_interval": 30
         },
         "statsd": {
           "metrics_aggregation_interval": 60,
           "metrics_collection_interval": 30,
           "service_address": ":8125"
         }
       }
     }
   }

2. (Facultatif) Pour ajouter d'autres compteurs de performances disponibles dans Performance Monitor, exécutez la commande suivante :

   "PerformanceCounter-Family(processor, logical disk, memory etc.)": {  
     "measurement": [
         "Counter-name ("%Usage, "% free space" etc.)"
       ],
     "metrics_collection_interval": 30,
     "resources": [
       "Counter Property ( "_total", "C:/" etc.)
     ]
   },

   Remarque : Dans la commande précédente, remplacez les exemples de valeurs par les vôtres. Assurez-vous également que les compteurs sont visibles dans Windows Performance Monitor afin que l'agent puisse transmettre les points de données pour le compteur.

3. Recherchez le fichier dans C:\Program Files\Amazon\AmazonCloudWatchAgent.

4. Pour démarrer l'agent CloudWatch, exécutez la commande Windows PowerShell suivante :

   "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -s -c file:"C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json"

Création manuelle du fichier de configuration

Pour plus d'informations sur la création manuelle du fichier JSON, consultez la section Créer ou modifier manuellement le fichier de configuration de l'agent CloudWatch.

Exemple de définition de schéma pour le fichier de configuration pour les serveurs Windows :

installation-directory/amazon-cloudwatch-agent-schema.json

Après avoir créé le fichier, copiez-le sur les autres serveurs Windows sur lesquels vous souhaitez installer l'agent.

Consulter les métriques des compteurs de performance dans CloudWatch

Procédez comme suit :

1. Ouvrez la console CloudWatch.
2. Dans le volet de navigation, sous Métriques, sélectionnez EC2.
3. Dans la section Espaces de nom personnalisés, sélectionnez CWAgent.
4. Triez par ImageID, InstanceType, instance, objectname ou InstanceID.

Informations connexes

Collecter des métriques, des journaux et des suivis avec l'agent CloudWatch