Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Auf dieser Seite:

Table of Contents
maxLevel2

Param Include
page_English Translation
url=/display/ID/iLert+Icinga+2+Integration

Mit dem iLert Icinga Notification Plugin können Sie Icinga einfach in iLert integrieren. Ihr bestehendes Icinga-System (und andere Nagios-Forks) können Sie so um die SMS-, Push- und Sprach-Benachrichtigung von iLert einfach erweitern.

Note
titleHaben Sie Icinga 1.x im Einsatz?

Für Icinga 1.x nutzen Sie bitte die Anleitung iLert Icinga 1 Integration

Systemvoraussetzungen

  • Icinga 2.x
  • Python 2.7.3 (oder höher)

Vorbereitung

Excerpt Include
iLert Nagios Integration
iLert Nagios Integration
nopaneltrue

Installationsanleitung

Laden Sie das iLert Icinga Plugin runter und entpacken es:

Panel
> wget https://github.com/iLert/ilert-nagios/archive/v1.4.zip
> unzip ilert_-nagios-1.4.zip

Legen Sie die Plugin-Datei nagios_ilert.py im Verzeichnis /usr/local/bin ab. Die Datei muss sowohl von Icinga als auch vom Cron-Daemon ausführbar sein:

Panel
> mv ilert_nagios.py /usr/local/bin
> chmod 755 /usr/local/bin/ilert_nagios.py

Öffnen Sie die Plugin-Konfigurationsdatei ilert_icinga2.conf und tragen den API Schlüssel im pager Feld der User-Definition ein, z.B.

Panel
object User "ilert" {
display_name = "iLert"
groups = [ "icingaadmins" ]
states = [ OK, Warning, Critical, Unknown]
types = [ Problem, Recovery, Acknowledgement ]
vars.additional_notes = "This user maps to an alert source in iLert."
pager = "12345678-abcd-efgh-ijkl-87654321"
}

Kopieren Sie die Datei in das Icinga Konfigurationsverzeichnis (variiert je nach Installation).

Panel
> mv ilert_icinga2.conf /etc/icinga2/conf.d/

Über das Attribut vars.notification.enable_ilert = true in Host- und Service-Definitionen können Sie iLert als Benachrichtigungskontakt aktivieren. Um iLert für alle Hosts und Services zu aktivieren, fügen Sie das Attribut in das Template /etc/icinga2/conf.d/templates.conf ein:

Panel
template Host "generic-host" {
 max_check_attempts = 5
 check_interval = 1m
 retry_interval = 30s check_command = "hostalive"  

 vars.notification.enable_ilert = true

template Service "generic-service" {
 max_check_attempts = 3
 check_interval = 1m
 retry_interval = 30s  

 vars.notification.enable_ilert = true 
}

Editieren Sie die crontab-Datei von dem Icinga Benutzer

Panel
> crontab -u icinga -e

Fügen Sie folgenden Eintrag hinzu:

Panel
* * * * * /usr/local/bin/ilert_nagios.py -m send

Über diesen Cron-job werden im Minutentakt Events an iLert gesendet, die im ersten Sendeversuch gescheitert sind (z.B. aufgrund eines Netzwerkfehlers).

Starten Sie Icinga neu:

Panel
> /etc/init.d/icinga2 restart

FAQ

Welche Icinga Notification Types werden vom Plugin verarbeitet?

Das Plugin verarbeitet die Notification Types PROBLEMACKNOWLEDGEMENT und RECOVERY. Die Notification Types FLAPPING* und DOWNTIME* werden ignoriert.

Include Page
_FAQInternetConnection
_FAQInternetConnection

Unterstützt das Plugin auch Icinga 1.x?

Ja, die Anleitung finden Sie unter iLert Icinga 1 Integration.

Include Page
_FAQPluginSupport
_FAQPluginSupport