icinga2/doc/7-icinga-template-library.md

Icinga Template Library

The Icinga Template Library (ITL) implements standard templates and object definitions for commonly used services.

By default the ITL is included in the icinga2.conf configuration file:

include <itl>

Generic Templates

These templates are imported by the provided example configuration.

plugin-check-command

Command template for check plugins executed by Icinga 2.

The plugin-check-command command does not support any vars.

plugin-notification-command

Command template for notification scripts executed by Icinga 2.

The plugin-notification-command command does not support any vars.

plugin-event-command

Command template for event handler scripts executed by Icinga 2.

The plugin-event-command command does not support any vars.

Check Commands

These check commands are embedded into Icinga 2 and do not require any external plugin scripts.

icinga

Check command for the built-in icinga check. This check returns performance data for the current Icinga instance.

The icinga check command does not support any vars.

cluster

Check command for the built-in cluster check. This check returns performance data for the current Icinga instance and connected endpoints.

The cluster check command does not support any vars.

cluster-zone

Check command for the built-in cluster-zone check.

Cluster Attributes:

Name	Description
cluster_zone	Optional. The zone name. Defaults to "host.name".

Plugin Check Commands

The Plugin Check Commands provides example configuration for plugin check commands provided by the Monitoring Plugins project.

By default the Plugin Check Commands are included in the icinga2.conf configuration file:

include <plugins>

The plugin check commands assume that there's a global constant named PluginDir which contains the path of the plugins from the Monitoring Plugins project.

apt

Check command for the check_apt plugin.

The apt check command does not support any vars.

by_ssh

Check command object for the check_by_ssh plugin.

Custom Attributes:

Name	Description
by_ssh_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
by_ssh_port	Optional. The SSH port. Defaults to 22.
by_ssh_command	Optional. The command that should be executed.
by_ssh_logname	Optional. The SSH username.
by_ssh_identity	Optional. The SSH identity.
by_ssh_quiet	Optional. Whether to suppress SSH warnings. Defaults to false.
by_ssh_warn	Optional. The warning threshold.
by_ssh_crit	Optional. The critical threshold.
by_ssh_timeout	Optional. The timeout in seconds.

dhcp

Check command object for the check_dhcp plugin.

Custom Attributes:

Name	Description
dhcp_serverip	Optional. The IP address of the DHCP server which we should get a response from.
dhcp_requestedip	Optional. The IP address which we should be offered by a DHCP server.
dhcp_timeout	Optional. The timeout in seconds.
dhcp_interface	Optional. The interface to use.
dhcp_mac	Optional. The MAC address to use in the DHCP request.
dhcp_unicast	Optional. Whether to use unicast requests. Defaults to false.

dig

Check command object for the check_dig plugin.

Custom Attributes:

Name	Description
dig_server	Optional. The DNS server to query. Defaults to "127.0.0.1".
dig_lookup	Optional. The address that should be looked up.

disk

Check command object for the check_disk plugin.

Custom Attributes:

Name	Description
disk_wfree	Optional. The free space warning threshold in %. Defaults to 20.
disk_cfree	Optional. The free space critical threshold in %. Defaults to 10.
disk_inode_wfree	Optional. The free inode warning threshold.
disk_inode_cfree	Optional. The free inode critical threshold.
disk_partition	Optional. The partition. Deprecated in 2.3.
disk_partition_excluded	Optional. The excluded partition. Deprecated in 2.3.
disk_partitions	Optional. The partition(s). Multiple partitions must be defined as array.
disk_partitions_excluded	Optional. The excluded partition(s). Multiple partitions must be defined as array.
disk_clear	Optional. Clear thresholds.
disk_exact_match	Optional. For paths or partitions specified with -p, only check for exact paths.
disk_errors_only	Optional. Display only devices/mountpoints with errors. May be true or false.
disk_group	Optional. Group paths. Thresholds apply to (free-)space of all partitions together
disk_kilobytes	Optional. Same as --units kB. May be true or false.
disk_local	Optional. Only check local filesystems. May be true or false.
disk_stat_remote_fs	Optional. Only check local filesystems against thresholds. Yet call stat on remote filesystems to test if they are accessible (e.g. to detect Stale NFS Handles). Myy be true or false
disk_mountpoint	Optional. Display the mountpoint instead of the partition. May be true or false.
disk_megabytes	Optional. Same as --units MB. May be true or false.
disk_all	Optional. Explicitly select all paths. This is equivalent to -R '.*'. May be true or false.
disk_eregi_path	Optional. Case insensitive regular expression for path/partition (may be repeated).
disk_ereg_path	Optional. Regular expression for path or partition (may be repeated).
disk_ignore_eregi_path	Optional. Regular expression to ignore selected path/partition (case insensitive) (may be repeated).
disk_ignore_ereg_path	Optional. Regular expression to ignore selected path or partition (may be repeated).
disk_timeout	Optional. Seconds before connection times out (default: 10).
disk_units	Optional. Choose bytes, kB, MB, GB, TB (default: MB).
disk_exclude_type	Optional. Ignore all filesystems of indicated type (may be repeated).

