How-To Guides
BHDM User UI Guides
Create an Email-Alert Based Trigger for DeviceHub Devices
13 min
in this use case, you will set up an alert and a trigger for a belden horizon data operations (bhdo) device then you will simulate an error output so that an alert is triggered when the alert is triggered, the email addresses specified in the trigger will receive an email with information about the alert and before you begin you will have to enable smtp from the belden horizon data manager (bhdm) admin console see docid\ l2yv7i3mkj2hvma2blbxu to learn more if you haven't yet connected your bhdo instance to bhdm, see docid\ bbgh94p0zhjuz0juao6by step 1 add device follow the steps to docid\ t cwpe0 jsfw5 aoj8wpp select the device type simulator and driver name generator step 2 add tag after connecting the device, you can docid\ wpe2hmxelarlbnhwbuchy to the device configure the following for the tag name s random value generator value type string step 3 import topic into default generic mqtt ssl connector you will next import the tag you've created as a topic into the generic mqtt ssl connector that connects bhdo to bhdm to import the tag into the generic mqtt ssl connector log in to belden horizon data operations navigate to integration click the generic mqtt ssl connector tile click the topics tab click the import from devicehub tags icon the devicehub import dialog box appears select the check box to import the tag from the device you created earlier and click import click the enable all topics icon return to the integration pane and toggle the connect option and confirm the status is connected step 4 set up an email alert based trigger in this step you will create an email notification alert next, you will create a trigger that will use the email notification alert see docid\ qcrikcfexyjqabqjtkjmr for additional details from belden horizon data manager, navigate to alerts and follow the steps below step 4a set up an email alert to set up an email alert from the alerts pane, click the add new action icon the add new action dialog box appears from the add new action dialog box, enter the following details action template select email action name enter an action name enter email enter an email address that will receive the alert notifications limit enter 1 interval select minute click add the newly created action appears in the action list step 4b set up a trigger to set up a trigger from the alerts pane, click the add new trigger icon the new trigger pane appears from the new trigger pane, configure the following sections trigger name enter a name for the trigger active select the checkbox dashboard select the checkbox description enter a description for the trigger scope select edge device and select the appropriate bhdo instance source select metrics as the source of the trigger click add new rule select alert template select dh device data quality for target value, msgs/minute, enter 1 minute for alert delay, seconds, enter 60 seconds action action list select the action you previously created continuously select the checkbox to send notifications continuously notification period, minutes enter 1 when done, click save the alert trigger appears in the trigger list step 5 simulate invalid/corrupted data from belden horizon data operations, you will simulate the devicehub driver sending invalid/corrupted data to simulate a disconnection log in to belden horizon data operations from the navigation panel, navigate to devicehub > tags the tags pane appears click the action menu for the tag you created and select edit for the value type field, select float64 for the formula field, corrupt the formula field by replacing the s in sin with 1 so that the final formula starts with 1in then, click update tag step 6 verify successful trigger and alert from belden horizon data manager, you will verify the simulated error rate to verify the successful trigger and alert log in to belden horizon data manager select the appropriate company and project the dashboard pane appears for the project from the navigation panel, select incidents the incidents pane appears review that the incidents display in the list the email address that was entered from step 4a set up an email alert will also receive the respective alert email