

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando CloudWatch registros com AWS Batch
<a name="using_cloudwatch_logs"></a>

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 é Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) 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 obter mais informações, consulte [Tutorial: Adicionar uma política do CloudWatch Logs IAM](cwl_iam_policy.md).
+ 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 obter mais informações, consulte [Usar o driver de log awslogs.](using_awslogs.md).

**Topics**
+ [Tutorial: Adicionar uma política do CloudWatch Logs IAM](cwl_iam_policy.md)
+ [Instalar e configurar o CloudWatch agente](installing_cwl_agent.md)
+ [Tutorial: Exibir CloudWatch registros](viewing_cwlogs.md)

# Tutorial: Adicionar uma política do CloudWatch Logs IAM
<a name="cwl_iam_policy"></a>

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 os CloudWatch Logs APIs. Após criar a política do IAM, 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](https://docs.aws.amazon.com/cli/latest/reference/) ou [AWS Batch API Reference](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html).

**Para criar a política de IAM `ECS-CloudWatchLogs`**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, selecione **Políticas**. 

1. Escolha **Create policy**.

1. Escolha **JSON** e insira a seguinte política:

------
#### [ JSON ]

****  

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

------

1. Escolha **Next: Tags**.

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

1. Escolha **Next: Review**.

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

1. 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/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, selecione **Roles**. 

1. Selecione `ecsInstanceRole`. Se o perfil não existir, siga os procedimentos em [Perfil de instância do Amazon ECS](instance_IAM_role.md) para criar o perfil.

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

1. Escolha a CloudWatchLogs política **ECS** e, em seguida, escolha **Anexar política**.

# Instalar e configurar o CloudWatch agente
<a name="installing_cwl_agent"></a>

Você pode criar um modelo de lançamento do Amazon EC2 que CloudWatch inclua monitoramento. Para obter mais informações, consulte [Iniciar uma instância a partir de um modelo de inicialização](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#lt-initiate-launch-template) e [Detalhes avançados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#lt-advanced-details), 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html) [Introdução aos AWS Batch tutoriais](Batch_GetStarted.md) e.

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

# Tutorial: Exibir CloudWatch registros
<a name="viewing_cwlogs"></a>

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

**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/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação à esquerda, escolha **Logs** e, em seguida, escolha **Grupos de logs**.  
![\[CloudWatch grupos de log do console\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/cwl-log-groups.png)

1. Escolha um grupo de logs para visualizar.  
![\[CloudWatch fluxos de log do console\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/cw_log_stream.png)

1. 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**.  
![\[CloudWatch eventos de log do console\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/cw_log_events.png)