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

# 使用警报监控数据 Amazon IoT SiteWise
<a name="industrial-alarms"></a>

您可以为您的数据配置警报，以便在设备或流程运行不佳时提醒您的团队。计算机或进程的最佳性能意味着特定指标的值应在上限和下限的范围内。当这些指标超出其运作范围时，必须通知设备操作员以便修复问题。使用警报功能快速识别问题并通知操作员，以最大限度地提高设备和进程的性能。

**Topics**
+ [警报类型](#alarm-types)
+ [警报状态](#alarm-states)
+ [警报状态属性](#alarm-state-properties)
+ [在中定义资产模型的警报 Amazon IoT SiteWise](define-alarms.md)
+ [在中配置资产警报 Amazon IoT SiteWise](configure-alarms.md)
+ [回应中的警报 Amazon IoT SiteWise](respond-to-alarms.md)
+ [摄取外部警报状态 Amazon IoT SiteWise](ingest-external-alarm-state.md)

## 警报类型
<a name="alarm-types"></a>

您可以定义在 Amazon 云端检测到的警报和通过外部进程检测到的警报。 Amazon IoT SiteWise 支持以下类型的警报：
+ **Amazon IoT Events 警报**
**注意**  
终止支持通知： Amazon 已终止对的支持 Amazon IoT Events。有关更多信息，请参阅[Amazon IoT Events 终止支持](https://docs.amazonaws.cn/iotevents/latest/developerguide/iotevents-end-of-support.html)。

  Amazon IoT Events 警报是检测到的警报 Amazon IoT Events。 Amazon IoT SiteWise 将资产属性值发送到中的警报模型 Amazon IoT Events。然后， Amazon IoT Events 将警报状态发送到 Amazon IoT SiteWise。您可以配置选项，例如警报何时检测到以及在警报状态发生变化时通知谁。您还可以定义警报状态发生变化时发生的[Amazon IoT Events 操作](https://docs.amazonaws.cn/iotevents/latest/developerguide/iotevents-supported-actions.html)。

  中的警报 Amazon IoT Events 是警报模型的实例。警报模型指定了警报的阈值和严重性、警报状态发生变化时该怎么做等等。配置警报模型的每个特征时，您可以指定警报监控的资产模型的特征属性。所有基于资产模型的资产在 Amazon IoT Events 评估警报的特征时都使用该属性的值。有关更多信息，请参阅《[ 开发人员指南》](https://docs.amazonaws.cn/iotevents/latest/developerguide/iotevents-alarms.html)中的*Amazon IoT Events 使用警报*。

  当 Amazon IoT Events 警报状态发生变化时，您可以对其做出响应。例如，您可以在警报激活时确认或暂停警报。您还可以启用、禁用和重置警报。

  SiteWise 监控用户可以在 SiteWise 监控门户中对 Amazon IoT Events 警报进行可视化、配置和响应。有关更多信息，请参阅*《Amazon IoT SiteWise Monitor 应用程序指南*》中的[使用警报进行监控](https://docs.amazonaws.cn/iot-sitewise/latest/appguide/monitor-alarms.html)。
**注意**  
Amazon IoT Events 评估这些警报并在 Amazon IoT SiteWise 和之间传输数据需要付费 Amazon IoT Events。有关更多信息，请参阅[Amazon IoT Events 定价](https://www.amazonaws.cn/iot-events/pricing/)。
+ **外部警报**

  外部警报是您在外部评估的警报 Amazon IoT SiteWise。如果您有报告警报状态的数据来源，请使用外部警报。外部警报包含一个测量属性，您可以从中提取警报状态数据。

  当外部警报改变状态时，您无法确认或暂停该警报。

  SiteWise 监控用户可以在 SiteWise 监控器门户中看到外部警报的状态，但他们无法配置或响应这些警报。

  Amazon IoT SiteWise 不评估外部警报的状态。

## 警报状态
<a name="alarm-states"></a>

工业警报包括有关其监控的设备或流程状态的信息，以及有关操作员对警报状态的响应的信息（可选）。

定义 Amazon IoT Events 警报时，您可以指定是否启用*确认流*。默认情况下，启用确认流。启用此选项后，操作员可以确认警报并留下备注，详细说明警报或其为解决警报采取的措施。如果操作员在活动警报变为非活动状态之前未确认该活动警报，则该警报将被锁定。锁定状态表示警报已激活且未被确认，因此操作员需要检查设备或流程，并确认已锁定的警报。

警报具有以下状态：
+ **正常** (`Normal`) - 警报已启用但处于非活动状态。工业流程或设备按预期运行。
+ **活动** (`Active`) - 警报处于活动状态。工业流程或设备超出了其操作范围，需要引起注意。
+ **已确认** (`Acknowledged`) - 操作员已确认警报的状态。

  此状态仅适用于您启用确认流的警报。
+ **已锁定** (`Latched`) - 警报恢复正常，但处于活动状态，没有操作员确认。工业流程或设备需要操作员注意才能将警报重置为正常。

  此状态仅适用于您启用确认流的警报。
+ **已暂停** (`SnoozeDisabled`) - 警报被停用，因为操作员暂停了警报。操作员定义警报暂停的持续时间。在该持续时间之后，警报将恢复正常状态。
+ **已禁用** (`Disabled`) - 警报已禁用，无法检测。

## 警报状态属性
<a name="alarm-state-properties"></a>

Amazon IoT SiteWise 将警报状态数据存储为序列化为字符串的 JSON 对象。此对象包含警报的状态和其他信息，例如操作员的响应操作和警报评估的规则。

您可以通过名称和结构类型 `AWS/ALARM_STATE` 来识别警报状态属性。有关更多信息，请参阅 [在中定义资产模型的警报 Amazon IoT SiteWise](define-alarms.md)。

警报状态数据对象包含以下信息：

`stateName`  
警报的状态。有关更多信息，请参阅 [警报状态](#alarm-states)。  
数据类型：`STRING`

`customerAction`  
（可选）包含有关操作员响应警报信息的对象。操作员可以启用、禁用、确认和暂停警报。当他们这样做时，警报状态数据包括他们的响应以及他们响应时可以留下的备注。该对象包含以下信息：    
`actionName`  
操作员为响应警报而采取的操作名称。此值包含以下字符串之一：  
+ `ENABLE`
+ `DISABLE`
+ `SNOOZE`
+ `ACKNOWLEDGE`
+ `RESET`
数据类型：`STRING`  
`enable`  
（可选）操作员启用警报时 `customerAction` 中存在的对象。当操作员启用警报时，警报状态将变为 `Normal`。该对象包含以下信息：    
`note`  
（可选）客户在启用警报时留下的备注。  
数据类型：`STRING`  
最大长度：128 个字符  
`disable`  
（可选）操作员禁用警报时 `customerAction` 中存在的对象。当操作员启用警报时，警报状态将变为 `Disabled`。该对象包含以下信息：    
`note`  
（可选）客户在禁用警报时留下的备注。  
数据类型：`STRING`  
最大长度：128 个字符  
`acknowledge`  
（可选）操作员确认警报时 `customerAction` 中存在的对象。当操作员启用警报时，警报状态将变为 `Acknowledged`。该对象包含以下信息：    
`note`  
（可选）客户在确认警报时留下的备注。  
数据类型：`STRING`  
最大长度：128 个字符  
`snooze`  
（可选）操作员暂停警报时 `customerAction` 中存在的对象。当操作员启用警报时，警报状态将变为 `SnoozeDisabled`。该对象包含以下信息：    
`snoozeDuration`  
操作员暂停警报的持续时间（以秒为单位）。在此持续时间之后，警报将变为 `Normal` 状态。  
数据类型：`INTEGER`  
`note`  
（可选）客户在暂停警报时留下的备注。  
数据类型：`STRING`  
最大长度：128 个字符

`ruleEvaluation`  
（可选）包含有关警报评估规则信息的对象。该对象包含以下信息：    
`simpleRule`  
包含有关简单规则信息的对象，该规则使用比较运算符将属性值与阈值进行比较。该对象包含以下信息：    
`inputProperty`  
此警报评估属性的值。  
数据类型：`DOUBLE`  
`operator`  
此警报用于将属性与阈值进行比较的比较运算符。此值包含以下字符串之一：  
+ `<` - 小于
+ `<=` - 小于或等于
+ `==` - 等于
+ `!=` - 不等于
+ `>=` - 大于或等于
+ `>` - 大于
数据类型：`STRING`  
`threshold`  
此警报与属性值进行比较的阈值。  
数据类型：`DOUBLE`