Solución de problemas con Amazon ECS Action Logs
Action Logs lo ayuda a diagnosticar los problemas al proporcionar registros detallados de las operaciones iniciadas por el servicio Amazon ECS. Cada entrada de registro contiene una marca de tiempo, un nivel de registro, un nombre de evento y una carga útil detallada con el contexto sobre lo que ocurrió y por qué. En este tema se describen los escenarios de solución de problemas más comunes y se proporcionan consultas de CloudWatch Logs Insights listas para usar.
Descripción de los niveles de registro
Action Logs utiliza tres niveles de registro para indicar la gravedad de cada evento:
INFO-
Operaciones normales, como inicio de implementaciones, inicio de tareas o aprovisionamiento de recursos. Estos eventos indican que Amazon ECS está realizando las acciones esperadas.
WARN-
Problemas no graves que podrían requerir atención, como los reintentos o las limitaciones de capacidad. Amazon ECS sigue progresando, pero es posible que la operación tarde más de lo esperado.
ERROR-
Fallos que requieren acciones, como un fallo de implementación, un error de aprovisionamiento o un problema en el inicio de una tarea. Revise estos eventos para identificar la causa raíz y tomar las acciones correctivas.
Comience filtrando los niveles de registro ERROR o WARN para identificar los problemas rápidamente. A continuación, puede ampliar la búsqueda a los eventos INFO para obtener más contexto.
Depuración de una implementación de servicio con errores
Síntomas
La implementación se quedó bloqueada en curso o se revirtió automáticamente.
Qué buscar
Filtre los registros de ERROR donde eventName contenga DEPLOYMENT. Compruebe la carga útil de detail para obtener el ARN de implementación, el motivo del estado y el recuento de tareas con errores.
En el siguiente ejemplo, se muestra un error de implementación en el que no había ningún candidato disponible para la reversión:
{ "resourceArn": "arn:aws:ecs:us-east-1:111122223333:cluster/my-cluster", "actionSourceId": "service/my-cluster/my-service", "logLevel": "ERROR", "eventTimestamp": 1784573730986, "detail": { "statusReason": "No rollback candidate was found to run the rollback.", "serviceDeploymentArn": "arn:aws:ecs:us-east-1:111122223333:service-deployment/my-cluster/my-service/abc123def456", "status": "FAILED", "eventName": "SERVICE_DEPLOYMENT_ROLLBACK_FAILED" } }
Resolución
Compruebe el campo detail.statusReason para identificar por qué fallaron las tareas. Use la siguiente consulta de CloudWatch Logs Insights para encontrar todos los errores de implementación:
fields @timestamp, detail.statusReason | filter logLevel = "ERROR" and detail.deploymentArn like /my-cluster\/my-service/ | sort @timestamp desc | limit 20
Diagnóstico de problemas con los daemons gestionados
Síntomas
El daemon no se inicia en las instancias o la implementación del daemon está bloqueada.
Qué buscar
Filtre los registros por el ARN del daemon para encontrar los eventos relacionados con su daemon. También puede filtrar por logLevel para limitar los resultados a advertencias o errores.
El siguiente ejemplo muestra una tarea de daemon que no se pudo iniciar por falta de memoria en la instancia de destino:
{ "timestamp": 1719500050000, "logLevel": "WARN", "account": "123456789012", "region": "us-east-1", "resourceArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "actionSourceId": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-logging-daemon", "eventName": "DAEMON_TASK_START_IMPAIRED", "detail": { "statusReason": "RESOURCE:MEMORY - Unable to place daemon task on container instance: insufficient memory", "containerInstanceArn": "arn:aws:ecs:us-east-1:123456789012:container-instance/my-cluster/a1b2c3d4" } }
Resolución
Compruebe que las instancias de destino tengan recursos suficientes para ejecutar la tarea del daemon. Si las instancias se están vaciando, es posible que el daemon no se inicie hasta que haya nuevas instancias disponibles. Use la siguiente consulta para filtrar los eventos de un daemon específico:
fields @timestamp, logLevel, detail.statusReason | filter actionSourceId like /my-logging-daemon/ | filter logLevel in ["ERROR", "WARN"] | sort @timestamp desc | limit 20
Descripción de los motivos de la detención de las tareas de daemon
Síntomas
Las tareas del daemon se detienen de forma inesperada.
Qué buscar
Filtre los registros de WARN y ERROR que contienen detalles sobre los errores de las tareas de daemon. Los siguientes campos de la carga útil de detail proporcionan información sobre el motivo por el que se detuvo una tarea de daemon:
detail.stopCode-
Un código legible por máquina que clasifica el motivo de la detención de la tarea.
detail.statusReason-
Una descripción en lenguaje natural de por qué se detuvo la tarea. Este campo no está presente en todas las entradas de registro.
detail.containerStoppedReason-
Contexto adicional sobre el contenedor específico que provocó la detención de la tarea.
Para obtener una lista completa de los códigos de detención de tareas y sus descripciones, consulte Mensajes de error de las tareas detenidas de Amazon ECS.
Las detenciones de tareas de daemon esperadas, como UserInitiated, se filtran de Action Logs. Solo se muestran las detenciones de tareas de daemon inesperadas o relacionadas con errores.
Consultas útiles de CloudWatch Logs Insights
Utilice las siguientes consultas de CloudWatch Logs Insights para investigar problemas comunes con sus servicios de Amazon ECS.
Todos los errores de la última hora
fields @timestamp, logLevel, eventName, detail.statusReason | filter logLevel = "ERROR" | sort @timestamp desc | limit 50
El campo detail.statusReason no está presente en todas las entradas de registro. Si el campo está vacío en los resultados, utilice el campo eventName y otros campos de la carga útil detail como contexto.
Eventos para un servicio específico
fields @timestamp, logLevel, detail.statusReason | filter @message like /my-service/ | sort @timestamp desc | limit 50
Cronograma de implementación para una implementación específica
fields @timestamp, logLevel, detail.statusReason | filter detail.deploymentArn like /my-cluster\/my-service\/abc123/ | sort @timestamp asc
Errores de tareas de daemon agrupados por motivo
filter logLevel = "ERROR" and detail.stopCode != "" | stats count(*) as failureCount by detail.stopCode, detail.statusReason | sort failureCount desc | limit 20