OSMC 2008 | Nagios für Einsteiger by Sven Velt

Nagios für Einsteiger
Sven Velt
team(ix) GmbH
sv@teamix.net

2008-09-11
Sven Velt, team(ix) GmbH
Über mich
● Linux seit > 10 Jahren
● 1995 - 2001 Internet-Provider
– Verantwortlich für Technik
– 24/7 muss alles laufen
– Monitoring notwendig
– ... mehr als einmal nachts aufgestanden
● Seit 2002 bei team(ix) GmbH
– Schulungen, u. a. Nagios, Apache, Linux
– Projekte, größtenteils Nagios

2008-09-11
(Benötigte) Bausteine
● Nagios
– „Framework“
– Übernimmt Verwaltung, z.B. Scheduling von
Checks, Benachrichtigung
– Web-Frontend
● Nagios-Plugins
– Eigentliche Checks
● Add-Ons (optional)

2008-09-11
Packages vs. Source
Packages
● Schnell
● keine Fehler beim
Compilieren
● Updates durch
Distributor
Source
● Auf System
abstimmbar
● Neue Versionen
verfügbar
● Ahnung vom
Hintergrund

2008-09-11
Packages
● OpenSUSE
– nagios
– nagios-www
– nagios-plugins
– /etc/nagios/
● Debian
– nagios3
– nagios-plugins
– /etc/nagios3/
– /usr/lib/nagios/plugins/

2008-09-11
Sources (I)
● Voraussetzungen beachten!
(„Quickstart Guide“ in der Doku)
● Nagios und Nagios-Plugins compilieren:
– ./configure && make all
– su -c “make install“
– Weitere Make-Targets:
● make install-init
● make install-commandmode
● make install-webconf
● make install-config
}make fullinstall

2008-09-11
Sources (II)
● Pfade (ohne „--prefix=“-Angabe beim
configure-Aufruf):
– /usr/local/nagios/etc/
– /usr/local/nagios/libexec/

2008-09-11
Apache Konfiguration
● Meist in /etc/apache2/conf.d/
nagios.conf zu finden
● Einbindung des Web-Frontends
● Absicherung per Username/Passwort
– „AuthUserFile“ gibt an, wo diese
gespeichert sind
– wichtig für den Start: Ein Eintrag für
„nagiosadmin“
– Wenn nicht vorhanden:
htpasswd(2) FILE nagiosadmin

2008-09-11
Web-Frontend Zugriff
● Einfacher Start: „nagiosadmin“ darf alles
● Dazu alle „authorized_for...=“-Zeilen
mit „nagiosadmin“ in cgi.cfg versehen
– Wahrscheinlich nur Kommentarzeichen
entfernen
– Wir schaffen einen Super-User, der alles darf
● „use_authentication = 1“

