Usando CloudWatch registros com AWS Batch

Você pode configurar seus AWS Batch trabalhos nos recursos do EC2 para enviar informações e métricas detalhadas de CloudWatch registros para a Logs. Ao fazer isso, você pode exibir logs diferentes das tarefas em um local conveniente. Para obter mais informações sobre CloudWatch registros, consulte O que é o Amazon CloudWatch Logs? no Guia do CloudWatch usuário da Amazon.

nota

Por padrão, CloudWatch os registros estão ativados para contêineres AWS Fargate.

Para ativar e personalizar o registro de CloudWatch registros, revise as seguintes tarefas de configuração únicas:

• Para ambientes AWS Batch computacionais baseados em recursos do EC2, adicione uma política do IAM à ecsInstanceRole função. Para ter mais informações, consulte Adicionar uma política de IAM do CloudWatch Logs.

• Crie um modelo de lançamento do Amazon EC2 que inclua CloudWatch monitoramento detalhado e, em seguida, especifique o modelo ao criar seu ambiente AWS Batch computacional. Você também pode instalar o CloudWatch agente em uma imagem existente e depois especificar a imagem no assistente de AWS Batch primeira execução.

• (Opcional) Configure o driver awslogs. Você pode adicionar parâmetros que alteram o comportamento padrão nos recursos do EC2 e do Fargate. Para ter mais informações, consulte Usar o driver de log awslogs.

Adicionar uma política de IAM do CloudWatch Logs

Antes que seus trabalhos possam enviar dados de registro e métricas detalhadas para o CloudWatch Logs, você precisa criar uma política do IAM que use as CloudWatch APIs do Logs. Após criar a política, anexe a política a um perfil ecsInstanceRole.

nota

Se a ECS-CloudWatchLogs política não estiver vinculada à ecsInstanceRole função, as métricas básicas ainda poderão ser enviadas ao CloudWatch Logs. No entanto, as métricas básicas não incluem dados de registro ou métricas detalhadas, como espaço livre em disco.

AWS Batch ambientes computacionais usam recursos do Amazon EC2. Quando você cria um ambiente computacional usando o assistente de AWS Batch primeira execução, AWS Batch cria a ecsInstanceRole função e configura o ambiente com ela.

Se você não estiver usando o assistente de primeira execução, poderá especificar a ecsInstanceRole função ao criar um ambiente computacional na API AWS Command Line Interface ou AWS Batch . Para obter mais informações, consulte AWS CLI Command Reference ou AWS Batch API Reference.

Para criar a política de IAM ECS-CloudWatchLogs

1. Abra o console IAM em https://console.aws.amazon.com/iam/.

2. No painel de navegação, escolha Policies.

3. Escolha Create policy.

4. Escolha JSON e insira a seguinte política:

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

5. Escolha Next: Tags.

6. (Opcional) Em Adicionar tags, escolha Adicionar tag para adicionar uma tag à política.

7. Escolha Next: Review.

8. Na página Review policy, em Name, digite ECS-CloudWatchLogs, e, em seguida, digite uma Description opcional.

9. Escolha Create policy.

Para anexar a política ECS-CloudWatchLogs a ecsInstanceRole

1. Abra o console do IAM em https://console.aws.amazon.com/iam/.

2. No painel de navegação, selecione Roles.

3. Selecione ecsInstanceRole. Se o perfil não existir, siga os procedimentos em Perfil de instância do Amazon ECS para criar o perfil.

4. Escolha Adicionar Permissões e depois escolha Anexar Políticas.

5. Escolha a política CloudWatchECS-Logs e, em seguida, escolha Anexar política.

Instalar e configurar o CloudWatch agente

Você pode criar um modelo de lançamento do Amazon EC2 que CloudWatch inclua monitoramento. Para obter mais informações, consulte Executar uma instância a partir de um modelo de execução e detalhes avançados no Guia do usuário do Amazon EC2.

Você também pode instalar o CloudWatch agente em uma AMI existente do Amazon EC2 e depois especificar a imagem no assistente de AWS Batch primeira execução. Para obter mais informações, consulte Instalação do CloudWatch agente e Introdução ao AWS Batch.

nota

Os modelos de lançamento não são compatíveis com os AWS Fargate recursos.

Exibir CloudWatch registros

Você pode visualizar e pesquisar CloudWatch registros de registros no AWS Management Console.

nota

Pode levar alguns minutos para que os dados sejam exibidos nos CloudWatch registros.

Para ver seus dados CloudWatch de registros

1. Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação à esquerda, escolha Logs e, em seguida, escolha Grupos de logs.

   

3. Escolha um grupo de logs para visualizar.

   

4. Escolha um stream de logs para visualizar. Por padrão, os fluxos são identificados pelos primeiros 200 caracteres do nome do trabalho e pelo ID da tarefa do Amazon ECS.

   dica

   Para baixar os dados do fluxo de logs, escolha Ações.