# Amazon ECS コンテナインスタンスの正常性をモニタリングする
<a name="container-instance-health"></a>

Amazon ECS は、コンテナインスタンスのヘルスモニタリングを提供します。Amazon ECS が、コンテナインスタンスがコンテナの実行を妨げる可能性のある問題を検出したか否かについて、すばやく判断できます。Amazon ECS は、エージェントバージョン `1.57.0` 以降を使用して実行中のすべてのコンテナインスタンスに対して自動チェックを実行し、問題を特定します。コンテナインスタンスのエージェントバージョンの検証に関する詳細については、[Amazon ECS コンテナエージェントをアップデートする](ecs-agent-update.md) を参照してください。

AWS CLI バージョン `1.22.3` 以降、または AWS CLI バージョン `2.3.6` 以降を使用する必要があります。AWS CLI をアップデートする情報については、*AWS Command Line Interface ユーザーガイドバージョン 2* の「[AWS CLI の最新バージョンのインストールまたはアップデート](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。

コンテナインスタンスの正常性を表示するには、`CONTAINER_INSTANCE_HEALTH` オプションを使用して `describe-container-instances` を実行します。

`overallStatus` は、`details` 配列内の個々のヘルスチェックステータスによって決まります。最も重要度の高いステータスは、`IMPAIRED`、`INSUFFICIENT_DATA`、`INITIALIZING` および `OK` の順序で優先されます。

次に示すのは、`overallStatus` の有効な値です。
+ `OK` – すべてのヘルスチェックに合格しています。
+ `IMPAIRED` – 1 つ以上のヘルスチェックが失敗しました。
+ `INSUFFICIENT_DATA` – 1 つ以上のヘルスチェックが使用できません。
+ `INITIALIZING` – 1 つ以上のヘルスチェックが初期化されています。

`describe-container-instances` の実行方法の例を次に示します。

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

以下は、出力されたヘルスステータスオブジェクトの例です。

```
"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"
	}]
}
```

## コンテナインスタンスの異常
<a name="container-instance-health-action"></a>

`overallStatus` が `OK` 以外のステータスの場合、以下を試してください。
+ 待機してから `describe-container-instances` を実行します。
+ EC2 コンソールまたは CLI を使用して、コンテナインスタンスの状態を表示します。
+ CloudWatch メトリクスを確認します。詳細については、[CloudWatch を使用して Amazon ECS をモニタリングする](cloudwatch-metrics.md)を参照してください。
+ AWS Health Dashboard をチェックして、サービスに問題があるかどうかを確認してください。