Troubleshooting SSM Agent - AWS Systems Manager

Troubleshooting SSM Agent

If you experience problems running operations on your managed instances, there might be a problem with SSM Agent. Use the following information to help you view SSM Agent log files and troubleshoot the agent.

SSM Agent is out of date

An updated version of SSM Agent is released whenever new capabilities are added to Systems Manager or updates are made to existing capabilities. If an older version of the agent is running on an instance, some SSM Agent processes can fail. For that reason, we recommend that you automate the process of keeping SSM Agent up-to-date on your instances. For information, see Automating updates to SSM Agent. To be notified about SSM Agent updates, subscribe to the SSM Agent Release Notes page on GitHub.

View SSM Agent log files

SSM Agent logs information in the following files. The information in these files can also help you troubleshoot problems.


If you choose to view these logs by using Windows File Explorer, be sure to enable the viewing of hidden files and system files in Folder Options.

On Windows

  • %PROGRAMDATA%\Amazon\SSM\Logs\amazon-ssm-agent.log

  • %PROGRAMDATA%\Amazon\SSM\Logs\errors.log

On Linux

  • /var/log/amazon/ssm/amazon-ssm-agent.log

  • /var/log/amazon/ssm/errors.log