BLinz2: Textersetzung - „“ durch „“

2017-08-06T18:52:10Z

Textersetzung - „<comments>“ durch „<comments />“

Neue Seite

[[Kategorie:Zabbix]]
[[Kategorie:Zabbix_Templates]]
==Vorschau==
Hier die Ansicht "'''''Latest Data'''''" mit den Rückgabecodes 
[[Datei:Zabbix_Template_Robocopy-001.png]]
 
 
----
==Value Mapping==
Eigentlich ist es ganz einfach die Ausführung von {{Key|Robocopy}} zu überwachen. 
Denn das Programm nutzt die Möglichkeit beim Beenden einen Fehlercode zu übergeben recht ausführlich. 
Nachzuschlagen zum Beispiel unter: 
* 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! 
 
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): 
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
 
Nun müssen wir nur noch diesen Exit-Code von Robocopy zu Zabbix bekommen.
 
 
----
==Vorbereitung auf dem Host==
<big>'''Variante 1:'''</big> Installierter Zabbix-Agent 
Also in meinen Umgebungen ist auf den Servern immer der Zabbix-Agent installiert. 
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! 
Sender: "C:\Program Files\Zabbix\zabbix_sender.exe"
 
Mit dem {{Key|zabbix_sender.exe}} kann man nämlich ganz hervorragend aus eigenen Skripten und Programmen heraus Daten an den Zabbix-Server senden. 
Und in der Konfigurationsdatei steht drin für welchen Host wir uns melden - und an welchen Server wir die Daten senden müssen. 
Deshalb rufen wir die {{Key|zabbix_sender.exe}} einfach wie folgt auf: 
"C:\Program Files\Zabbix\zabbix_sender.exe" -c "C:\Program Files\Zabbix\zabbix_agentd.win.conf" -k Name.des.Keys -o Wert
 
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. 
 
 
----
<big>'''Variante 2:'''</big> Direkt per {{Key|zabbix_sender.exe}} 
Alternativ lassen sich die Parameter auch alle einzeln an die {{Key|zabbix_sender.exe}} übergeben: 
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. 
 
 
----

==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: 
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%
 
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. 
 
Gesendet werden die Daten an den Host der in der Konfigurationsdatei definiert sind - mit dem Item-Key '''znil.robocopy[Netzlaufwerke-BOB]'''. 
Dieses muss es natürlich dann noch für den Host geben. 
 
 
----
==Item-Key anlegen==
Das können wir entweder in einem eigenen Template machen (empfohlen) oder auch direkt auf dem Host: 
[[Datei:Zabbix_Template_Robocopy-002.png]] 
 
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
 
Ich verwende hier immer
znil.robocopy[Name_des_Jobs]
Den Wert in den eckigen Klammern passe ich also immer an. 
 
Jetzt könnt ihr euer Skript einmal laufen lassen - und er sollte euch unter '''Latest Data'''' etwas wie folgt liefern: 
[[Datei:Zabbix_Template_Robocopy-003.png]] 
 
 
----
==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: 
{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: 
{znil Template Robocopy Example:znil.robocopy[Netzlaufwerke-BOB].nodata(3d)}=1
 
 
----

==Template==
Nachfolgend das Template. Es hat das Item für das obige Beispiel, die beiden Trigger - und enthält das '''Value-Mapping''':
 
:'''[[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! 
 
 
----
==Kommentare==
<comments />

Zabbix:Template Windows Robocopy - Versionsgeschichte

BLinz2: Textersetzung - „“ durch „“