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.
Status - Host Group Summary
Request URL: /rest/status/hostgroup
GET— lists summarised information about host groups.PUT,POST,DELETE— unimplemented.
URL parameters:
hostgroupid— includes this host group in list. Can be repeated. Note, this is for this one host group id only.parentid— includes all host groups with this parent. Can be repeated.fromhostgroupid— will include all host groups from this point in the hierarchy “downwards”. Includes itself. Can be repeated.has_perfdata— if set, will only return service that have performance data. Default not set.host— filter hosts by this host name. Can be repeated.servicecheck— filter services by this service check name. Can be repeated.filter— either handled or unhandled. Filters services by this condition.host_filter— either handled or unhandled. Filters host by this condition.state— filters by services in this state. Expects the numeric id for state. Can be repeated.host_state— filters by hosts in this state. Expects the numeric id for state. Can be repeated.include_cluster_health— if set to 1 will include additional details about collector health - see belowincludeunhandledhosts— if set to 1, will include hosts that are unhandled. Otherwise will only return services that are unhandled.include_servicegroups— if set to 1, will include service group information, with number of ok, warning, critical and unknown states.only_leaves— if set to 1, will only return host groups that are leaf host groups.rows— returns this number of rows. Set toallto get all results. Defaults toall.page— returns this page number if rows is set to a number. Defaults to 1st page.cols— can specify columns to remove. Possible columns: leaf, matpath. Example: cols=-leaf,-matpath.order— if set todependency, will return order based on hierarchy, starting with the top first then depth first. Otherwise, returns back ordered by name.
When include_cluster_health is set an additional cstatus field is returned in the output for each hostgroup entry. The value returned will be one of:
| Value | Meaning |
|---|---|
| not set | all hosts underneath have no collector problems |
| 1 | has a host underneath which is monitored by a degraded cluster |
| 2 | has a host underneath which is monitored by an offline cluster |
| 3 | has a collector underneath and is degraded |
| 4 | has a collector underneath and is offline |
Note
When usingfromhostgroupid, previous versions of Opsview were counting hosts and services multiple times in the summary - from 6.0, this will be the correct total number.
Example output:
{
"summary" : {
"handled" : "27",
"unhandled" : "37",
"service" : {
"ok" : "4",
"critical" : "3",
"handled" : "10",
"unhandled" : "35",
"unknown" : "38",
"total" : "45"
},
"total" : "64",
"totalhgs" : "4",
"host" : {
"handled" : "17",
"unhandled" : "2",
"up" : "15",
"down" : "4",
"total" : "19"
}
},
"list" : [
{
"hosts" : {
"handled" : "7",
"unhandled" : "1",
"up" : {
"handled" : "6"
},
"down" : {
"handled" : "1",
"unhandled" : "1"
},
"total" : "8"
},
"hostgroupid" : "4",
"services" : {
"ok" : {
"handled" : "1"
},
"handled" : "4",
"computed_state" : "unknown",
"unhandled" : "15",
"unknown" : {
"handled" : "3",
"unhandled" : "15"
},
"total" : "19"
},
"matpath" : [
{
"name" : "Opsview",
"id" : "1"
},
{
"name" : "UK",
"id" : "3"
}
],
"computed_state" : "critical",
"downtime" : "2",
"name" : "Leaf",
"leaf" : "0"
},
{
"hosts" : {
"handled" : "10",
"unhandled" : "1",
"up" : {
"handled" : "9"
},
"down" : {
"handled" : "1",
"unhandled" : "1"
},
"total" : "11"
},
"hostgroupid" : "1",
"services" : {
"ok" : {
"handled" : "3"
},
"critical" : {
"unhandled" : "3"
},
"handled" : "6",
"computed_state" : "critical",
"unhandled" : "20",
"unknown" : {
"handled" : "3",
"unhandled" : "17"
},
"total" : "26"
},
"computed_state" : "critical",
"matpath" : [],
"downtime" : "2",
"name" : "Opsview",
"leaf" : "0"
}
]
}
Note
The
computed_statekeyword represents the highest state based on host state and service state. Specifically, this will return critical if the host is down or unreachable otherwise the service computed_state. This is available from Opsview 3.13.0.The
summary.totalhgsvalue represents the number of host groups in this request, without any filtering. This means that if the value is > 0, the user has access to see host groups from this part of the host group tree. If the value is 0, then the user does not have access to this part of the host group tree.