/PRTG

PRTG Library for IP-Symcon

Primary LanguagePHPOtherNOASSERTION

SDK Version 2.51 Version 6.2
License Check Style Run Tests
Spenden

Symcon-Modul: PRTG

Einbinden von PRTG Geräten und Sensoren in IPS.

Dokumentation

Inhaltsverzeichnis

1. Funktionsumfang

PRTG IO:

  • Schnittstelle zwischen den Device und Sensor Instanzen und PRTG.
  • Empfangen von Events aus PRTG.
  • Bereitstellen von IPS Systeminformation für einen PRTG-Sensor.
  • Abfragen von Graphen aus PRTG.

PRTG Konfigurator:

  • Auflisten alle in PRTG verfügbaren Geräte und Sensoren.
  • Erstellen von neuen Device und Sensor Instanzen in IPS.

PRTG Gerät:

  • Empfangen und darstellen des aktuellen Zustand.
  • Pausieren und Fortsetzen der Überwachung über die Frontends, Aktionen und PHP-Scripten.

PRTG Sensor:

  • Empfangen und darstellen des aktuellen Zustand.
  • Pausieren und Fortsetzen der Überwachung über die Frontends, Aktionen und PHP-Scripten.
  • Quittieren von Alarmmeldungen über die Frontends, Aktionen und PHP-Scripten.

2. Voraussetzungen

  • IP-Symcon ab Version 6.2
  • PRTG

3. Software-Installation

Über den 'Module-Store' in IPS das Modul 'PRTG' hinzufügen.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.
Module-Store

Die Abfrage ob ein Konfigurator Modul angelegt werden soll, ist zu bestätigen. Es wird automatisch die Konfiguration für den benötigten IO abgefragt.

4. Einrichten der Instanzen in IP-Symcon

Details sind in der Dokumentation der jeweiligen Module beschrieben.

In der Dokumentation des PRTG IO wird im Anhang erläutert wie eine Überwachung von IPS aus PRTG erfolgen kann.
Ebenso wird dort das Empfangen von Statusänderungen eines Sensors in IPS erläutert, damit IPS den Zustand zeitnah darstellen kann.

Es wird dingend empfohlen somit zuerst den PRTG IO zu erstellen und fertig zu konfigurieren, sowie in PRTG alle gewünschten Einstellungen vorzunehmen, bevor weitere Instanzen in IPS über den PRTG Konfigurator angelegt werden.

5. Anhang

1. GUID der Module

Modul Typ Prefix GUID
PRTG IO I/O PRTG {67470842-FB5E-485B-92A2-4401E371E6FC}
PRTG Configurator Configurator PRTG {32B8B831-91B2-44B5-9B66-9F1685647216}
PRTG Device Device PRTG {95C47F84-8DF2-4370-90BD-3ED34C65ED7B}
PRTG Sensor Device PRTG {A37FD212-2E5B-4B65-83F2-956CB5BBB2FA}

2. Hinweise

Der im PRTG IO verwendete Benutzer sollte in PRTG Administrative Rechte bekommen, um die Überwachung zu steuern und Alarme quittieren zu können.
Die Kommunikation zwischen IPS und PRTG kann sowohl per HTTP als auch per HTTPS (SSL/TLS) erfolgen.
Hierzu ist PRTG und die URL im PRTG IO entsprechend zu anzupassen. Unverschlüsselte Übertragung sollte niemals zur Kommunikation mit einem externen PRTG-Server genutzt werden, da die Login-Informationen dann nicht verschlüsselt übertragen werden!

3. Changelog

Version 2.51:

  • Sensor und Device Intervall konnte beim starten von Symcon falsch sein.

Version 2.50:

  • Wurde ein Sensor pausiert, so wurden alle Statusvariablen neu als String angelegt und die alten somit gelöscht.
  • Aktionen hinzugefügt.
  • Dynamische Konfigurationsformulare und somit einfacher zu konfigurieren.
  • IO zeigt den Event Webhook für PRTG an.
  • Event Webhook mit verbesserten NAT Support.
  • Event Webhook unterstützt abweichenden Port (z.B. für NAT).

Version 2.30:

  • Werte für Mbit/sek. und kbit/sek. waren um den Faktor 10 zu groß.

Version 2.20:

  • Fehler im IPS-Sensor behoben, wenn PRTG 'Keine Daten' als Nutzdaten übertragen hat.

Version 2.10:

  • Fehler im IPS-Sensor behoben, wenn Laufwerke keine Bezeichnung hatten
  • Fehler im IPS-Sensor behoben, wenn Pagefile genutzt wird

Version 2.00:

  • Release für IPS 5.1 und den Module-Store

Version 1.36:

  • Location Feld in create verschoben

Version 1.35:

  • Fehler im Konfigurator, wenn die Kategorie in der Kategorieauswahl nicht auf oberster Ebene war.
  • Fehlende Übersetzung ergänzt.
  • Konfigurator meldet wenn IO nicht aktiv ist.

Version 1.31:

  • Darstellungsfehler im Konfigurator beseitigt
  • Formen nutzen jetzt NumberSpinner mit Suffix anstatt IntervalBox

Version 1.30:

  • Fehlerbehandlung Datenaustausch überarbeitet
  • Konfigurator erstellt Instanz unterhalb von Kategorien mit dem Namen des jeweiligen Gerätes

Version 1.20:

  • Sensordaten eines SSL-Zertifikatssensor verursachten Fehler

Version 1.10:

  • SSL Checks sind desaktivierbar
  • Sensorwerte mit Laufzeit Tage verursachten Fehler

Version 1.0:

  • Erstes offizielles Release

4. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

PayPal:

Wunschliste:

6. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0