Conditions préalables Configuration de l' CloudWatch agent pour collecter les CodeDeploy journaux Redémarrer l' CloudWatch agent

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.

Conditions préalables

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)

Exécutez l'assistant, comme décrit dans Exécuter l'assistant de configuration de l' CloudWatch agent.
Dans l'assistant, lorsque vous y êtes invité, Do you want to monitor any log files? entrez1.
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.
Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.
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.
Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.
Spécifiez les journaux du programme de mise à jour de l' CodeDeploy agent, comme suit :
1. PourLog file path, entrez le chemin du fichier journal du CodeDeploy programme de mise à jour. Le chemin dépend de la version de votre agent :
  - Pour les versions 2.0.x et ultérieures, utilisez. /var/log/aws/codedeploy-agent/codedeploy-agent-updater.log
  - Pour les versions 1.8.x et antérieures, utilisez. /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)

Exécutez l'assistant, comme décrit dans Exécuter l'assistant de configuration de l' CloudWatch agent.
Dans l'assistant, lorsque vous y êtes invité, Do you want to monitor any customized log files? entrez1.
Spécifiez le fichier CodeDeploy journal, comme suit :
1. PourLog file path, entrez le chemin du fichier journal de l' CodeDeploy agent. Le chemin dépend de la version de votre agent :
  - Pour les versions 2.0.x et ultérieures, utilisez. C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent.log
  - Pour les versions 1.8.x et antérieures, utilisez. 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.
Lorsque vous y êtes invitéDo you want to specify any additional log files?, entrez1.
Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit :
1. PourLog file path, entrez le chemin du fichier journal de CodeDeploy déploiement :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)

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.

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

Le chemin du journal de mise à jour varie selon la version. Pour les versions 2.0.x et ultérieures, utilisez. /var/log/aws/codedeploy-agent/codedeploy-agent-updater.log Pour les versions 1.8.x et antérieures, utilisez. /tmp/codedeploy-agent.update.log


...
"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": "/var/log/aws/codedeploy-agent/codedeploy-agent-updater.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)

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.

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

Pour les versions 2.0.x et ultérieures, le nom du fichier journal de l'agent est. codedeploy-agent.log Pour les versions 1.8.x et antérieures, le nom du fichier journal de l'agent est. codedeploy-agent-log.txt Le chemin du journal de déploiement est le même pour les deux versions.


...
"logs": {
        "logs_collected": {
            "files": {
                "collect_list": [
                    {
                        "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent.log",
                        "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' CloudWatch agent

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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Désinstallez l' CodeDeploy agent

Utilisation d’instances