PRTG Manual: System Information
You can access live data and live status data for system information using the PRTG API.
Authentication with API key or user name and passhash (or user name and password) must always be included in each PRTG API request. See section HTTP API for more information.
To retrieve system information using API calls, we recommend that you use the following order:
- Refresh the system information so that it is up to date, if necessary.
For details, see Scan Now. - Retrieve generic system information to make sure that the last scan (step 1) was successful and that there are no errors.
For details, see Generic Data. - Retrieve system information in the form of data tables.
For details, see Data Tables.
System information API calls only support the JavaScript Object Notation (JSON) output.
The following API calls to retrieve new information for a system information category. To refresh system information via the API, you need to provide
- the ID of a device (parameter id), and
- a kind (system information category).
We recommend that you only refresh system information if absolutely necessary because the refresh triggers a rescan of all system information tables.
Examples Refresh process information /api/sysinfochecknow.json?id=deviceid&kind=processes Refresh hardware information /api/sysinfochecknow.json?id=deviceid&kind=hardware sysinfochecknow only supports JSON output. |
Supported Output Columns ("kind=" Parameter)
Column Name |
Category (as displayed in the PRTG web interface) |
---|---|
system |
System |
hardware |
Hardware |
processes |
Processes |
services |
Services |
software |
Software |
loggedonusers |
Users |
The following API calls retrieve generic data about the system information category since the last scan, for example time stamps and if the last scan was successful. To retrieve this information via the PRTG API, you need to provide
- the ID of a device (parameter id), and
- a kind (system information category).
Examples Users /api/sysinfo.json?id=deviceid&kind=loggedonusers Services /api/sysinfo.json?id=deviceid&kind=services sysinfo only supports JSON output. |
The following API calls retrieve all information from a system information category table. To retrieve this information via the PRTG API, you need to provide
- the content type (always sysinfo),
- the category (as displayed in the PRTG web interface),
- columns (see Supported Output Columns ("columns=" Parameter)), and
- the ID of a device (parameter id).
Examples System /api/table.json?id=deviceid&content=sysinfo&category=system&usecaption=true&headers=key,value&columns=_key,_value Software /api/table.json?id=deviceid&content=sysinfo&category=software&usecaption=true&headers=key,value&columns=_displayname,_version Data tables for system information only support JSON output. |
Supported Output Columns ("columns=" Parameter)
You can use the following sysinfo-specific column names for the columns parameter (separated by comma, for example, columns=_key,_value).
For a list of all supported column names, see section Multiple Object Property or Status.
Column Name |
Description |
Can Be Used for |
---|---|---|
_key, _value |
Key value pair from the system table |
sysinfo (category: system) |
_displayname, _class, _caption |
Display name, class, and caption from the system table |
sysinfo (category: hardware) |
_user, _domain |
User and domain pair from the system table |
sysinfo (category: loggedonusers) |
_displayname, _creationdate, _processid |
Display name, creation date, and process id from the system table |
sysinfo (category: processes) |
_displayname, _state, _startmode |
Display name, state, and start mode from the system table |
sysinfo (category: services) |
_displayname, _version |
Display name and version pair from the system table |
sysinfo (category: software) |
KNOWLEDGE BASE
How can I use the PRTG Application Programming Interface (API)?