Opsview 6.8.x End of Support
With the release of Opsview 6.11.0 on February 2025, versions 6.8.x have reached their End of Support (EOS) status, according to our Support policy. This means that versions 6.8.x will no longer receive code fixes or security updates.
The documentation for version 6.8.9 and earlier versions will remain accessible for the time being, but it will no longer be updated or receive backports. We strongly recommend upgrading to the latest version of Opsview to ensure continued support and access to the latest features and security enhancements.
Runtime - Host Dependency Map
This section is for searching for live objects being monitored by Opsview. This is in the Runtime database, hence the URL path is /rest/runtime/{objecttype}.
URL: /rest/runtime/network. Requires authentication - requires VIEWALL or VIEWSOME permission.
GET— returns host dependency map.POST,PUT,DELETE— not implemented.
Access Control Copied
VIEWALL allows all hosts to be returned. VIEWSOME allows only hosts where permission has been granted based on the access object selection.
Retrieving Host Dependency Map Copied
Parameters:
hostgroupid— includes this host group (by id) in list. Can be repeated. Note, this will return all hosts in this hosgroupid and below in the hierarchy (so a hostgroupid of 1 effectively returns all hosts).fromhostname— if set, then only the host descendants will be returned. Can be repeated.host— filter hosts by this host name. Can be repeated.only_with_children— if set, then only hosts with at least 1 child are returned.monitoredby— if set, filter hosts if it is monitored by the monitoring server by this id.rows— if set, sets the maximum of rows requested.
Response:
rows— the number of actual rows returned.allrows— the total number of rows based on filtering parameters.total— the total number of rows if filtering is not applied.list— an associative array of:name— name of the host.children— this will be a list of the children nodes by host name.parents— this will be a list of the parents nodes by host name.
Note
If due to permission restriction children/parents are not visiblenullwill be used instead of host name.
Example response:
{
rows => 4,
total => 20,
allrows => 8,
list => [
{
name: "opsview",
parents: [],
children: [ "opsviewdev1", null, "cisco" ]
},
{
name: "opsviewdev1",
parents: [ "opsview" ],
children: []
},
{
name: "cisco",
parents: [ "opsview" ],
children: [ "monitored_by_collector", "cisco4" ]
},
{
name: "cisco4",
parents: [ "cisco" ],
children: [ null ]
}
]
}