Die Open Monitoring Distribution OMD unterstützt den Betrieb mehrerer Sites auf einem Server. Die Sites laufen jeweils unter einem eigenen Benutzer. Leider verwenden einige nagios-plugins einen absoluten Pfad (/var/tmp/) zum Cachen von Dateien oder als statesdir. Ein Beispiel dafür sind check_oracle_health und check_logfiles, die sich gewisse Informationen zwischen zwei Aufrufen persistent ‘merken’.

Der absolute Pfad führt zu Problemen (Versionsunterschiede und Zugriffsrechte).

check_oracle_health: tablespace-remaining-time

Es gibt mehrere Plugins, die sich den Status zwischen zwei Aufrufen merken müssen.

Hier ein Beispiel für check_oracle_health –tablespace-remaining-time. Drei Sites installiert. Nach dem Update von OMD 0.46 auf OMD 0.48 kam es zu einem Problem.
Das Kommando lieferte einen Fehler, da das Stateddir in /var/tmp/check_oracle_health nicht zur Version passte. In Nagios kommt die Fehlermeldung “no data from plugin”, weil das Plugin mit einem Laufzeitfehler abstürzt.

OMD[mysite]:~$ type check_oracle_health
check_oracle_health ist /omd/sites/mysite/version/lib/nagios/plugins/check_oracle_health

OMD[mysite]:~$ check_oracle_health  --connect=//bigbox:1521/nie1.world \
   --username=nagios --password=secret \
   --mode=tablespace-remaining-time --report=short
Can't use an undefined value as an ARRAY reference at
/omd/sites/mysite/version/lib/nagios/plugins/check_oracle_health line 3145.

Nach dem Löschen des Cache funktioniert der Aufruf wieder.

OMD[mysite]:~$ sudo rm -f /var/tmp/check_oracle_health/*

OMD[mysite]:~$ check_oracle_health  –connect=//bigbox:1521/nie1.world \
–username=nagios –password=secret \
–mode=tablespace-remaining-time –report=short
OK – no problems

Codestelle

Das ist nicht unbedingt ein Programmierfehler. Das Plugin bekommt einfach die falschen Dateien (von einer alten Version oder parallel installierten OMD site). Vielleicht stimmen die Rechte auch nicht, da jede Site unter einem anderen Unix-Benutzer läuft.

statefilesdir

Das statefilesdir kann in check_oracle_health nicht per Kommandozeile gesetzt werden. Es wird zur Compiletime (configure) fest vorgegeben.

use vars qw ($PROGNAME $REVISION $CONTACT $TIMEOUT $STATEFILESDIR $needs_restart %commandline);

$PROGNAME = "check_oracle_health";
$REVISION = '$Revision: 1.6.8 $';
...
$TIMEOUT = 60;
$STATEFILESDIR = '/var/tmp/check_oracle_health';
$needs_restart = 0;

Lösungsvorschlag

Das Statefilesdir wird eventuell recht groß und sollte nicht auf der Ramdisk in ~mysite/tmp gespeichert werden. Ausserdem muss es meistens persistent sein.
Zur Zeit kann man es meistens nur beim Compilieren (configure) fest konfigurieren.
Es fehlt also eine Kommandozeilenoption oder eine Umgebungsvariable.

Jede Site sollte aber ihr eigenes statedir für alle Plugins haben, die ein state retention dir brauchen (z.B. ~mysite/var/tmp/plugin-name).

Auf nagiosplugins.org wurde dies schon einmal diskutiert (Nagios Plugin State Retention).

…

• Location – use ./configure –sharedstatedir to define, default $PREFIX/var. Override with NAGIOS_PLUGIN_STATE_DIRECTORY envvar at runtime if set. Add plugin name to end
• Key – Is used as the filename of the store. Default to state.dat. Recommend that this is set to the string returned by np_state_generate_key(), to be unique per plugin call. Key can only consist of alphanumerics and underscore

…

Vielleicht können die Entwickler sich auf einen Standard für Kommandozeilenparameter und/oder Umgebungsvariable einigen. Umgebungsvariablen müssten dann aber auch von anderen Komponenten, die Plugins aufrufen (mod_gearman, check_multi,..) weitergegeben werden.

Per Kommandozeile könnte man den Plugins dann auch das Verzeichnis übergeben:

$USER1$/check_oracle_healtth --statefilesdir $USER4$/var/temp/check_oracle_health ...

oder

$USER1$/check_oracle_healtth --statefilesdir /var/tmp/$USER3$/check_oracle_health ...

(den Parameter –statefilesdir gibt es noch nicht ab Version 1.6.9).

 

Ein Patchen der plugins fällt als Lösung aus, weil dann die Vorteile von OMD (Kopieren von sites, unterschiedliche Versionen von Sites) verloren gehen.

In OMD sollte das Verzeichnis bei einem Update vielleicht auch noch gelöscht werden um Kompabilitätsprobleme zu vermeiden.

Update1: 16.06.2011: check_oracle_health 1.6.9 verwendet $ENV(OMD_ROOT)

Ab Version 1.6.9 erkennt check_oracle_health durch die Umgebungsvariable OMD_ROOT automatisch, dass das Plugin unter OMD läuft und setzt das statefilesdir auf $ENV(OMD_ROOT)/var/tmp. Damit wird es bei “omd cp” mit kopiert und die Rechte passen wieder (siehe Kommentar von Gerhard ).

• Neue Features in check_oracle_health 1.6.9 mit automatischem statefilesdir unter OMD, RMAN-Checks (–mode rman-backup-problems), …

Der Mechanismus ist einfach und plausibel. Andere Plugins sollten es ebenso machen.