Como verificar tarefas interrompidas em busca de erros

Se você tiver problemas ao iniciar uma tarefa, sua tarefa poderá ser interrompida devido a erros na aplicação ou na configuração. Por exemplo, você executa a tarefa, ela exibe um status PENDING e, em seguida, desaparece. Você pode visualizar erros de interrupção de tarefas como esse no console do Amazon ECS visualizando a tarefa interrompida e a inspecionando em busca de mensagens de erro.

Se sua definição de tarefa usar o driver de awslogs log, os logs do aplicativo gravados no Amazon CloudWatch Logs serão exibidos na guia Logs no console do Amazon ECS, desde que a tarefa interrompida apareça.

Se sua tarefa tiver sido criada por um serviço do Amazon ECS, as ações que o Amazon ECS executará para manter o serviço serão publicadas nos eventos do serviço. Você pode visualizar os eventos no AWS Management Console, na AWS CLI, em AWS SDKs, na API do Amazon ECS ou nas ferramentas que usam os SDKs e a API. Esses eventos incluem a interrupção e a substituição de uma tarefa pelo Amazon ECS porque os contêineres da tarefa interromperam a execução ou apresentaram falha em muitas verificações de integridade do Elastic Load Balancing. Para obter mais informações, consulte Mensagens de evento de serviço.

Importante

As tarefas interrompidas só serão exibidas no console do Amazon ECS, na AWS CLI e nos SDKs da AWS por pelo menos uma hora após a interrupção da tarefa. Depois disso, os detalhes da tarefa interrompida expiram e não ficam disponíveis no Amazon ECS.

O Amazon ECS também envia eventos de alteração do estado da tarefa para a Amazon EventBridge. Você não pode ver eventos em EventBridge. Em vez disso, você cria regras para enviar os eventos para outro armazenamento persistente, como o Amazon CloudWatch Logs. Você pode usar o armazenamento para visualizar os detalhes da tarefa interrompida depois que a visualização dela expirar no console do Amazon ECS. Para obter mais informações, consulte Eventos de alteração no estado da tarefa.

Para obter um exemplo de EventBridge configuração para arquivar eventos do Amazon ECS no Amazon CloudWatch Logs, consulte ECS Stopped Tasks in CloudWatch Logs no GitHub site.

Siga estas etapas para verificar se há erros em tarefas interrompidas.

Console

AWS Management Console

As etapas a seguir podem ser usadas para verificar se há erros nas tarefas interrompidas usando o novo AWS Management Console.

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. No painel de navegação, escolha Clusters.

3. Na página Clusters, escolha o cluster.

4. Na página Cluster : name, escolha a guia Tasks (Tarefas).

5. Configure o filtro para exibir tarefas interrompidas. Em Filtrar o status desejado, escolha Parado ou Qualquer status desejado.

   A opção Parado exibe suas tarefas interrompidas e Qualquer status desejado exibe todas as suas tarefas.

6. Escolha a tarefa interrompida para inspecionar.

7. Na linha da tarefa interrompida, na coluna Último status, escolha Parada.

   Uma janela pop-up exibe o motivo da parada.

AWS CLI

1. Liste as tarefas interrompidas no cluster. A saída contém o nome do recurso da Amazon (ARN) da tarefa, necessário para a descrição da tarefa.

   aws ecs list-tasks \
        --cluster cluster_name \
        --desired-status STOPPED \
        --region us-west-2

2. Descreva a tarefa interrompida para recuperar o stoppedReason na resposta.

   aws ecs describe-tasks \
        --cluster cluster_name \
        --tasks arn:aws:ecs:us-west-2:account_id:task/cluster_name/task_ID \
        --region us-west-2

Recursos adicionais

As páginas a seguir fornecem informações adicionais sobre códigos de erro:

• Por que minha tarefa do Amazon ECS foi interrompida?

• Códigos de erro de tarefas interrompidas