Quelltext der Seite Zabbix:Template Windows Robocopy


[[Kategorie:Zabbix]]
[[Kategorie:Zabbix_Templates]]
==Vorschau==
Hier die Ansicht "'''''Latest Data'''''" mit den Rückgabecodes<br>
[[Datei:Zabbix_Template_Robocopy-001.png]]
<br>
<br>
----
==Value Mapping==
Eigentlich ist es ganz einfach die Ausführung von {{Key|Robocopy}} zu überwachen.<br>
Denn das Programm nutzt die Möglichkeit beim Beenden einen Fehlercode zu übergeben recht ausführlich.<br>
Nachzuschlagen zum Beispiel unter:<br>
* https://support.microsoft.com/en-us/kb/954404
* http://ss64.com/nt/robocopy-exit.html
Generell lässt sich sagen das jeder Exit-Code ab 8 einen Fehler bedeutet!<br>
<br>
Ich habe mir dazu in Zabbix mein persönliches Value-Mapping zusammengestellt (was Ihr mit dem Template für Zabbix 3.0.x importieren könnt):<br>
  0 ⇒ No Change
  1 ⇒ Copy OK
  2 ⇒ Extra Files (deleted)
  3 ⇒ Copy OK + Extra Files (deleted)
  4 ⇒ Some Files can not be overwritten
  5 ⇒ New files copied + some Files can not be overwritten
  6 ⇒ Extra Files (deleted) + some Files can not be overwritten
  7 ⇒ New files copied + Extra File + Files can not be overwritten
  8 ⇒ FAILED
  9 ⇒ FAILED (Copy OK)
 10 ⇒ FAILED (Extra Files)
 11 ⇒ FAILED (Copy OK + Extra Files)
 12 ⇒ FAILED (Overwrite Problems)
 13 ⇒ FAILED (Copy OK + Overwrite Problems)
 14 ⇒ FAILED (Extra Files + Overwrite Probs)
 15 ⇒ FAILED (Copy OK, Extra Files + Overwrite Probs)
 16 ⇒ FATAL ERROR
<br>
Nun müssen wir nur noch diesen Exit-Code von Robocopy zu Zabbix bekommen.
<br>
<br>
----
==Vorbereitung auf dem Host==
<u><big>'''Variante 1:'''</big></u> Installierter Zabbix-Agent<br>
Also in meinen Umgebungen ist auf den Servern immer der Zabbix-Agent installiert.<br>
Es gibt also ein Verzeichnis im welchen der Zabbix-Agent und dessen Konfigurationsdatei liegt, in meinen Umgebungen sind das in der Regel folgende Pfade:
 Agent:         "C:\Program Files\Zabbix\zabbix_agentd.exe"
 Konfiguration: "C:\Program Files\Zabbix\zabbix_agentd.win.conf"
Das wichtige ist aber das ich auch die {{Key|zabbix_sender.exe}} dort mit ablege!<br>
 Sender:        "C:\Program Files\Zabbix\zabbix_sender.exe"
<br>
Mit dem {{Key|zabbix_sender.exe}} kann man nämlich ganz hervorragend aus eigenen Skripten und Programmen heraus Daten an den Zabbix-Server senden.<br>
Und in der Konfigurationsdatei steht drin für welchen Host wir uns melden - und an welchen Server wir die Daten senden müssen.<br>
Deshalb rufen wir die {{Key|zabbix_sender.exe}} einfach wie folgt auf:<br>
 "C:\Program Files\Zabbix\zabbix_sender.exe" -c "C:\Program Files\Zabbix\zabbix_agentd.win.conf" -k Name.des.Keys -o Wert
<br>
Damit das funktioniert muss in der Konfigurationsdatei zwingend der <code>ServerActive=</code> Eintrag gesetzt sein:
 ServerActive=192.168.50.253:10051
