Monitor Amazon ECS container instance health - Amazon Elastic Container Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Monitor Amazon ECS container instance health

Amazon ECS provides container instance health monitoring. You can quickly determine whether Amazon ECS has detected any problems that might prevent your container instances from running containers. Amazon ECS performs automated checks on every running container instance with agent version 1.57.0 or later to identify issues. For more information on verifying the agent version an a container instance, see Updating the Amazon ECS container agent.

You must be using Amazon CLI version 1.22.3 or later or Amazon CLI version 2.3.6 or later. For information about how to update the Amazon CLI, see Installing or updating the latest version of the Amazon CLI in the Amazon Command Line Interface User Guide Version 2.

To view the container instance health, run describe-container-instances with the CONTAINER_INSTANCE_HEALTH option.

The following are the valid values for overallStatus :

  • OK

  • IMPAIRED

  • INSUFFICIENT_DATA

  • INITIALIZING

The following is an example of how to run describe-container-instances .

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

The following is an example of the health status object in the output.

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

Container instance-health issues

When the overallStatus any status other than OK, try the following:

  • Wait, and then run describe-container-instances

  • View your container instance health in the EC2 console or by using the CLI.

  • Review the CloudWatch metrics. For more information, see Monitor Amazon ECS using CloudWatch

  • Check the Amazon Health Dashboard to see if there are any issues with the service.