Requisitos previos Configuración del agente de CloudWatch para que recopile los registros de CodeDeploy Reinicio del agente de CloudWatch

Envío de los registros del agente de CodeDeploy a CloudWatch

Puede enviar las métricas y los datos de registro del agente de CodeDeploy a CloudWatch mediante el agente de CloudWatch unificado o, más simplemente, el agente de CloudWatch.

Siga las instrucciones a continuación para instalar el agente de CloudWatch y configurarlo para su uso con los agentes de CodeDeploy.

Requisitos previos

Antes de empezar, complete las siguientes tareas:

Instale el agente de CodeDeploy y asegúrese de que se esté ejecutando. Para obtener más información, consulte Instalación del agente de CodeDeploy y Comprobación de que el agente de CodeDeploy se está ejecutando.
Instale el agente de CloudWatch. Para obtener más información, consulte Instalación del agente de CloudWatch.
Añada los siguientes permisos al perfil de instancia de IAM de CodeDeploy:
- CloudWatchLogsFullAccess
- CloudWatchAgentServerPolicy
Para obtener más información acerca del perfil de instancia, consulte Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2 de Introducción a CodeDeploy.

Configuración del agente de CloudWatch para que recopile los registros de CodeDeploy

Puede configurar el agente de CloudWatch siguiendo un asistente o creando o editando manualmente un archivo de configuración.

Para configurar el agente de CloudWatch con el asistente (Linux)

Ejecute el asistente, tal y como se describe en Ejecutar el asistente de configuración del agente de CloudWatch.
En el asistente, cuando se le pida Do you want to monitor any log files?, introduzca 1.
Especifique el archivo de registro del agente de CodeDeploy de la siguiente manera:
1. Para Log file path, introduzca la ruta del archivo de registro de CodeDeploy, por ejemplo: /var/log/aws/codedeploy-agent/codedeploy-agent.log.
2. Para Log group name, introduzca un nombre de grupo de registro, por ejemplo: codedeploy-agent-log.
3. Para Log stream name, introduzca un nombre de flujo de registro, por ejemplo: {instance_id}-codedeploy-agent-log.
Cuando se le pida Do you want to specify any additional log files?, introduzca 1.
Especifique los registros de implementación del agente de CodeDeploy de la siguiente manera:
1. Para Log file path, introduzca la ruta del archivo de registro de implementación de CodeDeploy, por ejemplo: /opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log.
2. Para Log group name, introduzca un nombre de grupo de registro, por ejemplo: codedeploy-agent-deployment-log.
3. Para Log stream name, introduzca un nombre de flujo de registro, por ejemplo: {instance_id}-codedeploy-agent-deployment-log.
Cuando se le pida Do you want to specify any additional log files?, introduzca 1.
Especifique los registros del actualizador del agente de CodeDeploy de la siguiente manera:
1. Para Log file path, introduzca la ruta del archivo de registro del actualizador de CodeDeploy, por ejemplo: /tmp/codedeploy-agent.update.log.
2. Para Log group name, introduzca un nombre de grupo de registro, por ejemplo: codedeploy-agent-updater-log.
3. Para Log stream name, introduzca un nombre de flujo de registro, por ejemplo: {instance_id}-codedeploy-agent-updater-log.

Para configurar el agente de CloudWatch con el asistente (Windows)

Ejecute el asistente, tal y como se describe en Ejecutar el asistente de configuración del agente de CloudWatch.
En el asistente, cuando se le pida Do you want to monitor any customized log files?, introduzca 1.
Especifique el archivo de registro de CodeDeploy de la siguiente manera:
1. Para Log file path, introduzca la ruta del archivo de registro del agente de CodeDeploy, por ejemplo: C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt.
2. Para Log group name, introduzca un nombre de grupo de registro, por ejemplo: codedeploy-agent-log.
3. Para Log stream name, introduzca un nombre de flujo de registro, por ejemplo: {instance_id}-codedeploy-agent-log.
Cuando se le pida Do you want to specify any additional log files?, introduzca 1.
Especifique los registros de implementación del agente de CodeDeploy de la siguiente manera:
1. Para Log file path, introduzca la ruta del archivo de registro de implementación de CodeDeploy, por ejemplo: C:\ProgramData\Amazon\CodeDeploy\deployment-logs\codedeploy-agent-deployments.log.
2. Para Log group name, introduzca un nombre de grupo de registro, por ejemplo: codedeploy-agent-deployment-log.
3. Para Log stream name, introduzca un nombre de flujo de registro, por ejemplo: {instance_id}-codedeploy-agent-deployment-log.

Para configurar el agente de CloudWatch mediante la creación o edición manual de un archivo de configuración (Linux)

Cree o edite el archivo de configuración del agente de CloudWatch como se describe en Creación o edición manual del archivo de configuración del agente de CloudWatch.

Asegúrese de que el archivo se llame /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json y de que contenga el siguiente código:


...
"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"
                }
            ]
        }
    }
}
...

Para configurar el agente de CloudWatch mediante la creación o edición manual de un archivo de configuración (Windows)

Cree o edite el archivo de configuración del agente de CloudWatch como se describe en Creación o edición manual del archivo de configuración del agente de CloudWatch.

Asegúrese de que el archivo se llame C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json y de que contenga el siguiente código:


...
"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"
                    }
                ]
            },
            ...
        }
    },
...

Reinicio del agente de CloudWatch

Tras realizar los cambios, reinicie el agente de CloudWatch tal y como se describe en Iniciar el agente de CloudWatch.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Desinstalación del agente de CodeDeploy

Trabajo con instancias