---
title: Manage Alert Triggers
slug: bhdm/manage-alert-triggers
createdAt: 2022-10-05T21:11:22.000Z
---

:::hint{type="info"}
**Note**: The user interface below is for Belden Horizon Data Manager version 2.10.0 and later.&#x20;
:::

You can add a user alert trigger for edge devices in the *Triggers* section in the *Alerts* module.&#x20;

:::hint{type="warning"}
**Important**: Triggers require an action for notification implementation.
:::

Variables change depending on the **Source** selected.

# Before You Begin

Add an action to the *Action List* to receive a notification. See [Add new Action](https://public-docs.litmus.io/bhdm/alerts#zXY57) for detail&#x73;*.*

# Step 1: Select and Set Up Source

Completing the *Source&#xA0;*&#x73;ection first avoids issues with the variables for the *Subject* and *Message* fields in th&#x65;*&#xA0;Trigger* section. The source is the type of condition needed to trigger an alert.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/xSfj2_ZaXtaABfMkzBfxM_image.png" size="80" width="1899" height="115" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Source section" position="center" showCaption="true"}

**To select a source**:

1. Select a **Source**.   &#x20;The options are:&#x20;
   - **Metrics:&#x20;**&#x54;he *Trigger&#x20;*&#x73;ection's *Subject* and *Message* fields will be hidden and disabled. &#x20;
   - **Events:&#x20;**&#x54;he *Trigger&#x20;*&#x73;ection's *Subject* and *Message* fields will be revealed and enabled.
2. Click the **Add** link to add a new rule. The rule table drops down. The rule table is dependent on your source selection.

## Step 1a: Set Up Metrics Source

Select a metrics source to set up an alert that triggers based on metrics collected by Belden Horizon Data Manager, specifically when the value of a variable is a certain desired value or certain set/interval of values.  You may create only one metrics rule per alert.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/S03m6kcsCMIqU_NIH1bTB_image.png" size="80" width="1914" height="391" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Source section : Metrics Source" position="center" showCaption="true"}

**To set up a metrics source**:

1. From the **Select Alert template** drop-down list, select an alert template. The options are:
   - Connector disk buffer | Integration
   - Connector online status | Integration
   - DH device online status | Device Hub
   - DH device data quality | Device Hub
   - DH device tag value | Device Hub
   - Edge Device online status | Edge Device
   - Edge Device license expiration | Edge Device
   - Edge Device free disk space | Edge Device
   - Edge Device memory available | Edge Device
   - Edge Device CPU idle | Edge Device
   - Instance free disk space | System
   - Instance memory available | System
   - Instance CPU idle | System
   - Instance license expiration | System
2. For the alert template you've chosen, for each of it's respective fields, enter a respective value.

## Step 1b: Set Up Events Source

Select an events source to set up an alert that triggers when a specific event occurs.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/bvKmNvw7R-WZUfula9UAY_image.png" size="80" width="1908" height="504" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Source section : Events Source" position="center" showCaption="true"}

**To set up an events source**:

1. From the **Severity** drop-down list, select an option.&#x20;
   - *All*
   - *Info*
   - *Warning*
   - *Alert*
2. From the **Component** drop-down list, select an option.&#x20;
   - *All*
   - *cc - Integrations*
   - *mp - Marketplace*
   - *dh - Device Hub*
   - *auth - Auth*
   - *dm - Device Management*
3. From the **Event ID&#x20;**&#x64;rop-down list, select an option. Options are dependent on th&#x65;*&#x20;Component&#x20;*&#x73;elected. See [Event ID for User Alert Triggers](https://public-docs.litmus.io/bhdm/event-id-for-user-alert-triggers).
4. (Optional) Click **Show Event Attributes...** For each of the event attributes, enter a value.
5. (Optional) In th&#x65;**&#x20;Info** field, enter a value.
6. Repeat with additional new rules by clicking the **Add new rule** button as needed.

# Step 2: Set Up Trigger

You can customize the trigger's subject/message contents that will be sent to a recipient. The visibility of the *Subject* and *Message* fields are dependent on the *Source* selection from Step 1.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VYtFM0oyS7flZgkCmV_kj_image.png" size="80" width="1905" height="250" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Set up Trigger : Metrics version" position="center" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Qi24tSa7GKdu3_CA3z3oT_image.png" size="80" width="1904" height="505" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Set up Trigger : Events version" position="center" showCaption="true"}

**To set up the trigger**:

1. In th&#x65;**&#x20;Name** field, enter a name for the trigger.&#x20;
2. (Optional) Click the **Active&#x20;**&#x63;heckbox to set an active trigger flag.
3. (Optional) Click the **Dashboard&#x20;**&#x63;heck box to show trigger alerts on the dashboard.
4.   In the **Description** field, enter a description for the trigger.&#x20;
5. Events-source only
   - (Optional) In the **Subject&#xA0;**&#x66;ield, add subject text.
   - (Optional) Select one or more variables from the **Subject** variables list.
     - The options for *Events* source are:&#x20;
       - `$devicename`
       - `$componentid`
       - `$message`
       - `$triggerid`
       - `$hostname`
       - `$deviceid`
       - `$tags`
       - `$severity`
       - `$triggername`
       - `$type`
       - `$eventid`
     - The selected variables appear in the **Subject** field.
   - For the **Message&#xA0;**&#x66;ield, repeat the same steps as **Subject** field from above.

# Step 3: Set Up Scope

You can customize the scope of the user triggers. This will determine the applicable edge device(s) that will receive this alert trigger.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/uTAh_63PMzgjrtQ1_-30R_image.png" size="80" width="1908" height="174" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Set up Scope" position="center" showCaption="true"}

**To set up the scope**:

1. From the **Scope** section, select an option   . &#x20;
   - **All edge devices**
   - **Edge Device**. From the **Edge Device** drop-down list, select an edge device.

# Step 4: Set Up Action

You must create an action to use this section. You can select the response action that will immediately occur after the alert is triggered.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/vSVb1Wx3DPYmMOubBkkxD_image.png" size="80" width="1917" height="196" caption="Belden Horizon Data Manager User UI : Alerts : New Trigger : Set up Action" position="center" showCaption="true"}

**To set up the action**:

1. Select an option from the **Action List** drop-down list.
2. (Optional) Select the **Continuously&#x20;**&#x63;heck box.
   - If you have checked **Continuously**, enter a value in the **Notification Period** field in minutes.
3. Click **Save**.   &#x20;The alert trigger appears in the Trigger List.

