= 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.

[[Image(email_transport.png, 800px, nolink)]]

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.

[[Image(LibreNMS_Email.png, 800px, nolink)]]


Now go back to the Alert Transport page and click [[Image(Test_transport.png, 25px, nolink, bottom)]] 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 [wiki:NSM2021/Agenda/SlackGuide here] )


* Next, Goto your LibreNMS Transport page and create a new transport and test. Use the webhook URL from your SLACK APP[[br]]
[[Image(alert-transport.png, 500px, nolink)]]
* If your transport worked, you should see something similar to this on your monitoring channel,[[br]]
[[Image(Check-channel.png, 800px, nolink)]]

=== 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 [wiki:NSM2021/Agenda/TelegramGuide here].

Next, Setup the Telegram Transport on LibreNMS.

[[Image(Telegram-transport.png, 600px, nolink)]]

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

[[Image(Telegram-test.png, 800px, nolink)]]

== 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:

[[Image(Transport-Group.png, 600px, nolink)]]


== Alert Rules ==