View a markdown version of this page

Risoluzione dei problemi con Amazon ECS Action Logs - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi con Amazon ECS Action Logs

Gli Action Logs ti aiutano a diagnosticare i problemi fornendo registrazioni dettagliate delle operazioni avviate dal servizio Amazon ECS. Ogni voce di registro contiene un timestamp, un livello di registro, un nome dell'evento e un payload dettagliato con il contesto di cosa è successo e perché. Questo argomento illustra gli scenari di risoluzione dei problemi più comuni e fornisce informazioni pronte all'uso CloudWatch Registra le domande di Insights.

Comprensione dei livelli di log

I log delle azioni utilizzano tre livelli di registro per indicare la gravità di ciascun evento:

INFO

Operazioni normali come l’avvio della distribuzione, l’avvio dell’attività o il provisioning delle risorse. Questi eventi indicano che Amazon ECS sta eseguendo le azioni previste.

WARN

Non-fatal problemi che potrebbero richiedere attenzione, come tentativi di nuovo tentativo o limiti di capacità. Amazon ECS continua a fare progressi, ma l’operazione potrebbe richiedere più tempo del previsto.

ERROR

Guasti che richiedono un’azione, ad esempio distribuzione non riuscita, errore di provisioning o avvio dell’attività compromesso. Esamina questi eventi per identificare la causa principale e intraprendere azioni correttive.

Suggerimento

Inizia filtrando per ERROR o WARN livelli di registro per identificare rapidamente i problemi. È quindi possibile espandere la ricerca a INFO eventi per un contesto aggiuntivo.

Debug di una distribuzione del servizio non riuscita

Caratteristiche

Distribuzione bloccata in corso o ripristinata automaticamente.

Cosa cercare

Filtra per ERROR registri dove eventName contiene DEPLOYMENT. Controlla il detail payload per l'ARN di distribuzione, il motivo dello stato e il conteggio delle attività non riuscite.

L'esempio seguente mostra un errore di distribuzione in cui non era disponibile alcun candidato per il rollback:

{ "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" } }
Risoluzione

Controllate il detail.statusReason campo per identificare il motivo per cui le attività non sono riuscite. Usa quanto segue CloudWatch Interroga Logs Insights per trovare tutti gli errori di distribuzione:

fields @timestamp, detail.statusReason | filter logLevel = "ERROR" and detail.deploymentArn like /my-cluster\/my-service/ | sort @timestamp desc | limit 20

Diagnosi dei problemi relativi ai daemon gestiti

Caratteristiche

Il demone non si avvia sulle istanze o la distribuzione del daemon è bloccata.

Cosa cercare

Filtra i log in base al daemon ARN per trovare gli eventi relativi al tuo daemon. Puoi anche filtrare per logLevel per restringere i risultati agli avvisi o agli errori.

L'esempio seguente mostra un task daemon che non è stato avviato a causa della memoria insufficiente sull'istanza di destinazione:

{ "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" } }
Risoluzione

Verifica che le istanze di destinazione dispongano di risorse sufficienti per eseguire il daemon task. Se le istanze si stanno esaurendo, il demone potrebbe non avviarsi finché non saranno disponibili nuove istanze. Usa la seguente query per filtrare gli eventi per un demone specifico:

fields @timestamp, logLevel, detail.statusReason | filter actionSourceId like /my-logging-daemon/ | filter logLevel in ["ERROR", "WARN"] | sort @timestamp desc | limit 20

Comprendere i motivi di interruzione delle attività del daemon

Caratteristiche

Le attività daemon si interrompono in modo imprevisto.

Cosa cercare

Filtra per WARN e ERROR registri che contengono dettagli sugli errori delle attività daemon. I seguenti campi in detail il payload fornisce informazioni sul motivo per cui un'attività daemon si è interrotta:

detail.stopCode

Un codice leggibile dalla macchina che classifica il motivo dell'interruzione dell'attività.

detail.statusReason

Una descrizione leggibile dall'uomo del motivo per cui l'attività è stata interrotta. Questo campo non è presente in tutte le voci del registro.

detail.containerStoppedReason

Contesto aggiuntivo sul contenitore specifico che ha causato l'interruzione dell'attività.

Per un elenco completo dei codici di interruzione delle attività e delle relative descrizioni, vedi Amazon ECS ha interrotto i messaggi di errore relativi alle attività.

Nota

Interruzioni previste dell'attività daemon, ad esempio UserInitiated, vengono filtrati dai registri delle azioni. Vengono visualizzate solo interruzioni impreviste o dovute a errori delle attività del demone.

Utile CloudWatch Domande su Logs Insights

Usa quanto segue CloudWatch Registra le richieste di Insights per analizzare i problemi più comuni con i tuoi servizi Amazon ECS.

Tutti gli errori dell'ultima ora

fields @timestamp, logLevel, eventName, detail.statusReason | filter logLevel = "ERROR" | sort @timestamp desc | limit 50
Nota

Le detail.statusReason il campo non è presente in tutte le voci del registro. Se il campo è vuoto nei risultati, usa il eventName e altri campi in detail payload per il contesto.

Eventi per un servizio specifico

fields @timestamp, logLevel, detail.statusReason | filter @message like /my-service/ | sort @timestamp desc | limit 50

Cronologia di implementazione per una distribuzione specifica

fields @timestamp, logLevel, detail.statusReason | filter detail.deploymentArn like /my-cluster\/my-service\/abc123/ | sort @timestamp asc

Errori delle attività Daemon raggruppati per motivo

filter logLevel = "ERROR" and detail.stopCode != "" | stats count(*) as failureCount by detail.stopCode, detail.statusReason | sort failureCount desc | limit 20