# Captura de eventos do Amazon ECS no console
<a name="task-lifecycle-events"></a>

O console do Amazon ECS fornece a funcionalidade de captura de eventos que armazena eventos gerados pelo Amazon ECS, como ações de serviço e alterações de estado de tarefas, no Amazon CloudWatch Logs por meio do EventBridge. Esse recurso inclui uma interface de consulta com capacidade de filtragem para monitoramento e solução de problemas.

Os eventos fornecem informações detalhadas sobre como suas implantações de serviços, serviços, tarefas e instâncias operam. Você pode usar essas informações para solucionar problemas de falhas na implantação de tarefas ou serviços.

Ao ativar a captura de eventos, você tem acesso a todos os eventos que o Amazon ECS gera por um período de retenção de sua escolha, estendendo-se além das limitações nativas dos últimos 100 eventos não filtrados ou tarefas interrompidas visíveis por apenas uma hora.

## Como funciona
<a name="task-lifecycle-events-overview"></a>

A captura de eventos usa o EventBridge para armazenar eventos em um grupo de logs predefinido do Amazon CloudWatch Logs. O console do Amazon ECS fornece consultas pré-criadas e opções de filtragem, além de correlacionar eventos para fornecer ciclos de vida de tarefas em um formato intuitivo.

Você pode consultar e recuperar os seguintes tipos de eventos:
+ **Eventos de ação de serviço**: ajudam a identificar problemas de provisionamento ou alocação de recursos
+ **Eventos de ciclo de vida da tarefa**: ajude a identificar por que tarefas ou contêineres falham na inicialização ou param de ser executados

O console do Amazon ECS permite que você configure a captura de eventos com um clique e fornece consultas e filtragens comumente usadas sem exigir que você aprenda linguagens de consulta ou navegue entre vários consoles.

## Tipos de eventos
<a name="task-lifecycle-events-types"></a>

A captura de eventos armazena todos os eventos gerados pelo Amazon ECS nas seguintes categorias:

Eventos de alteração no estado da tarefa  
Paradas de contêineres e outros eventos de encerramento, que você pode usar para solucionar problemas ou monitorar os cronogramas do ciclo de vida das tarefas.

Ações de serviço  
Eventos como atingir um estado estável, falha no posicionamento de tarefas ou restrições de recursos.

Alterações de estados da implantação de serviços  
Eventos como implantações em andamento, concluídas ou com falha acionados por configurações de disjuntor e reversão, para monitorar o estado de uma implantação de serviço.

Alterações do estado da instância de contêiner  
Para workloads em instâncias gerenciadas do Amazon ECS e EC2, os eventos mostram o status conectado e desconectado.

## Configuração do grupo de logs
<a name="task-lifecycle-events-log-group"></a>

Quando você ativa a captura de eventos, o Amazon ECS cria automaticamente os seguintes recursos:
+ Um grupo de logs do Amazon CloudWatch Logs chamado `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Uma regra do EventBridge que ingere todos os eventos da origem `aws.ecs` e os encaminha para o grupo de logs

Você pode especificar um período de retenção para o grupo de logs de um dia a dez anos. O período de retenção padrão é 7 dias.

## Considerações
<a name="task-lifecycle-events-limitations"></a>

Considere o seguinte ao usar a captura de eventos:
+ A captura de eventos armazena todos os eventos para simplificar. Você não pode configurar regras no console do Amazon ECS para capturar somente eventos específicos.
+ O console do Amazon ECS fornece critérios de consulta predefinidos. Para consultas avançadas, use os insights de logs do Amazon CloudWatch Logs para consultar diretamente o grupo de logs.
+ A funcionalidade Live Tail não está disponível no console do Amazon ECS. Use o Amazon CloudWatch Logs diretamente para live tail.
+ Quando você desabilita a captura de eventos, a regra do EventBridge é excluída.
+ A captura de eventos gera custos adicionais para a ingestão de dados do EventBridge, armazenamento do Amazon CloudWatch Logs e execução de consultas.

  Para obter informações sobre preços do EventBridge, consulte [Preços do Amazon EventBridge](https://aws.amazon.com/eventbridge/pricing/).

  Para obter informações sobre preços do CloudWatch, consulte [Preços do CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).

## Solução de problemas baseada em eventos
<a name="task-lifecycle-events-troubleshooting"></a>

Use eventos gerados pelo Amazon ECS para responder perguntas comuns de solução de problemas.

### Análise de falha na tarefa
<a name="task-lifecycle-events-task-failures"></a>

Você pode analisar os eventos de alteração de estado da tarefa `STOPPED`, os códigos de parada e os códigos de saída do contêiner para determinar por que uma tarefa falhou ao ser iniciada ou falhou durante a execução.

Você pode analisar os eventos de ação de serviço em busca de falhas de posicionamento e informações sobre restrições de recursos para determinar por que uma tarefa falhou ao ser posicionada por causa de restrições de recursos.

### Cenários comuns de falha de tarefa
<a name="task-lifecycle-events-common-issues"></a>

As falhas anormais mais comuns de tarefas estão relacionadas às seguintes questões:
+ Falhas na implantação do serviço CI/CD
+ Falhas no ajuste de escala automático
+ Falhas no rebalanceamento de tarefas
+ Saídas anormais de contêineres, como erros de falta de memória (OOM)

Falhas anormais de tarefas produzem eventos de mudança de estado da tarefa `STOPPED` com um código de parada `EssentialContainerExited` ou `TaskFailedToStart`. Você pode filtrar por esses códigos de parada para examinar os comportamentos de execução e parada de contêineres.

# Ativar a captura de eventos para um cluster existente do Amazon ECS
<a name="turn-on-event-capture-existing-cluster"></a>

Você pode habilitar a captura de eventos em um cluster do Amazon ECS existente para armazenar eventos gerados pelo Amazon ECS no Amazon CloudWatch Logs por meio do EventBridge. Esse recurso ajuda você a monitorar e solucionar problemas de falhas de tarefas, implantações de serviços e outras atividades de cluster.

Quando você habilita a captura de eventos, o Amazon ECS cria os seguintes recursos:
+ Um grupo de logs do Amazon CloudWatch Logs chamado `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Uma regra do EventBridge que captura todos os eventos da origem `aws.ecs`

