View a markdown version of this page

Visualização de registros de implantação para um ambiente do Elastic Beanstalk - AWS Elastic Beanstalk
Operações compatíveisConteúdo do logConsoleArquivos de log de instâncias

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

Visualização de registros de implantação para um ambiente do Elastic Beanstalk

O Elastic Beanstalk gera um log de implantação para cada implantação em seu ambiente. O registro de implantação fornece uma visão consolidada e cronológica do que aconteceu durante a implantação, incluindo a instalação da dependência, a saída da compilação, a inicialização do aplicativo e quaisquer erros encontrados. Você pode usar os registros de implantação para diagnosticar rapidamente falhas nas implantações sem precisar usar SSH nas instâncias ou correlacionar vários arquivos de log.

Os registros de implantação são gravados em cada instância localmente. Para implantações acionadas por meio do console, CLI, API ou atualizações gerenciadas, uma instância carrega continuamente seu log no Amazon S3 durante a implantação. O console do Elastic Beanstalk lê o log do Amazon S3, para que você possa monitorar o progresso sem se conectar à instância.

Os registros de implantação foram projetados para serem concisos. Em caso de sucesso, o registro mostra somente mensagens resumidas (por exemplo, quais comandos foram executados e concluídos). Em caso de falha, o registro inclui até 50 linhas de saída da etapa com falha, para que você possa ver o erro sem examinar a saída detalhada.

nota

Os registros de implantação estão disponíveis nas versões das plataformas Amazon Linux 2 e Amazon Linux 2023 lançadas em ou após 11 de março de 2026. Atualmente, não há suporte para plataformas Windows.

Operações compatíveis

Os registros de implantação são gerados para as seguintes operações:

  • Implantações de aplicativos — Implantação de uma nova versão do aplicativo em seu ambiente.

  • Atualizações de configuração — Alteração das configurações do ambiente que exigem atualizações de instância.

  • Criação de ambiente — A implantação inicial quando você cria um novo ambiente.

  • Reinicie o servidor do aplicativo — Reinicie o servidor do aplicativo em suas instâncias.

As operações que não modificam o estado do aplicativo ou da configuração nas instâncias, como solicitação de registros, troca ou atualização de tags CNAMEs, não geram registros de implantação.

Conteúdo do log de implantação

Um registro de implantação captura as seguintes informações durante uma implantação:

  • Ciclo de vida da implantação — mensagens de início e conclusão para cada fase de implantação, como e. Starting Application deployment Completed Application deployment

  • Saída.ebextensions — Em caso de sucesso, os nomes dos comandos executados. Em caso de falha, as últimas 50 linhas de cfn-init saída para ajudar a diagnosticar o problema.

  • Saída de ganchos de plataforma — Em caso de sucesso, os nomes dos scripts de ganchos executados. Em caso de falha, as últimas 50 linhas de saída do gancho.

  • Instalação de dependência — Saída de gerenciadores de pacotes como npm installpip install,composer install, e. bundle install Em caso de sucesso, somente uma mensagem de conclusão é registrada. Em caso de falha, as últimas 50 linhas de saída são incluídas.

  • Saída de compilação — Saída de comandos de compilaçãodocker build, comogo build, e compilações Java. Em caso de falha, as últimas 50 linhas de saída são incluídas.

  • Saída de inicialização do aplicativo — Saída inicial do seu aplicativo após sua inicialização. A fonte depende da sua plataforma:

    • Docker — registros de contêineres de ou docker logs docker compose logs

    • Java SE, Go, Node.js, Python, Ruby, .NET — registros de stdout de processos

    • Tomcat — Saída de log Catalina

    • PHP — registros de erros do master e do pool do PHP-FPM

    • ECS — registros de contêiner de cada contêiner de tarefas

    nota

    A saída do aplicativo é capturada a partir de 2 segundos após o início do aplicativo. Somente as mensagens iniciais de inicialização são incluídas — se seu aplicativo demorar mais para produzir a saída, ele não aparecerá no registro de implantação. Para ver os registros completos do aplicativo, solicite os registros do pacote ou conecte-se diretamente à instância. Para obter mais informações, consulte Visualizar logs da instância.

Quando uma etapa de implantação falha, o registro a marca com [ERROR] e inclui até 50 linhas de saída da etapa com falha. Se o registro de implantação não contiver detalhes suficientes, você poderá recuperar os registros completos da instância (eb-engine.logincluindo eb-hooks.log registros de aplicativos e) na guia Registros. Para obter mais informações, consulte Visualizar logs de instâncias do Amazon EC2 no ambiente do Elastic Beanstalk.

