MIDAS PRTG Sensors Addon

MIDAS PRTG Sensors AddonPRTG Sensors
PRTG Network Monitor

About PRTG

PRTG is a leading professional network monitoring software solution, trusted by over 150,000 network/IT administrators worldwide to provide unified monitoring of the performance and reliability of their entire networks, infrastructure and applications.
We also use PRTG here at MIDAS for 24/7 monitoring of our infrastructure.
A free version of PRTG is available (allowing monitoring with up to 100 sensors) alongside licensing options if a greater number of sensors are required.

MIDAS PRTG Sensors Addon

Our PRTG Sensors addon allows you to monitor key parameters and metrics from your self-hosted or cloud-hosted MIDAS scheduling system in real-time. For example, you can keep track on the number of users currently logged into your MIDAS system, the number of failed login attempts, the size of your database, the number of visitors on your premises, the number of bookings taking place today, and much much more!

Pre-Requisites

This addon requires the following:

Installing the Addon

The PRTG Sensors addon is available as an option for MIDAS v4.11 (or later), and can be purchased along with MIDAS, or added at a later stage to an existing system.Once purchased, the PRTG Sensors addon will become available for one-click installation via MIDAS Admin Options → Manage Addons → Addons Ready To Install → PRTG Sensors

Configuration & Usage

Once you've installed the PRTG Sensors addon, simply go to MIDAS Admin Options → Manage Addons → Installed Addons → PRTG Sensors to obtain (or generate) an Authorization Key.
This key helps prevent unauthorized access to the sensor data generated by the addon, and may be changed at any time. If you change this key, your MIDAS PRTG Sensors will stop working until you update the Authorization Key contained within the sensor URL in your PRTG installation.

To start monitoring MIDAS parameters within your your PRTG installation, first decide which parameter(s) you wish to monitor, from the sensor table below:

Sensor CodeTypeSensor Description
ALOIntegerNumber of currently active logins
BATIntegerNumber of bookings added today
BMTIntegerNumber of bookings modified today
BDTIntegerNumber of bookings deleted today
BTPIntegerNumber of bookings taking place today
DBSFloatCurrent database size (in MB)
ESTIntegerNumber of emails sent today
FLAIntegerNumber of failed login attempts today
ICTIntegerNumber of invoices created today
LOKIntegerNumber of locked/suspended user accounts
NBOIntegerNumber of bookings
NCLIntegerNumber of clients
NORIntegerNumber of organizations
NUSIntegerNumber of users
NVEIntegerNumber of venues
OBRIntegerNumber of outstanding booking requests
SOSIntegerNumber of staff on site
VISIntegerNumber of visitors on site

Next, construct a URL containing your authorization key and a comma separated list of the parameters you wish to monitor as follows:

https://your_midas_url/prtg.pl?key=authorization_key&sensors=comma_separated_list_of_sensor_codes

So for example, if you wish to monitor the number of current active logins in your MIDAS system ("ALO") and the number of failed login attempts today ("FLA") in a single PRTG sensor, the resulting URL would be:

https://your_midas_url/prtg.pl?key=authorization_key&sensors=ALO,FLA

Next within your PRTG installation, create a new "HTTP Content" Sensor:

Add HTTP Content Sensor

In the Sensor Settings dialog, set the following:

Basic Sensor Settings

Click "Continue" and PRTG will create your new sensor:

HTTP Content Sensor Display

By default, channels in your newly created sensor will be named "Value 1", "Value 2", etc, however, you can rename these to match the corresponding MIDAS parameters being monitored, via "Edit Channel Settings":

Naming HTTP Content Sensor Channels

Note: The channel order in your PRTG sensor is determined by the order of comma separated sensor codes passed in the URL you supplied. In our example (where the sensor string "ALO,FLA" was supplied), the first channel being monitored is "ALO" (current logins) and the second channel is "FLA" (number of failed login attempts)

Tip: You can use the same URL (with different sensor codes) to create additional sensors within your PRTG installation and monitor other metrics and parameters of your MIDAS system in separate sensors.

Release Notes

v1.00
17th December 2015· Initial release of the PRTG Sensors Addon (for MIDAS v4.11+)