2008-09-11
nagios.cfg – Objects (I)
● Definition von „Objects“ in eigenen
Dateien
● Organisation der Dateien ist dem Admin
überlassen
● Einbindung in Nagios
– via cfg_file=
● Einzelne Dateien direkt angegen
– via cfg_dir=
● Ein Verzeichnis rekursiv einlesen (Dateien müssen
auf „*.cfg“ enden!

2008-09-11
nagios.cfg – Objects (II)
● Persönliche(!) Empfehlung:
– Ein „cfg_dir“ für alle Konfigurationsdateien
– Unterteilung per Unterverzeichnisse
● das aber durchaus strikt und viel
– Evtl. einzelne, zusätzliche Files oder
Directories
● z.B. Debian:
„cfg_dir=/etc/nagios-plugins/config“

2008-09-11
Objects - Überblick
● Hosts & Hostgroups
● Services & Servicegroups
● Contacts & Contactgroups
● Timeperiods
● Commands
● (Host-/Service-Escalations)
● (Host-/Service-Dependencies)

2008-09-11
Konfiguration - Überblick

2008-09-11
Konfiguration - Verwirrung

2008-09-11
Die Objekte im Einzelnen
● Hosts - Einzelne Hosts/Rechner
● Services - Dienste
● Contacts - Kontakte
● Timeperiods - Zeitspannen
● Commands - Kommandos

2008-09-11
Templates
● „Da tippe ich mich ja zu Tode!“
● NEIN!
– Lösung: Templates
– Wiederkehrendes in Templates auslagern
– Verschieden Templates für verschieden
„Gruppen“
– Bei allen Objects möglich, nicht überall
sinnvoll
– Datei „templates.cfg“

2008-09-11
timeperiods
● Vordefiniert (timeperiods.cfg):
– 24x7
– workinghours
– none
– us-holidays
– 24x7_sans_holidays

2008-09-11
commands – notify
● Vordefiniert (commands.cfg):
– notify-host-by-email
– notify-service-by-email

2008-09-11
contacts
● Vordefiniert (contacts.cfg):
– nagiosadmin (AUA!)

2008-09-11
commands – check
● Vordefiniert (commands.cfg), u.a.:
– check-host-alive
– check_ping
– check_local_(disk|users|procs)
– check_local_(load|swap)
– check_ssh
– check_http
– ...

2008-09-11
hosts
● Vordefiniert (localhost.cfg):
– localhost
● Nicht aktviert (windows.cfg,
printer.cfg, switch.cfg):
– hplj2605dn
– linksys-srw224p
– winserver

2008-09-11
services
● Vordefiniert (localhost.cfg):
– PING
– Root Partition
– Current Users
– Total Processes
– Current Load
– Swap Usage
– SSH
– HTTP

2008-09-11
Templates (Wdh.)
● „Da tippe ich mich ja zu Tode!“
● NEIN!
– Lösung: Templates
– Wiederkehrendes in Templates auslagern
– Verschieden Templates für verschieden
„Gruppen“
– Bei allen Objects möglich, nicht überall
sinnvoll
– Datei „templates.cfg“

2008-09-11
Konfiguration testen
● WICHTIG!
– /.../nagios -v /.../nagios.cfg
– Fehler kommen schon vor dem Neustart ans
Licht!
– Nach jeder Änderung an der Konfiguration
ausführen!

2008-09-11
Time saving tricks
● Services
– host_name fasst mehre Hostnamen
– hostgroup_name ganzen Gruppen
– beides auch gleichzeitig!

2008-09-11
Was können Plugins?
● Alle Plugins besitzen eine Hilfe:
– check_* --help
● Beispiel: check_http
– Öffnet HTTP-Connection und wertet Rückgabe
aus
● -H localhost : Angabe des Rechners
● -m 5000:10000 : Seitengröße in Bytes
● -s Linux : Textstelle im Content
● --ssl : Verbindung per HTTPS/SSL
● --ssl -C 28 : SSL-Zertifiakt prüfen

2008-09-11
Plugin-Schnittstelle
● Plugin wird wie ein Programm/Skript
aufgerufen, Parameter werden übergeben
● Plugin gibt zurück:
– Return-Code: 0 (OK), 1 (WARN), 2 (CRIT),
3 (UNKNOWN)
● siehe auch „echo $?“ nach dem Aufruf
● oder PS1='$? u@h:w > '
– Eine Zeile Text
● „Output“: HTTP OK HTTP/1.1 200 OK – ...
● „Performance Data“: time=0.38s;;;0.00

2008-09-11
SOFT oder HARD?
● Nagios unterscheidet zwischen
– Es könnte ein Fehler sein (SOFT)
– Es ist ein Fehler (HARD)
● Jeder Host/Service wird mehrfach getestet
– max_check_attempts
● Erst wenn diese Anzahl erreicht ist, nimmt
Nagios an, dass wirklich ein Fehler
vorliegt
– check_interval +
(max_check_attempts - 1) * retry_interval

2008-09-11
Externe Steuerung
● Externe Steuerung (Web-Frontend!) bzw.
Verarbeitung von passiven Checks
● In nagios.cfg anpassen:
– check_external_commands=1
– log_external_commands=1
– external_command_file=/.../nagios.cmd
● ACHTUNG! „ls -l /.../nagios.cmd“
– Apache muss in die passende Gruppe:
● usermod -G GRUPPE www-data/wwwrun

2008-09-11
Netzwerkhierarchie
● Host können „parents“ haben
– Parent = Nächste(r) „Router“ auf dem Weg
zum Nagios-Server
– Dadurch Abbild des Netzwerks bzw. der
-Struktur im Nagios (siehe auch „Status-
Map“)
● Unterscheidung
– DOWN: Router ist kaputt
– UNREACHABLE: Die Rechner hinter dem
Router

2008-09-11
Benachrichtigungen

2008-09-11
Contacts
● Nur, wer Contact für einen Host/Service
ist, sieht diesen auch im Web-Frontend
● „nagiosadmin“ als Super-User zur
Kontrolle
– d.h. aber auch, alle Contacts müssen für den
Apache mit Passwort gepflegt werden!
– Wohl dem, der Apache 2.2 und alle User im
LDAP hat :-)
Wenn's sein muss, tut auch 'ne ADS :-(

2008-09-11
Notify
● Contact bekommt
– service_notify_command
– host_notify_command
● „Alles, was von der Kommandozeile
machbar ist“, geht:
– E-Mail, SMS, Instant Messenger, IRC(!)
– Anruf
– Fax
– SQL-Datenbank

2008-09-11
NRPE - Überblick
● Nagios Remote Plugin Executor
● NRPE-Daemon
– läuft auf zu überwachenden Maschine
● check_nrpe
– wird auf dem Nagios-Server aufgerufen

2008-09-11
NRPE-Daemon
● Typische Stolperfallen:
– „allowed_hosts“ in nrpe.cfg checken!
– Neustart nach Änderungen an Config!
– Kommando nicht eingetragen
● Allgemein:
– /var/log/... überprüfen! Da steht meistens
was schief geht

2008-09-11
check_nrpe
● Aufruf:
– check_nrpe -H HOST -c COMMAND
– „COMMAND“ wie es in der nrpe.cfg
eingetragen ist!
Ähnliche wie commands.cfg!

2008-09-11
Wunschkonzert!
Ich warte auf Vorschläge,
Fragen, Unklarheiten, ...
;-)

OSMC 2008 | Nagios für Einsteiger by Sven Velt

Weitere ähnliche Inhalte

Was ist angesagt?

Ähnlich wie OSMC 2008 | Nagios für Einsteiger by Sven Velt

OSMC 2008 | Nagios für Einsteiger by Sven Velt