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 and Services
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/service.
Requires authentication - requires VIEWALL or VIEWSOME permission
GET— returns available objects, either grouped by host or grouped by service.POST,PUT,DELETE— not implemented.
Access Control Copied
VIEWALL allows all objects to be returned. VIEWSOME allows objects to be returned where permission has been granted based on the access object selection.
Retrieving Host or Service Lists Copied
The same parameters as searching based on service filtering can be used.
Additional parameters:
rows— returns back this number of rows. Defaults to 50 rows.group_by— returns results based on either host or service. Defaults to host.distinct— if set to 1, then only a distinct list of hosts or services are returned. This means you are searching for host names or service names rather than a host+service combination.
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 array of the results.
Example response, if group_by=host and distinct=0:
{
"allrows" : "30",
"list" : [
{
"list" : [
"Another exception",
"Coldstart",
"Test exceptions"
],
"name" : "cisco"
},
{
"list" : [
"Another exception",
"Coldstart"
],
"name" : "cisco1"
}
],
"rows" : "5",
"total" : "50"
}
Example response if group_by=service and distinct=0:
{
"allrows" : "30",
"list" : [
{
"list" : [
"cisco",
"cisco1",
"cisco2",
"cisco3",
"cisco4"
],
"name" : "Another exception"
}
],
"rows" : "5",
"total" : "50"
}
Example response if group_by=host and distinct=1:
{
"allrows" : "12",
"list" : [
{
"name" : "cisco"
},
{
"name" : "cisco1"
},
{
"name" : "cisco2"
},
{
"name" : "cisco3"
},
{
"name" : "cisco4"
}
],
"rows" : "5",
"total" : "15"
}
Example response if group_by=service and distinct=1:
{
"allrows" : "12",
"list" : [
{
"name" : "Another exception"
},
{
"name" : "Check Loadavg"
},
{
"name" : "Check Memory"
},
{
"name" : "Coldstart"
},
{
"name" : "faked ok service"
}
],
"rows" : "5",
"total" : "19"
}