Withdraw of the 6.9.2 Release
Unfortunately, due to critical issues identified with version 6.9.2, we have decided to remove it and ensure it's no longer available for download. These issues impacted the ability to install or upgrade but none were security-related. We are diligently working to resolve these issues and are planning to release an updated version 6.9.3 in early May.
What if you've already upgraded?For customers who have already upgraded to 6.9.2, no immediate action is required, as none of these issues are security-related. Once it's available, you will still be able to upgrade to 6.9.3 as normal. We appreciate your patience and trust as we continue to enhance our software to better serve you. Thank you for your understanding.
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"
}