Enviar los registros CodeDeploy de los agentes a CloudWatch

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

Siga las instrucciones siguientes para instalar el CloudWatch agente y configurarlo para su uso con CodeDeploy los agentes.

Requisitos previos

Antes de empezar, complete las siguientes tareas:

• Instale el CodeDeploy agente y asegúrese de que se esté ejecutando. Para obtener más información, consulte Instale el CodeDeploy agente y Compruebe que el CodeDeploy agente se esté ejecutando.

• Instale el CloudWatch agente. Para obtener más información, consulte Instalación del CloudWatch agente.

• Añada los siguientes permisos al perfil de instancia de CodeDeploy IAM:

  • CloudWatchLogsFullAccess

  • CloudWatchAgentServerPolicy

  Para obtener más información sobre el perfil de la CodeDeploy instancia, consultePaso 4: Crea un perfil de IAM instancia para tus EC2 instancias de Amazon. Empezar con CodeDeploy

Configure el CloudWatch agente para recopilar CodeDeploy registros

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

Para configurar el CloudWatch agente mediante el asistente (Linux)

1. Ejecute el asistente, tal y como se describe en Ejecutar el asistente de configuración del CloudWatch agente.

2. En el asistente, cuando se le pida Do you want to monitor any log files?, introduzca 1.

3. Especifique el archivo de registro del CodeDeploy agente de la siguiente manera:

   1. Para Log file path introducir la ruta del archivo de CodeDeploy registro, 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.

4. Cuando se le pida Do you want to specify any additional log files?, introduzca 1.

5. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera:

   1. Para Log file path introducir la ruta del archivo de registro de CodeDeploy despliegue, 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.

6. Cuando se le pida Do you want to specify any additional log files?, introduzca 1.

7. Especifique los registros del actualizador del CodeDeploy agente, de la siguiente manera:

   1. Para Log file path introducir la ruta del archivo de registro del CodeDeploy actualizador, 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 CloudWatch agente mediante el asistente (Windows)

1. Ejecute el asistente, tal y como se describe en Ejecutar el asistente de configuración del CloudWatch agente.

2. En el asistente, cuando se le pida Do you want to monitor any customized log files?, introduzca 1.

3. Especifique el archivo de CodeDeploy registro de la siguiente manera:

   1. Para Log file path introducir la ruta o el archivo de registro del CodeDeploy agente, 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.

4. Cuando se le pida Do you want to specify any additional log files?, introduzca 1.

5. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera:

   1. Para Log file path introducir la ruta del archivo CodeDeploy de registro de despliegue, 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 CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Linux)

1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en Crear o editar manualmente el archivo de configuración del CloudWatch agente.

2. 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 CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Windows)

1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en Crear o editar manualmente el archivo de configuración del CloudWatch agente.

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

Reinicie el CloudWatch agente

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