# Visualizar erros de tarefa interrompida do Amazon ECS
<a name="stopped-task-errors"></a>

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.

 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. É possível visualizar os eventos no Console de gerenciamento da AWS, 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.

Caso a tarefa tenha sido executada em uma instância de contêiner no Amazon EC2 ou em computadores externos, você também pode verificar os logs do runtime do contêiner e do agente do Amazon ECS. Esses logs estão na instância do Amazon EC2 do host ou no computador externo. Para obter mais informações, consulte [Visualização de logs do agente de contêiner do Amazon ECS](logs.md).

## Procedimento
<a name="view-stopped-errors-procedure"></a>

------
#### [ Console ]

**Console de gerenciamento da AWS**

As etapas a seguir podem ser usadas para verificar se há erros nas tarefas interrompidas usando o console. Para visualizar tarefas interrompidas, é necessário alterar a opção de filtro.

As tarefas interrompidas só aparecem no console por 1 hora.

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. Na página **Clusters**, escolha o cluster.

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

1. Configure o filtro para exibir tarefas interrompidas. Em **Filtrar status desejado**, escolha **Interrompido**.

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

1. Escolha a tarefa interrompida para inspecionar.

1. Na linha das suas tarefas interrompidas, na coluna **Último status**, escolha **Interrompida**.

   Uma janela pop-up exibe o motivo da interrupção.

------
#### [ 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 region
   ```

1. Descreva a tarefa interrompida para recuperar as informações. Para obter mais informações, consulte [describe-tasks](https://docs.aws.amazon.com/cli/latest/reference/ecs/describe-tasks.html) na* AWS Command Line Interface Reference*.

   ```
   aws ecs describe-tasks \
        --cluster cluster_name \
        --tasks arn:aws:ecs:region:account_id:task/cluster_name/task_ID \
        --region region
   ```

Use os seguintes parâmetros de saída.
+ `stopCode`: o código de interrupção indica por que uma tarefa foi interrompida, por exemplo ResourceInitializationError
+ `StoppedReason`: o motivo pelo qual a tarefa foi interrompida.
+ `reason` (na estrutura de `containers`): o motivo fornece detalhes adicionais sobre o contêiner interrompido.

------

## Próximas etapas
<a name="additional-resources"></a>

Visualize as tarefas interrompidas para obter informações sobre a causa da interrupção. Para obter mais informações, consulte [Mensagens de erro de tarefa interrompida do Amazon ECS](stopped-task-error-codes.md).