You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 55 Next »

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:

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.

Requiered 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).

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.

Creating 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:
  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=

Preparations 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).

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: