Freeware und Plugins

Freewaregruppe Monitoring/Nagios-Plugins

check_windows_repadmin

Windows-Plugin: Prüft den Zustand von Replikationen innerhalb Microsoft Active Directory

Beschreibung

check_windows_repadmin ist ein Windows-Plugin für Nagios, welches den Zustand von Replikationen innerhalb Microsoft Active Directory überprüft.
Das Plugin ermittelt dabei den Zustand aller Replikationspartner und besteht aus 2 Teilen: dem Checks selbst und einem Task, der alle 5-60 Minuten gestartet werden muss um eine Logdatei zu schreiben.
Dieser Task (task_windows_repadmin.exe) kann über die Windows-interne Aufgabenplanung bspw. für eine Ausführung alle 30 Minuten eingerichtet werden.
Die dabei erzeugte Protokolldatei wird vom Check anschließend ausgewertet.

Voraussetzungen

task_windows_repadmin

Dokumentation

Zuerst ist der Task zum Schreiben der Protokolldatei einzurichten, hierzu verwenden wir vorzugsweise die Aufgabenplanung und erzeugen hier einen Task, der alle n Minuten aufgerufen wird. Der Wert reicht dabei von 5 bis maximal 60 Minuten.

Der Task task_windows_repadmin.exe verwendet in den Standardeinstellungen das Schreiben der Protokolldatei in

C:\Temp als Datei repadmin.log

Dies lässt sich unter Nutzung des Parameters tempfile überschreiben:

task_windows_repadmin.exe tempfile= C:\Protokolle\Mein_Protokoll.log

Nach Einrichten des Tasks ist zu prüfen, dass dieser eine Logdatei im angegebenen Verzeichnis schreibt.

Jetzt kann das Prüfskript eingesetzt werden, dieses wird normalerweise ohne weiteren Angaben aufgerufen:

C:> check_windows_repadmin.exe

Zu Debuggingzwecken kann es aber auch mit einer ausführlicheren Ausgabeoption aufgerufen werden (dieser Modus eignet sich nicht für den Dauerbetrieb, sondern dient nur Testzwecken!).
Es werden dann detailliert die Stati der einzelnen Komponenten ausgegeben:

C:> check_windows_repadmin.exe debug

C:\scripts> check_windows_repadmin.exe debug
Timeout: 15
Tempfile: C:\Temp\repadmin.log
Startzeit der Replikationszusammenfassung: 2014-09-07 18:13:09
Datensammlung für Replikationszusammenfassung wird gestartet.
Dieser Vorgang kann einige Zeit dauern.
.....
Quell-DSA         Größtes Delta   Fehler/gesamt %% Fehler

LE-DOM-01               21m:26s   0 /   5   0
LE-DOM-02               22m:55s   0 /   5   0

Ziel-DSA           Größtes Delta   Fehler/gesamt %% Fehler
LE-DOM-02               22m:55s   0 /   5   0
LE-DOM-01               21m:26s   0 /   5   0

REPADMIN OK: Source DSA: LE-DOM-01 Errors: 0, LE-DOM-02 Errors: 0 - Destination DSA: LE-DOM-01 Errors: 0, LE-DOM-02 Errors: 0 | Src-LE-DOM-01-Err=0 Src-LE-DOM-02-Err=0 Dst-LE-DOM-01-Err=0 Dst-LE-DOM-02-Err=0

Installation

Vorzugsweise wird das Plugin in das Skriptverzeichnis kopiert, in dem man seine Prüfskripte unter Windows ablegt.

Bei Einsatz von NSClient++ wird in der Initialisierungsdatei nsc.ini ein Eintrag ähnlich diesem erzeugt, der auf Check_Windows_RepAdmin verweist:

...
[/modules]
NRPEServer=enabled
CheckExternalScripts=enabled

[/settings/NRPE/server] 
allow arguments=true  

[/settings/external scripts/scripts] 
check_windows_repadmin=scripts\check_windows_repadmin.exe
...

Beispiele

Prüfung der Replikationen unter Verwendung einer anderen Protokolldatei:

check_windows_repadmin=c:\nsclient++\scripts\check_windows_repadmin.exe tempfile=“c:\protocols\repadmin.log“

Prüfung der Replikationen unter Verwendung einer anderen Protokolldatei und Festlegung einer halbstündigen Erneuerung der Replikationsinformationen:

check_windows_repadmin=c:\nsclient++\scripts\check_windows_repadmin.exe tempfile=“c:\protocols\repadmin.log“ outdated=30

Changelog

29.11.2018
Add Windows Server 2016/2019 compatibility

07.09.2014
1.0 – First public version

Copyright

check_windows_repadmin wird unter der GNU General Public License zur Verfügung gestellt.

Autor

Joachim Luft beantwortet gerne Ihre Fragen zu diesem Plugin und freut sich natürlich auch über eine kleine Spende!

Freeware-Name

check_windows_repadmin

  • System: Nagios Plugins und Addons
  • Datum: 29.November 2018
  • Autor: Joachim Luft
  • Version: 1.1

Kategorie: Monitoring/Nagios-Plugins

Tags: Windows-Plugin

Download