wiki:NSM2021/Agenda/AlertsLibrenms

Version 12 (modified by admin, 4 years ago) ( diff )

--

Sending Notifications and Alerts using LibreNMS.

When a specific event occurs (eg: Link Down) NMS should be able to send administrators some notifications. On LibreNMS this is done by creating different Transports and Alerting Rules. Transports are the mechanism on how LibreNMS should send the alerts (may be by Email, by some API etc.), where Alerting Rules specify when and to whom to send those alerts.

Alert Transports

We need to specify which transport we are going to use.

On your UI, Go to Alerts --> Alert Transports

Email Transport

Email transports needs to be created per email basis. If you need two emails to be notified, You have to create two transports.

Go to Create Alert Transport

  • Transport Name: Email to <Name of Admin1>
  • Transport type: Mail
  • Default Alert: Off
  • Email: <Email Address of Admin1>

Once you save the transport it should see like the following.

Repeat the same for the second Email Address if you have any.


For Email Transports to Work, you need to setup email server details for LibreNMS. Since we haven't installed a public email server, lets use GMAIL as the smtp server.

Log in to https://myaccount.google.com with any of your personal gmail accounts.

Goto Security --> Less secure app access

Enable Allow less secure apps

Next, on your LibreNMS installation,

Goto Settings Wheel --> Global Settings --> Alerting --> Email Options and include gmail settings as per following.

Now go back to the Alert Transport page and click in front of your transports and check whether you received a test mail to your email account/s.

Slack Tranport

Slack ( https://slack.com )is an enterprise messaging platform used worldwide for professional use. Slack supports Web and Mobile versions so that we can use slack to generate alerts on mobile devices. This is done by using its SLACK API and by creating a BOT to message you with the alerts.

If you don't have a slack account for your institute, create one with free plan. (If there are multiple attendees from the same institute, Please create test accounts as it may become an issue later someday. (eg: PDN-test-Lorence) Or else one may create a single account and add/invite others and make them Administrators.

Do first three steps under Getting started with Incoming Webhooks on https://api.slack.com/messaging/webhooks ( Example steps here )

  • Next, Goto your LibreNMS Transport page and create a new transport and test. Use the webhook URL from your SLACK APP

  • If your transport worked, you should see something similar to this on your monitoring channel,

Telegram Transport

Telegram is a well-known messaging platform with many users on Mobile devices. We can create another BOT to send Alerts from LibreNMS to a Telegram Group.

Here we will add the BOT to a Telegram Group so that many users can be included into this group.

Telegram BOT and Group creation can be found from here.

Next, Setup the Telegram Transport on LibreNMS.

Once you test the transport, you should see similar message on your Telegram Group.

Transport Groups

On the Same Alert Transport page, Create a transport Group. Transport group allows us to set a rule to do alerting on a group of transports. Since we have multiple email address transports, Slack, Telegram, we need you group them before applying them to actual rules.

eg:

Alert Rules

Attachments (17)

Note: See TracWiki for help on using the wiki.