mirror of https://github.com/Icinga/icinga2.git
ITL: add check_command nwc_health
fixes #9812 Signed-off-by: Michael Friedrich <michael.friedrich@netways.de>
This commit is contained in:
Lennart Betz
Michael Friedrich
parent
e17facfd57
commit
f1735895b7
|
|
@ -1777,6 +1777,57 @@ interfaces_match_aliases | **Optional.** Also match against aliases (Option --a
|
||||||
interfaces_timeout | **Optional.** Sets the SNMP timeout (in ms).
|
interfaces_timeout | **Optional.** Sets the SNMP timeout (in ms).
|
||||||
interfaces_sleep | **Optional.** Sleep between every SNMP query (in ms).
|
interfaces_sleep | **Optional.** Sleep between every SNMP query (in ms).
|
||||||
|
|
||||||
|
### <a id="plugins-contrib-command-nwc_health"></a> nwc_health
|
||||||
|
|
||||||
|
The plugin [check_nwc_health](https://labs.consol.de/de/nagios/check_nwc_health/index.html)
|
||||||
|
Check switches, router, there interfaces and utilization.
|
||||||
|
|
||||||
|
Custom attributes passed as [command parameters](3-monitoring-basics.md#command-passing-parameters):
|
||||||
|
|
||||||
|
Name | Description
|
||||||
|
--------------------------------|---------------------------------------------------------
|
||||||
|
nwc_health_timeout | **Optional.** Seconds before plugin times out (default: 15)
|
||||||
|
nwc_health_blacklist | **Optional.** Blacklist some (missing/failed) components.
|
||||||
|
nwc_health_hostname | **Optional.** The host's address. Defaults to "$address$" if the host's `address` attribute is set, "$address6$" otherwise.
|
||||||
|
nwc_health_port | **Optional.** The SNMP port to use (default: 161).
|
||||||
|
nwc_health_domain | **Optional.** The transport domain to use (default: udp/ipv4, other possible values: udp6, udp/ipv6, tcp, tcp4, tcp/ipv4, tcp6, tcp/ipv6).
|
||||||
|
nwc_health_protocol | **Optional.** The SNMP protocol to use (default: 2c, other possibilities: 1,3).
|
||||||
|
nwc_health_community | **Optional.** SNMP community of the server (SNMP v1/2 only).
|
||||||
|
nwc_health_username | **Optional.** The securityName for the USM security model (SNMPv3 only).
|
||||||
|
nwc_health_authpassword | **Optional.** The authentication password for SNMPv3.
|
||||||
|
nwc_health_authprotocol | **Optional.** The authentication protocol for SNMPv3 (md5|sha).
|
||||||
|
nwc_health_privpassword | **Optional.** The password for authPriv security level.
|
||||||
|
nwc_health_privprotocol | **Optional.** The private protocol for SNMPv3 (des|aes|aes128|3des|3desde).
|
||||||
|
nwc_health_contextengineid | **Optional.** The context engine id for SNMPv3 (10 to 64 hex characters).
|
||||||
|
nwc_health_contextname | **Optional.** The context name for SNMPv3 (empty represents the default context).
|
||||||
|
nwc_health_name | **Optional.** The name of an interface (ifDescr).
|
||||||
|
nwc_health_drecksptkdb | **Optional.** This parameter must be used instead of --name, because Devel::ptkdb is stealing the latter from the command line.
|
||||||
|
nwc_health_alias | **Optional.** The alias name of a 64bit-interface (ifAlias)
|
||||||
|
nwc_health_regexp | **Optional.** A flag indicating that --name is a regular expression
|
||||||
|
nwc_health_ifspeedin | **Optional.** Override the ifspeed oid of an interface (only inbound)
|
||||||
|
nwc_health_ifspeedout | **Optional.** Override the ifspeed oid of an interface (only outbound)
|
||||||
|
nwc_health_ifspeed | **Optional.** Override the ifspeed oid of an interface
|
||||||
|
nwc_health_units | **Optional.** One of %, B, KB, MB, GB, Bit, KBi, MBi, GBi. (used for e.g. mode interface-usage)
|
||||||
|
nwc_health_name2 | **Optional.** The secondary name of a component.
|
||||||
|
nwc_health_role | **Optional.** The role of this device in a hsrp group (active/standby/listen).
|
||||||
|
nwc_health_report | **Optional.** Can be used to shorten the output.
|
||||||
|
nwc_health_lookback | **Optional.** The amount of time you want to look back when calculating average rates. Use it for mode interface-errors or interface-usage. Without --lookback the time between two runs of check_nwc_health is the base for calculations. If you want your checkresult to be based for example on the past hour, use --lookback 3600.
|
||||||
|
nwc_health_warning | **Optional.** The warning threshold
|
||||||
|
nwc_health_critical | **Optional.** The critical threshold
|
||||||
|
nwc_health_warningx | **Optional.** The extended warning thresholds
|
||||||
|
nwc_health_criticalx | **Optional.** The extended critical thresholds
|
||||||
|
nwc_health_mitigation | **Optional.** The parameter allows you to change a critical error to a warning.
|
||||||
|
nwc_health_selectedperfdata | **Optional.** The parameter allows you to limit the list of performance data. It's a perl regexp. Only matching perfdata show up in the output.
|
||||||
|
nwc_health_morphperfdata | **Optional.** The parameter allows you to change performance data labels. It's a perl regexp and a substitution. --morphperfdata '(.*)ISATAP(.*)'='$1patasi$2'
|
||||||
|
nwc_health_negate | **Optional.** The parameter allows you to map exit levels, such as warning=critical.
|
||||||
|
nwc_health_mymodules-dyn-dir | **Optional.** A directory where own extensions can be found.
|
||||||
|
nwc_health_servertype | **Optional.** The type of the network device: cisco (default). Use it if auto-detection is not possible.
|
||||||
|
nwc_health_statefilesdir | **Optional.** An alternate directory where the plugin can save files.
|
||||||
|
nwc_health_oids | **Optional.** A list of oids which are downloaded and written to a cache file. Use it together with --mode oidcache.
|
||||||
|
nwc_health_offline | **Optional.** The maximum number of seconds since the last update of cache file before it is considered too old.
|
||||||
|
nwc_health_multiline | **Optional.** Multiline output
|
||||||
|
|
||||||
|
|
||||||
## <a id="plugins-contrib-web"></a> Web
|
## <a id="plugins-contrib-web"></a> Web
|
||||||
|
|
||||||
This category includes all plugins for web-based checks.
|
This category includes all plugins for web-based checks.
|
||||||
|
|
|
||||||
|
|
@ -443,3 +443,180 @@ object CheckCommand "interfaces" {
|
||||||
vars.interfaces_aliases = false
|
vars.interfaces_aliases = false
|
||||||
vars.interfaces_match_aliases = false
|
vars.interfaces_match_aliases = false
|
||||||
}
|
}
|
||||||
|
|
||||||
|
object CheckCommand "nwc_health" {
|
||||||
|
import "plugin-check-command"
|
||||||
|
import "ipv4-or-ipv6"
|
||||||
|
|
||||||
|
command = [ PluginContribDir + "/check_nwc_health" ]
|
||||||
|
|
||||||
|
arguments = {
|
||||||
|
"--timeout" = {
|
||||||
|
value = "$nwc_health_timeout$"
|
||||||
|
description = "Seconds before plugin times out (default: 15)"
|
||||||
|
}
|
||||||
|
"--blacklist" = {
|
||||||
|
value = "$nwc_health_blacklist$"
|
||||||
|
description = "Blacklist some (missing/failed) components"
|
||||||
|
}
|
||||||
|
"--hostname" = {
|
||||||
|
value = "$nwc_health_hostname$"
|
||||||
|
description = "Hostname or IP-address of the switch or router"
|
||||||
|
}
|
||||||
|
"--port" = {
|
||||||
|
value = "$nwc_health_port$"
|
||||||
|
description = "The SNMP port to use (default: 161)"
|
||||||
|
}
|
||||||
|
"--domain" = {
|
||||||
|
value = "$nwc_health_domain$"
|
||||||
|
description = "The transport domain to use (default: udp/ipv4, other possible values: udp6, udp/ipv6, tcp, tcp4, tcp/ipv4, tcp6, tcp/ipv6)"
|
||||||
|
}
|
||||||
|
"--protocol" = {
|
||||||
|
value = "$nwc_health_protocol$"
|
||||||
|
description = "The SNMP protocol to use (default: 2c, other possibilities: 1,3)"
|
||||||
|
}
|
||||||
|
"--community" = {
|
||||||
|
value = "$nwc_health_community$"
|
||||||
|
description = "SNMP community of the server (SNMP v1/2 only)"
|
||||||
|
}
|
||||||
|
"--username" = {
|
||||||
|
value = "$nwc_health_username$"
|
||||||
|
description = "The securityName for the USM security model (SNMPv3 only)"
|
||||||
|
}
|
||||||
|
"--authpassword" = {
|
||||||
|
value = "$nwc_health_authpassword$"
|
||||||
|
description = "The authentication password for SNMPv3"
|
||||||
|
}
|
||||||
|
"--authprotocol" = {
|
||||||
|
value = "$nwc_health_authprotocol$"
|
||||||
|
description = "The authentication protocol for SNMPv3 (md5|sha)"
|
||||||
|
}
|
||||||
|
"--privpassword" = {
|
||||||
|
value = "$nwc_health_privpassword$"
|
||||||
|
description = "The password for authPriv security level"
|
||||||
|
}
|
||||||
|
"--privprotocol" = {
|
||||||
|
value = "$nwc_health_privprotocol$"
|
||||||
|
description = "The private protocol for SNMPv3 (des|aes|aes128|3des|3desde)"
|
||||||
|
}
|
||||||
|
"--contextengineid" = {
|
||||||
|
value = "$nwc_health_contextengineid$"
|
||||||
|
description = "The context engine id for SNMPv3 (10 to 64 hex characters)"
|
||||||
|
}
|
||||||
|
"--contextname" = {
|
||||||
|
value = "$nwc_health_contextname$"
|
||||||
|
description = "The context name for SNMPv3 (empty represents the default context)"
|
||||||
|
}
|
||||||
|
"--mode" = {
|
||||||
|
value = "$nwc_health_mode$"
|
||||||
|
description = "A keyword which tells the plugin what to do"
|
||||||
|
}
|
||||||
|
"--name" = {
|
||||||
|
value = "$nwc_health_name$"
|
||||||
|
description = "The name of an interface (ifDescr)"
|
||||||
|
}
|
||||||
|
"--drecksptkdb" = {
|
||||||
|
value = "$nwc_health_drecksptkdb$"
|
||||||
|
description = "This parameter must be used instead of --name, because Devel::ptkdb is stealing the latter from the command line"
|
||||||
|
}
|
||||||
|
"--alias" = {
|
||||||
|
value = "$nwc_health_alias$"
|
||||||
|
description = "The alias name of a 64bit-interface (ifAlias)"
|
||||||
|
}
|
||||||
|
"--regexp" = {
|
||||||
|
set_if = "$nwc_health_regexp$"
|
||||||
|
description = "A flag indicating that --name is a regular expression"
|
||||||
|
}
|
||||||
|
"--ifspeedin" = {
|
||||||
|
value = "$nwc_health_ifspeedin$"
|
||||||
|
description = "Override the ifspeed oid of an interface (only inbound)"
|
||||||
|
}
|
||||||
|
"--ifspeedout" = {
|
||||||
|
value = "$nwc_health_ifspeedout$"
|
||||||
|
description = "Override the ifspeed oid of an interface (only outbound)"
|
||||||
|
}
|
||||||
|
"--ifspeed" = {
|
||||||
|
value = "$nwc_health_ifspeed$"
|
||||||
|
description = "Override the ifspeed oid of an interface"
|
||||||
|
}
|
||||||
|
"--units" = {
|
||||||
|
value = "$nwc_health_units$"
|
||||||
|
description = "One of %, B, KB, MB, GB, Bit, KBi, MBi, GBi. (used for e.g. mode interface-usage)"
|
||||||
|
}
|
||||||
|
"--name2" = {
|
||||||
|
value = "$nwc_health_name2$"
|
||||||
|
description = "The secondary name of a component"
|
||||||
|
}
|
||||||
|
"--role" = {
|
||||||
|
value = "$nwc_health_role$"
|
||||||
|
description = "The role of this device in a hsrp group (active/standby/listen)"
|
||||||
|
}
|
||||||
|
"--report" = {
|
||||||
|
set_if = "$nwc_health_report$"
|
||||||
|
description = "Can be used to shorten the output"
|
||||||
|
}
|
||||||
|
"--lookback" = {
|
||||||
|
value = "$nwc_health_lookback$"
|
||||||
|
description = "The amount of time you want to look back when calculating average rates. Use it for mode interface-errors or interface-usage. Without --lookback the time between two runs of check_nwc_health is the base for calculations. If you want your checkresult to be based for example on the past hour, use --lookback 3600."
|
||||||
|
}
|
||||||
|
"--critical" = {
|
||||||
|
value = "$nwc_health_critical$"
|
||||||
|
description = "The critical threshold"
|
||||||
|
}
|
||||||
|
"--warning" = {
|
||||||
|
value = "$nwc_health_warning$"
|
||||||
|
description = "The warning threshold"
|
||||||
|
}
|
||||||
|
"--warningx" = {
|
||||||
|
value = "$nwc_health_warningx$"
|
||||||
|
description = "The extended warning thresholds"
|
||||||
|
}
|
||||||
|
"--criticalx" = {
|
||||||
|
value = "$nwc_health_criticalx$"
|
||||||
|
description = "The extended critical thresholds"
|
||||||
|
}
|
||||||
|
"--mitigation" = {
|
||||||
|
set_if = "$nwc_health_mitigation$"
|
||||||
|
description = "The parameter allows you to change a critical error to a warning."
|
||||||
|
}
|
||||||
|
"--selectedperfdata" = {
|
||||||
|
value = "$nwc_health_selectedperfdata$"
|
||||||
|
description = "The parameter allows you to limit the list of performance data. It's a perl regexp. Only matching perfdata show up in the output."
|
||||||
|
}
|
||||||
|
"--morphperfdata" = {
|
||||||
|
value = "$nwc_health_morphperfdata$"
|
||||||
|
description = "The parameter allows you to change performance data labels. It's a perl regexp and a substitution. --morphperfdata '(.*)ISATAP(.*)'='$1patasi$2'"
|
||||||
|
}
|
||||||
|
"--negate" = {
|
||||||
|
value = "$nwc_health_negate$"
|
||||||
|
description = "The parameter allows you to map exit levels, such as warning=critical"
|
||||||
|
}
|
||||||
|
"--with-mymodules-dyn-dir" = {
|
||||||
|
value = "$nwc_health_mymodules-dyn-dir$"
|
||||||
|
description = "A directory where own extensions can be found"
|
||||||
|
}
|
||||||
|
"--servertype" = {
|
||||||
|
value = "$nwc_health_servertype$"
|
||||||
|
description = "The type of the network device: cisco (default). Use it if auto-detection is not possible"
|
||||||
|
}
|
||||||
|
"--statefilesdir" = {
|
||||||
|
value = "$nwc_health_statefilesdir$"
|
||||||
|
description = "An alternate directory where the plugin can save files"
|
||||||
|
}
|
||||||
|
"--oids" = {
|
||||||
|
value = "$nwc_health_oids$"
|
||||||
|
description = "A list of oids which are downloaded and written to a cache file. Use it together with --mode oidcache"
|
||||||
|
}
|
||||||
|
"--offline" = {
|
||||||
|
value = "$nwc_health_offline$"
|
||||||
|
description = "The maximum number of seconds since the last update of cache file before it is considered too old"
|
||||||
|
}
|
||||||
|
"--multiline" = {
|
||||||
|
set_if = "$nwc_health_multiline$"
|
||||||
|
description = "Multiline output"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
vars.nwc_health_hostname = "$check_address$"
|
||||||
|
vars.nwc_health_mode = "hardware-health"
|
||||||
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue