Create an Email-Alert Trigger for Connector Online Status
In this guide, you'll set up an alert and a trigger for Litmus Edge's default MQTT SSL connector that connects to Litmus Edge Manager. Then you will simulate a disconnection for the connector to trigger the alert.
Video
Before You Begin
- If you haven't yet connected your Litmus Edge instance to Litmus Edge Manager, see Activate an Edge Device. A Litmus Edge instance needs to be activated in Litmus Edge Manager before it can trigger alerts.
Step 1: Set Up an Email-Alert based Trigger
In this step you'll create an email notification alert. Next, you will create a trigger that will use the email notification alert. See Alerts for additional details.
From Litmus Edge Manager, navigate to Alerts and follow the steps below.
Step 1a: 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.
Add new Action icon- 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 1b: Set Up a Trigger
To set up a trigger:
From the Alerts pane, click the Add new Trigger icon. The New Trigger pane appears.
Add new Trigger icon- 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 Litmus Edge instance.
Source
- Select Metrics as the source of the trigger.
- Click Add new rule.
- Select Alert template: Select Connector online status.
- Enter the value 60 for Alert Delay, 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 2: Simulate a Disconnection
From Litmus Edge, you will simulate a disconnection with Litmus Edge Manager.
To simulate a disconnection:
- Log in to Litmus Edge.
- From the Navigation panel, select Integration. The Integration pane appears.
- From the generic-mqtt-ssl tile, click the toggle to disable the connector.
Step 3: Verify Successful Trigger and Alert
From Litmus Edge Manager, you will verify the simulated disconnection.
To verify the trigger and alert:
- Log in to Litmus Edge Manager.
- Select the appropriate company and project. The Dashboard pane appears for the project.
- From the navigation panel, select Incidents. The Incidents pane appears.
Confirm you see the incident listed.
The email address that was configured for the alert will also receive the respective alert email.
