Icinga Notifications Web¶

Warning

This is an early beta version for you to try, but do not use this in production. There may still be severe bugs.

At the moment, we don’t provide any support for this module.

Icinga Notifications is a set of components that processes received events from various sources, manages incidents and forwards notifications to predefined contacts. The components are:

Icinga Notifications, which receives events and sends notifications.
Icinga Notifications Web, which lets users configure Icinga Notifications and manage incidents.

Icinga 2 itself and other sources propagate state updates and other events to Icinga Notifications.

Big Picture¶

Icinga Notifications Architecture

All configuration of Icinga Notifications is done via Icinga Notifications Web. This includes the setup of sources Icinga Notifications will receive events from. To set up a source, an accompanying integration in Icinga Web is required. At the moment, compatible integrations are available for:

Icinga 2, by using Icinga DB as backend

Icinga Notifications receives events from the configured sources and decides whether to open an incident and when to forward them to which recipients. Icinga Notifications Web allows configuring these rules and managing incidents. To send notifications, Icinga Notifications is able to facilitate various types of channels, e.g., email, Rocket.Chat, webhook, etc.

Available Channels¶

The following channels are currently available out of the box:

email: Email submission via SMTP
rocketchat: Rocket.Chat
webhook: Configurable HTTP/HTTPS queries for third-party backends

Additional custom channels can be developed independently of Icinga Notifications, following the channel specification.

Installation¶

To install Icinga Notifications Web, see Installation.

License¶

Icinga Notifications Web and its documentation are licensed under the terms of the GNU General Public License Version 2.