

• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 使用 Amazon CloudWatch 监控 Run Command 指标
<a name="monitoring-cloudwatch-metrics"></a>

*指标*是 Amazon CloudWatch 中的基本概念。指标表示一个发布到 CloudWatch 并且按时间排序的数据点集。可将指标视为要监控的变量，而数据点代表该变量随时间变化的值。

AWS Systems Manager 会将与 Run Command 命令的状态有关的指标发布到 CloudWatch，让您能够根据这些指标设置警报。Run Command 是 AWS Systems Manager 中的一项工具。这些统计数据会被长时间记录，以便您可以访问历史信息并更好地了解 AWS 账户中命令运行的成功率。

可以跟踪其指标的命令的终端状态值包括 `Success`、`Failed` 和 `Delivery Timed Out`。例如，对于设置为每小时运行一次的 SSM Command 文档，您可以配置告警，以便在其中任何一小时未报告 `Success` 的状态时向您发送通知。有关命令状态值的更多信息，请参阅 [了解命令状态](monitor-commands.md)。

**在 CloudWatch 控制台中查看指标**

1. 通过 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 打开 CloudWatch 控制台。

1. 在导航窗格中，选择**指标**。

1. 在**按 AWS 服务告警**区域，对于**服务**，选择 **SSM-Run Command**。

**使用 AWS CLI 查看指标**  
打开命令提示符窗口并使用以下命令。

```
aws cloudwatch list-metrics --namespace "AWS/SSM-RunCommand"
```

要列出所有可用的指标，请使用以下命令。

```
aws cloudwatch list-metrics
```

## Systems Manager Run Command 指标和维度
<a name="metrics-and-dimensions"></a>

Systems Manager 每分钟向 CloudWatch 发送一次 Run Command 命令指标。

Systems Manager 将以下命令指标发送到 CloudWatch。

**注意**  
这些指标使用 `Count` 作为单位，因此 `Sum` 和 `SampleCount` 是最有用的统计数据。


| 指标 | 说明 | 
| --- | --- | 
| CommandsDeliveryTimedOut  | 终端状态为 Delivery Timed Out 的命令的数量。 | 
| CommandsFailed  | 终端状态为 Failed 的命令的数量。 | 
| CommandsSucceeded  | 终端状态为 Success 的命令的数量。 | 

有关使用 CloudWatch 指标的更多信息，请参阅 *Amazon CloudWatch 用户指南*中的以下主题：
+ [Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric)
+ [使用 Amazon CloudWatch 指标](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)
+ [使用 Amazon CloudWatch 告警](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)