New Question
 
 
PRTG Network Monitor

Intuitive to Use.
Easy to manage.

200.000 administrators have chosen PRTG to monitor their network. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free PRTG
Download >>

 

What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

 

Top Tags


View all Tags


How can I display sensor data from various PRTG installations in a single Map?

Votes:

0

Your Vote:

Up

Down

I would like to retrieve information on certain indicators, such as availability of systems, of more than one PRTG installation and show this data within one dashboard.

How can summarize data of different sensors on different PRTG installations? How can I accumulate the data to show it on one map?

api http-xml-rest-value-sensor maps prtg

Created on Nov 2, 2016 1:36:05 PM by  Jonas Vieracker [Paessler Support]

Last change on Nov 4, 2016 3:36:27 PM by  Gerald Schoch [Paessler Support]



1 Reply

Accepted Answer

Votes:

0

Your Vote:

Up

Down

This article applies to PRTG Network Monitor 16 or later

Accumulating Sensor Data with HTTP XML/Rest Value Sensor

When it comes to huge or several PRTG installations at one company (or as an MSP), it is helpful to display certain indicators of multiple devices or installations within one sensor or on a dashboard. With PRTG you can gather data of specific sensors either from the same installation or from several ones and show it within one sensor!

The PRTG HTTP XML/REST Value sensor is able to retrieve and parse an XML file from a given URL. With the PRTG API you can craft such URLs and use them. You can then add the sensor to a map within the installation you have created it.

How to Add and Configure a HTTP XML/Rest Value Sensor

  1. Add a new HTTP XML/REST Value sensor to a device in your PRTG installation (for example, to the Probe Device).
  2. Adjust the Basic Sensor Settings to your needs.
    • For example, enter a meaningful sensor name, especially if you use multiple HTTP XML/Rest Value sensors in your installation.

Further Sensor Settings and Creating the API Request

(1) Draft required URL

The URL field in the sensor settings is where you have to enter the API request to retrieve the needed data from a PRTG installation.

The following picture shows how you can create the URL for your API request.


Click here to enlarge.

The following steps show you how to create such an API request in detail. To prepare the URL you need a text editor and access to the API of your PRTG installation.

  1. Provide your PRTG server name: http://<yourPRTGserver>
    Access your PRTG installation via the web interface, copy the server name, including http(s)://, and add the name to the text editor.
  2. Add API function: /api/table.xml
    • In the PRTG manual, go to Live Data.
    • Add the desired API function (here: table.xml) after server name in your editor.
  3. Add data table parameters: ?content=sensors&columns=sensor,status
    • You can find all data table parameters here.
    • In this use case, the parameters content=sensor and columns=sensor,status are necessary.
    • Insert the data table parameters after the API function in your editor.
  4. Add advanced filter: &filter_status=#&filter_tags=@tag(tagname)
    • To get the required information, you need to further filter the data to retrieve. For example, filter by name tag to receive data of the desired sensors.
    • In this case you can use these filters: by status (for example, up OR down OR warning) and by name tag
    • You can find advanced filters here.
    • Example: For all Ping sensors with status down you would use the filter &filter_status=5&filter_tags=@tag(pingsensor)
    • Insert your advanced filter after the data table parameters in your editor.
  5. Add authentication: &username=myuser&passhash=hash
    • To access the data of a PRTG installation via the HTTP XML/REST Value sensor, the request does need an authentication, the credentials of a PRTG user account with sufficient rights.
    • Username: your PRTG login name (for example, PRTG Administrator)
    • Passhash: You can find your passhash under PRTG | Setup | My Account, section User Account. Click Show Passhash to display it.
    • Copy the hash and insert it after passhash= in your editor.
    • Insert your authentication after the advanced filter in your editor.
  6. XML Node and Sensor Value
    • Enter the XML node. This determines the sensor value.
    • In this use case it is sensor.
    • For the setting Sensor Value choose the option Use the number of occurrences of the selected XML node or its children/siblings to return the sensor count depending on your filter.

(2) Additional settings

Check your sensor settings according to the screenshot below.


Click here to enlarge.

After saving all settings, the sensor will appear in your installation on the device you have added it.


Click here to enlarge.

Now you can also add this sensor to a map!

Note: Add limits to the sensor channel settings to receive notifications based on your defined thresholds (for example, if 5 Ping sensors are in down status).

Created on Nov 2, 2016 2:39:05 PM by  Jonas Vieracker [Paessler Support]

Last change on Aug 14, 2018 8:05:23 AM by  Brandy Mauff [Paessler Support]



Please log in or register to enter your reply.


Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.