Der Vorteil ist das dies auch nach einem Update des Agenten, Ändern des Host-Namen oder Wechsel des Zabbix-Server weiter funktioniert ohne das ich in meinem Batch-Skript etwas ändern muss.<br>
<br>
<br>
----
<u><big>'''Variante 2:'''</big></u> Direkt per {{Key|zabbix_sender.exe}}<br>
Alternativ lassen sich die Parameter auch alle einzeln an die {{Key|zabbix_sender.exe}} übergeben:<br>
 zabbix_sender.exe -I <IP-Adresse> -p <Port> -s <Name_des_Host_auf_dem_Zabbix_Server> -k Name.des.Keys -o Wert
Ihr müsstet euch diese also an eine geeignete Stelle kopieren.<br>
<br>
<br>
----

==Einbau der Meldung in das Robocopy-Script==
Der Aufruf von {{Key|Robocopy}} muss über ein Skript erfolgen ('''.bat''' oder '''.cmd''') und sieht zum Beispiel wie folgt aus:<br>
 robocopy \\SERVER\D$\Netzlaufwerke\BOB\ \\NAS\backup1\Netzlaufwerke\BOB\ /MIR /R:10 /W:3
Nun schreiben wir unmittelbar danach folgende Zeile:
 "C:\Program Files\Zabbix\zabbix_sender.exe" -c "C:\Program Files\Zabbix\zabbix_agentd.win.conf" -k znil.robocopy[Netzlaufwerke-BOB] -o %ERRORLEVEL%
<br>
Direkt nach der Ausführung von {{Key|Robocopy}} wird also der Exit-Code an Zabbix gesenden. Die Zeile muss direkt auf den Befehl von {{Key|Robocopy}} folgen!
Nachdem nämlich zum Beispiel die {{Key|zabbix_sender.exe}} den Wert gesendet hat steht in <code>%ERRORLEVEL%</code> der Exit-Code der {{Key|zabbix_sender.exe}} drin.<br>
<br>
Gesendet werden die Daten an den Host der in der Konfigurationsdatei definiert sind - mit dem Item-Key '''znil.robocopy[Netzlaufwerke-BOB]'''.<br>
Dieses muss es natürlich dann noch für den Host geben.<br>
<br>
<br>
----
==Item-Key anlegen==
Das können wir entweder in einem eigenen Template machen (empfohlen) oder auch direkt auf dem Host:<br>
[[Datei:Zabbix_Template_Robocopy-002.png]]<br>
<br>
Wichtig ist das
* Das '''Type''' auf {{Key|Zabbix Trapper}} steht
* Der '''Key''' absolut identisch mit dem ist den wir bei der {{Key|zabbix_sender.exe}} eintragen
<br>
Ich verwende hier immer
 znil.robocopy[Name_des_Jobs]
Den Wert in den eckigen Klammern passe ich also immer an.<br>
<br>
Jetzt könnt ihr euer Skript einmal laufen lassen - und er sollte euch unter '''Latest Data'''' etwas wie folgt liefern:<br>
[[Datei:Zabbix_Template_Robocopy-003.png]]<br>
<br>
<br>
----
==Trigger anlegen==
Generell sehe ich 2 sinnvolle Prüfungen beim Trigger:
* ob der letzte Exit-Code größer als 7 ist
* Wenn mehr als x Minuten/Stunden/Tage keine neuen Daten gekommen sind
mit ersterem Prüfen wir den Kopiervorgang an sich, mit zweiten ob unser Job überhaupt gelaufen ist.
Die Expression für die Prüfung auf den Exit-Code kann also wie folgt aussehen:<br>
 {znil Template Robocopy Example:znil.robocopy[Netzlaufwerke-BOB].last()}>7
Und die Prüfung ob der Job in den letzten 3 Tagen gelaufen ist so:<br>
 {znil Template Robocopy Example:znil.robocopy[Netzlaufwerke-BOB].nodata(3d)}=1
<br>
<br>
----

==Template==
Nachfolgend das Template. Es hat das Item für das obige Beispiel, die beiden Trigger - und enthält das '''Value-Mapping''':
<br>
:'''[[Media:znil_Template_Robocopy_Example_Zabbix_3.0.x.zip|znil_Template_Robocopy_Example_Zabbix_3.0.x.zip]]'''
Es ist erst ab Zabbix 3.0.x geeigent!<br>
<br>
<br>
----
==Kommentare==
<comments />