Comment résoudre les problèmes de délai d'exécution de la commande d'exécution du Systems Manager ?

Brève description

Les détails de l'état du délai d'exécution de la commande sont les suivants :

• Délai d'exécution : Durée, en secondes, nécessaire à l'exécution d'une commande avant qu'elle ne soit considérée comme ayant échoué. La valeur par défaut est 3600 (1 heure). La valeur maximale est de 172 800 (48 heures).
• Délai de livraison : La commande n'a pas été transmise au nœud géré avant l'expiration du délai total.
• Délai d'expiration total : La valeur du délai de livraison plus le délai d'exécution. Si le délai d'exécution n'est pas requis par le document SSM, le délai d'expiration total est égal au délai de livraison plus le délai d'exécution par défaut.

Pour plus d'informations, consultez la section Comprendre les statuts des commandes.

Résolution

Vérifiez les détails de l'état d'exécution de la commande

1. Ouvrez la console Systems Manager.
2. Dans le volet de navigation, choisissez Exécuter la commande.
3. Choisissez l’ID de commande en lien hypertexte pour ouvrir la page État de la commande.
4. Dans la section Cibles et sorties, choisissez l’ID d'instance en lien hypertexte, puis passez en revue la sortie.

Lorsque la sortie est tronquée, connectez-vous à l'instance EC2 à l'aide de SSH, puis accédez aux répertoires suivants pour voir les détails complets de l'erreur. Notez les codes d'état de sortie, puis reportez-vous à la section Résolution des Problèmes liés à la Commande Exécuter du Gestionnaire de Systèmes pour des étapes de dépannage supplémentaires.

Pour Linux et macOS :

/var/lib/amazon/ssm/<instance-id>/document/orchestration/<command-id>/<Plugin-name>/<Step-name>/stdout
/var/lib/amazon/ssm/<instance-id>/document/orchestration/<command-id>/<Plugin-name>/<Step-name>/stderr

Pour Windows :

%ProgramData%\Amazon\SSM\InstanceData\<ManagedInstance-ID>\document\orchestration\<Command-ID>\<plug-in>\<step_number.plug-in>\stdout
%ProgramData%\Amazon\SSM\InstanceData\<ManagedInstance-ID>\document\orchestration\<Command-ID>\<plug-in>\<step_number.plug-in>\stderr

Consulter les journaux de l'agent SSM

Consultez les journaux de l'agent SSM pour plus de détails sur l'échec.

Pour Linux et macOS, recherchez les journaux dans les répertoires suivants :

/var/log/amazon/ssm/amazon-ssm-agent.log
/var/log/amazon/ssm/errors.log
/var/log/Amazon/SSM/Audits/Amazon-SSM-Agent-Audit-AAA-MM-JJ

Pour Windows, recherchez les journaux dans les répertoires suivants :

%PROGRAMDATA%\Amazon\SSM\Logs\amazon-ssm-agent.log
%PROGRAMDATA%\Amazon\SSM\Logs\errors.log
%PROGRAMDATA%\Amazon\SSM\Logs\audits\amazon-ssm-agent-audit-YYYY-MM-DD

Si les journaux de l'agent SSM ne fournissent pas les informations dont vous avez besoin pour résoudre l'erreur, autorisez la journalisation du débogage à reproduire le problème.

Résoudre les problèmes de délai d'expiration

• Assurez-vous que le temps total d'exécution de votre document Run Command SSM est inférieur à la propriété TimeoutSeconds et que le temps total requis pour les terminer est inférieur au paramètre TimeoutSeconds. La valeur par défaut de la propriété TimeoutSeconds est de 3 600 secondes (1 heure). Pour plus d'informations sur la spécification de la valeur de la propriété TimeoutSeconds, consultez la section Gestion des délais d'expiration dans les runbooks.
• L'instance EC2 doit s'afficher en tant que nœud géré et l'état du ping de l'agent SSM doit être En ligne. Si votre instance EC2 ne s'affiche pas en tant que nœud géré ou si l'état du ping de l'agent SSM n'est pas en ligne, un dépannage supplémentaire est nécessaire. Pour plus d'informations, consultez la section Pourquoi mon instance EC2 ne s'affiche-t-elle pas en tant que nœud géré ou affiche-t-elle le statut « Connexion perdue » dans le Gestionnaire des systèmes ?
• Si votre commande Exécuter exécute des scripts qui redémarrent les nœuds gérés, le nœud peut se déconnecter, ce qui entraîne des problèmes de délai d'expiration. Assurez-vous que vous utilisez les bons codes de sortie. Pour plus d'informations, consultez la section Gestion des redémarrages lors de l'exécution de commandes.
• Si la version de votre agent SSM est 2.0.913 ou supérieure, la valeur maximale du délai d'exécution est de 172 800 secondes (48 heures). Vérifiez que l'instance utilise la dernière version de l'agent SSM.
• Lorsque Maintenance Window ou State Manager exécute la commande, confirmez que la commande est en cours d'exécution. Pour confirmer, utilisez AWS CloudTrail pour examiner la réponse de SendCommand.

Renseignement connexes

Documents d'AWS Systems Manager

Configuration d'AWS Systems Manager

Comment résoudre les problèmes liés aux échecs de la commande d'exécution de Systems Manager ?