Uso de CloudWatch Logs con AWS Batch

Puede configurar sus trabajos AWS Batch en los recursos de EC2 para enviar información de registro y métricas detalladas a CloudWatch Logs. De esta forma, puede ver distintos registros desde sus trabajos en una ubicación cómoda. Para obtener más información acerca de CloudWatch, consulte ¿Qué son los registros de Amazon CloudWatch? en la Guía del usuario de Amazon CloudWatch.

nota

De forma predeterminada, CloudWatch Logs está activado en los contenedores de Fargate AWS.

Para activar y personalizar el registro de CloudWatch Logs, revise las siguientes tareas de configuración únicas:

• Para los entornos informáticos AWS Batch que se basan en recursos de EC2, añada una política de IAM al rol ecsInstanceRole. Para obtener más información, consulte Añadir una política de IAM de CloudWatch Logs.

• Cree una plantilla de lanzamiento de Amazon EC2 que incluya una supervisión detallada de CloudWatch y, a continuación, especifique la plantilla al crear su entorno informático AWS Batch. También puede instalar el agente de CloudWatch en una imagen existente y, a continuación, especificar la imagen en el asistente de primera ejecución AWS Batch.

• (Opcional) Configure el controlador awslogs. Puede agregar parámetros que cambien el comportamiento predeterminado en los recursos de EC2 y Fargate. Para obtener más información, consulte Uso del controlador de registros awslogs.

Añadir una política de IAM de CloudWatch Logs

Para que los trabajos puedan enviar datos de registros y métricas detalladas a CloudWatch Logs, debe crear una política de IAM que utilice las API de CloudWatch Logs. Después de crear la política de IAM, asóciela al rol ecsInstanceRole.

nota

Si la política ECS-CloudWatchLogs no está asociada al rol ecsInstanceRole, se pueden enviar métricas básicas a CloudWatch Logs. Sin embargo, las métricas básicas no incluyen datos de registro ni métricas detalladas, como el espacio libre en disco.

Los entornos de cómputo AWS Batch utilizan recursos de Amazon EC2. Al crear un entorno informático mediante el asistente de primera ejecución AWS Batch, AWS Batch crea el rol ecsInstanceRole y configura el entorno con él.

Si no utiliza el asistente de primera ejecución, puede especificar el rol ecsInstanceRole al crear un entorno informático en la API AWS Command Line Interface o AWS Batch. Para obtener más información, consulte Referencia de comandos AWS CLI o Referencia de API AWS Batch.

Para crear la política de IAM ECS-CloudWatchLogs

1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación, seleccione Políticas.

3. Elija Crear política.

4. Elija JSON y, a continuación, escriba la política siguiente:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogGroup",
                   "logs:CreateLogStream",
                   "logs:PutLogEvents",
                   "logs:DescribeLogStreams"
               ],
               "Resource": [
                   "arn:aws:logs:*:*:*"
               ]
           }
       ]
   }

5. Elija Siguiente: etiquetas.

6. (Opcional) En Añadir etiquetas, elije Añadir etiqueta para añadir una etiqueta a la política.

7. Elija Siguiente: revisar.

8. En la página Revisar política, en Nombre, escriba ECS-CloudWatchLogs, y después introduzca una Descripción opcional.

9. Elija Crear política.

Asociación de la política ECS-CloudWatchLogs a ecsInstanceRole

1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. Seleccione Roles en el panel de navegación.

3. Elija ecsInstanceRole. Si el rol no existe, siga los procedimientos que se indican en Función de instancia de Amazon ECS para crear el rol.

4. Elija Agregar permisos y luego Adjuntar políticas.

5. Elija la política ECS-CloudWatchLogs y haga clic en Adjuntar política.

Instalación y configuración del agente de CloudWatch

Puede crear una plantilla de lanzamiento de Amazon EC2 que incluya la supervisión de CloudWatch. Para obtener más información, consulte, Lanzar una instancia desde una plantilla de lanzamiento y Detalles avanzados en la Guía del usuario de Amazon EC2 para instancias de Linux.

También puede instalar el agente CloudWatch en una AMI de Amazon EC2 existente y, a continuación, especificar la imagen en el asistente de primera ejecución AWS Batch. Para obtener más información, consulte Instalación del agente de CloudWatch y Introducción a AWS Batch.

nota

Los recursos AWS Fargate no admiten plantillas de lanzamiento.

Ver CloudWatch Logs

Puede ver y buscar los registros de CloudWatch Logs en AWS Management Console.

nota

Es posible que los datos tarden unos minutos en mostrarse en CloudWatch Logs.

Para consultar los datos de CloudWatch Logs

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación izquierdo, elija Registros, luego, Grupos de registros.

   

3. Seleccione un grupo de registros que desea ver.

   

4. Elija el flujo de registros que desea ver. De forma predeterminada, las transmisiones se identifican con los primeros 200 caracteres del nombre del trabajo y el ID de la tarea de Amazon ECS.

   sugerencia

   Para descargar los datos del flujo de registro, elija Acciones.