dns

Check command object for the check_dns plugin.

Custom Attributes:

Name	Description
dns_lookup	Optional. The hostname or IP to query the DNS for. Defaults to host_name.
dns_server	Optional. The DNS server to query. Defaults to the server configured in the OS.
dns_expected_answer	Optional. The answer to look for. A hostname must end with a dot. Deprecated in 2.3.
dns_expected_answers	Optional. The answer(s) to look for. A hostname must end with a dot. Multiple answers must be defined as array.
dns_authoritative	Optional. Expect the server to send an authoritative answer.

dummy

Check command object for the check_dummy plugin.

Custom Attributes:

Name	Description
dummy_state	Optional. The state. Can be one of 0 (ok), 1 (warning), 2 (critical) and 3 (unknown). Defaults to 0.
dummy_text	Optional. Plugin output. Defaults to "Check was successful.".

fping4

Check command object for the check_fping plugin.

Custom Attributes:

Name	Description
fping_address	Optional. The host's IPv4 address. Defaults to "address".
fping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
fping_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
fping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
fping_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
fping_number	Optional. The number of packets to send. Defaults to 5.
fping_interval	Optional. The interval between packets in milli-seconds. Defaults to 500.
fping_bytes	Optional. The size of ICMP packet.
fping_target_timeout	Optional. The target timeout in milli-seconds.
fping_source_ip	Optional. The name or ip address of the source ip.
fping_source_interface	Optional. The source interface name.

fping6

Check command object for the check_fping plugin.

Custom Attributes:

Name	Description
fping_address	Optional. The host's IPv6 address. Defaults to "address6".
fping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
fping_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
fping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
fping_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
fping_number	Optional. The number of packets to send. Defaults to 5.
fping_interval	Optional. The interval between packets in milli-seconds. Defaults to 500.
fping_bytes	Optional. The size of ICMP packet.
fping_target_timeout	Optional. The target timeout in milli-seconds.
fping_source_ip	Optional. The name or ip address of the source ip.
fping_source_interface	Optional. The source interface name.

ftp

Check command object for the check_ftp plugin.

Custom Attributes:

Name	Description
ftp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.

hostalive

Check command object for the check_ping plugin with host check default values. This variant uses the host's address attribute if available and falls back to using the address6 attribute if the address attribute is not set.

Custom Attributes:

Name	Description
ping_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 3000.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 80.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 5000.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 100.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

hostalive4

Check command object for the check_ping plugin with host check default values. This variant uses the host's address attribute.

Custom Attributes:

Name	Description
ping_address	Optional. The host's IPv4 address. Defaults to "address".
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 3000.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 80.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 5000.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 100.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

hostalive6

Check command object for the check_ping plugin with host check default values. This variant uses the host's address6 attribute.

Custom Attributes:

Name	Description
ping_address	Optional. The host's IPv6 address. Defaults to "address6".
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 3000.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 80.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 5000.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 100.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

hpjd

Check command object for the check_hpjd plugin.

Custom Attributes:

Name	Description
hpjd_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
hpjd_port	Optional. The host's SNMP port. Defaults to 161.
hpjd_community	Optional. The SNMP community. Defaults to "public".

http

Check command object for the check_http plugin.

Custom Attributes:

Name	Description
http_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
http_vhost	Optional. The virtual host that should be sent in the "Host" header.
http_uri	Optional. The request URI.
http_port	Optional. The TCP port. Defaults to 80 when not using SSL, 443 otherwise.
http_ssl	Optional. Whether to use SSL. Defaults to false.
http_sni	Optional. Whether to use SNI. Defaults to false.
http_auth_pair	Optional. Add 'username:password' authorization pair.
http_proxy_auth_pair	Optional. Add 'username:password' authorization pair for proxy.
http_ignore_body	Optional. Don't download the body, just the headers.
http_linespan	Optional. Allow regex to span newline.
http_expect_body_regex	Optional. A regular expression which the body must match against. Incompatible with http_ignore_body.
http_expect_body_eregi	Optional. A case-insensitive expression which the body must match against. Incompatible with http_ignore_body.
http_invertregex	Optional. Changes behaviour of http_expect_body_regex and http_expect_body_eregi to return CRITICAL if found, OK if not.
http_warn_time	Optional. The warning threshold.
http_critical_time	Optional. The critical threshold.
http_expect	Optional. Comma-delimited list of strings, at least one of them is expected in the first (status) line of the server response. Default: HTTP/1.
http_certificate	Optional. Minimum number of days a certificate has to be valid. Port defaults to 443.
http_clientcert	Optional. Name of file contains the client certificate (PEM format).
http_privatekey	Optional. Name of file contains the private key (PEM format).
http_headerstring	Optional. String to expect in the response headers.
http_string	Optional. String to expect in the content.
http_post	Optional. URL encoded http POST data.
http_method	Optional. Set http method (for example: HEAD, OPTIONS, TRACE, PUT, DELETE).
http_maxage	Optional. Warn if document is more than seconds old.
http_contenttype	Optional. Specify Content-Type header when POSTing.
http_useragent	Optional. String to be sent in http header as User Agent.
http_header	Optional. Any other tags to be sent in http header.
http_extendedperfdata	Optional. Print additional perfdata. Defaults to false.
http_onredirect	Optional. How to handle redirect pages. Possible values: "ok" (default), "warning", "critical", "follow", "sticky" (like follow but stick to address), "stickyport" (like sticky but also to port)
http_pagesize	Optional. Minimum page size required:Maximum page size required.
http_timeout	Optional. Seconds before connection times out.

