View a markdown version of this page

Visualizando registros de implantação em um ambiente Elastic Beanstalk - AWS Elastic Beanstalk
Operações compatíveisConteúdo do logConsoleLocais de log

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

Visualizando registros de implantação em um ambiente 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 do que aconteceu durante uma implantação, para que você possa diagnosticar uma falha sem coletar vários registros sozinho. O que o log contém e quando ele se torna disponível depende se o ambiente é um ambiente Beanstalk Standard ou um ambiente Beanstalk Cluster.

Com o Beanstalk Standard, 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 para o 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 padrão são 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 que falhou, para que você possa ver o erro sem examinar a saída detalhada.

Com o Beanstalk Cluster, o Elastic Beanstalk coleta o log de implantação após a conclusão da operação. Ele reúne os registros de contêiner de cada pod no ambiente, junto com os eventos do Kubernetes para o namespace do ambiente, e os carrega como um único arquivo zip no bucket de armazenamento Amazon S3 do seu ambiente. O console do Elastic Beanstalk lê o arquivo zip do Amazon S3 e exibe seu conteúdo, para que você possa lê-lo sem se conectar ao seu cluster. A disponibilidade não depende da versão da plataforma, e o Elastic Beanstalk não grava um arquivo de log de implantação em seus nós.

nota

Para ambientes Beanstalk Standard, os registros de implantação estão disponíveis nas versões da plataforma Amazon Linux 2 e Amazon Linux 2023 lançadas em ou após 11 de março de 2026 e nas versões da plataforma Windows lançadas em ou após 22 de abril de 2026.

Operações compatíveis

Para ambientes Beanstalk Standard, os registros de implantação são gerados para as seguintes operações:

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

  • Atualizações de configuração — alterando as configurações do ambiente que são aplicadas às instâncias existentes e as atualizações que adicionam novas instâncias ao ambiente.

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

  • Reinicie o servidor de aplicativos — Reiniciando o servidor de aplicativos em suas instâncias.

  • Atualizações gerenciadas da plataforma — Atualizações de plataforma que o Elastic Beanstalk aplica automaticamente durante uma janela de manutenção programada.

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

Para ambientes Beanstalk Cluster, os registros de implantação são gerados para criação de ambientes, implantações de aplicativos, atualizações de configuração, reinicialização do servidor de aplicativos e encerramento do ambiente. O encerramento de um ambiente produz um registro de implantação, o que não acontece com o Beanstalk Standard. As atualizações gerenciadas da plataforma não se aplicam, porque um ambiente Beanstalk Cluster executa imagens de contêiner em vez de uma versão da plataforma.

O Elastic Beanstalk coleta o log de implantação de um ambiente Beanstalk Cluster após a etapa de implantação. Se uma operação falhar antes dessa etapa, por exemplo, ao criar a imagem do contêiner, criar o cluster, provisionar recursos ou gerar a especificação do Kubernetes, não haverá registro de implantação e os eventos do ambiente descreverão o que aconteceu. Para obter mais informações, consulte Visualizar o stream de eventos de um ambiente do Elastic Beanstalk.

Conteúdo do registro de implantação

Para ambientes Beanstalk Standard, 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 da plataforma — Em caso de sucesso, os nomes dos scripts de gancho 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 seu início. A fonte depende da sua plataforma:

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

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

    • Tomcat — Saída de registro Catalina

    • PHP — registros de erros PHP-FPM principais e de pool

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

    nota

    A saída do aplicativo é capturada 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 log 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 que falhou. Se o registro de implantação não contiver detalhes suficientes, você poderá recuperar os registros completos da instância (incluindo eb-engine.logeb-hooks.log, e registros do aplicativo) na guia Registros. Para obter mais informações, consulte Visualizar logs de instâncias do Amazon EC2 no ambiente do Elastic Beanstalk.

Conteúdo do log de implantação para ambientes Beanstalk Cluster

Para um ambiente Beanstalk Cluster, o log de implantação é um arquivo zip. Ele contém um arquivo de eventos em todo o ambiente e um arquivo por pod, em um diretório: 1-environment/

1-environment/
  _k8Events.txt
  pod-name.txt

_k8Events.txtmantém os eventos do Kubernetes no namespace do ambiente que não estão vinculados a um único pod, como eventos de agendamento, volume, escalabilidade e balanceador de carga. O sublinhado principal o classifica primeiro.

Cada um pod-name.txt começa com um =====EVENTS===== bloco contendo os eventos desse pod, o mais antigo primeiro, seguido por um =====LOGS===== bloco contendo os registros de cada contêiner no pod. Os contêineres de inicialização aparecem como seus próprios blocos de contêiner; portanto, quando um contêiner de inicialização falha, um registro vazio do contêiner do aplicativo é esperado em vez de um segundo problema.

Para um contêiner que está sendo reiniciado, o =====EVENTS===== bloco desse pod nomeia o motivo (por exemplo,BackOff) e o =====LOGS===== bloco mantém o registro do contêiner no momento da coleta. O registro de uma instância anterior do contêiner não está incluído.

O registro de cada contêiner é limitado a 5 MiB, sem limite de linha. Um tronco que atinge a tampa é marcado como truncado. Além desse limite, nada é removido do registro, independentemente de a operação ser bem-sucedida ou falhar. Se o Elastic Beanstalk não conseguir ler os logs de um contêiner, a coleta continuará e o bloco desse contêiner registrará o erro.

A instalação de dependência e a saída de compilação não estão no registro de implantação de um ambiente Beanstalk Cluster. Isso acontece quando o Elastic Beanstalk cria sua imagem de contêiner. Para obter mais informações, consulte Criação de imagens de contêiner para ambientes Beanstalk Cluster.

Visualizando registros de implantação no console

O console do Elastic Beanstalk fornece uma guia Implantações no painel do ambiente, na qual você pode visualizar seu histórico e registros de implantação. O histórico mostra as implantações dos últimos 42 dias (6 semanas).

Visualizando o histórico de implantação

Para visualizar o histórico de implantação

  1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. 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, reconstrução do ambiente, restauração do ambiente, troca de domínio do ambiente ou encerramento do ambiente.

    • Política — A política de implantação, como Tudo de uma vez, Rolling, Rolling with additional batch, Immutable ou Traffic splitting.

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

    • Duração — Quanto tempo a implantação demorou 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 Atualizar para recarregar manualmente a lista.

Visualizando detalhes e registros da implantação

Para ver os detalhes da implantação

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

  2. A página de detalhes da implantação mostra uma seção resumida com a ID da solicitação, status, tipo de implantação, hora de início, duração e política de implantação. A política de implantação (por exemplo, All at once , Rolling with additional batch, Immutable 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 registro e baixar o arquivo de registro.

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

Para um ambiente Beanstalk Cluster, o registro de implantação aparece após a conclusão da operação, portanto, a guia de registros não é atualizada enquanto a operação é executada. O arquivo de eventos em todo o ambiente é exibido primeiro, seguido pelos arquivos por pod. Se o arquivo zip compactado for maior que 5 MiB, o console solicitará que você o baixe do Amazon S3 em vez de exibi-lo. Esse limite se aplica ao arquivo como um todo, não ao registro de um único contêiner.

Importante

A visualização dos registros de implantação no console exige 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.

Onde os registros de implantação são armazenados

Arquivos de log de implantação em instâncias do Beanstalk Standard

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:

  • Workflow-controlled implantações (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.

  • Self-startup implantações (lançamento da instância) —eb-deployment-timestamp-instance-id.log, onde timestamp está no formato UTC (por exemplo20260317T151315Z) e instance-id é o ID da instância do Amazon EC2.

O Elastic Beanstalk gira automaticamente esses arquivos, mantendo os 50 registros de implantação mais recentes em cada instância.

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

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

Para implantações de inicialização automática, o log é enviado para o Amazon S3 em um subdiretório: selfstartup/

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

Para implantações controladas por fluxo de trabalho, a primeira instância a começar a carregar reivindica a função para toda a implantação. Essa instância carrega seu log para o Amazon S3 durante a implantação. Para implantações de inicialização automática, cada instância carrega seu próprio log de forma independente. Todas as instâncias ainda gravam registros de implantação localmente.

Importante

O upload dos registros de implantação para o Amazon S3 exige s3:PutObject 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 do log 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 log do S3

Para ambientes Beanstalk Standard, 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 o EB CLI ou AWS CLI.

A EB_DEPLOYMENT_LOG_S3_DISABLED propriedade é lida em suas instâncias, portanto, não tem efeito em um ambiente de cluster Beanstalk. Atualmente, não há como impedir que o Elastic Beanstalk faça o upload do log de implantação de um ambiente Beanstalk Cluster.

Arquivos de log de implantação para ambientes Beanstalk Cluster

Para um ambiente Beanstalk Cluster, o Elastic Beanstalk carrega o log de implantação para o bucket de armazenamento Amazon S3 do seu ambiente no seguinte caminho:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/deployment-environment-name-request-id.zip

O Elastic Beanstalk realiza o upload sozinho, usando a função de operação do ambiente, portanto, nenhuma permissão de perfil de instância está envolvida e nada precisa chegar ao Amazon S3 a partir de seus nós.

O upload é o melhor esforço. Se não for bem-sucedida, a operação ainda será concluída, nenhum evento de ambiente será gerado e o console informará o log de implantação como indisponível.