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á.
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 logs capturados mostram a saída do comando que você normalmente vê em um terminal interativo, se executasse o contêiner localmente, que são os fluxos de E/S STDOUT e STDERR. 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
Para enviar registros do sistema de suas instâncias de contêiner para o CloudWatch Logs, consulteUsando CloudWatch registros com AWS Batch. Para obter mais informações sobre CloudWatch registros, consulte Monitoramento de arquivos de log e cotas de CloudWatch registros no Guia do usuário do Amazon CloudWatch Logs.
opções do driver de log awslogs no tipo de AWS Batch JobDefiniton dados
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
awslogs-region-
Obrigatório: não
Especifique a região para a qual o driver de log
awslogsdeve 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 logawslogsenvia seus fluxos de logs. Se esse campo não for especificado, será usadoaws/batch/job. awslogs-stream-prefix-
Obrigatório: opcional
Com a
awslogs-stream-prefixopçã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
strftimeem 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
. Essa opção sempre terá precedência se os
awslogs-datetime-formateawslogs-multiline-patternestiverem configurados.nota
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
a documentação do Docker. Essa opção será ignorada se
awslogs-datetime-formattambém estiver configurado.nota
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.Atenção
Essa opção não é recomendada. Recomendamos que você crie o grupo de CloudWatch registros com antecedência usando a ação da CreateLogGroupAPI Logs, pois cada trabalho tenta criar o grupo de registros, aumentando a chance de falha do trabalho.
nota
A política do IAM para seu perfil de execução deve incluir a permissão
logs:CreateLogGroupantes que você tente usarawslogs-create-group.
Especificar uma configuração de log na definição de trabalho
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 .
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.
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.