icmp

Check command object for the check_icmp plugin.

Custom Attributes:

Name	Description
icmp_address	Optional. The host's address. This can either be a single address or an array of addresses. Defaults to "address".
icmp_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
icmp_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
icmp_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
icmp_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
icmp_source	Optional. The source IP address to send packets from.
icmp_packets	Optional. The number of packets to send. Defaults to 5.
icmp_packet_interval	Optional The maximum packet interval. Defaults to 80 (milliseconds).
icmp_target_interval	Optional. The maximum target interval.
icmp_hosts_alive	Optional. The number of hosts which have to be alive for the check to succeed.
icmp_data_bytes	Optional. Payload size for each ICMP request. Defaults to 8.
icmp_timeout	Optional. The plugin timeout in seconds. Defaults to 10 (seconds).

imap

Check command object for the check_imap plugin.

Custom Attributes:

Name	Description
imap_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
imap_port	Optional. The port that should be checked. Defaults to 143.

load

Check command object for the check_load plugin.

Custom Attributes:

Name	Description
load_wload1	Optional. The 1-minute warning threshold. Defaults to 5.
load_wload5	Optional. The 5-minute warning threshold. Defaults to 4.
load_wload15	Optional. The 15-minute warning threshold. Defaults to 3.
load_cload1	Optional. The 1-minute critical threshold. Defaults to 10.
load_cload5	Optional. The 5-minute critical threshold. Defaults to 6.
load_cload15	Optional. The 15-minute critical threshold. Defaults to 4.

nrpe

Check command object for the check_nrpe plugin.

Custom Attributes:

Name	Description
nrpe_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
nrpe_port	Optional. The NRPE port. Defaults to 5668.
nrpe_command	Optional. The command that should be executed.
nrpe_no_ssl	Optional. Whether to disable SSL or not. Defaults to false.
nrpe_timeout_unknown	Optional. Whether to set timeouts to unknown instead of critical state. Defaults to false.
nrpe_timeout	Optional. The timeout in seconds.
nrpe_arguments	Optional. Arguments that should be passed to the command. Multiple arguments must be defined as array.

nscp

Check command object for the check_nt plugin.

Custom Attributes:

Name	Description
nscp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
nscp_port	Optional. The NSClient++ port. Defaults to 12489.
nscp_password	Optional. The NSClient++ password.
nscp_variable	Required. The variable that should be checked.
nscp_params	Optional. Parameters for the query. Multiple parameters must be defined as array.
nscp_warn	Optional. The warning threshold.
nscp_crit	Optional. The critical threshold.
nscp_timeout	Optional. The query timeout in seconds.

ntp_time

Check command object for the check_ntp_time plugin.

Custom Attributes:

Name	Description
ntp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.

passive

Specialised check command object for passive checks executing the check_dummy plugin with appropriate default values.

Custom Attributes:

Name	Description
dummy_state	Optional. The state. Can be one of 0 (ok), 1 (warning), 2 (critical) and 3 (unknown). Defaults to 3.
dummy_text	Optional. Plugin output. Defaults to "No Passive Check Result Received.".

ping

Check command object for the check_ping plugin. This command uses the host's address attribute if available and falls back to using the address6 attribute if the address attribute is not set.

Custom Attributes:

Name	Description
ping_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

ping4

Check command object for the check_ping plugin.

Custom Attributes:

Name	Description
ping_address	Optional. The host's IPv4 address. Defaults to "address".
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

ping6

Check command object for the check_ping plugin.

Custom Attributes:

Name	Description
ping_address	Optional. The host's IPv6 address. Defaults to "address6".
ping_wrta	Optional. The RTA warning threshold in milliseconds. Defaults to 100.
ping_wpl	Optional. The packet loss warning threshold in %. Defaults to 5.
ping_crta	Optional. The RTA critical threshold in milliseconds. Defaults to 200.
ping_cpl	Optional. The packet loss critical threshold in %. Defaults to 15.
ping_packets	Optional. The number of packets to send. Defaults to 5.
ping_timeout	Optional. The plugin timeout in seconds. Defaults to 0 (no timeout).

pop

Check command object for the check_pop plugin.

Custom Attributes:

Name	Description
pop_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
pop_port	Optional. The port that should be checked. Defaults to 110.

procs

Check command object for the check_procs plugin.

Custom Attributes:

