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á.

# Usar o driver de log awslogs.
<a name="using_awslogs"></a>

Por padrão, AWS Batch permite que o driver de `awslogs` registro envie informações de registro para o CloudWatch Logs. Você pode usar esse atributo para visualizar logs diferentes dos contêineres em um local indicado e evita que os logs de contêiner ocupem espaço em disco nas instâncias de contêiner. Este tópico ajuda você a configurar o driver de log `awslogs` em suas definições de trabalho.

**nota**  
No AWS Batch console, você pode configurar o driver de `awslogs` registro na seção **Configuração de registro** ao criar uma definição de tarefa.

**nota**  
O tipo de informações registradas em log pelos contêineres em seu trabalho depende principalmente do comando `ENTRYPOINT`. Por padrão, os registros capturados mostram a saída do comando que você normalmente vê em um terminal interativo se você executou o contêiner localmente, que são os `STDERR` I/O fluxos `STDOUT` e. O driver de `awslogs` log simplesmente passa esses registros do Docker para o CloudWatch Logs. Para obter mais informações sobre como os logs do Docker são processados, incluindo maneiras alternativas de capturar fluxos ou dados de arquivos diferentes, consulte [Visualizar logs de um contêiner ou serviço](https://docs.docker.com/config/containers/logging/) na documentação do Docker.

Para enviar registros do sistema de suas instâncias de contêiner para o CloudWatch Logs, consulte[Usando CloudWatch registros com AWS Batch](using_cloudwatch_logs.md). Para obter mais informações sobre CloudWatch registros, consulte [Monitoramento de arquivos de log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) e [cotas de CloudWatch registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) no *Guia do usuário do Amazon CloudWatch Logs*.

## opções do driver de log awslogs no tipo de AWS Batch JobDefiniton dados
<a name="create_awslogs_logdriver_options"></a>

O driver de `awslogs` log oferece suporte às seguintes opções nas definições de AWS Batch tarefas. Para obter mais informações, consulte [Driver de registro de CloudWatch registros](https://docs.docker.com/config/containers/logging/awslogs/) na documentação do Docker.

`awslogs-region`  
Obrigatório: não  
Especifique a região para a qual o driver de log `awslogs` deve enviar os logs do Docker. Por padrão, a região usada é a mesma do trabalho. Você pode optar por enviar todos os seus registros de trabalhos em diferentes regiões para uma única região em CloudWatch Registros. Isso permite que todos sejam visíveis em um único local. Como alternativa, você pode separá-los por região para uma abordagem mais granular. No entanto, quando escolher esta opção, certifique-se de que os grupos de logs especificados existam na região especificada.

`awslogs-group`  
Obrigatório: opcional  
Com a opção `awslogs-group`, você pode especificar o grupo de logs para o qual o driver de log `awslogs` envia seus fluxos de logs. Se esse campo não for especificado, será usado `aws/batch/job`.

`awslogs-stream-prefix`  
Obrigatório: opcional  
Com a `awslogs-stream-prefix` opção, você pode associar um fluxo de log ao prefixo especificado e ao ID da tarefa do Amazon ECS do AWS Batch trabalho ao qual o contêiner pertence. Caso você especifique um prefixo com essa opção, o fluxo de log utiliza o seguinte formato:  

```
prefix-name/default/ecs-task-id
```

`awslogs-datetime-format`  
Obrigatório: não  
Essa opção define um padrão de início de várias linhas no formato `strftime` em Python. Uma mensagem de log é formada por uma linha em conformidade com o padrão e as linhas seguintes que não correspondem ao padrão. Assim, a linha em conformidade é o delimitador entre as mensagens de log.  
Um exemplo de um caso de uso para esse formato é a análise da saída, como um despejo de pilha, que poderia ser registrado em várias entradas. O padrão correto permite que ele seja capturado em uma única entrada.  
Para obter mais informações, consulte [awslogs-datetime-format](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-datetime-format).  
Essa opção sempre terá precedência se `awslogs-datetime-format` e `awslogs-multiline-pattern` estiverem configurados.  
O registro em várias linhas executa a análise da expressão regular e a correspondência de todas as mensagens de log. Isso pode ter um impacto negativo na performance do registro em log.

`awslogs-multiline-pattern`  
Obrigatório: não  
Essa opção define um padrão inicial de várias linhas usando uma expressão regular. Uma mensagem de log é formada por uma linha em conformidade com o padrão e as linhas seguintes que não correspondem ao padrão. Assim, a linha em conformidade é o delimitador entre as mensagens de log.  
Para obter mais informações, consulte [awslogs-multiline-pattern](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-multiline-pattern)a documentação do Docker.  
Essa opção será ignorada se `awslogs-datetime-format` também estiver configurado.  
O registro em várias linhas executa a análise da expressão regular e a correspondência de todas as mensagens de log. Isso pode ter um impacto negativo na performance do registro em log.

`awslogs-create-group`  
Obrigatório: não  
Especifique se você deseja que o grupo de logs seja criado automaticamente. Se essa opção não for especificada, o padrão será `false`.  
Essa opção não é recomendada. Recomendamos que você crie o grupo de CloudWatch registros com antecedência usando a ação da [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)API Logs, pois cada trabalho tenta criar o grupo de registros, aumentando a chance de falha do trabalho.
A política do IAM para seu perfil de execução deve incluir a permissão `logs:CreateLogGroup` antes que você tente usar `awslogs-create-group`.

## Especificar uma configuração de log na definição de trabalho
<a name="specify-log-config"></a>

Por padrão, AWS Batch ativa o driver de `awslogs` log. Esta seção descreve como personalizar a configuração de log `awslogs` de um trabalho. Para obter mais informações, consulte [Criar uma definição de tarefa de nó único](create-job-definition.md).

Os trechos JSON de configuração de log a seguir têm um objeto `logConfiguration` especificado para cada trabalho. Uma é para um WordPress trabalho que envia registros para um grupo de registros chamado `awslogs-wordpress` e outra é para um contêiner MySQL que envia registros para um grupo de registros chamado. `awslogs-mysql` Ambos os contêineres usam o prefixo de fluxo de log `awslogs-example`.

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-wordpress",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-mysql",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

No AWS Batch console, a configuração de log para a definição do `wordpress` trabalho é especificada conforme mostrado na imagem a seguir. 

![\[Log configuration interface showing awslogs driver with group and stream prefix options.\]](http://docs.aws.amazon.com/pt_br/batch/latest/userguide/images/awslogs-console-config.png)


Depois de registrar uma definição de tarefa com o driver de `awslogs` registro em uma configuração de registro de definição de trabalho, você pode enviar um trabalho com essa definição de trabalho para começar a enviar CloudWatch registros para o Logs. Para obter mais informações, consulte [Tutorial: enviar um trabalho](submit_job.md).