Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachen Sie Daten mit Alarmen AWS IoT SiteWise
Sie können Alarme für Ihre Daten konfigurieren, um Ihr Team zu benachrichtigen, wenn Geräte oder Prozesse nicht optimal funktionieren. Optimale Leistung eines Geräts oder Prozesses bedeutet, dass die Werte für bestimmte Metriken innerhalb des Bereichs zwischen einem unteren und einem oberen Grenzwert liegen sollten. Wenn diese Metriken außerhalb ihres Betriebsbereichs liegen, müssen Gerätebediener benachrichtigt werden, damit sie das Problem beheben können. Verwenden Sie Alarme, um Probleme schnell zu erkennen und die Bediener zu benachrichtigen, um die Leistung Ihrer Geräte und Prozesse zu maximieren.
**Topics**
+ [Arten von Alarmen](#alarm-types)
+ [Alarmzustände](#alarm-states)
+ [Eigenschaften des Alarmstatus](#alarm-state-properties)
+ [Definieren Sie Alarme für Asset-Modelle in AWS IoT SiteWise](define-alarms.md)
+ [Konfigurieren Sie Alarme für Anlagen in AWS IoT SiteWise](configure-alarms.md)
+ [Reagieren Sie auf Alarme in AWS IoT SiteWise](respond-to-alarms.md)
+ [Erfassen Sie einen externen Alarmstatus in AWS IoT SiteWise](ingest-external-alarm-state.md)
## Arten von Alarmen
Sie können Alarme definieren, die in der AWS Cloud erkannt werden, und Alarme, die Sie bei externen Prozessen erkennen. AWS IoT SiteWise unterstützt die folgenden Arten von Alarmen:
+ **AWS IoT Events Alarme**
**Anmerkung**
Hinweis zum Ende des Supports: Der Support für AWS wurde beendet AWS IoT Events. Weitere Informationen finden Sie unter [AWS IoT Events Ende des Supports](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
AWS IoT Events Alarme sind Alarme, die eintreffen AWS IoT Events. AWS IoT SiteWise sendet Eigenschaftswerte einer Anlage an ein Alarmmodell in AWS IoT Events. AWS IoT Events Sendet dann den Alarmstatus an AWS IoT SiteWise. Sie können Optionen konfigurieren, z. B. wann der Alarm erkannt wird und wen benachrichtigt werden soll, wenn sich der Alarmstatus ändert. Sie können auch die [AWS IoT Events Aktionen definieren, die ausgeführt](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html) werden, wenn sich der Alarmstatus ändert.
Alarme in AWS IoT Events sind Instanzen von Alarmmodellen. Das Alarmmodell spezifiziert den Schwellenwert und den Schweregrad des Alarms, was zu tun ist, wenn sich der Alarmstatus ändert, und vieles mehr. Wenn Sie jedes Merkmal des Alarmmodells konfigurieren, geben Sie eine Attributeigenschaft aus dem Asset-Modell an, das der Alarm überwacht. Alle auf dem Asset-Modell basierenden Assets verwenden den Wert des Attributs, wenn sie dieses AWS IoT Events Merkmal des Alarms auswerten. Weitere Informationen finden Sie unter [Verwenden von Alarmen](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-alarms.html) im *AWS IoT Events Entwicklerhandbuch*.
Sie können auf einen AWS IoT Events Alarm reagieren, wenn er seinen Status ändert. Sie können beispielsweise einen Alarm bestätigen oder die Schlummerfunktion deaktivieren, wenn er aktiv wird. Sie können Alarme auch aktivieren, deaktivieren und zurücksetzen.
SiteWise Monitor-Benutzer können AWS IoT Events Alarme in SiteWise Monitor-Portalen visualisieren, konfigurieren und darauf reagieren. Weitere Informationen finden Sie unter [Überwachung mit Alarmen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/monitor-alarms.html) im *AWS IoT SiteWise Monitor Anwendungsleitfaden*.
**Anmerkung**
AWS IoT Events Für die Auswertung dieser Alarme und die Übertragung von Daten zwischen AWS IoT SiteWise und fallen Gebühren an AWS IoT Events. Weitere Informationen finden Sie unter [AWS IoT Events Preise](https://aws.amazon.com/iot-events/pricing/).
+ **Externe Alarme**
Externe Alarme sind Alarme, die Sie außerhalb auswerten AWS IoT SiteWise. Verwenden Sie externe Alarme, wenn Sie über eine Datenquelle verfügen, die den Alarmstatus meldet. Der externe Alarm enthält eine Messeigenschaft, in die Sie die Alarmzustandsdaten aufnehmen.
Sie können einen externen Alarm nicht bestätigen oder in den Schlummermodus versetzen, wenn er seinen Status ändert.
SiteWise Monitor-Benutzer können den Status externer Alarme in SiteWise Monitor-Portalen sehen, sie können diese Alarme jedoch nicht konfigurieren oder darauf reagieren.
AWS IoT SiteWise bewertet den Status externer Alarme nicht.
## Alarmzustände
Industriealarme enthalten Informationen über den Zustand der Geräte oder Prozesse, die sie überwachen, und (optional) Informationen über die Reaktion des Bedieners auf den Alarmzustand.
Wenn Sie einen AWS IoT Events Alarm definieren, geben Sie an, ob der *Bestätigungsfluss* aktiviert werden soll oder nicht. Der Bestätigungsfluss ist standardmäßig aktiviert. Wenn Sie diese Option aktivieren, können die Bediener den Alarm bestätigen und eine Notiz mit Einzelheiten zum Alarm oder zu den Maßnahmen hinterlassen, die sie zu seiner Behebung ergriffen haben. Wenn ein Bediener einen aktiven Alarm nicht bestätigt, bevor er inaktiv wird, wird der Alarm gesperrt. Der verriegelte Zustand bedeutet, dass der Alarm aktiv wurde und nicht bestätigt wurde. Der Bediener muss also die Ausrüstung oder den Prozess überprüfen und den eingeschalteten Alarm bestätigen.
Alarme haben die folgenden Zustände:
+ **Normal** (`Normal`) — Der Alarm ist aktiviert, aber inaktiv. Der industrielle Prozess oder die industrielle Ausrüstung funktioniert erwartungsgemäß.
+ **Aktiv** (`Active`) — Der Alarm ist aktiv. Der industrielle Prozess oder die industrielle Ausrüstung befindet sich außerhalb des Betriebsbereichs und erfordert besondere Aufmerksamkeit.
+ **Bestätigt** (`Acknowledged`) — Ein Bediener hat den Zustand des Alarms bestätigt.
Dieser Status gilt nur für Alarme, bei denen Sie den Bestätigungsfluss aktivieren.
+ **Eingeschaltet** (`Latched`) — Der Alarm wurde wieder normal, war aber aktiv und kein Bediener hat ihn bestätigt. Der industrielle Prozess oder die industrielle Ausrüstung erfordert die Aufmerksamkeit eines Bedieners, um den Alarm wieder in den Normalzustand zu versetzen.
Dieser Status gilt nur für Alarme, bei denen Sie den Bestätigungsfluss aktivieren.
+ **Snoozed** (`SnoozeDisabled`) — Der Alarm ist deaktiviert, weil ein Bediener den Alarm ausgeschaltet hat. Der Operator definiert die Dauer, für die der Alarm in den Schlummermodus versetzt wird. Nach dieser Dauer kehrt der Alarm in den Normalzustand zurück.
+ **Deaktiviert** (`Disabled`) — Der Alarm ist deaktiviert und wird nicht erkannt.
## Eigenschaften des Alarmstatus
AWS IoT SiteWise speichert Alarmzustandsdaten als JSON-Objekt, das in eine Zeichenfolge serialisiert ist. Dieses Objekt enthält den Status und zusätzliche Informationen über den Alarm, z. B. Aktionen zur Reaktion des Bedieners und die Regel, die der Alarm auswertet.
Sie identifizieren die Alarmstatuseigenschaft anhand ihres Namens und Strukturtyps,`AWS/ALARM_STATE`. Weitere Informationen finden Sie unter [Definieren Sie Alarme für Asset-Modelle in AWS IoT SiteWise](define-alarms.md).
Das Datenobjekt für den Alarmstatus enthält die folgenden Informationen:
`stateName`
Der Zustand des Alarms. Weitere Informationen finden Sie unter [Alarmzustände](#alarm-states).
Datentyp: `STRING`
`customerAction`
(Optional) Ein Objekt, das Informationen über die Reaktion eines Bedieners auf den Alarm enthält. Bediener können Alarme aktivieren, deaktivieren, bestätigen und die Schlummerfunktion aktivieren. Wenn sie dies tun, umfassen die Daten zum Alarmstatus ihre Reaktion und den Hinweis, den sie hinterlassen können, wenn sie reagieren. Dieses Objekt enthält die folgenden Informationen:
`actionName`
Der Name der Aktion, die der Bediener ergreift, um auf den Alarm zu reagieren. Dieser Wert enthält eine der folgenden Zeichenketten:
+ `ENABLE`
+ `DISABLE`
+ `SNOOZE`
+ `ACKNOWLEDGE`
+ `RESET`
Datentyp: `STRING`
`enable`
(Optional) Ein Objekt, das vorhanden ist, `customerAction` wenn der Bediener den Alarm aktiviert. Wenn ein Bediener den Alarm aktiviert, wechselt der Alarmstatus zu`Normal`. Dieses Objekt enthält die folgenden Informationen:
`note`
(Optional) Die Notiz, die der Kunde hinterlässt, wenn er den Alarm aktiviert.
Datentyp: `STRING`
Maximale Länge: 128 Zeichen
`disable`
(Optional) Ein Objekt, das vorhanden ist, `customerAction` wenn der Bediener den Alarm deaktiviert. Wenn ein Bediener den Alarm aktiviert, wechselt der Alarmstatus zu`Disabled`. Dieses Objekt enthält die folgenden Informationen:
`note`
(Optional) Die Notiz, die der Kunde hinterlässt, wenn er den Alarm deaktiviert.
Datentyp: `STRING`
Maximale Länge: 128 Zeichen
`acknowledge`
(Optional) Ein Objekt, das vorhanden ist, `customerAction` wenn der Bediener den Alarm bestätigt. Wenn ein Bediener den Alarm aktiviert, wechselt der Alarmstatus zu`Acknowledged`. Dieses Objekt enthält die folgenden Informationen:
`note`
(Optional) Die Notiz, die der Kunde hinterlässt, wenn er den Alarm bestätigt.
Datentyp: `STRING`
Maximale Länge: 128 Zeichen
`snooze`
(Optional) Ein Objekt, das vorhanden ist, `customerAction` wenn der Bediener den Alarm in den Schlummermodus versetzt. Wenn ein Bediener den Alarm aktiviert, wechselt der Alarmstatus zu. `SnoozeDisabled` Dieses Objekt enthält die folgenden Informationen:
`snoozeDuration`
Die Dauer in Sekunden, für die der Bediener den Alarm aktiviert. Nach Ablauf dieser Dauer wechselt der Alarm in `Normal` den Status.
Datentyp: `INTEGER`
`note`
(Optional) Die Notiz, die der Kunde hinterlässt, wenn er den Alarm aktiviert.
Datentyp: `STRING`
Maximale Länge: 128 Zeichen
`ruleEvaluation`
(Optional) Ein Objekt, das Informationen über die Regel enthält, die den Alarm auswertet. Dieses Objekt enthält die folgenden Informationen:
`simpleRule`
Ein Objekt, das Informationen über eine einfache Regel enthält, die einen Eigenschaftswert mit einem Schwellenwert anhand eines Vergleichsoperators vergleicht. Dieses Objekt enthält die folgenden Informationen:
`inputProperty`
Der Wert der Eigenschaft, die dieser Alarm auswertet.
Datentyp: `DOUBLE`
`operator`
Der Vergleichsoperator, den dieser Alarm verwendet, um die Eigenschaft mit dem Schwellenwert zu vergleichen. Dieser Wert enthält eine der folgenden Zeichenketten:
+ `<`— Weniger als
+ `<=`— Weniger als oder gleich
+ `==`— Gleich
+ `!=`— Nicht gleich
+ `>=`— Größer als oder gleich
+ `>`— Größer als
Datentyp: `STRING`
`threshold`
Der Schwellenwert, mit dem dieser Alarm den Eigenschaftswert vergleicht.
Datentyp: `DOUBLE`
# Definieren Sie Alarme für Asset-Modelle in AWS IoT SiteWise
Anlagenmodelle fördern die Standardisierung Ihrer industriellen Daten und Alarme. Sie können Alarmdefinitionen für Anlagenmodelle definieren, um die Alarme für alle Anlagen auf der Grundlage eines Anlagenmodells zu standardisieren.
Sie verwenden *zusammengesetzte Asset-Modelle*, um Alarme für Asset-Modelle zu definieren. Bei zusammengesetzten Anlagenmodellen handelt es sich um Anlagenmodelle, die einen bestimmten Satz von Eigenschaften auf ein anderes Anlagenmodell standardisieren. Zusammengesetzte Anlagemodelle stellen sicher, dass bestimmte Eigenschaften in einem Anlagemodell vorhanden sind. Alarme verfügen über Typ-, Status- und (optionale) Quelleneigenschaften, sodass das zusammengesetzte Alarmmodell erzwingt, dass diese Eigenschaften vorhanden sind.
Jedes zusammengesetzte Objektmodell hat einen Typ, der die Eigenschaften für dieses zusammengesetzte Modell definiert. Verbundmodelle für Alarme definieren Eigenschaften für den Alarmtyp, den Alarmstatus und die (optionale) Alarmquelle. Wenn Sie ein Asset aus einem Asset-Modell mit zusammengesetzten Modellen erstellen, enthält das Asset neben den Eigenschaften, die Sie im Asset-Modell angeben, auch die Eigenschaften aus dem Verbundmodell.
Jede Eigenschaft in einem zusammengesetzten Modell muss den Namen haben, der sie für ihren Typ des zusammengesetzten Modells kennzeichnet. Die Eigenschaften eines zusammengesetzten Modells unterstützen Eigenschaften mit komplexen Datentypen. Diese Eigenschaften haben den `STRUCT` Datentyp und ein `dataTypeSpec` Merkmal, das den komplexen Datentyp der Eigenschaft angibt. Eigenschaften komplexer Datentypen enthalten JSON-Daten, die als Zeichenfolgen serialisiert sind.
Verbundmodelle von Alarmen haben die folgenden Eigenschaften. Jede Eigenschaft muss den Namen haben, der sie für diesen Typ von Verbundmodell identifiziert.
**Typ des Alarms**
Der Typ des Alarms. Geben Sie eines der folgenden Elemente an:
+ `IOT_EVENTS`— Ein AWS IoT Events Alarm. AWS IoT SiteWise sendet Daten an, AWS IoT Events um den Status dieses Alarms auszuwerten. Sie müssen die Eigenschaft Alarmquelle angeben, um das AWS IoT Events Alarmmodell für diese Alarmdefinition zu definieren.
**Anmerkung**
Hinweis zum Ende des Supports: Der Support für AWS wurde eingestellt AWS IoT Events. Weitere Informationen finden Sie unter [AWS IoT Events Ende des Supports](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
+ `EXTERNAL`— Ein externer Alarm. Sie nehmen den Zustand des Alarms als Messwert auf.
Name der Immobilie: `AWS/ALARM_TYPE`
Art der Immobilie: [Attribut](attributes.md)
Datentyp: `STRING`
**Zustand des Alarms**
Die Zeitreihendaten für den Status des Alarms. Dies ist ein als Zeichenfolge serialisiertes Objekt, das den Status und andere Informationen über den Alarm enthält. Weitere Informationen finden Sie unter [Eigenschaften des Alarmstatus](industrial-alarms.md#alarm-state-properties).
Name der Immobilie: `AWS/ALARM_STATE`
Art der Immobilie: [Messung](measurements.md)
Datentyp: `STRUCT`
Typ der Datenstruktur: `AWS/ALARM_STATE`
**Quelle des Alarms**
(Optional) Der Amazon-Ressourcenname (ARN) der Ressource, die den Status des Alarms auswertet. Für AWS IoT Events Alarme ist dies der ARN des Alarmmodells.
Name der Immobilie: `AWS/ALARM_SOURCE`
Art der Immobilie: [Attribut](attributes.md)
Datentyp: `STRING`
**Example Beispiel für ein zusammengesetztes Alarmmodell**
Das folgende Anlagenmodell stellt einen Kessel dar, dessen Temperatur über einen Alarm überwacht wird. AWS IoT SiteWise sendet die Temperaturdaten an, AWS IoT Events um den Alarm zu erkennen.
```
{
"assetModelName": "Boiler",
"assetModelDescription": "A boiler that alarms when its temperature exceeds its limit.",
"assetModelProperties": [
{
"name": "Temperature",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"measurement": {}
}
},
{
"name": "High Temperature",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
}
],
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
},
{
"name": "AWS/ALARM_SOURCE",
"dataType": "STRING",
"type": {
"attribute": {}
}
}
]
}
]
}
```
**Topics**
+ [Anforderungen für Alarmmeldungen in AWS IoT SiteWise](iot-events-alarm-notification-requirements.md)
+ [Definieren Sie AWS IoT Events Alarme für AWS IoT SiteWise](define-iot-events-alarms.md)
+ [Definieren Sie externe Alarme in AWS IoT SiteWise](define-external-alarms.md)
# Anforderungen für Alarmmeldungen in AWS IoT SiteWise
AWS IoT Events verwendet eine AWS Lambda Funktion in Ihrem AWS Konto, um Alarmbenachrichtigungen zu senden. Sie müssen diese Lambda-Funktion in derselben AWS Region wie Ihre Alarme erstellen, um Alarmbenachrichtigungen zu aktivieren. Diese Lambda-Funktion verwendet [Amazon Simple Notification Service (Amazon SNS)](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) zum Senden von Textbenachrichtigungen und [Amazon Simple Email Service (Amazon SES)](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html) zum Senden von E-Mail-Benachrichtigungen. Wenn Sie den AWS IoT Events Alarm erstellen, konfigurieren Sie die Protokolle und Einstellungen, die der Alarm zum Senden von Benachrichtigungen verwendet.
**Anmerkung**
Hinweis zum Ende des Supports: Der Support für AWS wurde beendet AWS IoT Events. Weitere Informationen finden Sie unter [AWS IoT Events Ende des Supports](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
AWS IoT Events stellt eine AWS CloudFormation Stack-Vorlage bereit, mit der Sie diese Lambda-Funktion in Ihrem Konto erstellen können. Weitere Informationen finden Sie unter [Lambda-Funktion für Alarmbenachrichtigungen](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) im *AWS IoT Events Entwicklerhandbuch*.
# Definieren Sie AWS IoT Events Alarme für AWS IoT SiteWise
**Anmerkung**
Hinweis zum Ende des Supports: Der Support für AWS wurde beendet AWS IoT Events. Weitere Informationen finden Sie unter [AWS IoT Events Ende des Supports](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
Wenn Sie einen AWS IoT Events Alarm erstellen, AWS IoT SiteWise sendet die Eigenschaftswerte der Anlage an AWS IoT Events , um den Status des Alarms auszuwerten. AWS IoT Events Alarmdefinitionen hängen von einem Alarmmodell ab, in dem Sie sie definieren AWS IoT Events. Um einen AWS IoT Events Alarm anhand eines Anlagenmodells zu definieren, definieren Sie ein zusammengesetztes Alarmmodell, das das AWS IoT Events Alarmmodell als Alarmquelleneigenschaft angibt.
AWS IoT Events Alarme hängen von Eingaben wie Alarmschwellenwerten und Einstellungen für Alarmbenachrichtigungen ab. Sie definieren diese Eingaben als Attribute im Asset-Modell. Sie können diese Eingaben dann für jedes Asset auf der Grundlage des Modells anpassen. Die AWS IoT SiteWise Konsole kann diese Attribute für Sie erstellen. Wenn Sie Alarme mit der API AWS CLI oder definieren, müssen Sie diese Attribute im Asset-Modell manuell definieren.
Sie können auch andere Aktionen definieren, die ausgeführt werden, wenn Ihr Alarm erkannt wird, z. B. benutzerdefinierte Aktionen für Alarmbenachrichtigungen. Sie können beispielsweise eine Aktion konfigurieren, die eine Push-Benachrichtigung an ein Amazon SNS SNS-Thema sendet. Weitere Informationen zu den Aktionen, die Sie definieren können, finden Sie unter [Arbeiten mit anderen AWS Diensten](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-other-aws-services.html) im *AWS IoT Events Entwicklerhandbuch*.
Wenn Sie ein Asset-Modell aktualisieren oder löschen, AWS IoT SiteWise kann überprüft werden, ob ein Alarmmodell eine mit diesem Asset-Modell verknüpfte Anlageneigenschaft überwacht. AWS IoT Events Dadurch wird verhindert, dass Sie eine Anlageneigenschaft löschen, die derzeit von einem AWS IoT Events Alarm verwendet wird. Um diese Funktion in zu aktivieren AWS IoT SiteWise, benötigen Sie die `iotevents:ListInputRoutings` entsprechende Genehmigung. Diese Berechtigung AWS IoT SiteWise ermöglicht Aufrufe des [ListInputRoutings](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListInputRoutings.html)API-Vorgangs, der von unterstützt wird AWS IoT Events. Weitere Informationen finden Sie unter [(Optionale) ListInputRoutings Erlaubnis](alarms-iam-permissions.md#alarms-listInputRoutings-permissions).
**Anmerkung**
Die Funktion für Alarmbenachrichtigungen ist in der Region China (Peking) nicht verfügbar.
**Topics**
+ [Definieren Sie einen AWS IoT Events Alarm (AWS IoT SiteWise Konsole)](#define-iot-events-alarm-console)
+ [Definieren Sie einen AWS IoT Events Alarm (AWS IoT Events Konsole)](#define-iot-events-alarm-console-ite-console)
+ [Definieren Sie einen AWS IoT Events Alarm (AWS CLI)](#define-iot-events-alarm-cli)
## Definieren Sie einen AWS IoT Events Alarm (AWS IoT SiteWise Konsole)
Sie können die AWS IoT SiteWise Konsole verwenden, um einen AWS IoT Events Alarm für ein vorhandenes Anlagenmodell zu definieren. Um einen AWS IoT Events Alarm für ein neues Asset-Modell zu definieren, erstellen Sie das Asset-Modell und führen Sie dann diese Schritte aus. Weitere Informationen finden Sie unter [Erstellen Sie Asset-Modelle in AWS IoT SiteWise](create-asset-models.md).
**Wichtig**
Für jeden Alarm ist ein Attribut erforderlich, das den Schwellenwert angibt, mit dem für den Alarm verglichen werden soll. Sie müssen das Schwellenwertattribut im Asset-Modell definieren, bevor Sie einen Alarm definieren können.
Stellen Sie sich ein Beispiel vor, bei dem Sie einen Alarm definieren möchten, der erkennt, wenn eine Windkraftanlage ihre maximale Nennwindgeschwindigkeit von 50 mph überschreitet. Bevor Sie den Alarm definieren, müssen Sie ein Attribut (**Maximale Windgeschwindigkeit**) mit dem Standardwert definieren`50`.
**Um einen AWS IoT Events Alarm für ein Asset-Modell zu definieren**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Klicken Sie im Navigationsbereich auf **Models (Modelle)**.
1. Wählen Sie das Asset-Modell aus, für das Sie einen Alarm definieren möchten.
1. Wählen Sie die Registerkarte **Alarm**.
1. Wählen **Sie Alarm hinzufügen**.
1. Wählen Sie im Bereich **Optionen für den Alarmtyp** die Option **AWS IoT Events Alarm** aus.
1. Gehen Sie im Abschnitt **Alarmdetails** wie folgt vor:
1. Geben Sie einen Namen für den Alarm ein.
1. (Optional) Geben Sie eine Beschreibung für Ihren Alarm ein.
1. Im Abschnitt **Schwellenwertdefinitionen** legen Sie fest, wann der Alarm erkannt wird und wie schwerwiegend der Alarm ist. Gehen Sie wie folgt vor:
1. Wählen Sie die **Eigenschaft** aus, bei der der Alarm erkannt wird. Jedes Mal, wenn diese Eigenschaft einen neuen Wert erhält, wird der Wert AWS IoT SiteWise an gesendet, AWS IoT Events um den Status des Alarms auszuwerten.
1. Wählen Sie den **Operator** aus, der verwendet werden soll, um die Eigenschaft mit dem Schwellenwert zu vergleichen. Wählen Sie aus den folgenden Optionen aus:
+ **< weniger als**
+ **<= kleiner als oder gleich**
+ **== gleich**
+ **\$1 = nicht gleich**
+ **>= größer als oder gleich**
+ **> größer als**
1. Wählen Sie **unter Wert** die Attributeigenschaft aus, die als Schwellenwert verwendet werden soll. AWS IoT Events vergleicht den Wert der Eigenschaft mit dem Wert dieses Attributs.
1. Geben Sie den **Schweregrad** des Alarms ein. Verwenden Sie eine Zahl, die Ihr Team versteht, um den Schweregrad dieses Alarms wiederzugeben.
1. (Optional) Gehen Sie im Abschnitt **Benachrichtigungseinstellungen — *optional*** wie folgt vor:
1. Wählen Sie **Aktiv**.
**Anmerkung**
Wenn Sie **Inaktiv** wählen, erhalten Sie und Ihr Team keine Alarmbenachrichtigungen.
1. Wählen Sie unter **Empfänger** den Empfänger aus.
**Wichtig**
Sie können Alarmbenachrichtigungen an AWS IAM Identity Center Benutzer senden. Um diese Funktion nutzen zu können, müssen Sie IAM Identity Center aktivieren. Sie können IAM Identity Center jeweils nur in einer AWS Region aktivieren. Das bedeutet, dass Sie Alarmbenachrichtigungen nur in der Region definieren können, in der Sie IAM Identity Center aktivieren. Weitere Informationen finden Sie unter [Erste Schritte](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) im *AWS IAM Identity Center -Benutzerhandbuch*.
1. Wählen Sie **unter Protokoll** eine der folgenden Optionen aus:
+ **E-Mail und Text** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer SMS-Nachricht und einer E-Mail-Nachricht.
+ **E-Mail** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer E-Mail-Nachricht.
+ **Text** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer SMS-Nachricht.
1. Wählen Sie unter **Absender den Absender** aus.
**Wichtig**
Sie müssen die Absender-E-Mail-Adresse in Amazon Simple Email Service (Amazon SES) verifizieren. Weitere Informationen finden Sie unter [Verifizieren der Identität einer E-Mail-Adresse](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-email-proc) im *Amazon Simple Email Service Developer Guide*.
1. Im Abschnitt **Standard-Asset-Status** können Sie den Standardstatus für Alarme festlegen, die mit diesem Asset-Modell erstellt wurden.
**Anmerkung**
Sie aktivieren oder deaktivieren diesen Alarm für Assets, die Sie in einem späteren Schritt anhand dieses Asset-Modells erstellen.
1. Im Bereich **Erweiterte Einstellungen** können Sie die Berechtigungen, die zusätzlichen Benachrichtigungseinstellungen, die Alarmstatusaktionen, das Alarmmodell in SiteWise Monitor und den Bestätigungsablauf konfigurieren.
**Anmerkung**
AWS IoT Events Für Alarme sind die folgenden Servicerollen erforderlich:
Eine Rolle, die AWS IoT Events davon ausgeht, Alarmstatuswerte an zu senden AWS IoT SiteWise.
Eine Rolle, die AWS IoT Events davon ausgeht, Daten an Lambda zu senden. Sie benötigen diese Rolle nur, wenn Ihr Alarm Benachrichtigungen sendet.
Gehen Sie im Abschnitt **Berechtigungen** wie folgt vor:
1. Verwenden Sie als **AWS IoT Events Rolle** eine vorhandene Rolle oder erstellen Sie eine Rolle mit den erforderlichen Berechtigungen. Diese Rolle erfordert die `iotsitewise:BatchPutAssetPropertyValue` Erlaubnis und eine Vertrauensbeziehung, die es iotevents.amazonaws.com ermöglicht, die Rolle zu übernehmen.
1. Verwenden Sie für die **AWS IoT Events Lambda-Rolle** eine vorhandene Rolle oder erstellen Sie eine Rolle mit den erforderlichen Berechtigungen. Für diese Rolle sind die `sso-directory:DescribeUser` Berechtigungen `lambda:InvokeFunction` und sowie eine Vertrauensbeziehung erforderlich, die es ermöglicht, die Rolle `iotevents.amazonaws.com` zu übernehmen.
1. (Optional) Gehen Sie im Abschnitt **Zusätzliche Benachrichtigungseinstellungen** wie folgt vor:
1. Für **das Empfängerattribut** definieren Sie ein Attribut, dessen Wert den Empfänger der Benachrichtigung angibt. Sie können IAM Identity Center-Benutzer als Empfänger auswählen.
Sie können ein Attribut erstellen oder ein vorhandenes Attribut im Asset-Modell verwenden.
+ Wenn Sie **Neues Empfängerattribut erstellen** wählen, geben Sie den **Namen des Empfängerattributs** und den **Standardwert Empfänger an — **optional**** für das Attribut.
+ Wenn Sie **Bestehendes Empfängerattribut verwenden** wählen, wählen Sie das Attribut im Feld **Name des Empfängerattributs** aus. Der Alarm verwendet den Standardwert des von Ihnen ausgewählten Attributs.
Sie können den Standardwert für jedes Asset, das Sie anhand dieses Asset-Modells erstellen, überschreiben.
1. Für das **benutzerdefinierte Nachrichtenattribut** definieren Sie ein Attribut, dessen Wert die benutzerdefinierte Nachricht angibt, die zusätzlich zur Standardnachricht zur Statusänderung gesendet werden soll. Sie können beispielsweise eine Nachricht angeben, die Ihrem Team hilft, zu verstehen, wie mit diesem Alarm umgegangen werden kann.
Sie können wählen, ob Sie ein Attribut erstellen oder ein vorhandenes Attribut im Asset-Modell verwenden möchten.
+ Wenn Sie **ein neues benutzerdefiniertes Nachrichtenattribut erstellen** möchten, geben Sie den **Namen des benutzerdefinierten Nachrichtenattributs** und den **Standardwert für benutzerdefinierte Nachricht an — *optional*** für das Attribut.
+ Wenn Sie **Ein vorhandenes benutzerdefiniertes Nachrichtenattribut verwenden** wählen, wählen Sie das Attribut unter **Name des benutzerdefinierten Nachrichtenattributs** aus. Der Alarm verwendet den Standardwert des von Ihnen ausgewählten Attributs.
Sie können den Standardwert für jedes Asset, das Sie anhand dieses Asset-Modells erstellen, überschreiben.
1. Führen Sie für **Manage your Lambda function** einen der folgenden Schritte aus:
+ Um eine neue Lambda-Funktion AWS IoT SiteWise erstellen zu lassen, wählen Sie **Create a new lambda from an AWS managed template**.
+ Um eine bestehende Lambda-Funktion zu **verwenden, wählen Sie Use an existing lambda** und wählen Sie den Namen der Funktion.
Weitere Informationen finden Sie unter [Verwaltung von Alarmbenachrichtigungen](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) im *AWS IoT Events Entwicklerhandbuch*.
1. (Optional) Gehen **Sie im Abschnitt Statusaktion festlegen** wie folgt vor:
1. Wählen Sie **Aktion bearbeiten** aus.
1. **Fügen Sie unter Aktionen zum Alarmstatus** **hinzufügen die Aktionen hinzu und wählen Sie dann Speichern aus.**
Sie können bis zu 10 Aktionen hinzufügen.
AWS IoT Events kann Aktionen ausführen, wenn der Alarm aktiv ist. Sie können integrierte Aktionen definieren, um einen Timer zu verwenden oder eine Variable festzulegen oder Daten an andere AWS Ressourcen zu senden. Weitere Informationen finden Sie im *AWS IoT Events Entwicklerhandbuch* unter [Unterstützte Aktionen](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html).
1. (Optional) Wählen **Sie unter Alarmmodell im SiteWise Monitor verwalten — *optional*** die Option **Aktiv** oder **Inaktiv** aus.
Verwenden Sie diese Option, damit Sie das Alarmmodell in SiteWise Monitoren aktualisieren können. Diese Option ist standardmäßig aktiviert.
1. **Wählen Sie unter **Acknowledge-Flow** die Option **Aktiv oder Inaktiv** aus.** Weitere Informationen zum Bestätigungsablauf finden Sie unter[Alarmzustände](industrial-alarms.md#alarm-states).
1. Wählen Sie „**Alarm hinzufügen**“.
**Anmerkung**
Die AWS IoT SiteWise Konsole stellt mehrere API-Anfragen, um den Alarm zum Asset-Modell hinzuzufügen. Wenn Sie **Alarm hinzufügen** wählen, öffnet die Konsole ein Dialogfeld, in dem der Status dieser API-Anfragen angezeigt wird. Bleiben Sie auf dieser Seite, bis jede API-Anfrage erfolgreich ist oder bis eine API-Anfrage fehlschlägt. Wenn eine Anfrage fehlschlägt, schließen Sie das Dialogfeld, beheben Sie das Problem und wählen Sie **Alarm hinzufügen**, um es erneut zu versuchen.
## Definieren Sie einen AWS IoT Events Alarm (AWS IoT Events Konsole)
Sie können die AWS IoT Events Konsole verwenden, um einen AWS IoT Events Alarm für ein vorhandenes Anlagenmodell zu definieren. Um einen AWS IoT Events Alarm für ein neues Asset-Modell zu definieren, erstellen Sie das Asset-Modell und führen Sie dann diese Schritte aus. Weitere Informationen finden Sie unter [Erstellen Sie Asset-Modelle in AWS IoT SiteWise](create-asset-models.md).
**Wichtig**
Für jeden Alarm ist ein Attribut erforderlich, das den Schwellenwert angibt, mit dem für den Alarm verglichen werden soll. Sie müssen das Schwellenwertattribut im Asset-Modell definieren, bevor Sie einen Alarm definieren können.
Stellen Sie sich ein Beispiel vor, bei dem Sie einen Alarm definieren möchten, der erkennt, wenn eine Windkraftanlage ihre maximale Nennwindgeschwindigkeit von 50 mph überschreitet. Bevor Sie den Alarm definieren, müssen Sie ein Attribut (**Maximale Windgeschwindigkeit**) mit dem Standardwert definieren`50`.
**Um einen AWS IoT Events Alarm für ein Asset-Modell zu definieren**
1. Navigieren Sie zur [AWS IoT Events -Konsole](https://console.aws.amazon.com/iotevents/).
1. Wählen Sie im Navigationsbereich die Option **Alarmmodelle** aus.
1. Wählen Sie **Alarmmodell erstellen** aus.
1. Geben Sie einen Namen für den Alarm ein.
1. (Optional) Geben Sie eine Beschreibung für Ihren Alarm ein.
1. Gehen Sie im Bereich **Alarmziel** wie folgt vor:
1. Wählen Sie **unter Zieloptionen** die Option **AWS IoT SiteWise Asset-Eigenschaft** aus.
1. Wählen Sie das Asset-Modell aus, für das Sie den Alarm hinzufügen möchten.
1. Im Abschnitt **Schwellenwertdefinitionen** legen Sie fest, wann der Alarm erkannt wird und wie schwerwiegend der Alarm ist. Gehen Sie wie folgt vor:
1. Wählen Sie die **Eigenschaft** aus, bei der der Alarm erkannt wird. Jedes Mal, wenn diese Eigenschaft einen neuen Wert erhält, wird der Wert AWS IoT SiteWise an gesendet, AWS IoT Events um den Status des Alarms auszuwerten.
1. Wählen Sie den **Operator** aus, der verwendet werden soll, um die Eigenschaft mit dem Schwellenwert zu vergleichen. Wählen Sie aus den folgenden Optionen aus:
+ **< weniger als**
+ **<= kleiner als oder gleich**
+ **== gleich**
+ **\$1 = nicht gleich**
+ **>= größer als oder gleich**
+ **> größer als**
1. Wählen Sie **unter Wert** die Attributeigenschaft aus, die als Schwellenwert verwendet werden soll. AWS IoT Events vergleicht den Wert der Eigenschaft mit dem Wert dieses Attributs.
1. Geben Sie den **Schweregrad** des Alarms ein. Verwenden Sie eine Zahl, die Ihr Team versteht, um den Schweregrad dieses Alarms wiederzugeben.
1. (Optional) Gehen Sie im Abschnitt **Benachrichtigungseinstellungen — *optional*** wie folgt vor:
1. Wählen Sie unter **Protokoll** eine der folgenden Optionen aus:
+ **E-Mail und Text** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer SMS-Nachricht und einer E-Mail-Nachricht.
+ **E-Mail** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer E-Mail-Nachricht.
+ **Text** — Der Alarm benachrichtigt IAM Identity Center-Benutzer mit einer SMS-Nachricht.
1. Wählen Sie unter **Absender den Absender** aus.
**Wichtig**
Sie müssen die Absender-E-Mail-Adresse in Amazon Simple Email Service (Amazon SES) verifizieren. Weitere Informationen finden Sie unter [Verifizieren von E-Mail-Adressen in Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) im *Amazon Simple Email Service Developer Guide*.
1. Wählen Sie das Attribut unter **Empfängerattribut — *optional*** aus. Der Alarm verwendet den Standardwert des von Ihnen ausgewählten Attributs.
1. Wählen Sie das Attribut unter **Benutzerdefiniertes Nachrichtenattribut — *optional*** aus. Der Alarm verwendet den Standardwert des von Ihnen ausgewählten Attributs.
1. Geben Sie im Abschnitt **Instanz** den **Standardstatus** für diesen Alarm an. Sie können diesen Alarm in einem späteren Schritt für alle Assets aktivieren oder deaktivieren, die Sie anhand dieses Asset-Modells erstellen.
1. In den **erweiterten Einstellungen** können Sie die Berechtigungen, die zusätzlichen Benachrichtigungseinstellungen, die Alarmstatusaktionen, das Alarmmodell in SiteWise Monitor und den Bestätigungsablauf konfigurieren.
**Anmerkung**
AWS IoT Events Für Alarme sind die folgenden Servicerollen erforderlich:
Eine Rolle, die AWS IoT Events davon ausgeht, Alarmstatuswerte an zu senden AWS IoT SiteWise.
Eine Rolle, die AWS IoT Events davon ausgeht, Daten an Lambda zu senden. Sie benötigen diese Rolle nur, wenn Ihr Alarm Benachrichtigungen sendet.
1. Wählen Sie im **Abschnitt Bestätigungsablauf** die Option **Aktiviert oder **Deaktiviert**** aus. Weitere Informationen zum Bestätigungsablauf finden Sie unter[Alarmzustände](industrial-alarms.md#alarm-states).
1. Gehen Sie im Abschnitt „**Berechtigungen**“ wie folgt vor:
1. Verwenden Sie als **AWS IoT Events Rolle** eine vorhandene Rolle oder erstellen Sie eine Rolle mit den erforderlichen Berechtigungen. Diese Rolle erfordert die `iotsitewise:BatchPutAssetPropertyValue` Erlaubnis und eine Vertrauensbeziehung, die es iotevents.amazonaws.com ermöglicht, die Rolle zu übernehmen.
1. Verwenden Sie für die **Lambda-Rolle** eine vorhandene Rolle oder erstellen Sie eine Rolle mit den erforderlichen Berechtigungen. Für diese Rolle sind die `sso-directory:DescribeUser` Berechtigungen `lambda:InvokeFunction` und sowie eine Vertrauensbeziehung erforderlich, die es ermöglicht, die Rolle `iotevents.amazonaws.com` zu übernehmen.
1. (Optional) Gehen Sie im Bereich **Zusätzliche Benachrichtigungseinstellungen** wie folgt vor:
1. Führen Sie für **Manage your Lambda function** einen der folgenden Schritte aus:
+ Um eine neue Lambda-Funktion AWS IoT Events erstellen zu lassen, wählen Sie **Create a new Lambda-Funktion**.
+ Um eine bestehende Lambda-Funktion zu **verwenden, wählen Sie Bestehende Lambda-Funktion** verwenden und wählen Sie den Namen der Funktion.
Weitere Informationen finden Sie unter [Verwaltung von Alarmbenachrichtigungen](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) im *AWS IoT Events Entwicklerhandbuch*.
1. (Optional) Gehen **Sie im Abschnitt Statusaktion festlegen — *optional*** wie folgt vor:
1. **Fügen Sie unter **Aktionen zum Alarmstatus** die Aktionen hinzu und wählen Sie dann Speichern aus.**
Sie können bis zu 10 Aktionen hinzufügen.
AWS IoT Events kann Aktionen ausführen, wenn der Alarm aktiv ist. Sie können integrierte Aktionen definieren, um einen Timer zu verwenden oder eine Variable festzulegen oder Daten an andere AWS Ressourcen zu senden. Weitere Informationen finden Sie im *AWS IoT Events Entwicklerhandbuch* unter [Unterstützte Aktionen](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html).
1. Wählen Sie **Erstellen** aus.
**Anmerkung**
Die AWS IoT Events Konsole stellt mehrere API-Anfragen, um den Alarm zum Asset-Modell hinzuzufügen. Wenn Sie **Alarm hinzufügen** wählen, öffnet die Konsole ein Dialogfeld, in dem der Status dieser API-Anfragen angezeigt wird. Bleiben Sie auf dieser Seite, bis jede API-Anfrage erfolgreich ist oder bis eine API-Anfrage fehlschlägt. Wenn eine Anfrage fehlschlägt, schließen Sie das Dialogfeld, beheben Sie das Problem und wählen Sie **Alarm hinzufügen**, um es erneut zu versuchen.
## Definieren Sie einen AWS IoT Events Alarm (AWS CLI)
Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen AWS IoT Events Alarm zu definieren, der eine Anlageneigenschaft überwacht. Sie können den Alarm für ein neues oder ein vorhandenes Asset-Modell definieren. Nachdem Sie den Alarm für das Asset-Modell definiert haben, erstellen Sie einen Alarm im Asset-Modell AWS IoT Events und verbinden ihn mit dem Asset-Modell. In diesem Prozess gehen Sie wie folgt vor:
**Topics**
+ [Schritt 1: Definieren Sie einen Alarm für ein Asset-Modell](#define-iot-events-alarm-definition-cli)
+ [Schritt 2: Definieren Sie ein Alarmmodell AWS IoT Events](#define-iot-events-alarm-model-cli)
+ [Schritt 3: Aktivieren Sie den Datenfluss zwischen AWS IoT SiteWise und AWS IoT Events](#define-iot-events-alarm-data-flow-cli)
### Schritt 1: Definieren Sie einen Alarm für ein Asset-Modell
Fügen Sie eine Alarmdefinition und zugehörige Eigenschaften zu einem neuen oder vorhandenen Anlagenmodell hinzu.
**So definieren Sie einen Alarm für ein Asset-Modell (CLI)**
1. Erstellen Sie eine Datei mit dem Namen `asset-model-payload.json`. Folgen Sie den Schritten in diesen anderen Abschnitten, um der Datei die Details Ihres Asset-Modells hinzuzufügen, reichen Sie jedoch nicht die Anfrage zur Erstellung oder Aktualisierung des Asset-Modells ein. In diesem Abschnitt fügen Sie den Asset-Modelldetails in der `asset-model-payload.json` Datei eine Alarmdefinition hinzu.
+ Weitere Informationen zum Erstellen eines Asset-Modells finden Sie unter[Erstellen Sie ein Asset-Modell (AWS CLI)](create-asset-models.md#create-asset-model-cli).
+ Weitere Informationen zum Aktualisieren eines vorhandenen Asset-Modells finden Sie unter[Aktualisieren Sie ein Objektmodell, ein Komponentenmodell oder eine Schnittstelle ()AWS CLI](update-asset-models.md#update-asset-model-cli).
**Anmerkung**
Ihr Anlagenmodell muss mindestens eine Anlageneigenschaft definieren, einschließlich der Anlageneigenschaft, die mit dem Alarm überwacht werden soll.
1. Fügen Sie dem Anlagenmodell ein zusammengesetztes Alarmmodell (`assetModelCompositeModels`) hinzu. Ein zusammengesetztes AWS IoT Events Alarmmodell spezifiziert den `IOT_EVENTS` Typ und gibt eine Alarmquelleneigenschaft an. Sie fügen die Eigenschaft Alarmquelle hinzu, nachdem Sie das Alarmmodell in erstellt haben AWS IoT Events.
**Wichtig**
Das zusammengesetzte Alarmmodell muss denselben Namen haben wie das AWS IoT Events Alarmmodell, das Sie später erstellen. Namen von Alarmmodellen dürfen nur alphanumerische Zeichen enthalten. Geben Sie einen eindeutigen, alphanumerischen Namen an, sodass Sie denselben Namen für das Alarmmodell verwenden können.
```
{
...
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
1. Fügen Sie dem Asset-Modell ein Alarmschwellenwertattribut hinzu. Geben Sie den Standardwert an, der für diesen Schwellenwert verwendet werden soll. Sie können diesen Standardwert für jedes Asset, das auf diesem Modell basiert, überschreiben.
**Anmerkung**
Das Alarmschwellenwertattribut muss ein `INTEGER` oder a sein`DOUBLE`.
```
{
...
"assetModelProperties": [
...
{
"name": "Temperature Max Threshold",
"dataType": "DOUBLE",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
}
]
}
```
1. (Optional) Fügen Sie dem Asset-Modell Attribute für Alarmbenachrichtigungen hinzu. Diese Attribute geben den IAM Identity Center-Empfänger und andere Eingaben an, die zum Senden von Benachrichtigungen AWS IoT Events verwendet werden, wenn sich der Status des Alarms ändert. Sie können diese Standardwerte für jedes Asset, das auf diesem Modell basiert, überschreiben.
**Wichtig**
Sie können Alarmbenachrichtigungen an AWS IAM Identity Center Benutzer senden. Um diese Funktion nutzen zu können, müssen Sie IAM Identity Center aktivieren. Sie können IAM Identity Center jeweils nur in einer AWS Region aktivieren. Das bedeutet, dass Sie Alarmbenachrichtigungen nur in der Region definieren können, in der Sie IAM Identity Center aktivieren. Weitere Informationen finden Sie unter [Erste Schritte](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) im *AWS IAM Identity Center -Benutzerhandbuch*.
Gehen Sie wie folgt vor:
1. Fügen Sie ein Attribut hinzu, das die ID Ihres IAM Identity Center-Identitätsspeichers angibt. Sie können den IAM Identity Center [ListInstances](https://docs.aws.amazon.com/singlesignon/latest/APIReference/API_ListInstances.html)API-Vorgang verwenden, um Ihre Identitätsspeicher aufzulisten. Dieser Vorgang funktioniert nur in der Region, in der Sie IAM Identity Center aktivieren.
```
aws sso-admin list-instances
```
Geben Sie dann die Identitätsspeicher-ID (z. B.`d-123EXAMPLE`) als Standardwert für das Attribut an.
```
{
...
"assetModelProperties": [
...
{
"name": "identityStoreId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "d-123EXAMPLE"
}
}
}
]
}
```
1. Fügen Sie ein Attribut hinzu, das die ID des IAM Identity Center-Benutzers angibt, der Benachrichtigungen erhält. Um einen Standardempfänger für Benachrichtigungen zu definieren, fügen Sie eine IAM Identity Center-Benutzer-ID als Standardwert hinzu. Gehen Sie wie folgt vor, um eine IAM Identity Center-Benutzer-ID zu erhalten:
1. Sie können die IAM Identity [ListUsers](https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_ListUsers.html)Center-API verwenden, um die ID eines Benutzers abzurufen, dessen Benutzernamen Sie kennen. *d-123EXAMPLE*Ersetzen Sie sie durch die ID Ihres Identitätsspeichers und *Name* ersetzen Sie sie durch den Benutzernamen des Benutzers.
```
aws identitystore list-users \
--identity-store-id d-123EXAMPLE \
--filters AttributePath=UserName,AttributeValue=Name
```
1. Verwenden Sie die [IAM Identity Center-Konsole](https://console.aws.amazon.com/singlesignon), um Ihre Benutzer zu durchsuchen und eine Benutzer-ID zu finden.
Geben Sie dann die Benutzer-ID (z. B.`123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE`) als Standardwert für das Attribut an, oder definieren Sie das Attribut ohne Standardwert.
```
{
...
"assetModelProperties": [
...
{
"name": "userId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
}
}
}
]
}
```
1. (Optional) Fügen Sie ein Attribut hinzu, das die Standard-Absender-ID für SMS-Benachrichtigungen (Text) angibt. Die Absender-ID wird in Nachrichten, die Amazon Simple Notification Service (Amazon SNS) sendet, als Nachrichtenabsender angezeigt. Weitere Informationen finden Sie [AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter Eine Absender-ID anfordern](https://docs.aws.amazon.com/sms-voice/latest/userguide/sender-id-request.html).
```
{
...
"assetModelProperties": [
...
{
"name": "senderId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "MyFactory"
}
}
}
]
}
```
1. *(Optional) Fügen Sie ein Attribut hinzu, das die Standard-E-Mail-Adresse angibt, die als Absenderadresse in E-Mail-Benachrichtigungen verwendet werden soll.*
```
{
...
"assetModelProperties": [
...
{
"name": "fromAddress",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "my.factory@example.com"
}
}
}
]
}
```
1. (Optional) Fügen Sie ein Attribut hinzu, das den Standard-Betreff angibt, der in E-Mail-Benachrichtigungen verwendet werden soll.
```
{
...
"assetModelProperties": [
...
{
"name": "emailSubject",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "[ALERT] High boiler temperature"
}
}
}
]
}
```
1. (Optional) Fügen Sie ein Attribut hinzu, das eine zusätzliche Nachricht angibt, die in Benachrichtigungen aufgenommen werden soll. Standardmäßig enthalten Benachrichtigungen Informationen über den Alarm. Sie können auch eine zusätzliche Nachricht hinzufügen, die dem Benutzer weitere Informationen gibt.
```
{
...
"assetModelProperties": [
...
{
"name": "additionalMessage",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Turn off the power before you check the alarm."
}
}
}
]
}
```
1. Erstellen Sie das Asset-Modell oder aktualisieren Sie das bestehende Asset-Modell. Führen Sie eine der folgenden Aktionen aus:
+ Führen Sie den folgenden Befehl aus, um das Asset-Modell zu erstellen.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
+ Führen Sie den folgenden Befehl aus, um das vorhandene Asset-Modell zu aktualisieren. *asset-model-id*Ersetzen Sie es durch die ID des Asset-Modells.
```
aws iotsitewise update-asset-model \
--asset-model-id asset-model-id \
--cli-input-json file://asset-model-payload.json
```
Nachdem Sie den Befehl ausgeführt haben, notieren Sie sich das `assetModelId` in der Antwort.
#### Beispiel: Modell der Kesselanlage
Das folgende Anlagenmodell stellt einen Kessel dar, der Temperaturdaten meldet. Dieses Anlagenmodell definiert einen Alarm, der erkennt, wenn der Kessel überhitzt.
```
{
"assetModelName": "Boiler Model",
"assetModelDescription": "Represents a boiler.",
"assetModelProperties": [
{
"name": "Temperature",
"dataType": "DOUBLE",
"unit": "C",
"type": {
"measurement": {}
}
},
{
"name": "Temperature Max Threshold",
"dataType": "DOUBLE",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
},
{
"name": "identityStoreId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "d-123EXAMPLE"
}
}
},
{
"name": "userId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
}
}
},
{
"name": "senderId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "MyFactory"
}
}
},
{
"name": "fromAddress",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "my.factory@example.com"
}
}
},
{
"name": "emailSubject",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "[ALERT] High boiler temperature"
}
}
},
{
"name": "additionalMessage",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Turn off the power before you check the alarm."
}
}
}
],
"assetModelHierarchies": [
],
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
### Schritt 2: Definieren Sie ein Alarmmodell AWS IoT Events
Erstellen Sie das Alarmmodell in AWS IoT Events. In AWS IoT Events verwenden Sie *Ausdrücke*, um Werte in Alarmmodellen anzugeben. Sie können Ausdrücke verwenden, um Werte anzugeben AWS IoT SiteWise , die ausgewertet und als Eingaben für den Alarm verwendet werden sollen. Wenn die Eigenschaftswerte einer Anlage AWS IoT SiteWise an das Alarmmodell sendet, AWS IoT Events wertet sie den Ausdruck aus, um den Wert der Eigenschaft oder die ID der Anlage zu ermitteln. Sie können die folgenden Ausdrücke im Alarmmodell verwenden:
+ **Werte der Eigenschaften von Vermögenswerten**
Verwenden Sie den folgenden Ausdruck, um den Wert einer Anlageneigenschaft zu ermitteln. *assetModelId*Ersetzen Sie ihn durch die ID des Asset-Modells und *propertyId* ersetzen Sie ihn durch die ID der Eigenschaft.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.propertyValue.value
```
+ **Anlage IDs**
Verwenden Sie den folgenden Ausdruck, um die ID des Assets abzurufen. *assetModelId*Ersetzen Sie es durch die ID des Asset-Modells und *propertyId* ersetzen Sie es durch die ID der Eigenschaft.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.assetId
```
**Anmerkung**
Wenn Sie das Alarmmodell erstellen, können Sie Literale anstelle von Ausdrücken definieren, die zu AWS IoT SiteWise Werten ausgewertet werden. Dadurch kann die Anzahl der Attribute, die Sie in Ihrem Asset-Modell definieren, reduziert werden. Wenn Sie jedoch einen Wert als Literalwert definieren, können Sie diesen Wert nicht für Anlagen anpassen, die auf dem Anlagemodell basieren. Ihre AWS IoT SiteWise Monitor Benutzer können den Alarm auch nicht anpassen, da sie Alarmeinstellungen nur für Assets konfigurieren können.
**So erstellen Sie ein AWS IoT Events Alarmmodell (CLI)**
1. Wenn Sie das Alarmmodell in erstellen AWS IoT Events, müssen Sie die ID jeder Eigenschaft angeben, die der Alarm verwendet. Dazu gehören:
+ Die Eigenschaft „Alarmstatus“ im zusammengesetzten Objektmodell
+ Die Eigenschaft, die der Alarm überwacht
+ Das Schwellenwertattribut
+ (Optional) Das ID-Attribut für den Identitätsspeicher von IAM Identity Center
+ (Optional) Das IAM Identity Center-Benutzer-ID-Attribut
+ (Optional) Das SMS-Absender-ID-Attribut
+ *(Optional) Das E-Mail-Absender-Adressattribut*
+ (Optional) Das E-Mail-Betreff-Attribut
+ (Optional) Das zusätzliche Nachrichtenattribut
Führen Sie den folgenden Befehl aus, um die IDs dieser Eigenschaften für das Asset-Modell abzurufen. *asset-model-id*Ersetzen Sie es durch die ID des Asset-Modells aus dem vorherigen Schritt.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
Die Operation gibt eine Antwort zurück, die Details des Komponentenmodells enthält. Notieren Sie sich die ID jeder Eigenschaft, die der Alarm verwendet. Sie verwenden diese IDs , wenn Sie im nächsten Schritt das AWS IoT Events Alarmmodell erstellen.
1. Erstellen Sie das Alarmmodell in AWS IoT Events. Gehen Sie wie folgt vor:
1. Erstellen Sie eine Datei mit dem Namen `alarm-model-payload.json`.
1. Kopieren Sie das folgende JSON-Objekt in die Datei.
1. Geben Sie einen Namen (`alarmModelName`), eine Beschreibung (`alarmModelDescription`) und einen Schweregrad (`severity`) für Ihren Alarm ein. Geben Sie für den Schweregrad eine Ganzzahl an, die den Schweregrad Ihres Unternehmens widerspiegelt.
**Wichtig**
Das Alarmmodell muss denselben Namen haben wie das zusammengesetzte Alarmmodell, das Sie zuvor für Ihr Anlagenmodell definiert haben.
Namen von Alarmmodellen dürfen nur alphanumerische Zeichen enthalten.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3
}
```
1. Fügen Sie dem Alarm die Vergleichsregel (`alarmRule`) hinzu. Diese Regel definiert die zu überwachende Eigenschaft (`inputProperty`), den zu vergleichenden Schwellenwert (`threshold`) und den zu verwendenden Vergleichsoperator (`comparisonOperator`).
+ *assetModelId*Ersetzen Sie es durch die ID des Asset-Modells.
+ *alarmPropertyId*Ersetzen Sie durch die ID der Immobilie, die der Alarm überwacht.
+ *thresholdAttributeId*Ersetzen Sie es durch die ID der Attributeigenschaft „Threshold“.
+ *GREATER*Ersetzen Sie es durch den Operator, der verwendet werden soll, um die Eigenschaftswerte mit dem Schwellenwert zu vergleichen. Wählen Sie aus den folgenden Optionen aus:
+ `LESS`
+ `LESS_OR_EQUAL`
+ `EQUAL`
+ `NOT_EQUAL`
+ `GREATER_OR_EQUAL`
+ `GREATER`
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
}
}
```
1. Fügen Sie eine Aktion (`alarmEventActions`) hinzu, um den Alarmstatus an den AWS IoT SiteWise Zeitpunkt zu senden, an dem sich der Zustand des Alarms ändert.
**Anmerkung**
Für eine erweiterte Konfiguration können Sie zusätzliche Aktionen definieren, die ausgeführt werden, wenn der Alarm seinen Status ändert. Sie können beispielsweise eine AWS Lambda Funktion aufrufen oder zu einem MQTT-Thema veröffentlichen. Weitere Informationen finden Sie unter [Arbeiten mit anderen AWS Diensten](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-other-aws-services.html) im *AWS IoT Events Entwicklerhandbuch*.
+ *assetModelId*Ersetzen Sie es durch die ID des Asset-Modells.
+ *alarmPropertyId*Ersetzen Sie durch die ID der Immobilie, die der Alarm überwacht.
+ *alarmStatePropertyId*Ersetzen Sie durch die ID der Eigenschaft „Alarmstatus“ im zusammengesetzten Alarmmodell.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
}
}
```
1. (Optional) Konfigurieren Sie die Einstellungen für die Alarmbenachrichtigung. Die Alarmbenachrichtigungsaktion verwendet eine Lambda-Funktion in Ihrem Konto, um Alarmbenachrichtigungen zu senden. Weitere Informationen finden Sie unter [Anforderungen für Alarmmeldungen in AWS IoT SiteWise](iot-events-alarm-notification-requirements.md). In den Einstellungen für Alarmbenachrichtigungen können Sie SMS- und E-Mail-Benachrichtigungen konfigurieren, die an IAM Identity Center-Benutzer gesendet werden. Gehen Sie wie folgt vor:
1. Fügen Sie die Konfiguration für Alarmbenachrichtigungen (`alarmNotification`) zur Payload in hinzu. `alarm-model-payload.json`
+ *alarmNotificationFunctionArn*Ersetzen Sie es durch den ARN der Lambda-Funktion, die Alarmbenachrichtigungen verarbeitet.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
}
}
]
}
}
```
1. (Optional) Konfigurieren Sie die SMS-Benachrichtigungen (`smsConfigurations`), die an einen IAM Identity Center-Benutzer gesendet werden, wenn sich der Status des Alarms ändert.
+ *identityStoreIdAttributeId*Ersetzen Sie es durch die ID des Attributs, das die ID des IAM Identity Center-Identitätsspeichers enthält.
+ *userIdAttributeId*Ersetzen Sie es durch die ID des Attributs, das die ID des IAM Identity Center-Benutzers enthält.
+ *senderIdAttributeId*Ersetzen Sie es durch die ID des Attributs, das die Amazon SNS SNS-Sender-ID enthält, oder entfernen Sie es `senderId` aus der Payload.
+ *additionalMessageAttributeId*Ersetzen Sie es durch die ID des Attributs, das die zusätzliche Nachricht enthält, oder entfernen Sie sie `additionalMessage` aus der Payload.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
]
}
]
}
}
```
1. (Optional) Konfigurieren Sie die E-Mail-Benachrichtigungen (`emailConfigurations`), die an einen IAM Identity Center-Benutzer gesendet werden, wenn sich der Status des Alarms ändert.
+ *identityStoreIdAttributeId*Ersetzen Sie es durch die ID der IAM Identity Center Identity Store-ID-Attributeigenschaft.
+ *userIdAttributeId*Ersetzen Sie es durch die ID der IAM Identity Center-Benutzer-ID-Attributeigenschaft.
+ *fromAddressAttributeId*Ersetzen Sie es durch die ID der Adressattributeigenschaft „Von“ oder entfernen Sie sie `from` aus der Payload.
+ *emailSubjectAttributeId*Ersetzen Sie es durch die ID der Eigenschaft des E-Mail-Betreff-Attributs oder entfernen Sie es `subject` aus der Payload.
+ *additionalMessageAttributeId*Ersetzen Sie es durch die ID der zusätzlichen Nachrichtenattributeigenschaft oder entfernen Sie sie `additionalMessage` aus der Payload.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
}
}
```
1. (Optional) Fügen Sie die Alarmfunktionen (`alarmCapabilities`) zur Payload-Eingabe hinzu. `alarm-model-payload.json` In diesem Objekt können Sie angeben, ob der Bestätigungsfluss aktiviert ist, und den standardmäßigen Aktivierungsstatus für Anlagen auf der Grundlage des Asset-Modells festlegen. Weitere Informationen zum Bestätigungsfluss finden Sie unter[Alarmzustände](industrial-alarms.md#alarm-states).
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
},
"alarmCapabilities": {
"initializationConfiguration": {
"disabledOnInitialization": false
},
"acknowledgeFlow": {
"enabled": true
}
}
}
```
1. Fügen Sie die IAM-Dienstrolle (`roleArn`) hinzu, die davon ausgehen AWS IoT Events kann, Daten an zu AWS IoT SiteWise senden. Für diese Rolle sind die `iotsitewise:BatchPutAssetPropertyValue` Genehmigung und eine Vertrauensbeziehung erforderlich, die es ermöglichen, die Rolle `iotevents.amazonaws.com` zu übernehmen. Zum Senden von Benachrichtigungen benötigt diese Rolle auch die `sso-directory:DescribeUser` Berechtigungen `lambda:InvokeFunction` und. Weitere Informationen finden Sie unter [Alarm-Dienstrollen](https://docs.aws.amazon.com/iotevents/latest/developerguide/security-iam.html) im *AWS IoT Events Entwicklerhandbuch*.
+ Ersetzen Sie das `roleArn` durch den ARN der Rolle, die diese Aktionen ausführen AWS IoT Events kann.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
},
"alarmCapabilities": {
"initializationConfiguration": {
"disabledOnInitialization": false
},
"acknowledgeFlow": {
"enabled": false
}
},
"roleArn": "arn:aws:iam::123456789012:role/MyIoTEventsAlarmRole"
}
```
1. Führen Sie den folgenden Befehl aus, um das AWS IoT Events Alarmmodell aus der Payload in `alarm-model-payload.json` zu erstellen.
```
aws iotevents create-alarm-model --cli-input-json file://alarm-model-payload.json
```
1. Die Operation gibt eine Antwort zurück, die den ARN des Alarmmodells enthält,`alarmModelArn`. Kopieren Sie diesen ARN, um ihn im nächsten Schritt in der Alarmdefinition Ihres Asset-Modells festzulegen.
### Schritt 3: Aktivieren Sie den Datenfluss zwischen AWS IoT SiteWise und AWS IoT Events
Nachdem Sie die erforderlichen Ressourcen in AWS IoT SiteWise und erstellt haben AWS IoT Events, können Sie den Datenfluss zwischen den Ressourcen aktivieren, um Ihren Alarm zu aktivieren. In diesem Abschnitt aktualisieren Sie die Alarmdefinition im Asset-Modell, um das Alarmmodell zu verwenden, das Sie im vorherigen Schritt erstellt haben.
**So aktivieren Sie den Datenfluss zwischen AWS IoT SiteWise und AWS IoT Events (CLI)**
+ Stellen Sie das Alarmmodell als Quelle des Alarms im Asset-Modell ein. Gehen Sie wie folgt vor:
1. Führen Sie den folgenden Befehl aus, um die vorhandene Komponentenmodelldefinition abzurufen. *asset-model-id*Ersetzen Sie es durch die ID des Asset-Modells.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
Die Operation gibt eine Antwort zurück, die Details des Komponentenmodells enthält.
1. Erstellen Sie eine Datei namens `update-asset-model-payload.json` und kopieren Sie die Antwort des vorherigen Befehls in die Datei.
1. Entfernen Sie die folgenden Schlüssel-Wert-Paare aus der `update-asset-model-payload.json` Datei:
+ `assetModelId`
+ `assetModelArn`
+ `assetModelCreationDate`
+ `assetModelLastUpdateDate`
+ `assetModelStatus`
1. Fügen Sie dem zuvor definierten zusammengesetzten Alarmmodell die Eigenschaft Alarmquelle (`AWS/ALARM_SOURCE`) hinzu. *alarmModelArn*Ersetzen Sie ihn durch den ARN des Alarmmodells, der den Wert der Eigenschaft Alarmquelle festlegt.
```
{
...
"assetModelCompositeModels": [
...
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
},
{
"name": "AWS/ALARM_SOURCE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "alarmModelArn"
}
}
}
]
}
]
}
```
1. Führen Sie den folgenden Befehl aus, um das Asset-Modell mit der in der `update-asset-model-payload.json` Datei gespeicherten Definition zu aktualisieren. *asset-model-id*Ersetzen Sie es durch die ID des Asset-Modells.
```
aws iotsitewise update-asset-model \
--asset-model-id asset-model-id \
--cli-input-json file://update-asset-model-payload.json
```
Ihr Anlagenmodell definiert jetzt einen Alarm, der eindringt AWS IoT Events. Der Alarm überwacht die Zielimmobilie in allen Anlagen, die auf diesem Anlagenmodell basieren. Sie können den Alarm für jedes Asset konfigurieren, um Eigenschaften wie den Schwellenwert oder den IAM Identity Center-Empfänger für jedes Asset anzupassen. Weitere Informationen finden Sie unter [Konfigurieren Sie Alarme für Anlagen in AWS IoT SiteWise](configure-alarms.md).
# Definieren Sie externe Alarme in AWS IoT SiteWise
Externe Alarme enthalten den Status eines Alarms, den Sie außerhalb eines AWS IoT SiteWise Alarms erkennen.
## Definieren Sie einen externen Alarm (Konsole)
Sie können die AWS IoT SiteWise Konsole verwenden, um einen externen Alarm für ein vorhandenes Anlagenmodell zu definieren. Um einen externen Alarm für ein neues Asset-Modell zu definieren, erstellen Sie das Asset-Modell und führen Sie dann diese Schritte aus. Weitere Informationen finden Sie unter [Erstellen Sie Asset-Modelle in AWS IoT SiteWise](create-asset-models.md).
**Um einen Alarm für ein Asset-Modell zu definieren**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Klicken Sie im Navigationsbereich auf **Models (Modelle)**.
1. Wählen Sie das Asset-Modell aus, für das Sie einen Alarm definieren möchten.
1. Wählen Sie die Registerkarte **Alarmdefinitionen**.
1. Wählen **Sie Alarm hinzufügen**.
1. Wählen Sie in den **Optionen für den Alarmtyp** die Option **Externer Alarm** aus.
1. Geben Sie einen Namen für den Alarm ein.
1. (Optional) Geben Sie eine Beschreibung für Ihren Alarm ein.
1. Wählen **Sie Alarm hinzufügen**.
## Definieren Sie einen externen Alarm (CLI)
Sie können den verwenden AWS CLI , um einen externen Alarm für ein neues oder vorhandenes Anlagenmodell zu definieren.
Um einem Asset-Modell einen externen Alarm hinzuzufügen, fügen Sie dem Asset-Modell ein zusammengesetztes Alarmmodell hinzu. Ein zusammengesetztes externes Alarmmodell spezifiziert den `EXTERNAL` Typ und keine Eigenschaft der Alarmquelle. Das folgende Beispiel für einen zusammengesetzten Alarm definiert einen externen Temperaturalarm.
```
{
...
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "EXTERNAL"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
Weitere Informationen zum Hinzufügen eines zusammengesetzten Modells zu einem neuen oder vorhandenen Anlagenmodell finden Sie im Folgenden:
+ [Erstellen Sie ein Asset-Modell (AWS CLI)](create-asset-models.md#create-asset-model-cli)
+ [Aktualisieren Sie ein Objektmodell, ein Komponentenmodell oder eine Schnittstelle ()AWS CLI](update-asset-models.md#update-asset-model-cli)
Nachdem Sie den externen Alarm definiert haben, können Sie den Alarmstatus auf der Grundlage des Asset-Modells in Anlagen aufnehmen. Weitere Informationen finden Sie unter [Erfassen Sie einen externen Alarmstatus in AWS IoT SiteWise](ingest-external-alarm-state.md).
# Konfigurieren Sie Alarme für Anlagen in AWS IoT SiteWise
Nachdem Sie einen AWS IoT Events Alarm für ein Asset-Modell definiert haben, können Sie den Alarm für jedes Asset basierend auf dem Asset-Modell konfigurieren. Sie können den Schwellenwert und die Benachrichtigungseinstellungen für den Alarm bearbeiten. Jeder dieser Werte ist ein Attribut auf dem Asset, sodass Sie den Standardwert des Attributs aktualisieren können, um diese Werte zu konfigurieren.
**Anmerkung**
Sie können diese Werte für AWS IoT Events Alarme konfigurieren, jedoch nicht für externe Alarme.
**Topics**
+ [Konfigurieren Sie einen Schwellenwert (Konsole)](#configure-alarm-threshold-value-console)
+ [Konfigurieren Sie einen Schwellenwert (AWS CLI)](#configure-alarm-threshold-value-cli)
+ [Konfigurieren Sie die Benachrichtigungseinstellungen in AWS IoT SiteWise](configure-alarm-notification-settings.md)
## Konfigurieren Sie einen Schwellenwert (Konsole)
Sie können die AWS IoT SiteWise Konsole verwenden, um den Wert des Attributs zu aktualisieren, das den Schwellenwert eines Alarms angibt.
**Um den Schwellenwert eines Alarms zu aktualisieren (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarmschwellenwert aktualisieren möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie **Bearbeiten** aus.
1. Suchen Sie das Attribut, das der Alarm für seinen Schwellenwert verwendet, und geben Sie dann seinen neuen Wert ein.
1. Wählen Sie **Speichern**.
## Konfigurieren Sie einen Schwellenwert (AWS CLI)
Sie können das AWS Command Line Interface (AWS CLI) verwenden, um den Wert des Attributs zu aktualisieren, das den Schwellenwert eines Alarms angibt.
Um dieses Verfahren abzuschließen, müssen Sie die `assetId` Ihrer Komponenten und die `propertyId` Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennen`assetId`, verwenden Sie die [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API, um alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie den [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Vorgang, um die Eigenschaften Ihres Assets einschließlich der Immobilien anzuzeigen IDs.
Verwenden Sie die Operation [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), um Attributwerte zu Ihrer Komponente zuzuweisen. Mit dieser Operation können Sie mehrere Attribute gleichzeitig festlegen. Die Nutzlast dieser Operation enthält eine Liste von Einträgen, jeweils mit der Komponenten-ID, der Eigenschafts-ID und dem Attributwert.
**Um den Wert eines Attributs zu aktualisieren (AWS CLI)**
1. Erstellen Sie eine Datei namens `batch-put-payload.json` und kopieren Sie das folgende JSON-Objekt in die Datei. In diesem Nutzlast-Beispiel wird veranschaulicht, wie der Breiten- und Längengrad einer Windturbine festgelegt wird. Aktualisieren Sie die IDs Werte und Zeitstempel, um die Nutzlast für Ihren Anwendungsfall zu ändern.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Jeder Eintrag in der Nutzlast enthält eine `entryId`, die Sie als eindeutige Zeichenfolge definieren können. Bei fehlgeschlagenen Anforderungseinträgen enthält jeder Fehler die `entryId` der entsprechenden Anforderung, woran Sie erkennen können, welche Anforderungen zu wiederholen sind.
+ Um einen Attributwert festzulegen, können Sie `propertyValues` für jede Attributeigenschaft eine timestamp-quality-value (TQV-) Struktur in die Liste aufnehmen. Diese Struktur muss den neuen `value` und den aktuellen `timestamp` enthalten.
+ `value`— Eine Struktur, die je nach Typ der festzulegenden Eigenschaft eines der folgenden Felder enthält:
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Eine Struktur, die die aktuelle Unix-Epoche in Sekunden enthält,`timeInSeconds`. AWS IoT SiteWise lehnt alle Datenpunkte mit Zeitstempeln ab, die länger als 7 Tage in der Vergangenheit oder neuer als 5 Minuten in der future existierten.
Weitere Informationen zum Vorbereiten einer Nutzlast für [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) finden Sie unter [Daten aufnehmen mit AWS IoT SiteWise APIs](ingest-api.md).
1. Führen Sie den folgenden Befehl aus, um die Attributwerte an zu senden: AWS IoT SiteWise
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# Konfigurieren Sie die Benachrichtigungseinstellungen in AWS IoT SiteWise
Sie können die Einstellungen für Alarmbenachrichtigungen entweder mit der AWS IoT SiteWise Konsole oder mit AWS Command Line Interface (AWS CLI) konfigurieren.
## Konfigurieren Sie die Benachrichtigungseinstellungen (Konsole)
Sie können die AWS IoT SiteWise Konsole verwenden, um den Wert der Attribute zu aktualisieren, die die Benachrichtigungseinstellungen für einen Alarm angeben.
**Um die Benachrichtigungseinstellungen eines Alarms zu aktualisieren (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie die Alarmeinstellungen aktualisieren möchten.
1. Wählen Sie **Bearbeiten** aus.
1. Suchen Sie das Attribut, das der Alarm für die Benachrichtigungseinstellung verwendet, die Sie ändern möchten, und geben Sie dann den neuen Wert ein.
1. Wählen Sie **Speichern**.
## Benachrichtigungseinstellungen konfigurieren (CLI)
Sie können die AWS Command Line Interface (AWS CLI) verwenden, um den Wert des Attributs zu aktualisieren, das die Benachrichtigungseinstellungen für einen Alarm angibt.
Um dieses Verfahren abzuschließen, müssen Sie die `assetId` Ihrer Komponenten und die `propertyId` Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennen`assetId`, verwenden Sie die [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API, um alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie den [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Vorgang, um die Eigenschaften Ihres Assets einschließlich der Immobilien anzuzeigen IDs.
Verwenden Sie die Operation [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), um Attributwerte zu Ihrer Komponente zuzuweisen. Mit dieser Operation können Sie mehrere Attribute gleichzeitig festlegen. Die Nutzlast dieser Operation enthält eine Liste von Einträgen, jeweils mit der Komponenten-ID, der Eigenschafts-ID und dem Attributwert.
**Um den Wert eines Attributs zu aktualisieren (AWS CLI)**
1. Erstellen Sie eine Datei namens `batch-put-payload.json` und kopieren Sie das folgende JSON-Objekt in die Datei. In diesem Nutzlast-Beispiel wird veranschaulicht, wie der Breiten- und Längengrad einer Windturbine festgelegt wird. Aktualisieren Sie die IDs Werte und Zeitstempel, um die Nutzlast für Ihren Anwendungsfall zu ändern.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Jeder Eintrag in der Nutzlast enthält eine `entryId`, die Sie als eindeutige Zeichenfolge definieren können. Bei fehlgeschlagenen Anforderungseinträgen enthält jeder Fehler die `entryId` der entsprechenden Anforderung, woran Sie erkennen können, welche Anforderungen zu wiederholen sind.
+ Um einen Attributwert festzulegen, können Sie `propertyValues` für jede Attributeigenschaft eine timestamp-quality-value (TQV-) Struktur in die Liste aufnehmen. Diese Struktur muss den neuen `value` und den aktuellen `timestamp` enthalten.
+ `value`— Eine Struktur, die je nach Typ der festzulegenden Eigenschaft eines der folgenden Felder enthält:
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Eine Struktur, die die aktuelle Unix-Epoche in Sekunden enthält,`timeInSeconds`. AWS IoT SiteWise lehnt alle Datenpunkte mit Zeitstempeln ab, die länger als 7 Tage in der Vergangenheit oder neuer als 5 Minuten in der future existierten.
Weitere Informationen zum Vorbereiten einer Nutzlast für [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) finden Sie unter [Daten aufnehmen mit AWS IoT SiteWise APIs](ingest-api.md).
1. Führen Sie den folgenden Befehl aus, um die Attributwerte an zu senden: AWS IoT SiteWise
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# Reagieren Sie auf Alarme in AWS IoT SiteWise
Wenn sich der Status eines AWS IoT Events Alarms ändert, können Sie wie folgt auf den Alarm reagieren:
+ Bestätigen Sie einen Alarm, um anzuzeigen, dass Sie sich mit dem Problem befassen.
+ Schalten Sie einen Alarm in die Schlummerfunktion, um ihn vorübergehend zu deaktivieren.
+ Deaktivieren Sie einen Alarm, um ihn dauerhaft zu deaktivieren, bis Sie ihn wieder aktivieren.
+ Aktivieren Sie einen deaktivierten Alarm, um den Alarmstatus zu erkennen.
+ Setzen Sie einen Alarm zurück, um seinen Status und seinen letzten Wert zu löschen.
Sie können die AWS IoT SiteWise Konsole oder die AWS IoT Events API verwenden, um auf einen Alarm zu reagieren.
**Anmerkung**
Sie können auf AWS IoT Events Alarme reagieren, aber nicht auf externe Alarme.
**Topics**
+ [Reagieren Sie auf einen Alarm (Konsole)](#respond-to-alarm-console)
+ [Reagieren Sie auf einen Alarm (API)](#respond-to-alarm-cli)
## Reagieren Sie auf einen Alarm (Konsole)
Sie können die AWS IoT SiteWise Konsole verwenden, um einen Alarm zu bestätigen, in den Schlummermodus zu versetzen, zu deaktivieren oder zu aktivieren.
**Topics**
+ [Bestätigen Sie einen Alarm (Konsole)](#acknowledge-alarm-console)
+ [Alarmanlage ausschalten (Konsole)](#snooze-alarm-console)
+ [Deaktiviert einen Alarm (Konsole)](#disable-alarm-console)
+ [Aktiviert einen Alarm (Konsole)](#enable-alarm-console)
+ [Einen Alarm zurücksetzen (Konsole)](#reset-alarm-console)
### Bestätigen Sie einen Alarm (Konsole)
Sie können einen Alarm bestätigen, um anzuzeigen, dass Sie das Problem lösen.
**Anmerkung**
Sie müssen den Bestätigungsfluss für den Alarm aktivieren, damit Sie den Alarm bestätigen können. Diese Option ist standardmäßig aktiviert, wenn Sie den Alarm von der AWS IoT SiteWise Konsole aus definieren.
**Um einen Alarm zu bestätigen (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarm bestätigen möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie die Registerkarte **Alarme**.
1. Wählen Sie den Alarm aus, den Sie bestätigen möchten, und wählen Sie dann **Aktionen**, um das Aktionsmenü für die Reaktion zu öffnen.
1. Wählen Sie **Acknowledge** (Bestätigen). Der Status des Alarms wechselt zu **Bestätigt**.
### Alarmanlage ausschalten (Konsole)
Sie können einen Alarm in die Schlummerfunktion versetzen, um ihn vorübergehend zu deaktivieren. Geben Sie die Dauer an, für die der Alarm deaktiviert werden soll.
**Um einen Alarm in die Schlummerfunktion zu versetzen (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarm deaktivieren möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie die Registerkarte **Alarme**.
1. Wählen Sie den Alarm aus, der in den Schlummermodus versetzt werden soll, und wählen Sie dann **Aktionen**, um das Aktionsmenü für die Reaktion zu öffnen.
1. **Wählen Sie „Schlummern“.** Es wird ein Modell geöffnet, in dem Sie die Dauer für den Schlummermodus angeben.
1. **Wählen Sie die **Schlummerlänge oder geben Sie eine benutzerdefinierte Schlummerlänge** ein.**
1. Wählen Sie **Speichern**. **Der Alarmstatus wechselt zu Snoozed.**
### Deaktiviert einen Alarm (Konsole)
Sie können einen Alarm deaktivieren, sodass er nicht mehr erkannt wird. Nachdem Sie den Alarm deaktiviert haben, müssen Sie ihn erneut aktivieren, wenn der Alarm erkannt werden soll.
**Um einen Alarm zu deaktivieren (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarm deaktivieren möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie die Registerkarte **Alarme**.
1. Wählen Sie den Alarm aus, den Sie deaktivieren möchten, und wählen Sie dann **Aktionen**, um das Aktionsmenü für die Reaktion zu öffnen.
1. Wählen Sie **Disable ** (deaktivieren) aus. Der Status des Alarms ändert sich zu **Deaktiviert**.
### Aktiviert einen Alarm (Konsole)
Sie können einen Alarm so einrichten, dass er erneut erkannt wird, nachdem Sie ihn deaktiviert oder die Schlummerfunktion aktiviert haben.
**Um einen Alarm zu aktivieren (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarm aktivieren möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie die Registerkarte **Alarme**.
1. Wählen Sie den Alarm aus, den Sie aktivieren möchten, und wählen Sie dann **Aktionen**, um das Aktionsmenü für die Reaktion zu öffnen.
1. Wählen Sie **Enable (Aktivieren)** aus. Der Zustand des Alarms wechselt zu **Normal**.
### Einen Alarm zurücksetzen (Konsole)
Sie können einen Alarm zurücksetzen, um seinen Status und seinen letzten Wert zu löschen.
**Um einen Alarm zurückzusetzen (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie das Asset aus, für das Sie einen Alarm zurücksetzen möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie die Registerkarte **Alarme**.
1. Wählen Sie den Alarm aus, den Sie aktivieren möchten, und wählen Sie dann **Aktionen**, um das Aktionsmenü für die Reaktion zu öffnen.
1. Klicken Sie auf **Reset (Zurücksetzen)**. Der Zustand des Alarms wechselt zu **Normal**.
## Reagieren Sie auf einen Alarm (API)
Sie können die AWS IoT Events API verwenden, um einen Alarm zu bestätigen, in den Schlummermodus zu versetzen, zu deaktivieren, zu aktivieren oder zurückzusetzen. Weitere Informationen finden Sie in der *AWS IoT Events API-Referenz* zu den folgenden Vorgängen:
+ [BatchAcknowledgeAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchAcknowledgeAlarm.html)
+ [BatchSnoozeAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchSnoozeAlarm.html)
+ [BatchDisableAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchDisableAlarm.html)
+ [BatchEnableAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchEnableAlarm.html)
+ [BatchResetAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchResetAlarm.html)
Weitere Informationen finden Sie unter [Reagieren auf Alarme](https://docs.aws.amazon.com/iotevents/latest/developerguide/respond-to-alarms.html) im *AWS IoT Events Entwicklerhandbuch*.
# Erfassen Sie einen externen Alarmstatus in AWS IoT SiteWise
Externe Alarme sind Alarme, die Sie außerhalb von auswerten AWS IoT SiteWise. Sie können externe Alarme verwenden, wenn Sie über eine Datenquelle verfügen, die den Alarmstatus meldet und in die Sie Daten aufnehmen möchten AWS IoT SiteWise.
Für die Eigenschaften des Alarmstatus ist ein bestimmtes Format für die Datenwerte des Alarmstatus erforderlich. Jeder Datenwert muss ein JSON-Objekt sein, das in eine Zeichenfolge serialisiert ist. Anschließend nehmen Sie die serialisierte Zeichenfolge als Zeichenkettenwert auf. Weitere Informationen finden Sie unter [Eigenschaften des Alarmstatus](industrial-alarms.md#alarm-state-properties).
**Example Beispiel für einen Datenwert für den Alarmstatus (nicht serialisiert)**
```
{
"stateName": "Active"
}
```
**Example Beispiel für einen Datenwert für den Alarmstatus (serialisiert)**
```
{\"stateName\":\"Active\"}
```
**Anmerkung**
Wenn Ihre Datenquelle keine Daten in diesem Format melden kann oder Sie Ihre Daten nicht in dieses Format konvertieren können, bevor Sie sie aufnehmen, können Sie sich dafür entscheiden, keine Alarm-Eigenschaft zu verwenden. Stattdessen können Sie die Daten beispielsweise als Messeigenschaft mit dem Datentyp Zeichenfolge aufnehmen. Weitere Informationen erhalten Sie unter [Definieren Sie Datenströme von Geräten (Messungen)](measurements.md) und [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md).
# Ordnen Sie externe Alarmstatus-Streams zu AWS IoT SiteWise
Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)
**Topics**
+ [Ordnen Sie externe Alarmstatus-Streams zu (Konsole)](#connect-alarm-data-stream-console)
+ [Ordnen Sie externe Alarmstatus-Streams zu (AWS CLI)](#connect-alarm-data-stream-cli)
## Ordnen Sie externe Alarmstatus-Streams zu (Konsole)
Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)
Sie können die AWS IoT SiteWise Konsole verwenden, um einen Alias für eine Alarmstatuseigenschaft festzulegen.
**Um einen Eigenschaftsalias für eine Alarmstatuseigenschaft festzulegen (Konsole)**
1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).
1. Wählen Sie im linken Navigationsbereich **Komponenten** aus.
1. Wählen Sie die Komponente aus, für die Sie einen Eigenschaftenalias festlegen möchten.
**Tipp**
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.
1. Wählen Sie **Bearbeiten** aus.
1. Scrollen Sie zu **Alarme** und erweitern Sie den Bereich.
1. Geben Sie unter **Externe Alarme** den Alias im Feld **Eigenschaftsalias — *optional*** ein.
1. Wählen Sie **Speichern**.
## Ordnen Sie externe Alarmstatus-Streams zu (AWS CLI)
Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)
Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen Alias für eine Alarmstatuseigenschaft festzulegen.
Um dieses Verfahren abzuschließen, müssen Sie die `assetId` Ihrer Komponenten und die `propertyId` Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennen`assetId`, verwenden Sie die [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API, um alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie den [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Vorgang, um die Eigenschaften Ihres Assets einschließlich der Immobilien anzuzeigen IDs.
**Anmerkung**
Die [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Antwort enthält die Liste der zusammengesetzten Anlagenmodelle für den Vermögenswert. Jeder Alarm ist ein zusammengesetztes Modell. Um das zu finden`propertyId`, suchen Sie das zusammengesetzte Modell für den Alarm und suchen Sie dann die `AWS/ALARM_STATE` Eigenschaft in diesem zusammengesetzten Modell.
Weitere Hinweise zum Festlegen des Eigenschaftsalias finden Sie unter[Aktualisieren Sie den Alias einer Asset-Eigenschaft](update-data-streams-method.md).
# Daten zum Alarmstatus aufnehmen in AWS IoT SiteWise
Bei den Eigenschaften des Alarmstatus wird der Alarmstatus als serialisierte JSON-Zeichenfolge erwartet. Um den Alarmstatus in einen externen Alarm zu übernehmen AWS IoT SiteWise, nehmen Sie diese serialisierte Zeichenfolge als Zeichenkettenwert mit Zeitstempel auf. Das folgende Beispiel zeigt einen Statusdatenwert für einen aktiven Alarm.
```
{\"stateName\":\"Active\"}
```
Um eine Eigenschaft für den Alarmstatus zu identifizieren, können Sie eine der folgenden Optionen angeben:
+ Das `assetId` Ende `propertyId` der Alarm-Eigenschaft, an die Sie Daten senden.
+ Das`propertyAlias`, was ein Datenstream-Alias ist (z. B.`/company/windfarm/3/turbine/7/temperature/high`). Um diese Option verwenden zu können, müssen Sie zuerst den Alias Ihrer Alarm-Eigenschaft festlegen. Informationen zum Festlegen von Eigenschaftsaliasnamen für Eigenschaften des Alarmstatus finden Sie unter[Ordnen Sie externe Alarmstatus-Streams zu AWS IoT SiteWise](connect-alarm-data-streams.md).
Die folgende [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)Beispiel-API-Payload zeigt, wie der Status eines externen Alarms formatiert wird. Dieser externe Alarm meldet, wenn der Wert der Umdrehungen pro Minute (U/min) einer Windturbine zu hoch ist.
**Example Beispiel für eine BatchPutAssetPropertyValue Payload für Alarmzustandsdaten**
```
{
"entries": [
{
"entryId": "unique entry ID",
"propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
"propertyValues": [
{
"value": {
"stringValue": "{\"stateName\":\"Active\"}"
},
"timestamp": {
"timeInSeconds": 1607550262
}
}
]
}
]
}
```
Weitere Hinweise zur Verwendung der `BatchPutAssetPropertyValue` API zum Erfassen von Daten finden Sie unter. [Daten aufnehmen mit AWS IoT SiteWise APIs](ingest-api.md)
Weitere Hinweise zu anderen Möglichkeiten der Datenaufnahme finden Sie unter. [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md)