Name	Description
procs_warning	Optional. The process count warning threshold. Defaults to 250.
procs_critical	Optional. The process count critical threshold. Defaults to 400.
procs_metric	Optional. Check thresholds against metric.
procs_timeout	Optional. Seconds before plugin times out.
procs_traditional	Optional. Filter own process the traditional way by PID instead of /proc/pid/exe. Defaults to false.
procs_state	Optional. Only scan for processes that have one or more of the status flags you specify.
procs_ppid	Optional. Only scan for children of the parent process ID indicated.
procs_vsz	Optional. Only scan for processes with VSZ higher than indicated.
procs_rss	Optional. Only scan for processes with RSS higher than indicated.
procs_pcpu	Optional. Only scan for processes with PCPU higher than indicated.
procs_user	Optional. Only scan for processes with user name or ID indicated.
procs_argument	Optional. Only scan for processes with args that contain STRING.
procs_argument_regex	Optional. Only scan for processes with args that contain the regex STRING.
procs_command	Optional. Only scan for exact matches of COMMAND (without path).
procs_nokthreads	Optional. Only scan for non kernel threads. Defaults to false.

running_kernel

Check command object for the check_running_kernel plugin provided by the nagios-plugins-contrib package on Debian.

The running_kernel check command does not support any vars.

simap

Check command object for the check_simap plugin.

Custom Attributes:

Name	Description
simap_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
simap_port	Optional. The host's port.

smtp

Check command object for the check_smtp plugin.

Custom Attributes:

Name	Description
smtp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
smtp_port	Optional. The port that should be checked. Defaults to 25.
smtp_mail_from	Optional. Test a MAIL FROM command with the given email address.

snmp

Check command object for the check_snmp plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_oid	Required. The SNMP OID.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_warn	Optional. The warning threshold.
snmp_crit	Optional. The critical threshold.
snmp_string	Optional. Return OK state if the string matches exactly with the output value
snmp_ereg	Optional. Return OK state if extended regular expression REGEX matches with the output value
snmp_eregi	Optional. Return OK state if case-insensitive extended REGEX matches with the output value
snmp_label	Optional. Prefix label for output value
snmp_invert_search	Optional. Invert search result and return CRITICAL state if found
snmp_units	Optional. Units label(s) for output value (e.g., 'sec.').
snmp_timeout	Optional. The command timeout in seconds. Defaults to 10 seconds.

snmpv3

Check command object for the check_snmp plugin, using SNMPv3 authentication and encryption options.

Custom Attributes:

Name	Description
snmpv3_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmpv3_user	Required. The username to log in with.
snmpv3_auth_alg	Optional. The authentication algorithm. Defaults to SHA.
snmpv3_auth_key	Required. The authentication key.
snmpv3_priv_alg	Optional. The encryption algorithm. Defaults to AES.
snmpv3_priv_key	Required. The encryption key.
snmpv3_oid	Required. The SNMP OID.
snmpv3_warn	Optional. The warning threshold.
snmpv3_crit	Optional. The critical threshold.
snmpv3_label	Optional. Prefix label for output value.

snmp-uptime

Check command object for the check_snmp plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_oid	Optional. The SNMP OID. Defaults to "1.3.6.1.2.1.1.3.0".
snmp_community	Optional. The SNMP community. Defaults to "public".

spop

Check command object for the check_spop plugin.

Custom Attributes:

Name	Description
spop_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
spop_port	Optional. The host's port.

ssh

Check command object for the check_ssh plugin.

Custom Attributes:

Name	Description
ssh_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ssh_port	Optional. The port that should be checked. Defaults to 22.
ssh_timeout	Optional. Seconds before connection times out. Defaults to 10.

ssl

Check command object for the check_tcp plugin, using ssl-related options.

Custom Attributes:

Name	Description
ssl_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ssl_port	Required. The port that should be checked.
ssl_timeout	Optional. Timeout in seconds for the connect and handshake. The plugin default is 10 seconds.
ssl_cert_valid_days_warn	Optional. Warning threshold for days before the certificate will expire. When used, ssl_cert_valid_days_critical must also be set.
ssl_cert_valid_days_critical	Optional. Critical threshold for days before the certificate will expire. When used, ssl_cert_valid_days_warn must also be set.

ssmtp

Check command object for the check_ssmtp plugin.

Custom Attributes:

Name	Description
ssmtp_address	Required. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ssmtp_port	Optional. The port that should be checked. Defaults to 465.

swap

Check command object for the check_swap plugin.

Custom Attributes:

Name	Description
swap_wfree	Optional. The free swap space warning threshold in %. Defaults to 50.
swap_cfree	Optional. The free swap space critical threshold in %. Defaults to 25.

tcp

Check command object for the check_tcp plugin.

Custom Attributes:

Name	Description
tcp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
tcp_port	Required. The port that should be checked.

udp

Check command object for the check_udp plugin.

Custom Attributes:

Name	Description
udp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
udp_port	Required. The port that should be checked.

ups

Check command object for the check_ups plugin.

Custom Attributes:

Name	Description
ups_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
ups_name	Optional. The UPS name. Defaults to ups.

users

Check command object for the check_users plugin.

Custom Attributes:

Name	Description
users_wgreater	Optional. The user count warning threshold. Defaults to 20.
users_cgreater	Optional. The user count critical threshold. Defaults to 50.

SNMP Manubulon Plugin Check Commands