Uma guia **Histórico** é exibida na visualização do cluster, permitindo que você consulte eventos de ciclo de vida da tarefa e ações de serviço. A captura de eventos começa imediatamente e armazena todos os eventos gerados pelo Amazon ECS de acordo com o período de retenção especificado.

## Pré-requisitos
<a name="turn-on-event-capture-prerequisites"></a>
+ Um cluster existente do Amazon ECS.
+ Permissões apropriadas do IAM para modificar as configurações do cluster e criar recursos do Amazon CloudWatch Logs

## Ativar a captura de eventos usando o console
<a name="turn-on-event-capture-procedure"></a>

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. No painel de navegação, escolha **Clusters**.

1. Selecione o cluster no qual você deseja habilitar a captura de eventos.

   A página de detalhes do cluster é exibida.

1. Escolher **configuração**.

1. Na seção **Eventos do ECS**, escolha **Ativar captura de eventos**.

   A caixa de diálogo **Ativar captura de eventos** é exibida.

1. Em **Expirar evento**, escolha o período de retenção para o grupo de logs do Amazon CloudWatch Logs. O padrão são 7 dias.

1. Selecione **Ativar**.

# Visualizar eventos de mudança de estado de serviços e tarefas do Amazon ECS
<a name="viewing-state-events"></a>

O console do Amazon ECS fornece a funcionalidade de captura de eventos que armazena eventos gerados pelo Amazon ECS, como ações de serviço e alterações de estado de tarefas, no Amazon CloudWatch Logs por meio do EventBridge. Esse recurso inclui uma interface de consulta com capacidade de filtragem para aprimorar o monitoramento e a solução de problemas.

Os eventos fornecem informações detalhadas sobre como suas implantações de serviços, serviços, tarefas e instâncias operam. Você pode usar essas informações para solucionar problemas de falhas na implantação de tarefas ou serviços.

Você pode usar qualquer um dos critérios a seguir para filtrar os eventos:
+  ID de implantação (disponível somente na página de detalhes do serviço) 
+ Hora de início
+ End Time 
+ Nome do serviço (aplicável somente na página de detalhes do cluster, na página de detalhes do serviço, esse será o padrão do serviço atual) 
+ ID da tarefa 
+ Último status da tarefa 
+ Família de definições de tarefa 
+ Revisão da definição de tarefa 

## Visualizar eventos no nível do cluster
<a name="view-cluster-procedure"></a>

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Escolha **Clusters**.

   A página da lista de clusters é exibida.

1. Escolha o cluster .

   A página de detalhes do cluster é exibida.

1. Em **Histórico**, determine os eventos a serem visualizados.

   1. Para visualizar eventos de ação de serviço, escolha **Eventos de ação de serviço**.

   1. Para visualizar eventos de mudança de estado da tarefa, escolha **Eventos de mudança de estado da tarefa**.

   1. (Opcional) Em **Critérios de consulta**, insira os filtros para os eventos que você deseja visualizar.

1. Selecione **Executar consulta**.

   Os eventos são exibidos em uma lista.

1. Para ver os detalhes completos do evento, escolha o evento.

## Visualizar no nível do serviço
<a name="tasks-procedure"></a>

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Na página **Clusters**, escolha o cluster.

1. Na página de detalhes do cluster, na seção **Serviços**, escolha o serviço.

   A página de detalhes do serviço é exibida.

1. Em **Histórico**, determine os eventos a serem visualizados.

   1. Para visualizar eventos de ação de serviço, escolha **Eventos de ação de serviço**.

   1. Para visualizar eventos de mudança de estado da tarefa, escolha **Eventos de mudança de estado da tarefa**.

   1. (Opcional) Em **Critérios de consulta**, insira os filtros para os eventos que você deseja visualizar.

1. Selecione **Executar consulta**.

   Os eventos são exibidos em uma lista.

1. Para ver os detalhes completos do evento, escolha o evento.