Opsview 6.8.x End of Support

With the release of Opsview 6.11.0 on February 2025, versions 6.8.x have reached their End of Support (EOS) status, according to our Support policy. This means that versions 6.8.x will no longer receive code fixes or security updates.

The documentation for version 6.8.9 and earlier versions will remain accessible for the time being, but it will no longer be updated or receive backports. We strongly recommend upgrading to the latest version of Opsview to ensure continued support and access to the latest features and security enhancements.

Config - Monitoring Clusters

Object type: monitoringcluster

Request URL: /rest/config/monitoringcluster

Example GET Copied

    {
       "object" : {
          "roles" : [
             {
                "ref" : "/rest/config/role/12",
                "name" : "View some, change some"
             }
          ],
          "activated" : "1",
          "monitors" : [
             {
                "ref" : "/rest/config/host/10",
                "name" : "cisco3"
             },
             {
                "ref" : "/rest/config/host/4",
                "name" : "monitored_remotely"
             }
          ],
          "name" : "ClusterA",
          "nodes" : [
             {
                "host" : {
                   "ip" : "192.168.10.20",
                   "ref" : "/rest/config/host/5",
                   "name" : "collector1"
                },
                "slave_port" : "22"   // Unused in 6.0
             }
          ],
          "id" : "2",
          "uncommitted" : "1"
       }
    }

If id=1, this is the primary monitoring cluster.

DELETEs are blocked if the monitoring cluster is the primary, or if there are any hosts still monitored by this monitoring cluster.

Additional parameters:

The additional details included in the output when include_cluster_details is used are:

"status": "OK",    // Other values: OFFLINE or DEGRADED
"alarms": [        // Contains an array of strings of alarms about this cluster
                   // Note: Strings will be localised based on language
  "Component 'opsview-scheduler' is OFFLINE", 
  "No response in time"
]

There is an activated_calculated column that will be included if order=activated_calculated is set. This can be one of 4 values (the value 3 is not ordered correctly - this is a known limitation):

When PUT/POSTing to monitoringclusters, monitors and roles is unsupported. The nodes parameter should be of the form:

    nodes: [ { id: 13 }, { id: 20 } ]

where the id are the host ids of the collectors. For the primary monitoring cluster, only the first node is used and the remainder silently ignored.

network_topology_enabled - will be added if ov-network-topology feature is enabled. Will be 0 (disabled) or 1 (enabled) depending on if this cluster has the feature switched on, to allow detection to occur.

["Opsview On-Premises"] ["API", "Technical Reference"] "1"

Was this topic helpful?