The SNMP Manubulon Plugin Check Commands provide example configuration for plugin check commands provided by the SNMP Manubulon project.

The SNMP manubulon plugin check commands assume that the global constant named ManubulonPluginDir is set to the path where the Manubublon SNMP plugins are installed.

You can enable these plugin check commands by adding the following the include directive in your configuration icinga2.conf file:

include <manubulon>

Checks by Host Type

N/A : Not available for this type.

SNMP : Available for simple SNMP query.

?? : Untested.

Specific : Script name for platform specific checks.

Host type	Interface	storage	load/cpu	mem	process	env	specific
Linux	Yes	Yes	Yes	Yes	Yes	No
Windows	Yes	Yes	Yes	Yes	Yes	No	check_snmp_win.pl
Cisco router/switch	Yes	N/A	Yes	Yes	N/A	Yes
HP router/switch	Yes	N/A	Yes	Yes	N/A	No
Bluecoat proxy	Yes	SNMP	Yes	SNMP	No	Yes
CheckPoint on SPLAT	Yes	Yes	Yes	Yes	Yes	No	check_snmp_cpfw.pl
CheckPoint on Nokia IP	Yes	Yes	Yes	No	??	No	check_snmp_vrrp.pl
Boostedge	Yes	Yes	Yes	Yes	??	No	check_snmp_boostedge.pl
AS400	Yes	Yes	Yes	Yes	No	No
NetsecureOne Netbox	Yes	Yes	Yes	??	Yes	No
Radware Linkproof	Yes	N/A	SNMP	SNMP	No	No	check_snmp_linkproof_nhr check_snmp_vrrp.pl
IronPort	Yes	SNMP	SNMP	SNMP	No	Yes
Cisco CSS	Yes	??	Yes	Yes	No	??	check_snmp_css.pl

snmp-load

Check command object for the check_snmp_load.pl plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_nocrypt	Optional. Define SNMP encryption. If set snmp_v3 needs to be set. Defaults to false.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_port	Optional. The SNMP port connection.
snmp_v2	Optional. SNMP version to 2c. Defaults to false.
snmp_v3	Optional. SNMP version to 3. Defaults to false.
snmp_login	Optional. SNMP version 3 username. Defaults to "snmpuser".
snmp_password	Required. SNMP version 3 password. No value defined as default.
snmp_v3_use_privpass	Optional. Define to use SNMP version 3 priv password. Defaults to false.
snmp_authprotocol	Optional. SNMP version 3 authentication protocol. Defaults to "md5,des".
snmp_privpass	Required. SNMP version 3 priv password. No value defined as default.
snmp_warn	Optional. The warning threshold. Change the snmp_load_type var to "netsl" for using 3 values.
snmp_crit	Optional. The critical threshold. Change the snmp_load_type var to "netsl" for using 3 values.
snmp_load_type	Optional. Load type. Defaults to "stand". Check all available types in the snmp load documentation.
snmp_perf	Optional. Enable perfdata values. Defaults to true.
snmp_timeout	Optional. The command timeout in seconds. Defaults to 5 seconds.

snmp-memory

Check command object for the check_snmp_mem.pl plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_nocrypt	Optional. Define SNMP encryption. If set snmp_v3 needs to be set. Defaults to false.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_port	Optional. The SNMP port connection.
snmp_v2	Optional. SNMP version to 2c. Defaults to false.
snmp_v3	Optional. SNMP version to 3. Defaults to false.
snmp_login	Optional. SNMP version 3 username. Defaults to "snmpuser".
snmp_password	Required. SNMP version 3 password. No value defined as default.
snmp_v3_use_privpass	Optional. Define to use SNMP version 3 priv password. Defaults to false.
snmp_authprotocol	Optional. SNMP version 3 authentication protocol. Defaults to "md5,des".
snmp_privpass	Required. SNMP version 3 priv password. No value defined as default.
snmp_warn	Optional. The warning threshold.
snmp_crit	Optional. The critical threshold.
snmp_perf	Optional. Enable perfdata values. Defaults to true.
snmp_timeout	Optional. The command timeout in seconds. Defaults to 5 seconds.

snmp-storage

Check command object for the check_snmp_storage.pl plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_nocrypt	Optional. Define SNMP encryption. If set snmp_v3 needs to be set. Defaults to false.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_port	Optional. The SNMP port connection.
snmp_v2	Optional. SNMP version to 2c. Defaults to false.
snmp_v3	Optional. SNMP version to 3. Defaults to false.
snmp_login	Optional. SNMP version 3 username. Defaults to "snmpuser".
snmp_password	Required. SNMP version 3 password. No value defined as default.
snmp_v3_use_privpass	Optional. Define to use SNMP version 3 priv password. Defaults to false.
snmp_authprotocol	Optional. SNMP version 3 authentication protocol. Defaults to "md5,des".
snmp_privpass	Required. SNMP version 3 priv password. No value defined as default.
snmp_warn	Optional. The warning threshold.
snmp_crit	Optional. The critical threshold.
snmp_storage_name	Optional. Storage name. Default to regex "^/". More options available in the snmp storage documentation.
snmp_perf	Optional. Enable perfdata values. Defaults to true.
snmp_timeout	Optional. The command timeout in seconds. Defaults to 5 seconds.

