Runbook

Troubleshooting ECS Fargate Service Health Check Failures

Back to Runbooks

Overview

This incident type refers to troubleshooting issues related to blue/green deployments for services hosted on Amazon Elastic Container Service (ECS) Fargate. Specifically, the incident involves ECS service failing to stabilize due to health check failures. The solution involves ensuring that the port mappings of task definitions match the ports of target groups. To troubleshoot load balancer health check issues for ECS Fargate task and pass the Application Load Balancer health check, connectivity between the load balancer and Amazon ECS task, health check settings of the target group, and status and configuration of the application in ECS Fargate container must be checked.

Parameters

Debug

1. Check the status of the ECS task

2. Check the status of the ECS service

3. Check the status of the target group associated with the ECS service

4. Check the logs for the ECS task

5. Check the load balancer configuration

6. Check the health check settings for the target group

7. Check the status and configuration of the application in the ECS Fargate container

Repair

Compare the port mappings of your task definitions match the ports of your target groups and update the task definition

Learn more

Related Runbooks

Check out these related runbooks to help you debug and resolve similar issues.