# Monitoramento da integridade da instância de contêiner do Amazon ECS
<a name="container-instance-health"></a>

O Amazon ECS fornece monitoramento de integridade de instâncias de contêiner. É possível determinar rapidamente se o Amazon ECS detectou problemas que possam impedir que suas instâncias de contêiner executem contêineres. O Amazon ECS realiza verificações automatizadas em todas as instâncias de contêiner em execução com a versão do agente `1.57.0` ou posterior para identificar problemas. Para obter mais informações sobre como verificar a versão do agente de uma instância de contêiner, consulte [Atualizar o agente de contêiner do Amazon ECS](ecs-agent-update.md).

Você deve estar usando a AWS CLI versão `1.22.3` ou posterior ou a AWS CLI versão `2.3.6` ou posterior. Para obter informações sobre como atualizar a AWS CLI, consulte [Instalação ou atualização da versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface versão 2*.

Para visualizar a integridade da instância do contêiner, execute `describe-container-instances` com a opção `CONTAINER_INSTANCE_HEALTH`. 

O `overallStatus` é determinado pelos status de verificação de integridade individuais na matriz `details`. O status mais grave tem precedência, nesta ordem: `IMPAIRED`, `INSUFFICIENT_DATA`, `INITIALIZING` e `OK`.

Estes são os valores válidos para `overallStatus`:
+ `OK`: todas as verificações de integridade estão sendo aprovadas.
+ `IMPAIRED`: uma ou mais verificações de integridade falharam.
+ `INSUFFICIENT_DATA`: uma ou mais verificações de integridade estão indisponíveis.
+ `INITIALIZING`: uma ou mais verificações de integridade estão sendo inicializadas.

Veja a seguir um exemplo de como executar `describe-container-instances`.

```
aws ecs describe-container-instances \
     --cluster cluster_name \
     --container-instances 47279cd2cadb41cbaef2dcEXAMPLE \
     --include CONTAINER_INSTANCE_HEALTH
```

Veja a seguir um exemplo do objeto de status de integridade na saída.

```
"healthStatus": {
	"overallStatus": "OK",
	"details": [{
		"type": "CONTAINER_RUNTIME",
		"status": "OK",
		"lastUpdated": "2021-11-10T03:30:26+00:00",
		"lastStatusChange": "2021-11-10T03:26:41+00:00"
	}]
}
```

## Problemas de integridade de instâncias de contêiner
<a name="container-instance-health-action"></a>

Quando o `overallStatus` tiver qualquer status diferente de `OK`, tente o seguinte:
+ Aguarde e execute `describe-container-instances`
+ Visualize a integridade da sua instância de contêiner no console do EC2 ou usando a CLI.
+ Analise as métricas do CloudWatch. Para obter mais informações, consulte . [Monitoramento do Amazon ECS usando o CloudWatch](cloudwatch-metrics.md)
+ Verifique em AWS Health Dashboard se há algum problema com o serviço.