Defining external alarms
External alarms contain the state of an alarm that you detect outside of Amazon IoT SiteWise.
Defining an external alarm (console)
You can use the Amazon IoT SiteWise console to define an external alarm on an existing asset model. To define an external alarm on a new asset model, create the asset model, and then complete these steps. For more information, see Creating asset models.
To define an alarm on an asset model
Navigate to the Amazon IoT SiteWise console
. In the navigation pane, choose Models.
-
Choose the asset model for which to define an alarm.
-
Choose the Alarm definitions tab.
-
Choose Add alarm.
-
In Alarm type options, choose External alarm.
-
Enter a name for your alarm.
-
(Optional) Enter a description for your alarm.
-
Choose Add alarm.
Defining an external alarm (CLI)
You can use the Amazon CLI to define an external alarm on a new or existing asset model.
To add an external alarm to an asset model, you add an alarm composite model to the
asset model. An external alarm composite model specifies the EXTERNAL
type
and doesn't specify an alarm source property. The following example composite alarm
defines an external temperature alarm.
{
...
"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": {} } } ] } ] }
For more information about how to add a composite model to a new or existing asset model, see the following:
After you define the external alarm, you can ingest alarm state to assets based on the asset model. For more information, see Ingesting external alarm state.