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 Elastic Beanstalk com o Amazon CloudWatch Logs

Este tópico explica os recursos de monitoramento que o serviço Amazon CloudWatch Logs pode fornecer ao Elastic Beanstalk. Ele também orienta na configuração e lista os locais dos logs de cada plataforma do Elastic Beanstalk.

A implementação do CloudWatch Logs pode permitir que as seguintes atividades de monitoramento sejam realizadas:

O agente do CloudWatch Logs instalado em cada instância do Amazon EC2 no ambiente publica pontos de dados de métrica para o serviço CloudWatch para cada grupo de logs configurado. Cada grupo de logs aplica seus próprios padrões de filtro para determinar quais eventos de stream de log serão enviados ao CloudWatch como pontos de dados. Os streams de log que pertencem ao mesmo grupo de log compartilham as mesmas configurações de retenção, monitoramento e controle de acesso. É possível configurar o Elastic Beanstalk para fazer streaming automaticamente de logs para o serviço CloudWatch, conforme descrito em Fazer streaming de logs de instâncias para o CloudWatch Logs. Para obter mais informações sobre o CloudWatch Logs, incluindo terminologia e conceitos, consulte o Guia do usuário do Amazon CloudWatch Logs.

Além de logs da instância, se você habilitar a integridade avançada para seu ambiente, poderá configurar o ambiente para fazer streaming de informações de integridade para o CloudWatch Logs. Consulte Fazer streaming de informações de integridade do ambiente do Elastic Beanstalk para o Amazon CloudWatch Logs.

Pré-requisitos para streaming de logs de instância para o CloudWatch Logs

Para habilitar o streaming de logs de instâncias do Amazon EC2 do ambiente para o CloudWatch Logs, é necessário atender às condições a seguir.

Como o Elastic Beanstalk configura o CloudWatch Logs

O Elastic Beanstalk instala um agente de log do CloudWatch com as configurações padrão em cada instância criada. Saiba mais na Referência do agente do CloudWatch Logs.

Quando o streaming de log de instâncias é habilitado para o CloudWatch Logs, o Elastic Beanstalk envia arquivos de log das instâncias do seu ambiente para o CloudWatch Logs. Plataformas diferentes transmitem logs diferentes. A tabela a seguir lista os logs por plataforma.

O Elastic Beanstalk configura grupos de logs no CloudWatch Logs para os vários arquivos de log dos quais ele faz streaming. Para recuperar arquivos de log específicos do CloudWatch Logs, é necessário saber o nome do grupo de logs correspondente. O esquema de nomenclatura do grupo de logs depende do sistema operacional da plataforma.

Para plataformas Linux, prefixe o local do arquivo de log na instância com /aws/elasticbeanstalk/environment_name para obter o nome do grupo de logs. Por exemplo, para recuperar o arquivo /var/log/nginx/error.log, especifique o grupo de logs /aws/elasticbeanstalk/environment_name/var/log/nginx/error.log.

Para plataformas Windows, consulte a tabela a seguir referente ao grupo de logs correspondente a cada arquivo de log.

Fazer streaming de logs de instâncias para o CloudWatch Logs

É possível habilitar o streaming de logs de instâncias para o CloudWatch Logs usando o console do Elastic Beanstalk, a CLI do EB ou as opções de configuração.

Antes de habilitá-lo, configure as permissões do IAM a serem usadas com o agente do CloudWatch Logs. Você pode anexar a seguinte política personalizada ao perfil da instância atribuído a seu ambiente.

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

Streaming de logs de instâncias usando o console do Elastic Beanstalk

Depois de ativar o streaming de logs, você poderá voltar para a categoria ou a página de configuração Software para encontrar o link Log Groups (Grupos de logs). Clique nesse link para ver logs no console do CloudWatch.

Streaming de logs de instância usando a EB CLI

Para habilitar o streaming de logs de instância para o CloudWatch Logs usando a CLI do EB, use o comando eb logs.

$ eb logs --cloudwatch-logs enable

Você também pode usar eb logs para recuperar logs do CloudWatch Logs. Você pode recuperar todos os logs de instância do ambiente ou usar as várias opções do comando para especificar subconjuntos de logs que devem ser recuperados. Por exemplo, o comando a seguir recupera o conjunto completo de logs de instância para seu ambiente e salva todos eles em um diretório em .elasticbeanstalk/logs.

$ eb logs --all

Especificamente, a opção --log-group permite que você recupere logs da instância de um grupo de logs específico, correspondente a um arquivo de log específico na instância. Para fazer isso, você precisa saber o nome do grupo de logs que corresponde ao arquivo de log que você deseja recuperar. Você pode encontrar essas informações em Como o Elastic Beanstalk configura o CloudWatch Logs.

Streaming de logs de instância usando arquivos de configuração

Ao criar ou atualizar um ambiente, você pode usar um arquivo de configuração para definir e configurar o streaming de logs de instância para o CloudWatch Logs. O exemplo de arquivo de configuração a seguir ativa o streaming de logs de instância padrão. O Elastic Beanstalk faz streaming do conjunto padrão de arquivos de log para a plataforma do ambiente. Para usar o exemplo, copie o texto em um arquivo com a extensão .config no diretório .ebextensions, no nível superior do pacote de origem do aplicativo.

option_settings:
  - namespace: aws:elasticbeanstalk:cloudwatch:logs
    option_name: StreamLogs
    value: true

Streaming do arquivo de log personalizado

A integração do Elastic Beanstalk ao CloudWatch Logs não é diretamente compatível com o streaming de arquivos de log personalizados gerados pela aplicação. Para transmitir logs personalizados, use um arquivo de configuração para instalar diretamente o agente do CloudWatch e configurar os arquivos a serem enviados. Para obter um arquivo de configuração demonstrativo, consulte logs-streamtocloudwatch-linux.config.

Para obter mais informações sobre a configuração dos logs do CloudWatch, consulte a referência de arquivos de configuração do agente do CloudWatch, no Guia do Usuário do Amazon CloudWatch.

Solucionar problemas de integração do CloudWatch Logs

Se não conseguir encontrar alguns dos logs de instância do ambiente que você espera encontrar no CloudWatch Logs, investigue os problemas comuns a seguir: