Amazon ECS troubleshooting

You might need to troubleshoot issues with your load balancers, tasks, services, or container instances. This chapter helps you find diagnostic information from the Amazon ECS container agent, the Docker daemon on the container instance, and the service event log in the Amazon ECS console.

For information about stopped tasks, see one of the following.

Action	Learn more
Resolve stopped task errors.	Viewing Amazon ECS stopped task errors
View stopped task errors.	Resolve Amazon ECS stopped task errors
Review stopped task error codes.	Amazon ECS stopped tasks error messages
Review CannotPullContainer task errors.	CannotPullContainer task errors in Amazon ECS
View task IAM role requests.	Viewing IAM role requests for Amazon ECS tasks

For information about service errors, see one of the following.

Action	Learn more
View service event messages.	Viewing Amazon ECS service event messages
Review service event messages.	Amazon ECS service event messages
Review load balancer issues.	Troubleshooting service load balancers in Amazon ECS
Review service auto scaling issues.	Troubleshooting service auto scaling in Amazon ECS

For information about task definition errors, see one of the following.

Action	Learn more
Resolve task definition memory error.	Troubleshoot Amazon ECS task definition invalid CPU or memory errors

For information about Amazon ECS agent errors, see one of the following.

Action	Learn more
View Amazon ECS container agent logs.	Viewing Amazon ECS container agent logs
Learn how to collect Amazon ECS logs.	Collecting container logs with Amazon ECS logs collector
Retrieve diagnostic details with the Amazon ECS agent.	Retrieve Amazon ECS diagnostic details with agent introspection

For information about Docker errors, see one of the following.

Action	Learn more
Use Docker diagnostics.	Docker diagnostics in Amazon ECS
Turn on Docker debug mode.	Configuring verbose output from the Docker daemon in Amazon ECS
Troubleshoot Docker API error 500.	Troubleshoot the Docker API error (500): devmapper in Amazon ECS

For information about ECS Exec and Amazon ECS Anywhere errors, see one of the following.

Action	Learn more
Troubleshoot ECS Exec.	Troubleshoot Amazon ECS Exec issues
Troubleshoot Amazon ECS Anywhere.	Troubleshoot Amazon ECS Anywhere issues

For information about throttling issues, see one of the following.

Action	Learn more
Learn about Fargate throttling quotas.	AWS Fargate throttling quotas
Learn the best practices for Amazon ECS throttling.	Handle Amazon ECS throttling issues

For information about API errors, see one of the following.

Action	Learn more
Resolve API errors.	Amazon ECS API failure reasons