PRTG Manual: Live Data

You can access live data and live status data of objects using the PRTG API.

In this section:

Single Object Property

Single Object Status

Multiple Object Property or Status

System Information

Getting PRTG System Status

You can also get the PRTG system status such as the number of alarms or messages using the following API calls.

i_speechExamples

Live system status in the Extensible Markup Language (XML) format:

/api/getstatus.xml?id=0

Live system status in the JavaScript Object Notation (JSON) format:

/api/getstatus.htm?id=0

All sensors in use in the JSON format:

/api/sensortypesinuse.json

Number of all sensor states:

/api/gettreenodestats.xml

Getting PRTG Health Status

You can also get the overall PRTG system health status such as probe connection status and if login is possible using the following API calls:

i_speechExamples

Live overall system status of PRTG in the JSON format:

/api/healthstatus.json

Live overall system status of PRTG Hosted Monitor in the JSON format:

/api/healthstatus.json&mode=hosted

Getting PRTG Health Data

You can also get the PRTG health data such as system CPU used (%), system memory used (%), disk space used (%), disk space used (GB), health (%), total number of probes, disconnected probes, total sensors, and sensor in the Unknown status using the following API calls:

i_speechExample

Live health data of PRTG in the JSON format using maxage:

/api/health.json&maxage=age

i_round_bluemaxage is the age in seconds for data to be considered "old". For example, if data is older than 4 minutes and maxage=120, the data will be refreshed and then sent to the client.

Live health data of PRTG in the JSON format using refreshnow:

/api/health.json&refreshnow=1/anything_else

i_round_blueIf refreshnow=1, the data will be refreshed before the API call is returned. Also, if refreshnow=1 is present in the API call, maxage will not be considered.

More

i_square_blueKNOWLEDGE BASE

How can I use the PRTG Application Programming Interface (API)?

https://kb.paessler.com/en/topic/593