XML-Monitoring (PRTG)

XML-Monitoring (PRTG)

Diese Seite beschreibt die Funktionsweise für das XML-Monitoring für PRTG. Den Download für das Modul befindet sich auf der Hauptseite.

Technische Voraussetzungen

  • Paessler PRTG Network Monitor

  • STARFACE 8.1.0.4

  • Verfügbare Checks
    • STARFACE Accounts
    • STARFACE Fax Queue
    • STARFACE Hardware ID
    • STARFACE SIP Provider Registrierung
    • Alle SIP-Endgeräte
    • Status des PBX-Logs
    • Status des Support-Logs
    • Disk Space
    • CPU Load
    • Memory Info

Installation des PRTG Network Monitor

Wenn noch nicht vorhanden installiere den PRTG Network Monitor.

Kopiere alle Dateien aus der ZIP-Datei „PRTG_Monitoring.zip“ in den Ordner „C:\Program Files (x86)\PRTG Network Monitor\Custom Sensors\EXEXML“.

Auf der Weboberfläche von PRTG Network Monitor klicke auf „Geräte“->“Gerät hinzufügen“. Im neuen geöffneten Fenster wähle, Linux / macOS / Unix“ aus und bestätige mit „OK“.

image-4.png

Es öffnet sich ein weiteres Fenster. Unter „Name des Geräts“ wähle einen beliebigen Namen aus und unter „IPv4-Adresse/DNS-Name“ gebe die Adresse der Starface an.

image-5.png

In der Geräteübersicht klicke auf die Starface, sie erscheint unter „Linux / macOS / Unix“. Klicke auf das „+“ Symbol und danach auf „Sensor hinzufügen“. In der Suche gebe „Programm/Skript (Erweitert)“ ein und klicke diese dann an.

image-6.png

Vergebe einen funktionalen Namen für den Sensor. Unter „Programm/Skript“ wähle „prtg-monitoring.exe“ aus. Um die Funktion den Sensor zu konfigurieren, um z.B. die CPU-Auslastung gebe unter „Parameter“ „%host XMLMonitoring GetMonitoringData 10 starface cpuLoad“ ein.

image-7.png

Entnehme die Zusammensetzung des obigen Sensors den folgenden Tabellen:

Parameter aus dem Beispielsensor Erklärung
1 %host ist immer der Host, PRTG erlaubt es mit %host automatisch den Host zu übernehmen
2 XMLMonitoring Name der Modulinstanz
3 GetMonitoringData Die per RPC aufrufende Funktion
4 10 Login-ID von STARFACE
5 starface Passwort von STARFACE
6 cpuLoad Welcher Sensor aufgerufen werden soll. (wird in Tabelle 2 weiter beschrieben)
7 Wird NUR bei Sensor SIP Provider verwendet!
Parameter Funktion
starfaceAccounts zeigt die Anzahl maximaler Accounts, die erlaubt sind, wie viele Accounts angelegt sind und wie viele davon Admin Accounts sind
memInfo zeigt Informationen über freier, verfügbarer und Gesamtspeicher
allPeersOffline gibt eine Fehlermeldung, wenn alle Telefone offline sind
faxQueue Informationen über die Fax-Warteschlange
hardwareID zeigt die Hardware-ID
diskSpace gibt Informationen über den Speicherplatz auf der Root-Festplatte
cpuLoad zeigt den CPU-Load in den letzten 1, 5, 15 Minuten
sipProvider zeigt ob die SIP Leitung registriert ist. Hierfür wird der 7. Parameter verwendet, um den Namen der Leitung anzugeben (s. unten)
supportLogErrorString im Modul kann man ein String übergeben, nach dem in dem support.log gesucht werden soll. Wenn dieser String vorkommt, gibt der Sensor ERROR ausgeben
pbxLogErrorString im Modul kann man ein String übergeben nach dem in dem PBX-Log gesucht werden soll, wenn dieser String vorkommt, wird der Sensor ein ERROR ausgeben

Sensoren

Xml_PRTG_Sensoren-1.png

SIP Provider

„%host XMLMonitoring GetMonitoringData 10 starface sipProvider 0251 5906850@hfosip“

Die Leitungen müssen einzeln manuell erstellt werden. Ist nicht der ganze Name bekannt reicht auch der Benutzername, hier z.B 025196280080 und ein “@” am Ende, also “025196280080@”.