Visualizando registros de implantação no console

O console do Elastic Beanstalk fornece uma guia Implantações no painel do ambiente, onde você pode visualizar seu histórico e registros de implantação.

Visualizando o histórico de implantação

Para ver o histórico de implantação

  1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione sua. Região da AWS

  2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

  3. No painel do ambiente, escolha a guia Implantações.

    A guia Implantações mostra uma tabela de implantações para o ambiente. Cada linha inclui as seguintes informações:

    • ID da solicitação — O identificador exclusivo da implantação.

    • Status — Bem-sucedido, falhado ou em andamento.

    • Tipo — O tipo de implantação, como criação de ambiente, implantação de aplicativo, atualização de configuração, atualização de plataforma gerenciada, reinicialização do servidor de aplicativos, ambiente de reconstrução, ambiente de restauração, domínio do ambiente de troca ou ambiente de encerramento.

    • Hora de início — Quando a implantação começou.

    • Duração — Quanto tempo a implantação levou para ser concluída.

Quando uma implantação está em andamento, a guia pesquisa automaticamente as atualizações. Você também pode escolher o botão de atualização para recarregar manualmente a lista.

Visualizando detalhes e registros de implantação

Para ver os detalhes da implantação

  1. Na guia Implantações, escolha o link ID da solicitação para a implantação que você deseja inspecionar.

  2. A página de detalhes da implantação mostra uma seção resumida com o ID da solicitação, o status, o tipo de implantação, a hora de início, a duração e a política de implantação. A política de implantação (por exemplo, All at once, Rolling, Rolling with additional batch, Imutable ou Traffic splitting) é exibida quando pode ser determinada a partir dos eventos de implantação.

  3. Abaixo do resumo, escolha uma das seguintes guias:

    • Eventos — Uma linha do tempo de eventos relacionados a essa implantação, filtrada para mostrar somente os eventos da implantação selecionada.

    • Registros de implantação — O registro consolidado de implantação da instância. Você pode pesquisar, filtrar por nível de log e baixar o arquivo de log.

Para implantações em andamento, a guia de registros é atualizada automaticamente para mostrar novas entradas de registro à medida que elas são gravadas. Após a conclusão da implantação, o console busca o estado final do log para garantir que você veja a saída completa.

Importante

A visualização dos registros de implantação no console requer s3:GetObject permissão no bucket de armazenamento Amazon S3 do ambiente ()elasticbeanstalk-region-account-id. Se sua política do IAM não incluir essa permissão, o histórico de implantação e os eventos ainda estarão disponíveis, mas a guia de registros mostrará um erro.

Arquivos de log de implantação em instâncias

Os registros de implantação são gravados no /var/log/deployments/ diretório de cada instância. O nome do arquivo de log depende de como a implantação foi acionada:

  • Implantações controladas por fluxo de trabalho (acionadas por meio do console, CLI ou API) —eb-deployment-request-id.log, onde request-id está o ID exclusivo da solicitação de implantação.

  • Implantações de inicialização automática (inicialização da instância ou reinicialização do servidor do aplicativo) —. eb-deployment-unix-timestamp.log

O Elastic Beanstalk faz a rotação automática desses arquivos, mantendo os 50 registros de implantação mais recentes em cada instância.

Para implantações controladas por fluxo de trabalho, o log é carregado no Amazon S3 no seguinte caminho:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

Em ambientes de várias instâncias, a primeira instância a começar o upload reivindica a função de toda a implantação. Essa instância carrega seu log no Amazon S3 durante a implantação. Todas as instâncias ainda gravam registros de implantação localmente.

Importante

O upload de registros de implantação para o Amazon S3 s3:PutObject requer permissão no bucket de armazenamento Amazon S3 do ambiente no perfil da instância, e a configuração da VPC deve permitir a conectividade com o Amazon S3.

Os uploads de registros de implantação são limitados a 1 MB por arquivo. Se um registro de implantação exceder esse tamanho, a versão carregada será truncada com uma mensagem indicando que o registro completo está disponível na instância.

Desativando os uploads de registros do S3

Para evitar que os registros de implantação sejam enviados para o Amazon S3, defina a seguinte propriedade de ambiente em seu ambiente:

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  EB_DEPLOYMENT_LOG_S3_DISABLED
    value:  true

Quando essa propriedade de ambiente é definida, os registros de implantação ainda são gravados localmente /var/log/deployments/ em cada instância, mas não são enviados para o Amazon S3 e não estarão disponíveis na guia Implantações do console. Você também pode definir essa propriedade na página Configuração, em Software, ou usando a CLI do EB ou. AWS CLI