snmp-interface

Check command object for the check_snmp_int.pl plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_nocrypt	Optional. Define SNMP encryption. If set snmp_v3 needs to be set. Defaults to false.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_port	Optional. The SNMP port connection.
snmp_v2	Optional. SNMP version to 2c. Defaults to false.
snmp_v3	Optional. SNMP version to 3. Defaults to false.
snmp_login	Optional. SNMP version 3 username. Defaults to "snmpuser".
snmp_password	Required. SNMP version 3 password. No value defined as default.
snmp_v3_use_privpass	Optional. Define to use SNMP version 3 priv password. Defaults to false.
snmp_authprotocol	Optional. SNMP version 3 authentication protocol. Defaults to "md5,des".
snmp_privpass	Required. SNMP version 3 priv password. No value defined as default.
snmp_warn	Optional. The warning threshold.
snmp_crit	Optional. The critical threshold.
snmp_interface	Optional. Network interface name. Default to regex "eth0".
snmp_interface_perf	Optional. Check the input/ouput bandwidth of the interface. Defaults to true.
snmp_interface_label	Optional. Add label before speed in output: in=, out=, errors-out=, etc...
snmp_interface_bits_bytes	Optional. Output performance data in bits/s or Bytes/s. Depends on snmp_interface_kbits set to true. Defaults to true.
snmp_interface_percent	Optional. Output performance data in % of max speed. Defaults to false.
snmp_interface_kbits	Optional. Make the warning and critical levels in KBits/s. Defaults to true.
snmp_interface_megabytes	Optional. Make the warning and critical levels in Mbps or MBps. Depends on snmp_interface_kbits set to true. Defaults to true.
snmp_interface_64bit	Optional. Use 64 bits counters instead of the standard counters when checking bandwidth & performance data for interface >= 1Gbps. Defaults to false.
snmp_interface_errors	Optional. Add error & discard to Perfparse output. Defaults to true.
snmp_interface_noregexp	Optional. Do not use regexp to match interface name in description OID. Defaults to false.
snmp_interface_delta	Optional. Delta time of perfcheck. Defaults to "300" (5 min).
snmp_warncrit_percent	Optional. Make the warning and critical levels in % of reported interface speed. If set snmp_interface_megabytes needs to be set to false. Defaults to false.
snmp_perf	Optional. Enable perfdata values. Defaults to true.
snmp_timeout	Optional. The command timeout in seconds. Defaults to 5 seconds.

snmp-process

Check command object for the check_snmp_process.pl plugin.

Custom Attributes:

Name	Description
snmp_address	Optional. The host's address. Defaults to "address" or "address6" if the address attribute is not set.
snmp_nocrypt	Optional. Define SNMP encryption. If set snmp_v3 needs to be set. Defaults to false.
snmp_community	Optional. The SNMP community. Defaults to "public".
snmp_port	Optional. The SNMP port connection.
snmp_v2	Optional. SNMP version to 2c. Defaults to false.
snmp_v3	Optional. SNMP version to 3. Defaults to false.
snmp_login	Optional. SNMP version 3 username. Defaults to "snmpuser".
snmp_password	Required. SNMP version 3 password. No value defined as default.
snmp_v3_use_privpass	Optional. Define to use SNMP version 3 priv password. Defaults to false.
snmp_authprotocol	Optional. SNMP version 3 authentication protocol. Defaults to "md5,des".
snmp_privpass	Required. SNMP version 3 priv password. No value defined as default..
snmp_warn	Optional. The warning threshold.
snmp_crit	Optional. The critical threshold.
snmp_process_name	Optional. Name of the process (regexp). No trailing slash!. Defaults to ".*".
snmp_perf	Optional. Enable perfdata values. Defaults to true.
snmp_timeout	Optional. The command timeout in seconds. Defaults to 5 seconds.

Plugins Contrib

The Plugins contrib collects various contributed command definitions.

These check commands assume that the global constant named PluginsContribDir is set to the path where the user installs custom plugins and can be enabled by uncommenting the corresponding line in icinga2.conf.

IPMI Devices

This category includes all plugins for IPMI devices.

ipmi-sensor

With the plugin ipmi-sensor provided by Thomas-Krenn.AG you can monitor sensor data for IPMI devices. See https://www.thomas-krenn.com/en/wiki/IPMI_Sensor_Monitoring_Plugin for installation and configuration instructions.

Custom Attributes:

