Envoyer les journaux des CodeDeploy agents à CloudWatch

Vous pouvez envoyer les données métriques et de journal de l' CodeDeploy agent à CloudWatch l'aide de l' CloudWatch agent unifié ou, plus simplement, de l' CloudWatch agent.

Suivez les instructions ci-dessous pour installer l' CloudWatch agent et le configurer pour une utilisation avec CodeDeploy des agents.

Prérequis

Avant de commencer, effectuez les tâches suivantes :

• Installez l' CodeDeploy agent et assurez-vous qu'il est en cours d'exécution. Pour plus d’informations, consultez Installation de l' CodeDeploy agent et Vérifiez que l' CodeDeploy agent est en cours d'exécution.

• Installez l' CloudWatch agent. Pour plus d'informations, consultez la section Installation de l' CloudWatch agent.

• Ajoutez les autorisations suivantes au profil d'instance CodeDeploy IAM :

  • CloudWatchLogsFullAccess

  • CloudWatchAgentServerPolicy

  Pour plus d'informations sur le profil d' CodeDeploy instance, consultez Étape 4 : Création d'un profil d'instance IAM pour vos instances Amazon EC2 la section deCommencer avec CodeDeploy.

Configuration de l' CloudWatch agent pour collecter les CodeDeploy journaux

Vous pouvez configurer l' CloudWatch agent en utilisant un assistant ou en créant ou en modifiant manuellement un fichier de configuration.

Pour configurer l' CloudWatch agent à l'aide de l'assistant (Linux)

1. Exécutez l'assistant, comme décrit dans Exécuter l'assistant de configuration de l' CloudWatch agent.

2. Dans l'assistant, lorsque vous y êtes invité, Do you want to monitor any log files? entrez1.

3. Spécifiez le fichier journal de l' CodeDeploy agent, comme suit :

   1. Pour Log file path saisir le chemin du fichier CodeDeploy journal, par exemple :/var/log/aws/codedeploy-agent/codedeploy-agent.log.

   2. Pour Log group name saisir un nom de groupe de journaux, par exemple :codedeploy-agent-log.

   3. Pour Log stream name saisir un nom de flux de journal, par exemple :{instance_id}-codedeploy-agent-log.

4. Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.

5. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit :

   1. Pour Log file path saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log.

   2. Pour Log group name saisir un nom de groupe de journaux, par exemple :codedeploy-agent-deployment-log.

   3. Pour Log stream name saisir un nom de flux de journal, par exemple :{instance_id}-codedeploy-agent-deployment-log.

6. Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.

7. Spécifiez les journaux du programme de mise à jour de l' CodeDeploy agent, comme suit :

   1. Pour Log file path saisir le chemin du fichier journal du CodeDeploy programme de mise à jour, par exemple :/tmp/codedeploy-agent.update.log.

   2. Pour Log group name saisir un nom de groupe de journaux, par exemple :codedeploy-agent-updater-log.

   3. Pour Log stream name saisir un nom de flux de journal, par exemple :{instance_id}-codedeploy-agent-updater-log.

Pour configurer l' CloudWatch agent à l'aide de l'assistant (Windows)

1. Exécutez l'assistant, comme décrit dans Exécuter l'assistant de configuration de l' CloudWatch agent.

2. Dans l'assistant, lorsque vous y êtes invité, Do you want to monitor any customized log files? entrez1.

3. Spécifiez le fichier CodeDeploy journal, comme suit :

   1. Pour Log file path saisir le chemin ou le fichier journal de l' CodeDeploy agent, par exemple :C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt.

   2. Pour Log group name saisir un nom de groupe de journaux, par exemple :codedeploy-agent-log.

   3. Pour Log stream name saisir un nom de flux de journal, par exemple :{instance_id}-codedeploy-agent-log.

4. Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.

5. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit :

   1. Pour Log file path saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :C:\ProgramData\Amazon\CodeDeploy\deployment-logs\codedeploy-agent-deployments.log.

   2. Pour Log group name saisir un nom de groupe de journaux, par exemple :codedeploy-agent-deployment-log.

   3. Pour Log stream name saisir un nom de flux de journal, par exemple :{instance_id}-codedeploy-agent-deployment-log.

Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Linux)

1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans Création ou modification manuelle du fichier de configuration de l' CloudWatch agent.

2. Assurez-vous que le fichier est appelé /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json et qu'il contient le code suivant :

   ...
   "logs": {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
                       "log_group_name": "codedeploy-agent-log",
                       "log_stream_name": "{instance_id}-agent-log"
                   },
                   {
                       "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
                       "log_group_name": "codedeploy-agent-deployment-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                   },
                   {
                       "file_path": "/tmp/codedeploy-agent.update.log",
                       "log_group_name": "codedeploy-agent-updater-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
                   }
               ]
           }
       }
   }
   ...

Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Windows)

1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans Création ou modification manuelle du fichier de configuration de l' CloudWatch agent.

2. Assurez-vous que le fichier est appelé C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json et qu'il contient le code suivant :

   ...
   "logs": {
           "logs_collected": {
               "files": {
                   "collect_list": [
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
                           "log_group_name": "codedeploy-agent-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-log"
                       },
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
                           "log_group_name": "codedeploy-agent-deployment-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                       }
                   ]
               },
               ...
           }
       },
   ...

Redémarrer l' CloudWatchagent

Après avoir apporté vos modifications, redémarrez l' CloudWatch agent comme décrit dans Démarrer l' CloudWatch agent.