Defining Amazon IoT Events alarms

When you create an Amazon IoT Events alarm, Amazon IoT SiteWise sends asset property values to Amazon IoT Events to evaluate the state of the alarm. Amazon IoT Events alarm definitions depend on an alarm model that you define in Amazon IoT Events. To define an Amazon IoT Events alarm on an asset model, you define an alarm composite model that specifies the Amazon IoT Events alarm model as its alarm source property.

Amazon IoT Events alarms depend on inputs such as alarm thresholds and alarm notification settings. You define these inputs as attributes on the asset model. You can then customize these inputs on each asset based on the model. The Amazon IoT SiteWise console can create these attributes for you. If you define alarms with the Amazon CLI or API, you must manually define these attributes on the asset model.

You can also define other actions that happen when your alarm detects, such as custom alarm notification actions. For example, you can configure an action that sends a push notification to an Amazon SNS topic. For more information the actions that you can define, see Working with other Amazon services in the Amazon IoT Events Developer Guide.

When you update or delete an asset model, Amazon IoT SiteWise can check if an alarm model in Amazon IoT Events is monitoring an asset property associated with this asset model. This prevents you from deleting an asset property that an Amazon IoT Events alarm is currently using. To enable this feature in Amazon IoT SiteWise, you must have the iotevents:ListInputRoutings permission. This permission allows Amazon IoT SiteWise to make calls to the ListInputRoutings API operation supported by Amazon IoT Events. For more information, see (Optional) ListInputRoutings permission.