Versions Compared

Old Version 26

changes.mady.by.user Sebastian Benz

Saved on

compared with

New Version 27

changes.mady.by.user Sebastian Benz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

PRTG ist ein Netzwerkmonitoring-System der Paessler AG. Die Kentix Geräte können unter Nutzung verschiedener Schnittstellen gut und einfach in die Software integriert werden. Weiterhin ist es möglich, das SMS-Gateway des AlarmManagers für die PRTG-Alarmierung zu nutzen.

Folgende Integrationsmöglichkeiten werden im Artikel beschrieben:

Table of Contents
maxLevel2

AlarmManager-Integration unter Verwendung einer Gerätevorlage (SNMP)

Zunächst aktivieren Sie die SNMP-Schnittstelle in der AlarmManager-Konfiguration. Ihnen Stehen die SNMP-Protokolle v2 und v3 zur Verfügung. Wählen Sie die Option Daten bereitstellen. Damit sind auf Seiten des AlarmManagers die Vorraussetzungen für die Integration bereits  erledigt.


Panel
titleIn PRTG sind folgende Schritte nötig

  1. Laden Sie zunächst die benötigten Dateien herunter

  2. Legen Sie die Template-Datei Kentix_AlamManager.odt im Ordner devicetemplates Ihrer PRTG-Installation ab. (C:\Program Files (x86)\PRTG Network Monitor\devicetemplates).
  3. Legen Sie Lookup-Files mit der Dateiendung .ovl im Ordner für die custom Lookup-Files ab.(C:\Program Files (x86)\PRTG Network Monitor\lookups\custom).



Divbox
stylewidth:300px
classbtn-wrapper

Template AlarmManager


Damit sind die Vorraussetzungen gegeben, um beim Hinzufügen des AlarmManagers die Gerätevorlage, und die in den Lookup-Files konfigurierten Alarmwerte für das Gerät zu verwenden. Beim Hinzufügen des AlarmManagers müssen Sie lediglich folgende Dinge auswählen:

Name und IP-Adresse des AlarmManagers auswählen

Icon und Automatische Suche mit Gerätevorlage auswählen

SNMP-Zugangsdaten des AlarmManagers angeben

PRTG führt dann eine automatische Suche anhand der IP-Adresse und der hinterlegten Gerätevorlage durch

Kentix-Systemintegration mit Verwendung der API-Schnittstelle

Alle Kentix-Geräte bieten eine API-Schnittstelle. PRTG bietet den REST Custom Sensor, der genau diese Schnittstelle abfragen und die bereitgestellten Werte mithilfe eines Templates strukturiert darstellen kann. Im Beispeil fragen wir die API-Route /api/devices/multisensor/values eines Multisensors ab. Zur Authentifizierung nutzen wir einen HTTP-Header mit Basic Authentication. Um diesen zu erstellen gehen Sie folgendermaßen vor.



Panel
titleErstellen HTTP-Header

  1. Kopieren Sie den API-Authentifizierungsschlüssel. Dieser dient als Benutzername für die Basic Authentication

  2. Ergänzen Sie den API-Key mit einem ":" und wandeln diesen in das BASE64-Format um. Nutzen Sie hierzu z.B. folgendes Tool: https://www.base64encode.org/
  3. Der HTTP-Header hat folgende Syntax: Authorization: Basic <credentials> Die credentials setzen sich zusammen aus Benutzername:password (Der Benutzername entspricht dem API-Key, gefolgt von dem ":", das Passwort bleibt leer
  4. Ein beispielhafter HTTP-Header mit dem Kommunikationsschlüsse "Kentix" sieht dann folgendermaßen aus: 
    Authorization: Basic ZjlhNzY2Yjg4NDBmNTMxMmExNGYwYTE5YzUzOWMzN2I2ZDJmMWQ0YjY4ZTI4OTQ5YmQ3MGQ2OTI2NGI4MzdiNTo=




Panel
titleVorbereitunge in PRTG

  1. Laden Sie zunächst die benötigten Dateien herunter

  2. Legen Sie die Template-Datei Kentix.multisensor.template im Unterordner rest (Custom Sensors) Ihrer PRTG-Installation ab. (C:\Program Files (x86)\PRTG Network Monitor\Custom Sensors\rest).
  3. Legen Sie das Lookup-File mit der Dateiendung .ovl im Ordner für die custom Lookup-Files ab.(C:\Program Files (x86)\PRTG Network Monitor\lookups\custom).



Divbox
stylewidth:300px
classbtn-wrapper

MultiSensor API-Template AlarmManager


Nun können Sie in PRTG einen REST Custom Sensor für den MultiSensor anlegen. Im Sensor selbst sind dann folgende sensorspezifischen Einstellungen notwendig: