The SiteWise Monitor feature is not available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)

# Create alarm definitions
<a name="create-alarms"></a>

On the **Models** page, you can create AWS IoT Events alarms on models to monitor properties associated with the models. The alarms can also send notifications to you and members of your organization.

**Note**  
Your IT administrator must enable the alarms feature for your portal before you can create alarms.
If you want to send alarm notifications, your IT administrator must use IAM Identity Center for the portal authentication service.
For more information, see [Enabling alarms for your SiteWise Monitor portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-additional-features.html) in the *AWS IoT SiteWise User Guide*.

**To create an alarm definition**

1. In the navigation bar, choose the **Models** icon.

1. Choose a model in the **Models** hierarchy.

1. Choose the **Alarms** tab for the model.

1. Choose **Create an alarm definition**.

1. On the **Define threshold** page, you define when the alarm is invoked and the severity of the alarm. Do the following: 

   1. Choose the property on which the alarm monitors. Each time this property receives a new value, AWS IoT SiteWise sends the value to AWS IoT Events to evaluate the state of the alarm.

   1. Select the operator to use to compare the property with the threshold value. Choose from the following options:
      + **< less than**
      + **<= less than or equal**
      + **== equal**
      + **\$1= not equal**
      + **>= greater than or equal**
      + **> greater than**

   1. Choose the property or custom value to use as the threshold. AWS IoT Events compares the value of the property with the value of this attribute.
**Note**  
If you choose **Custom value**, enter a number.

   1. Enter the **Severity** of the alarm. Use an integer that your team understands to reflect the severity of this alarm.

   1. Choose an asset to preview this threshold.

   1. Choose **Next**.  
![\["Define threshold" page with model dropdown menus and "Preview" dropdown menu highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/alarms-create-define-threshold.png)

1. On the **Configuration settings** page, you enter a name and choose the default state for this alarm definition. Do the following:

   1. Enter a unique alarm name.

   1. Specify the **Default state** for this alarm definition. You can enable or disable all alarms created based on this alarm definition. You can enable or disable individual alarms associated with model in a later step.

   1. Choose **Next**.  
![\["Configure settings" screen with "Name" field highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/alarms-create-configure-settings.png)

1. On the **Configure notification** page, you configure the notification recipient, the message protocol, and the custom message to send when this alarm is invoked. Do the following:

   1. For **Recipient**, choose the recipient.
**Note**  
Your IT administrator must add IAM Identity Center users in the current AWS Region before you can add recipients for this alarm.

   1. For **Protocol**, choose from the following options:
      + **Email and text** – The alarm notifies IAM Identity Center users with an SMS message and an email.
      + **Email** – The alarm notifies IAM Identity Center users with an email.
      + **Text** – The alarm notifies IAM Identity Center users with an SMS message.

   1. For **Additional custom message**, you specify the custom message to send in addition to the default state change message. For example, you can specify a message that helps your team understand how to address this alarm.

   1. Choose **Create alarm definition**.  
![\[Create an alarm in the SiteWise Monitor portal.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/alarms-create-configure-notification.png)