2018-09-19 22:38:01 +00:00
|
|
|
source: Alerting/Introduction.md
|
2018-10-27 22:04:34 +00:00
|
|
|
path: blob/master/doc/
|
2018-09-19 22:38:01 +00:00
|
|
|
|
|
|
|
# Introduction
|
|
|
|
|
2019-06-20 18:53:45 +00:00
|
|
|
To get started, you first need some alert rules which will react to
|
|
|
|
changes with your devices before raising an alert.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
|
|
|
[Creating alert rules](Rules.md)
|
|
|
|
|
2019-06-20 18:53:45 +00:00
|
|
|
After that you also need to tell LibreNMS how to notify you when an
|
|
|
|
alert is raised, this is done using `Alert Transports`.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
|
|
|
[Configuring alert transports](Transports.md)
|
|
|
|
|
2019-06-20 18:53:45 +00:00
|
|
|
The next step is not strictly required but most people find it
|
|
|
|
useful. Creating custom alert templates will help you get the benefit
|
|
|
|
out of the alert system in general. Whilst we include a default
|
|
|
|
template, it is limited in the data that you will receive in the alerts.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
|
|
|
[Configuring alert templates](Templates.md)
|
|
|
|
|
2019-10-21 00:47:40 +00:00
|
|
|
## Managing alerts
|
2018-09-19 22:38:01 +00:00
|
|
|
|
2019-06-20 18:53:45 +00:00
|
|
|
When an alert has triggered you will see these in the Alerts ->
|
|
|
|
Notifications page within the Web UI.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
2019-06-20 18:53:45 +00:00
|
|
|
This list has a couple of options available to it and we'll explain
|
|
|
|
what these are here.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
2019-10-21 00:47:40 +00:00
|
|
|
### ACK
|
2019-06-20 18:53:45 +00:00
|
|
|
|
2018-09-19 22:38:01 +00:00
|
|
|
This column provides you visibility on the status of the alert:
|
2019-06-20 18:53:45 +00:00
|
|
|
|
|
|
|
![ack alert](img/ack.png) This alert is currently active and sending
|
|
|
|
alerts. Click this icon to acknowledge the alert.
|
|
|
|
|
|
|
|
![unack alert](img/unack.png) This alert is currently acknowledged
|
|
|
|
until the alert clears. Click this icon to un-acknowledge the alert.
|
|
|
|
|
|
|
|
![unack alert until fault worsens](img/nunack.png) This alert is
|
|
|
|
currently acknowledged until the alert worsens or gets
|
|
|
|
better, at which stage it will be automatically unacknowledged and
|
|
|
|
alerts will resume. Click this icon to un-acknowledge the alert.
|
2018-09-19 22:38:01 +00:00
|
|
|
|
2019-10-21 00:47:40 +00:00
|
|
|
### Notes
|
2019-06-20 18:53:45 +00:00
|
|
|
|
|
|
|
![alert notes](img/notes.png) This column will allow you access to the
|
|
|
|
acknowledge/unacknowledge notes for this alert.
|