Monitoring Commands
You can issue commands with SSM Run Command to multiple instances at the same time. Each copy of the command targeting each instance is a command invocation. For example, if you use the AWS-RunShellScript document and send an ifconfig command to 20 instances, that command has 20 invocations. You can monitor the status of each invocation in the Amazon EC2 console or you can use the aws ssm list-command-invocations (AWS CLI) command. You can view the details of each invocation; these details can help you troubleshoot problems if a command fails.
Command Status
Each command invocation individually reports status. Furthermore, each SSM document consists of one or more code-execution blocks called plugins. The plugins for a given command invocation individually report status as well. The following table describes Run Command execution statuses.
For more information about plugins, see SSM Documents > SSM Plugins in the Amazon EC2 Simple Systems Manager API Reference.
| Status | Details |
|---|---|
| Pending | The command was not yet received by the SSM agent. If the command is not received by the SSM agent before the value specified by the Timeout (seconds) parameter is reached, then the status changes to Timed Out. |
| In Progress | The command was received by the SSM agent or the command started executing on the instance. Depending on the result of all command plugins, the status will change to Success, Failed, or Timed Out. If the SSM agent is not available on the instance, the command status will show In Progress until the SSM agent is available again. The status will then change to a terminal state. |
| Success | The command, including all plugins, finished executing on the instance. |
| Failed |
One or more plugins failed to execute. To help you identify and troubleshoot problems with a command, if a plugin fails, the entire invocation status is changed to Failed. |
| Timed Out | The command did not reach the SSM agent on the instance before the value specified by the Timeout (seconds) parameter was reached. Or, the command execution ran longer than the allowable execution time. The amount of time a command execution can run varies by plugin. Default values range from two hours to eight hours. |
| Cancelling | You sent the command to cancel a command invocation. The command has not reached a terminal state (Success, Failed, or Timed Out). If the SSM agent responds within the time-frame specified by the Timeout (seconds) parameter, then the status will change to reflect a terminal state. Otherwise the status will change to Timed Out. |
| Cancelled | The command was successfully cancelled. |
Note
In the Amazon EC2 console, click the Refresh symbol in the upper-right corner to monitor command status as command execution progresses.
