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+Nagios+Integration

Mit dem iLert Nagios / Icinga Notification Plugin können Sie Nagios / Icinga einfach in iLert integrieren. Ihr bestehendes Nagios- und 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 2.x im Einsatz?

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


Systemvoraussetzungen

  • Nagios 2, 3, 4 oder Icinga 1.x
  • Python 2.7.3 (oder höher)

Vorbereitung

Excerpt
  1. Erstellen Sie in iLert eine neue Alarmquelle



  2. Wählen Sie den Typ Nagios / Icinga aus und klicken Sie auf speichern.



  3. Es wird ein API Schlüssel generiert. Den API Schlüssen werden Sie unten bei der Einrichtung des Plugins benötigen.

Installationsanleitung

Laden Sie das iLert Nagios / Icinga Plugin runter und entpacken es:

Panel
> wget httphttps://wwwgithub.ilert.decom/siLert/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 Nagios als auch vom Cron-Daemon ausführbar sein:
Panel
> mv ilert_nagios.py /usr/local/bin
> chmod 755 /usr/local/bin/ilert_nagios.py

Aktivieren Sie in Nagios die Option enable_environment_macros (falls nicht bereits aktiv). Öffnen Sie hierfür Ihre Nagios Konfigurationsdatei nagios.cfg und setzen den Wert auf 1:

Panel
enable_environment_macros=1

Falls Sie eine größere Nagios- bzw. Icinga-Installation haben und enable_environment_macros auf 0 setzen möchten, ist das auch möglich. Weitere Informationen hierzu finden Sie in der Konfigurationsdatei ilert_nagios.cfg.

Öffnen Sie die Plugin-Konfigurationsdatei ilert_nagios.cfg und tragen den API Schlüssel im pager Feld der Kontaktdefinition ein, z.B.

Panel
define contact {
contact_name ilert
alias iLert
service_notification_period 24x7
host_notification_period 24x7
service_notification_options w,u,c,r
host_notification_options d,r
service_notification_commands notify-ilert
host_notification_commands notify-ilert
pager 12345678-abcd-efgh-ijkl-87654321
}
Kopieren Sie die Datei in das Nagios bzw. Icinga Konfigurationsverzeichnis (variiert je nach Installation).
Panel
> cp ilert_nagios.cfg /etc/nagios/conf.d/

Je nach Installation von Nagios oder Icinga gibt es eine nagios.cfg bzw. icinga.cfg Datei, in der Sie die iLert-Konfigurationsdatei einbinden müssen. Der Eintrag in der nagios.cfg würde für dieses Beispiel wie folgt aussehen:

Panel
cfg_file=/etc/nagios/conf.d/ilert_nagios.cfg

Fügen Sie den iLert Kontakt in Ihre Nagios / Icinga Kontaktgruppe hinzu. Falls Sie hier die Nagios Standardeinstellungen verwenden, öffnen Sie hierzu die Datei contacts.cfg für den iLert Kontakt hinzu:

Panel
define contactgroup{
    contactgroup_name admins
    alias Nagios Administrators
    members nagiosadmin, ilert
}

Editieren Sie die crontab-Datei von dem nagios Benutzer

Panel
> crontab -u nagios -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 Nagios / Icinga neu:

Panel
> /etc/init.d/nagios restart

FAQ

Welche Nagios 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 2.x?

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

Include Page
_FAQPluginSupport
_FAQPluginSupport