Opsview 6.9.x End of Support
Opsview versions 6.9.x reached their End of Support (EOS) status at the end of January 2026, in accordance with our Support policy. As of this date, these versions no longer receive code fixes, security updates, maintenance releases, or backported changes.
The documentation for version 6.9.7 and earlier releases will remain accessible for reference, but it will no longer be updated or maintained. We strongly recommend upgrading to the latest supported 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 ]
}
]
}