×
![]()
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
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
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"
}
["Opsview"]
["API", "Technical Reference"]