Name	Description
ipmi_address	Required. Specifies the remote host (IPMI device) to check. Defaults to "address".
ipmi_config_file	Optional. Path to the FreeIPMI configuration file. It should contain IPMI username, IPMI password, and IPMI privilege-level.
ipmi_username	Optional. The IPMI username.
ipmi_password	Optional. The IPMI password.
ipmi_privilege_level	Optional. The IPMI privilege level of the IPMI user.
ipmi_backward_compatibility_mode	Optional. Enable backward compatibility mode, useful for FreeIPMI 0.5.* (this omits FreeIPMI options "--quiet-cache" and "--sdr-cache-recreate").
ipmi_sensor_type	Optional. Limit sensors to query based on IPMI sensor type. Examples for IPMI sensor types are 'Fan', 'Temperature' and 'Voltage'.
ipmi_exclude_sensor_id	Optional. Exclude sensor matching ipmi_sensor_id.
ipmi_sensor_id	Optional. Include sensor matching ipmi_sensor_id.
ipmi_protocal_lan_version	Optional. Change the protocol LAN version. Defaults to "LAN_2_0".
ipmi_number_of_active_fans	Optional. Number of fans that should be active. Otherwise a WARNING state is returned.
ipmi_show_fru	Optional. Print the product serial number if it is available in the IPMI FRU data.
ipmi_no_sel_checking	Optional. Turn off system event log checking via ipmi-sel.

Network Components

This category includes all plugins for various network components like routers, switches and firewalls.

interfacetable

The plugin interfacetable generates a html page containing information about the monitored node and all of its interfaces. The actively developed and maintained version is interfacetable_v3t provided by Yannick Charton on http://www.tontonitch.com or https://github.com.

Custom Attributes:

Name	Description
interfacetable_hostquery	Required. Specifies the remote host to poll. Defaults to "address".
interfacetable_hostdisplay	Optional. Specifies the hostname to display in the HTML link. Defaults to "host.display_name".
interfacetable_regex	Optional. Interface names and property names for some other options will be interpreted as regular expressions. Defaults to false.
interfacetable_outputshort	Optional. Reduce the verbosity of the plugin output. Defaults to false.
interfacetable_exclude	Optional. Comma separated list of interfaces globally excluded from the monitoring.
interfacetable_include	Optional. Comma separated list of interfaces globally included in the monitoring.
interfacetable_aliasmatching	Optional. Allow you to specify alias in addition to interface names. Defaults to false.
interfacetable_excludetraffic	Optional. Comma separated list of interfaces excluded from traffic checks.
interfacetable_includetraffic	Optional. Comma separated list of interfaces included for traffic checks.
interfacetable_warningtraffic	Optional. Interface traffic load percentage leading to a warning alert.
interfacetable_criticaltraffic	Optional. Interface traffic load percentage leading to a critical alert.
interfacetable_pkt	Optional. Add unicast/non-unicast pkt stats for each interface.
interfacetable_trackproperty	Optional. List of tracked properties.
interfacetable_excludeproperty	Optional. Comma separated list of interfaces excluded from the property tracking.
interfacetable_includeproperty	Optional. Comma separated list of interfaces included in the property tracking.
interfacetable_community	Optional. Specifies the snmp v1/v2c community string. Defaults to "public" if using snmp v1/v2c, ignored using v3.
interfacetable_snmpv2	Optional. Use snmp v2c. Defaults to false.
interfacetable_login	Optional. Login for snmpv3 authentication.
interfacetable_passwd	Optional. Auth password for snmpv3 authentication.
interfacetable_privpass	Optional. Priv password for snmpv3 authentication.
interfacetable_protocols	Optional. Authentication protocol,Priv protocol for snmpv3 authentication.
interfacetable_domain	Optional. SNMP transport domain.
interfacetable_contextname	Optional. Context name for the snmp requests.
interfacetable_port	Optional. SNMP port. Defaults to standard port.
interfacetable_64bits	Optional. Use SNMP 64-bits counters. Defaults to false.
interfacetable_maxrepetitions	Optional. Increasing this value may enhance snmp query performances by gathering more results at one time.
interfacetable_snmptimeout	Optional. Define the Transport Layer timeout for the snmp queries.
interfacetable_snmpretries	Optional. Define the number of times to retry sending a SNMP message.
interfacetable_unixsnmp	Optional. Use unix snmp utilities for snmp requests. Defaults to false, which means use the perl bindings.
interfacetable_enableperfdata	Optional. Enable port performance data. Defaults to false.
interfacetable_perfdataformat	Optional. Define which performance data will be generated. Possible values are "full" (default), "loadonly", "globalonly".
interfacetable_perfdatathreshold	Optional. Define which thresholds are printed in the generated performance data. Possible values are "full" (default), "loadonly", "globalonly".
interfacetable_perfdatadir	Optional. When specified, the performance data are also written directly to a file, in the specified location.
interfacetable_perfdataservicedesc	Optional. Specify additional parameters for output performance data to PNP. Defaults to "service.name", only affects interfacetable_perfdatadir.
interfacetable_grapher	Optional. Specify the used graphing solution. Possible values are "pnp4nagios" (default), "nagiosgrapher", "netwaysgrapherv2" and "ingraph".
interfacetable_grapherurl	Optional. Graphing system url. Default depends on interfacetable_grapher.
interfacetable_portperfunit	Optional. Traffic could be reported in bits (counters) or in bps (calculated value).
interfacetable_nodetype	Optional. Specify the node type, for specific information to be printed / specific oids to be used. Possible values: "standard" (default), "cisco", "hp", "netscreen", "netapp", "bigip", "bluecoat", "brocade", "brocade-nos", "nortel", "hpux".
interfacetable_duplex	Optional. Add the duplex mode property for each interface in the interface table. Defaults to false.
interfacetable_stp	Optional. Add the stp state property for each interface in the interface table. Defaults to false.
interfacetable_vlan	Optional. Add the vlan attribution property for each interface in the interface table. Defaults to false. This option is available only for the following nodetypes: "cisco", "hp", "nortel"
interfacetable_noipinfo	Optional. Remove the ip information for each interface from the interface table. Defaults to false.
interfacetable_alias	Optional. Add the alias information for each interface in the interface table. Defaults to false.
interfacetable_accessmethod	Optional. Access method for a shortcut to the host in the HTML page. Format is : [:] Where method can be: ssh, telnet, http or https.
interfacetable_htmltablelinktarget	Optional. Specifies the windows or the frame where the [details] link will load the generated html page. Possible values are: "_blank", "_self" (default), "_parent", "_top", or a frame name.
interfacetable_delta	Optional. Set the delta used for interface throuput calculation in seconds.
interfacetable_ifs	Optional. Input field separator. Defaults to ",".
interfacetable_cache	Optional. Define the retention time of the cached data in seconds.
interfacetable_noifloadgradient	Optional. Disable color gradient from green over yellow to red for the load percentage. Defaults to false.
interfacetable_nohuman	Optional. Do not translate bandwidth usage in human readable format. Defaults to false.
interfacetable_snapshot	Optional. Force the plugin to run like if it was the first launch. Defaults to false.
interfacetable_timeout	Optional. Define the global timeout limit of the plugin in seconds. Defaults to "15s".
interfacetable_css	Optional. Define the css stylesheet used by the generated html files. Possible values are "classic", "icinga", "icinga-alternate1" or "nagiosxi".
interfacetable_config	Optional. Specify a config file to load.
interfacetable_noconfigtable	Optional. Disable configuration table on the generated HTML page. Defaults to false.
interfacetable_notips	Optional. Disable the tips in the generated html tables. Defaults to false.
interfacetable_defaulttablesorting	Optional. Default table sorting can be "index" (default) or "name".
interfacetable_tablesplit	Optional. Generate multiple interface tables, one per interface type. Defaults to false.
interfacetable_notype	Optional. Remove the interface type for each interface. Defaults to false.

