2018/10/16 13:17 1/4 5 Simple checks

5 Simple checks

5.1 Overview

Simple checks are normally used for remote agent-less checks of services.

Note that Zabbix agent is not needed for simple checks. Zabbix server/proxy is responsible for the
processing of simple checks (making external connections, etc).

Examples of using simple checks:

net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]

5.2 Supported simple checks

List of supported simple checks:

Key
▲ Description Return value Parameters Comments
icmpping[<target>,<packets>,<interval>,<size>,<timeout>]
target - host IP or
DNS name
packets - number
of packets
Example: icmpping[,4] - if at least one
0 - ICMP ping interval - time
packet of the four is returned, the item will
Host accessibility fails between
return 1.
by ICMP ping. 1 - ICMP ping successive packets
successful in milliseconds
See also: table of default values.
size - packet size
in bytes
timeout - timeout
in milliseconds
icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>]
target - host IP or
DNS name
packets - number
of packets
interval - time
Percentage of between
Float. See also: table of default values.
lost packets. successive packets
in milliseconds
size - packet size
in bytes
timeout - timeout
in milliseconds
icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>]

Zabbix Documentation 2.0 - https://www.zabbix.com/documentation/2.0/

Last
update:
manual:config:items:itemtypes:simple_checks https://www.zabbix.com/documentation/2.0/manual/config/items/itemtypes/simple_checks
2017/02/22
13:25

Key
▲ Description Return value Parameters Comments
target - host IP or
DNS name
packets - number
of packets
interval - time
between If host is not available (timeout reached), the
ICMP ping
successive packets item will return 0.
response time (in Float.
in milliseconds
seconds).
size - packet size See also: table of default values.
in bytes
timeout - timeout
in milliseconds
mode - one of min,
max, avg (default)
net.tcp.service[service,<ip>,<port>]
Example: net.tcp.service[ftp,,45] can be
used to test the availability of FTP server on
service - one of
TCP port 45.
ssh, ntp, ldap,
Note that with tcp service indicating the port
smtp, ftp, http,
is mandatory.
pop, nntp, imap,
Note that these checks may result in
tcp, https, telnet
additional messages in system daemon
(see details)
Check if service 0 - service is logfiles (SMTP and SSH sessions being logged
ip - IP address or
is running and down usually).
DNS name (by
accepting TCP 1 - service is Checking of encrypted protocols (like IMAP on
default, host
connections. running port 993 or POP on port 995) is currently not
IP/DNS is used)
supported. As a workaround, please use
port - port number
net.tcp.service[tcp,<ip>,port] for checks like
(by default
these.
standard service
Services https and telnet supported since
port number is
Zabbix 2.0.
used).
Service ntp only works since Zabbix 2.0.15,
despite being available in earlier versions.
net.tcp.service.perf[service,<ip>,<port>]
service - one of Example: net.tcp.service.perf[ssh] can be
ssh, ntp, ldap, used to test the speed of initial response
smtp, ftp, http, from SSH server.
pop, nntp, imap, Note that with tcp service indicating the port
0 - service is tcp, https, telnet is mandatory.
down (see details) Checking of encrypted protocols (like IMAP on
Service sec - number ip - IP address or port 993 or POP on port 995) is currently not
performance of seconds DNS name (by supported. As a workaround, please use
check. spent while default, host net.tcp.service.perf[tcp,<ip>,port] for checks
connecting to IP/DNS is used) like these.
the service port - port number Services https and telnet supported since
(by default Zabbix 2.0.
standard service Service ntp only works since Zabbix 2.0.15,
port number is despite being available in earlier versions.
used). Called tcp_perf before Zabbix 2.0.

https://www.zabbix.com/documentation/2.0/ Printed on 2018/10/16 13:17

2018/10/16 13:17 3/4 5 Simple checks

Timeout processing

Zabbix will not process a simple check longer than the Timeout seconds defined in the Zabbix
server/proxy configuration file.

5.3 ICMP pings

Zabbix uses external utility fping for processing of ICMP pings.

The utility is not part of Zabbix distribution and has to be additionally installed. If the utility is missing,
has wrong permissions or its location does not match the location set in the Zabbix server/proxy
configuration file ('FpingLocation' parameter), ICMP pings (icmpping, icmppingloss, icmppingsec)
will not be processed.

See also: known issues

fping must be executable by the user Zabbix daemons run as and setuid root. Run these commands
as user root in order to set up correct permissions:

shell> chown root:zabbix /usr/sbin/fping

shell> chmod 4710 /usr/sbin/fping

After performing the two commands above check ownership of the fping executable. In some cases
the ownership can be reset by executing the chmod command.

Defaults, limits and description of values for ICMP check parameters:

Allowed limits
Fping's Defaults set by
Parameter Unit Description by Zabbix
flag
fping Zabbix min max
number of request
packets number -C 3 1 10000
packets to a target
time to wait between
interval milliseconds -p 1000 20 unlimited
successive packets
packet size in bytes
size bytes 56 bytes on x86, 68 bytes -b 56 or 68 24 65507
on x86_64
fping v3.x -
fping v3.x - timeout to 500
wait after last packet sent
(affected by “-C” flag) fping v4.x -
timeout milliseconds -t 50 unlimited
inherited from
fping v4.x - individual -p flag, but not
timeout for each packet more than
2000

Warning: fping defaults can differ depending on platform and version - if in doubt, check fping
documentation.

Zabbix Documentation 2.0 - https://www.zabbix.com/documentation/2.0/

Last
update:
manual:config:items:itemtypes:simple_checks https://www.zabbix.com/documentation/2.0/manual/config/items/itemtypes/simple_checks
2017/02/22
13:25

Zabbix writes IP addresses to be checked by any of three icmpping* keys to a temporary file, which is
then passed to fping. If items have different key parameters, only ones with identical key parameters
are written to a single file.
All IP addresses written to the single file will be checked by fping in parallel, so Zabbix icmp pinger
process will spend fixed amount of time disregarding the number of IP addresses in the file.

From:
https://www.zabbix.com/documentation/2.0/ - Zabbix Documentation 2.0

Permanent link:
https://www.zabbix.com/documentation/2.0/manual/config/items/itemtypes/simple_checks

Last update: 2017/02/22 13:25

https://www.zabbix.com/documentation/2.0/ Printed on 2018/10/16 13:17