Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

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 (Geräte ab 02/2018): 

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 Voraussetzungen 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).
  4. Laden Sie die gespeicherten Lookup-Files im PRTG Web Interface (Setup | System Administration |  Administrative Tools | Load Lookups and File Lists)



Divbox
stylewidth:300px
classbtn-wrapper

Template AlarmManager


Damit sind die Voraussetzungen 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 (Werden die Default-SNMP v2c-Einstellungen verwendet, müssen keine Anpassungen erfolgen)

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

Kentix-Systemintegration unter 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 Beispiel 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).
  4. Laden Sie die gespeicherten Lookup-Files im PRTG Web Interface (Setup | System Administration |  Administrative Tools | Load Lookups and File Lists)



Divbox
stylewidth:300px
classbtn-wrapper

API-Template MultiSensor


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

AlarmManager als SMS-Gateway

Der AlarmManager bietet eine SMS-Gateway-Funktion. Diese kann von PRTG genutzt werden, um Alarme über die SIM-Karte des AlarmManager als SMS zu versenden.

Diese Funktion können Sie im AlarmManager unter Konfiguration → GSM aktivieren. An dieser Stelle vergeben Sie ein Passwort für das Gateway


Dieses Gateway können Sie dann in PRTG nutzen und die entsprechende URL hinterlegen:

https://192.168.100.222/php/sms_gateway.php?key=password&recipients=%SMSNUMBER&message=%SMSTEXT

Sv translation
languageen

PRTG is a network monitoring system developed by Paessler AG. The Kentix devices can be easily integrated into the software using various interfaces. It is also possible to use the AlarmManager's SMS gateway for PRTG alerts.

The following integration options are described in the article:

Table of Contents
maxLevel2

AlarmManager integration using a device template (SNMP)

First activate the SNMP interface in the AlarmManager configuration. The SNMP protocols v2 and v3 are available. Select the "Provide data" option. This already provides the AlarmManager with the requirements for the integration.


Panel
titleRequiered steps in PRTG
  1. First download the required files

  2. Place the template-file Kentix_AlamManager.odt in the devicetemplates folder of yourPRTG-installation ab. (C:\Program Files (x86)\PRTG Network Monitor\devicetemplates).
  3. Place lookup-files with the extension .ovl in the folder for custom Lookup-Files.(C:\Program Files (x86)\PRTG Network Monitor\lookups\custom).



Divbox
stylewidth:300px
classbtn-wrapper

Template AlarmManager


This provides the prerequisites for using the device template and the alarm values configured in the lookup files for the device when adding the Alarm Manager. When adding the AlarmManager you only have to select the following items:

Select name and IP address of the Alarm Manager

Select Icon and Auto discovery with Device Template

Specify SNMP access data of the Alarm Manager

PRTG then performs an automatic search using the IP address and the stored device template

Kentix system integration using the API interface

All Kentix devices provide an API interface. PRTG offers the REST Custom Sensor, which can query exactly this interface and display the provided values in a structured way using a template. In the example we query the API route /api/devices/multisensor/values of a multisensor. For authentication we use an HTTP header with Basic Authentication. To create this header, proceed as follows.


Panel
titleCreating HTTP-Header
  1. Copy the API authentication key. This serves as the user name for the Basic Authentication

  2. Add a ":" to the API key and convert it to the BASE64 format. Use the following tool for example: https://www.base64encode.org/
  3. The HTTP header has the following syntax: Authorization: Basic <credentials> The credentials consist of username:password (The username is the API key, followed by the ":", the password remains empty
  4. An example HTTP header with the communication key "Kentix" looks like this: 
    Authorization: Basic ZjlhNzY2Yjg4NDBmNTMxMmExNGYwYTE5YzUzOWMzN2I2ZDJmMWQ0YjY4ZTI4OTQ5YmQ3MGQ2OTI2NGI4MzdiNTo=




Panel
titlePreparations in PRTG
  1. First download the required files

  2. Place the template file Kentix.multisensor.template in the rest (Custom Sensors) subfolder of your PRTG installation. (C:\Program Files (x86)\PRTG Network Monitor\Custom Sensors\rest).
  3. Place the lookup file with the extension .ovl in the custom lookup files folder (C:\Program Files (x86)\PRTG Network Monitor\lookups\custom).



Divbox
stylewidth:300px
classbtn-wrapper

API-Template MultiSensor


Now you can create a REST custom sensor for the MultiSensor in PRTG. In the sensor itself the following sensor-specific settings are then required:

AlarmManager as SMS-Gateway

The AlarmManager offers an SMS gateway function. This can be used by PRTG to send alarms via the AlarmManager SIM card as SMS.

You can activate this function in the AlarmManager under Configuration → GSM. At this point you assign a password for the gateway


You can then use this gateway in PRTG and store the corresponding URL:

https://192.168.100.222/php/sms_gateway.php?key=password&recipients=%SMSNUMBER&message=%SMSTEXT