本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS IoT SiteWise 使用 Amazon CloudWatch 指标进行监控
<a name="monitor-cloudwatch-metrics"></a>

您可以使用 AWS IoT SiteWise 进行监控 CloudWatch，它收集原始数据并将其处理为可读的近乎实时的指标。这些统计数据会保存 15 个月，从而使您能够访问历史信息，并能够更好地了解您的 Web 应用程序或服务的执行情况。此外，可以设置用于监测特定阈值的警报，并在达到相应阈值时发送通知或执行操作。有关更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。

AWS IoT SiteWise 将以下各节中列出的指标和维度发布到`AWS/IoTSiteWise`命名空间。

**提示**  
AWS IoT SiteWise 每隔一分钟发布指标。当您在 CloudWatch 控制台的图表中查看这些指标时，我们建议您选择 **1 分钟****的时间段**。这样，您便能查看指标数据的最高可用解析。

**Topics**
+ [AWS IoT Greengrass Version 2 网关指标](#gateway-metrics-ggv2)

## AWS IoT Greengrass Version 2 网关指标
<a name="gateway-metrics-ggv2"></a>

AWS IoT SiteWise 发布经典流、V2 网关和支持 MQTT 的 V3 网关的网关指标。除非另有说明，否则每个指标都适用于两个自托管网关版本。所有 SiteWise Edge 网关指标每隔一分钟发布一次。


**SiteWise 边缘网关指标**  

| 指标 | 描述 | 
| --- | --- | 
| Gateway.AvailableMemory |  SiteWise 边缘网关的可用内存。<br />单位：字节<br />维度：无 | 
| Gateway.AvailableDiskSpace |  SiteWise Edge 网关的可用磁盘空间。<br />单位：字节<br />维度：无 | 
| Gateway.CloudConnectivity |  SiteWise 边缘网关的云连接状态。<br />单位：无<br />维度： GatewayId | 
| Gateway.CpuUsage |  SiteWise 边缘网关的 CPU 使用率。<br />单位：百分比<br />维度：无 | 
| Gateway.TotalDiskSpace |  SiteWise Edge 网关的总磁盘空间。<br />单位：字节<br />维度：无 | 
| Gateway.TotalMemory |  SiteWise 边缘网关的总内存。<br />单位：字节<br />维度：无 | 
| Gateway.UsedDiskSpace |  SiteWise Edge 网关的已用磁盘空间。<br />单位：字节<br />维度：无 | 
| Gateway.UsedMemory |  SiteWise 边缘网关的已用内存。<br />单位：字节<br />维度：无 | 
| Gateway.UsedPercentageDiskSpace |  SiteWise Edge 网关磁盘空间的已用百分比。<br />单位：字节<br />维度：无 | 
| Gateway.UsedPercentageMemory |  SiteWise Edge 网关的已用内存百分比。<br />单位：字节<br />维度：无 | 


**AWS IoT SiteWise 发布者指标**  

| 指标 | 描述 | 
| --- | --- | 
| IoTSiteWisePublisher.ComponentBuildVersion | 该指标表示网关上运行的 IoT SiteWise 发布者组件的构建版本。值为 1 表示网关正在运行与该`ComponentBuildVersion`维度相对应的发布者版本。<br />单位：1<br />尺寸： GatewayId， ComponentBuildVersion | 
| IoTSiteWisePublisher.DroppedCount | 由 SiteWise Edge 网关 (`GatewayId`) 丢弃但未发布到云端的数据点数量，每分钟生成一次。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.Heartbeat | 由发布者在 SiteWise Edge 网关中每分钟生成一次。<br />单位：1（1 表示发布者正在运行但缺少表示发布者未运行的数据点。）<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.IsConnectedToMqttBroker | 由发布者在 SiteWise Edge 网关中每分钟生成一次。<br />单位：1（1 表示发布者已连接到 MQTT 代理。）<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.MessageCheckpointPersistenceErrorCount | 该指标表明网关检测到用于跟踪发布者处理的数据的检查点文件存在问题。值为 `1` 表示已发生故障。<br />单位：无<br />尺寸： AccountId， GatewayId | 
| IoTSiteWisePublisher.MqttMessageReceivedSuccessCount | 发布者成功接收来自 MQTT 代理的消息数量，每分钟生成一次。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.MqttReceivedSuccessBytes | 发布者成功接收来自 MQTT 代理的消息数据的字节数，每分钟生成一次。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker | 发布者订阅 MQTT 代理的主题数量，每分钟生成一次。多级通配符主题计为 1。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived | 发布者从 MQTT 代理收到的唯一主题的数量，每分钟生成一次。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.PublishFailureCount |  SiteWise 边缘网关 (`GatewayId`) 发布失败的数据点数量，每分钟生成。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.PublishRejectedCount |  SiteWise 边缘网关 (`GatewayId`) 每分钟从云端拒绝的数据点数量。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.PublishSuccessCount |  SiteWise 边缘网关 (`GatewayId`) 每分钟成功发布到云端的数据点数量。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.PublishToS3FailureCount | 网关（`GatewayId`）未能发布到 Amazon S3 存储桶的数据点的数量。<br />单位：计数<br />尺寸： GatewayId | 
| IoTSiteWisePublisher.PublishToS3SuccessCount | 网关（`GatewayId`）成功发布到 Amazon S3 存储桶的数据点的数量。<br />单位：计数<br />尺寸： GatewayId | 


**OPC UA 收集器指标**  

| 指标 | 描述 | 
| --- | --- | 
| OpcUaCollector.ActiveDataStreamCount |  SiteWise 边缘网关 (`gatewayId`) 为 OPC UA 源 (`sourceName`) 订阅的数据流数量。<br />单位：计数<br />尺寸: GatewayId, SourceName, PropertyGroup  | 
| OpcUaCollector.ComponentBuildVersion（不适用于经典直播、V2 网关） | 该指标表示网关上运行的 IoT SiteWise OPC UA 收集器组件的构建版本。值为 1 表示网关正在运行与该`ComponentBuildVersion`维度相对应的收集器版本。<br />单位：1<br />尺寸： GatewayId， ComponentBuildVersion | 
| OpcUaCollector.ConversionErrors |  SiteWise 边缘网关 (`gatewayId`) 接收到的 OPC UA 源 (`sourceName`) 的数据点数量，这些数据点在将数据发送到 AWS IoT SiteWise时导致转换错误。OPC UA 收集器不会摄取这些数据点。<br />单位：计数<br />尺寸： GatewayId， SourceName | 
| OpcUaCollector.Heartbeat | 每分钟为连接到 SiteWise Edge 网关 (`sourceName`) 的每个 OPC UA 源 (`gatewayId`) 生成一次。<br />单位：计数（1 表示源已连接，0 表示源已断开连接。）<br />尺寸： GatewayId， SourceName | 
| OpcUaCollector.IncomingValuesCount |  SiteWise 边缘网关 (`gatewayId`) 每分钟为 OPC UA 源 (`sourceName`) 接收的数据点数量。<br />单位：计数<br />尺寸: GatewayId, SourceName, PropertyGroup  | 
| OpcUaCollector.IncomingValueErrors |  SiteWise 边缘网关 (`gatewayId`) 从 OPC UA 源 (`sourceName`) 接收的无效值的数据点数量。OPC UA 收集器不会摄取这些数据点，而是每分钟生成一次。<br />单位：计数<br />尺寸: GatewayId, SourceName, PropertyGroup  | 
| OpcUaCollector.IsConnectedToMqttBroker（不适用于经典直播、V2 网关） | 由 SiteWise Edge 网关中的 IoT SiteWise OPC UA 收集器组件每分钟生成一次。<br />单位：1（1 表示物联网 SiteWise OPC UA 收集器组件连接到 MQTT 代理）<br />尺寸： GatewayId | 
| OpcUaCollector.MqttMessagesDroppedCount（不适用于经典直播、V2 网关） | 物联网 SiteWise OPC UA 收集器组件丢弃的 MQTT 消息数量。<br />单位：计数<br />尺寸： GatewayId， SourceName | 
| OpcUaCollector.MqttMessagesPublishedBytes（不适用于经典直播、V2 网关） | 物联网 SiteWise OPC UA 收集器组件成功发布到 MQTT 代理的 MQTT 消息数据的字节数。<br />单位：计数<br />尺寸： GatewayId， SourceName | 
| OpcUaCollector.MqttMessagesPublishedCount（不适用于经典直播、V2 网关） | 物联网 SiteWise OPC UA 收集器组件成功向 MQTT 代理发布的 MQTT 消息的数量。<br />单位：计数<br />尺寸： GatewayId， SourceName | 
| OpcUaCollector.NullValueCount（不适用于经典直播、V2 网关） | 物联网 SiteWise OPC UA 收集器组件从 OPC UA 服务器接收的空值的数量。<br />单位：计数<br />尺寸: GatewayId, SourceName, PropertyGroup  | 
| OpcUaCollector.NumberOfUniqueMqttTopicsPublished（不适用于经典直播、V2 网关） | 物联网 SiteWise OPC UA 收集器向 MQTT 代理发布的唯一 MQTT 主题的数量。<br />单位：计数<br />尺寸： GatewayId， SourceName | 


**AWS IoT SiteWise 处理器指标**  

| 指标 | 描述 | 
| --- | --- | 
| Gateway.DataProcessor.IngestionThrottled（在支持 MQTT 的 V3 网关上不可用） | 受限数据点的数量，每分钟生成一次。<br />单位：计数<br />尺寸： ThrottledAt | 
| Gateway.DataProcessor.MeasurementRejected（在支持 MQTT 的 V3 网关上不可用） | 被拒绝的测量值的数量，每分钟生成一次。<br />单位：计数<br />维度：原因 | 
| Gateway.DataProcessor.MessagesRemaining（在支持 MQTT 的 V3 网关上不可用） | 流中剩余的消息数量，每分钟生成一次。<br />单位：计数<br />尺寸： StreamName | 
| Gateway.DataProcessor.ProcessingError（在支持 MQTT 的 V3 网关上不可用） | 处理错误的数量，每分钟生成一次。<br />单位：计数<br />维度：原因 |