Versions Compared

Key

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

...

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).
  4. load the Lookup Files in PRTG's Web Interface (Setup | System Administration | Administrative Tools | Load Lookups and File Lists)



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 ManagerManager (If the default SNMP v2c settings are used, no adjustments are necessary)

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).
  4. load the Lookup Files in PRTG's Web Interface (Setup | System Administration | Administrative Tools | Load Lookups and File Lists)



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