[comment]: # translation:outdated
[comment]: # ({be4ab03d-be4ab03d})
# 5 种简单检查
[comment]: # ({/be4ab03d-be4ab03d})
[comment]: # ({76023448-76023448})
#### 概述
简单检查通常用于远程无agent的服务监控。
注意简单检查不需要Zabbix agent。Zabbix server/proxy负责处理简单检查（建立外部连接等）。
简单检查的使用示例：
net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]
net.udp.service.perf[ntp]
::: noteclassic
简单检查监控项配置中的*用户名*和*密码*字段用于VMware监控监控项；其他情况下会被忽略。
:::
[comment]: # ({/76023448-76023448})
[comment]: # ({df646d51-f59a5ccc})
#### 支持的简单检查
支持的简单检查列表:
另请参阅:
- [VMware monitoring 监控项
keys](/manual/config/items/itemtypes/simple_checks/vmware_keys)
| 键 | < | < | < |
|--|--|------|------|
| **描述** | **返回值** | **参数** | **备注** |
| **icmpping**[<目标>,<数据包数>,<间隔>,<大小>,<超时>] | < | < | < |
主机 通过ICMP ping可达性检测 | 0 - ICMP ping失败
1 - ICMP ping成功 | **target** - 主机 IP或DNS名称
**packets** - 数据包数量
**interval** - 连续数据包间隔时间（毫秒）
**size** - 数据包大小（字节）
**timeout** - 超时时间（毫秒） | 示例：
=> icmpping\[,4\] → 若四个数据包中至少有一个返回，监控项将返回1。
另见：[icmp-ping-检测](simple_checks#icmp-ping-检测)表格。 |
| **icmppingloss**[<目标>,<数据包数>,<间隔>,<大小>,<超时>] | < | < | < |
| 丢包百分比. | float. | **target** - 主机 IP或DNS名称
**packets** - 数据包数量
**interval** - 连续数据包之间的时间间隔（毫秒）
**size** - 数据包大小（字节）
**timeout** - 超时时间（毫秒） | 另请参阅: [icmp-ping-检测](simple_checks#icmp-ping-检测)表格. |
| **icmppingsec**\[<目标>,<数据包数>,<间隔>,<大小>,<超时>,<模式>\] | < | < | < |
| ICMP ping响应时间（以秒为单位）。 | float. | **target** - 主机 IP或DNS名称
**packets** - 数据包数量
**interval** - 连续数据包之间的间隔时间（毫秒）
**size** - 数据包大小（字节）
**timeout** - 超时时间（毫秒）
**mode** - 可选值：*min*、*max*、*avg*（默认） | 丢失或超时的数据包不参与计算。
如果主机不可达（达到超时），监控项将返回0。
若返回值小于0.0001秒，该值将被设为0.0001秒。
另见：[icmp-ping-检测](simple_checks#icmp-ping-检测)表格。 |
| **net.tcp.service**\[服务,,<端口>\] | < | < | < |
| 检查服务是否正在运行并接受TCP连接。 | 0 - 服务停止
1 - 服务正在运行 | **service** - 可选值: *ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (参见[details](/manual/appendix/items/service_check_details))
**ip** - IP地址或DNS名称(默认使用主机 IP/DNS)
**port** - 端口号(默认使用标准服务端口号) | 示例:
=> net.tcp.service\[ftp,,45\] → 可用于测试FTP服务器在TCP端口45上的可用性。
注意：对于*tcp*服务，必须指定端口参数。
这些检查可能会在系统守护进程日志文件中产生额外消息(通常SMTP和SSH会话会被记录)。
当前不支持检查加密协议(如端口993的IMAP或端口995的POP)。作为替代方案，请使用net.tcp.service\[tcp,,port\]进行此类检查。
*https*和*telnet*服务自Zabbix 2.0起支持。 |
| **net.tcp.service.perf**\[服务,,<端口>\] | < | < | < |
| 检测TCP服务的性能 | float.
0.000000 - 服务不可用
秒数 - 连接到服务所耗费的秒数 | **service** - 可选值: *ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (参见 [details](/manual/appendix/items/service_check_details))
**ip** - IP地址或DNS名称 (默认使用 主机 IP/DNS)
**port** - 端口号 (默认使用标准服务端口号) | 示例:
=> net.tcp.service.perf\[ssh\] → 可用于测试SSH服务器的初始响应速度.
注意：使用 *tcp* 服务时必须指定端口.
目前不支持检查加密协议(如端口993的IMAP或端口995的POP). 作为替代方案，请使用 net.tcp.service.perf\[tcp,,port\] 进行此类检查.
*https* 和 *telnet* 服务自Zabbix 2.0起支持.
在Zabbix 2.0之前称为 tcp\_perf. |
| **net.udp.service**\[service,,\] | < | < | < |
检查服务是否正在运行并响应UDP请求。 | 0 - 服务已停止
1 - 服务正在运行 | **service** - 可能的值: *ntp* (参见[details](/manual/appendix/items/service_check_details))
**ip** - IP地址或DNS名称(默认使用主机 IP/DNS)
**port** - 端口号(默认使用标准服务端口号)。 | 示例:
=> net.udp.service\[ntp,,45\] → 可用于测试UDP端口45上的NTP服务可用性。
此监控项自Zabbix 3.0起支持，但早期版本中net.tcp.service\[\] 监控项已提供*ntp*服务支持。 |
| **net.udp.service.perf**\[service,,\] | < | < | < |
| 检测UDP服务的性能 | float.
0.000000 - 服务不可用
seconds - 等待服务响应的秒数 | **service** - 可选值: *ntp* (参见[details](/manual/appendix/items/service_check_details))
**ip** - IP地址或DNS名称(默认使用主机 IP/DNS)
**port** - 端口号(默认使用标准服务端口号) | 示例:
=> net.udp.service.perf\[ntp\] → 可用于测试NTP服务的响应时间
该监控项自Zabbix 3.0起支持，但早期版本中net.tcp.service\[\] 监控项已提供*ntp*服务检测功能 |
[comment]: # ({/df646d51-f59a5ccc})
[comment]: # ({9557f612-15865974})
::: noteimportant
对于LDAP简单检查中的SourceIP支持（例如`net.tcp.service[ldap]`），需要OpenLDAP version 2.6.1或更高版本。自Zabbix 6.0.1起，LDAP简单检查中支持SourceIP功能。
:::
[comment]: # ({/9557f612-15865974})
[comment]: # ({7b5f94c9-92a6c4ae})
##### 超时处理
Zabbix将不会处理超过在Zabbix server/proxy配置file中定义的超时秒数的简单检查。对于icmpping* 监控项，超时和重试次数直接在监控项键中指定，不受全局超时参数影响。
[comment]: # ({/7b5f94c9-92a6c4ae})
[comment]: # ({781803a5-b08a4508})
#### ICMP ping 检测
Zabbix使用外部工具**fping**处理ICMP ping检测。
该工具不属于Zabbix发行版，需额外安装。若工具缺失、权限错误或路径与Zabbix
server/proxy配置file中的'FpingLocation'参数不匹配，ICMP ping检测
(**icmpping**、**icmppingloss**、**icmppingsec**)将无法执行。
另见：[简单检查](/manual/installation/known_issues#简单检查)
**fping**必须设置为setuid root且Zabbix守护进程run用户可执行。以**root**用户运行以下命令设置正确权限：
chown root:zabbix /usr/sbin/fping
chmod 4710 /usr/sbin/fping
执行上述两条命令后需检查**fping**可执行文件的所有权。某些情况下执行chmod命令会重置所有权。
同时通过以下命令检查zabbix用户是否属于zabbix组：
groups zabbix
若不属于则执行：
usermod -a -G zabbix zabbix
ICMP检测参数的默认值、限制及描述：
| 参数 | 单位 | 描述 | Fping的flag | 默认值设定方 | < | Zabbix允许限制
| < |
|--|--|--------|-|--|--|--|--|
| | | | | **fping** | **Zabbix** | **最小值** | **最大值** |
| packets | 数值 | 发送至目标地址的请求包数量 | -C | | 3 | 1 | 10000 |
| interval | 毫秒 | 连续数据包间的等待时间 | -p | 1000 | | 20 | 无限制 |
| size | 字节 | 数据包大小
x86架构56字节，x86_64架构68字节 | -b | 56或68 | | 24 | 65507 |
| timeout | 毫秒 | **fping v3.x** - 最后数据包发送后的等待超时，受*-C* flag影响
**fping v4.x** - 每个数据包的独立超时 | -t | **fping v3.x** - 500
**fping v4.x** - 继承自*-p* flag，但不超过2000 | | 50 | 无限制 |
此外Zabbix使用fping的*-i间隔毫秒*选项（勿与上表中监控项参数*interval*混淆，该参数对应fping的*-p*选项）及*-S源IP地址*选项（旧版fping使用*-I*）。这些选项通过运行不同组合的检测自动识别。Zabbix尝试通过测试0、1和10三个值来检测fping允许使用*-i*的最小毫秒值，首次成功的值将用于后续ICMP检测。该过程由每个[server-进程类型](/manual/concepts/server#server-进程类型)进程独立完成。
自动识别的fping选项每小时失效一次，并在下次执行ICMP检测时重新识别。将DebugLevel>=4可查看server 或 proxy日志file中的详细过程。
::: notewarning
警告：fping默认值可能因平台和version而异，如有疑问请查阅fping文档。
:::
Zabbix将三个*icmpping\**键值需检测的IP地址写入临时file后传递给**fping**。若监控项具有不同键值参数，仅参数完全相同的条目会写入同一file。\
单个file中的所有IP地址将由fping并行检测，因此Zabbix icmp pinger进程耗时固定，与file中的IP数量无关。
[comment]: # ({/781803a5-b08a4508})