Latest News - July 2020: MIDAS v4.25 Now Available | COVID-19 Support

MIDAS PRTG Sensors Addon MIDAS PRTG Sensors Addon: 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:

  • Sensor Name: The name for your PRTG sensor i.e. "MIDAS"
  • Script URL: The URL to your MIDAS PRTG Sensors addon you've constructed above, i.e. "https://your_midas_url/prtg.pl?key=authorization_key&sensors=ALO,FLA"
  • Value Type: Select "Integer" if you're exclusively monitoring MIDAS parameters which return integer values, otherwise select "Float".
  • Number of Channels: IMPORTANT: Set this to the same number of sensor codes present in the comma separated list you constructed for the above URL (in the above example, this number is "2" ("sensors=ALO,FLA")

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.