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 - Service Checks
Object type: servicecheck
Request URL: /rest/config/servicecheck
Example GET Copied
{
"object" : {
"alert_from_failure" : "5",
"args" : "",
"attribute" : null,
"calculate_rate" : "no",
"cascaded_from" : {
"name" : "Interface Poller",
"ref" : "/rest/config/servicecheck/107"
},
"check_attempts" : "5",
"check_freshness" : "1",
"check_interval" : "25",
"check_period" : {
"name" : "workhours",
"ref" : "/rest/config/timeperiod/2"
},
"checktype" : {
"name" : "SNMP trap",
"ref" : "/rest/config/checktype/4"
},
"critical_comparison" : null,
"critical_value" : null,
"dependencies" : [
{
"name" : "Check Swap",
"ref" : "/rest/config/servicecheck/46"
},
{
"name" : "DHCP",
"ref" : "/rest/config/servicecheck/3"
}
],
"description" : "",
"event_handler" : "",
"flap_detection_enabled" : "1",
"freshness_type" : "set_stale",
"hosts" : [
{
"name" : "cisco4",
"ref" : "/rest/config/host/11"
},
{
"name" : "opsview",
"ref" : "/rest/config/host/1"
}
],
"hosttemplates" : [
{
"name" : "Network - Base",
"ref" : "/rest/config/hosttemplate/2"
}
],
"id" : "79",
"invertresults" : "0",
"keywords" : [
{
"name" : "cisco",
"ref" : "/rest/config/keyword/2"
},
{
"name" : "cisco_gp2",
"ref" : "/rest/config/keyword/4"
}
],
"label" : null,
"markdown_filter" : "0",
"name" : "Coldstart",
"notification_interval" : null,
"notification_options" : "w,c,r,u",
"notification_period" : null,
"oid" : null,
"plugin" : null,
"retry_check_interval" : null,
"sensitive_arguments" : "1",
"servicegroup" : {
"name" : "Operations",
"ref" : "/rest/config/servicegroup/1"
},
"snmptraprules" : [
{
"alertlevel" : "1",
"code" : "\"${TRAPNAME}\" =~ /SNMPv2-MIB::coldstart/i",
"message" : "Device coldstarted",
"name" : "Check coldstart",
"process" : "1",
"ref" : "/rest/config/snmptraprule/1",
"uncommitted" : "1"
},
{
"alertlevel" : "0",
"code" : "1",
"message" : "OK",
"name" : "Otherwise Ok",
"process" : "1",
"ref" : "/rest/config/snmptraprule/2",
"uncommitted" : "1"
}
],
"stale_state" : "2",
"stale_text" : "Set to critical!!",
"stale_threshold_seconds" : "3750",
"stalking" : null,
"uncommitted" : "1",
"volatile" : "0",
"warning_comparison" : null,
"warning_value" : null
}
}
If you set a parameter of order with the value dependency, the service checks will be listed based on their level, which means that if there are service check dependencies, the most dependent items will be listed first.
Take note of the following considerations:
- The reference to plugin,
checktypeandsnmptrapruleis not available. - Errors will be thrown if validation fails for check_interval, retry_check_interval, check_attempts or stale_threshold_seconds.
checktypemust be specified at service check creation time. This field cannot be subsequently changed. Cloning will not allow a change inchecktype.- For
checktype= 1 (active) or 5 (SNMP polling), the fields for check_interval, retry_check_interval and check_attempts will be returned in the REST API, otherwise they will not. Similarly, these fields will be processed on input, otherwise they are ignored.