本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中使用警示監控資料 AWS IoT SiteWise
<a name="industrial-alarms"></a>

您可以設定資料的警示，在設備或程序以次最佳化方式執行時提醒您的團隊。機器或程序的最佳效能，表示特定指標的值應該在高低限制範圍內。當這些指標超出其操作範圍時，則必須通知設備操作員以便修正問題。使用警示快速識別問題並通知操作員，以最大限度地提高設備和程序的效能。

**Topics**
+ [警示類型](#alarm-types)
+ [警示狀態](#alarm-states)
+ [警示狀態屬性](#alarm-state-properties)
+ [在 中定義資產模型的警示 AWS IoT SiteWise](define-alarms.md)
+ [在 中設定資產警示 AWS IoT SiteWise](configure-alarms.md)
+ [在 中回應警示 AWS IoT SiteWise](respond-to-alarms.md)
+ [在 中擷取外部警示狀態 AWS IoT SiteWise](ingest-external-alarm-state.md)

## 警示類型
<a name="alarm-types"></a>

您可以定義在 AWS 雲端中偵測到的警示，以及使用外部程序偵測到的警示。 AWS IoT SiteWise 支援下列類型的警示：
+ **AWS IoT Events 警示**
**注意**  
終止支援通知： AWS 已結束對 的支援 AWS IoT Events。如需詳細資訊，請參閱[AWS IoT Events 終止支援](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)。

  AWS IoT Events 警示是偵測 in. AWS IoT Events AWS IoT SiteWise sends 資產屬性值到 中警示模型的警示 AWS IoT Events。然後， AWS IoT Events 傳送警示狀態至 AWS IoT SiteWise。您可以設定選項，例如警示偵測到時，以及警示狀態變更時要通知誰。您也可以定義警示狀態變更時所發生[AWS IoT Events 的動作](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html)。

  中的警示 AWS IoT Events 是警示模型的執行個體。警示模型會指定警示的閾值和嚴重性、警示狀態變更時應採取的動作等。當您設定警示模型的每個特徵時，您可以從警示監控的資產模型指定屬性屬性。當 AWS IoT Events 評估警示的特性時，所有以資產模型為基礎的資產都會使用 屬性的值。如需詳細資訊，請參閱《 *AWS IoT Events 開發人員指南*》中的[使用警示](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-alarms.html)。

  您可以在 AWS IoT Events 警示變更狀態時回應警示。例如，您可以在警示變成作用中時確認警示或將其休眠。您也可以啟用、停用和重設警示。

  SiteWise Monitor 使用者可以在 SiteWise Monitor 入口網站中視覺化、設定和回應 AWS IoT Events 警示。如需詳細資訊，請參閱《 *AWS IoT SiteWise Monitor 應用程式指南*》中的[使用警示進行監控](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/monitor-alarms.html)。
**注意**  
AWS IoT Events 費用適用於評估這些警示，以及在 AWS IoT SiteWise 和 之間傳輸資料 AWS IoT Events。如需詳細資訊，請參閱 [AWS IoT Events 定價](https://aws.amazon.com/iot-events/pricing/)。
+ **外部警示**

  外部警示是您在 外部評估的警示 AWS IoT SiteWise。如果您有報告警示狀態的資料來源，請使用外部警示。外部警示包含您擷取警示狀態資料的測量屬性。

  當外部警示變更狀態時，您無法確認或休眠外部警示。

  SiteWise Monitor 使用者可以在 SiteWise Monitor 入口網站中查看外部警示的狀態，但無法設定或回應這些警示。

  AWS IoT SiteWise 不會評估外部警示的狀態。

## 警示狀態
<a name="alarm-states"></a>

工業警示包含其監控之設備或程序狀態的相關資訊，以及 （選用） 運算子對警示狀態的回應資訊。

當您定義 AWS IoT Events 警示時，您可以指定是否啟用*確認流程*。預設會啟用確認流程。當您啟用此選項時，運算子可以確認警示，並記下警示的詳細資訊或他們為了解決該警示而採取的動作。如果運算子在處於非作用中狀態之前未確認作用中警示，則警示會遭到鎖定。閂鎖狀態表示警示變成作用中且未確認，因此操作員需要檢查設備或程序，並確認閂鎖警示。

警示具有下列狀態：
+ **正常** (`Normal`) – 警示已啟用但非作用中。工業程序或設備可如預期運作。
+ **作用中** (`Active`) – 警示處於作用中狀態。工業程序或設備超出其操作範圍，需要注意。
+ **已確認 **(`Acknowledged`) – 操作員已確認警示的狀態。

  此狀態僅適用於您啟用確認流程的警示。
+ **鎖定 **(`Latched`) – 警示傳回正常，但處於作用中狀態，且沒有操作員認可。工業程序或設備需要操作員的注意，才能將警示重設為正常。

  此狀態僅適用於您啟用確認流程的警示。
+ **Snoozed** (`SnoozeDisabled`) – 警示已停用，因為運算子將警示休眠。運算子定義警示休眠的持續時間。在該持續時間之後，警示會返回正常狀態。
+ **已停用** (`Disabled`) – 警示已停用且無法偵測。

## 警示狀態屬性
<a name="alarm-state-properties"></a>

AWS IoT SiteWise 會將警示狀態資料儲存為序列化至字串的 JSON 物件。此物件包含警示的狀態和其他資訊，例如運算子回應動作和警示評估的規則。

您可以依警示狀態屬性的名稱和結構類型 來識別警示狀態屬性`AWS/ALARM_STATE`。如需詳細資訊，請參閱[在 中定義資產模型的警示 AWS 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`