Operating System

In this category you can find plugins for gathering information about your operating system or the system beneath like memory usage.

mem

The plugin mem is used for gathering information about memory usage on linux and unix hosts. It is able to count cache memory as free when comparing it to the thresholds. It is provided by Justin Ellison on https://github.com. For more details see the developers blog http://sysadminsjourney.com.

Custom Attributes:

Name	Description
mem_used	Optional. Tell the plugin to check for used memory in opposite of mem_free. Must specify one of these as true.
mem_free	Optional. Tell the plugin to check for free memory in opposite of mem_used. Must specify one of these as true.
mem_cache	Optional. If set to true plugin will count cache as free memory. Defaults to false.
mem_warning	Required. Specifiy the warning threshold as number interpreted as percent.
mem_critical	Required. Specifiy the critical threshold as number interpreted as percent.

Virtualization

This category includes all plugins for various virtualization technologies.

esxi_hardware

The plugin esxi_hardware is a plugin to monitor hardware of ESXi servers through the vmware api and cim service. It is provided by Claudio Kuenzler on http://www.claudiokuenzler.com. For instruction on creating the required local user and workarounds for some hardware types have a look on his homepage.

Custom Attributes:

Name	Description
esxi_hardware_host	Required. Specifies the host to monitor. Defaults to "address".
esxi_hardware_user	Required. Specifies the user for polling. Must be a local user of the root group on the system. Can also be provided as a file path file:/path/to/.passwdfile, then first string of file is used.
esxi_hardware_pass	Required. Password of the user. Can also be provided as a file path file:/path/to/.passwdfile, then second string of file is used.
esxi_hardware_vendor	Optional. Defines the vendor of the server: "auto", "dell", "hp", "ibm", "intel", "unknown" (default).
esxi_hardware_html	Optional. Add web-links to hardware manuals for Dell servers (use your country extension). Only useful with esxi_hardware_vendor = dell.
esxi_hardware_ignore	Optional. Comma separated list of elements to ignore.
esxi_hardware_perfdata	Optional. Add performcedata for graphers like PNP4Nagios to the output. Defaults to false.
esxi_hardware_nopower	Optional. Do not collect power performance data, when esxi_hardware_perfdata is set to true. Defaults to false.
esxi_hardware_novolts	Optional. Do not collect voltage performance data, when esxi_hardware_perfdata is set to true. Defaults to false.
esxi_hardware_nocurrent	Optional. Do not collect current performance data, when esxi_hardware_perfdata is set to true. Defaults to false.
esxi_hardware_notemp	Optional. Do not collect temperature performance data, when esxi_hardware_perfdata is set to true. Defaults to false.
esxi_hardware_nofan	Optional. Do not collect fan performance data, when esxi_hardware_perfdata is set to true. Defaults to false.