interfaces_timeout | **Optional.** Sets the SNMP timeout (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
This category includes all plugins for web-based checks.
vars.interfaces_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"
+}
projects / icinga2 / commitdiff