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
<a name="environments-deployment-logs"></a>

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](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2.html) [e Amazon Linux 2023](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2023.html) lançadas em ou após 11 de março de 2026. Atualmente, não há suporte para plataformas Windows.

## Operações compatíveis
<a name="environments-deployment-logs.supported-operations"></a>

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
<a name="environments-deployment-logs.contents"></a>

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 install****pip 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ção**docker build**, como**go 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](using-features.logging.md).

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.log`incluindo `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](using-features.logging.md).

## Visualizando registros de implantação no console
<a name="environments-deployment-logs.console"></a>

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
<a name="environments-deployment-logs.console.history"></a>

**Para ver o histórico de implantação**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

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

1. 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
<a name="environments-deployment-logs.console.detail"></a>

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

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

1. 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
<a name="environments-deployment-logs.instance"></a>

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
<a name="environments-deployment-logs.disable"></a>

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