シンプルチェックは、通常、リモートエージェントを使用しないサービスをチェックするために使用します。
なお、シンプルチェックでは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]
シンプルチェック項目のUser nameおよびPasswordフィールドはVMwareの監視項目に使用され、それ以外は無視されます。
The item keys are listed without optional parameters and additional information. Click on the item key to see the full details. オプションのパラメーターや追加情報なしのアイテムキーのリストです。アイテムキーをクリックすると詳細が表示されます。
参照: VMware monitoring item keys
アイテムキー | 説明 |
---|---|
icmpping | ICMP ping によるホストのアクセス。 |
icmppingloss | パケットロスの割合 |
icmppingsec | ICMP ping の応答時間。 |
net.tcp.service | サービスが実行中であり、TCP接続を受け入れているかどうかを確認します。 |
net.tcp.service.perf | TCPサービスのパフォーマンスチェック。 |
net.udp.service | サービスが実行中であり、UDPリクエストに応答しているかどうかを確認します。 |
net.udp.service.perf | UDPサービスのパフォーマンスチェック |
The host accessibility by ICMP ping.
Return value: 0 - ICMP ping fails; 1 - ICMP ping successful.
Parameters:
See also the table of default values.
Example:
The percentage of lost packets.
Return value: Float.
Parameters:
See also the table of default values.
The ICMP ping response time (in seconds).
Return value: Float.
Parameters:
Comments:
Checks if a service is running and accepting TCP connections.
Return value: 0 - the service is down; 1 - the service is running.
Parameters:
Comments:
net.tcp.service[tcp,<ip>,port]
for checks like these.Example:
net.tcp.service[ftp,,45] #This item can be used to test the availability of FTP server on TCP port 45.
Checks the performance of a TCP service.
Return value: Float: 0.000000 - the service is down; seconds - the number of seconds spent while connecting to the service.
Parameters:
Comments:
net.tcp.service[tcp,<ip>,port]
for checks like these.Example:
net.tcp.service.perf[ssh] #This item can be used to test the speed of initial response from SSH server.
Checks if a service is running and responding to UDP requests.
Return value: 0 - the service is down; 1 - the service is running.
Parameters:
Example:
net.udp.service[ntp,,45] #This item can be used to test the availability of NTP service on UDP port 45.
Checks the performance of a UDP service.
Return value: Float: 0.000000 - the service is down; seconds - the number of seconds spent waiting for response from the service.
Parameters:
Example:
Note that for SourceIP support in LDAP simple checks, OpenLDAP version 2.6.1 or above is required.
Zabbixは、Zabbix server / proxy 設定ファイルに定義されたタイムアウト秒数以上のシンプルチェックは処理しません。
ZabbixはICMP pingの処理に外部ユーティリティfpingを使用しています。
このユーティリティはZabbixの配布物には含まれていないため、追加でインストールする必要があります。
ユーティリティがない場合、パーミッションが正しくない場合、またはユーティリティの場所が
Zabbix server / proxy 設定ファイル('FpingLocation'パラメータ)で設定した場所と一致しない場合、 ICMP Ping(icmpping, icmppingloss, icmppingsec) は処理されません。
known issues もあわせて参照してください。
fpingは、Zabbix daemon が実行されるユーザで実行可能である必要があります。setuid root で実行する必要があります。
正しいパーミッションを設定するために、ユーザrootとして以下のコマンドを実行してください。
上記 2 つのコマンドを実行した後、fping 実行ファイルの所有権を確認します。 場合によっては、chmod コマンドを実行することで、所有権をリセットできる場合があります。
また、ユーザ zabbix がグループ zabbix に属しているかどうかも確認してください。
zabbix グループに追加されていない場合は、以下を実行してください。
ICMPチェックパラメータのデフォルト値、制限値の説明:
パラメータ | 単位 | 説明 | Fpingのflag | デフォルト値 | 制限値 by Zabbix |
||
---|---|---|---|---|---|---|---|
fping | Zabbix | min | max | ||||
packets | number | number of request packets to a target | -C | 3 | 1 | 10000 | |
interval | milliseconds | time to wait between successive packets | -p | 1000 | 20 | unlimited | |
size | bytes | packet size in bytes 56 bytes on x86, 68 bytes on x86_64 |
-b | 56 or 68 | 24 | 65507 | |
timeout | milliseconds | fping v3.x - timeout to wait after last packet sent, affected by -C flag fping v4.x - individual timeout for each packet |
-t | fping v3.x - 500 fping v4.x - inherited from -p flag, but not more than 2000 |
50 | unlimited |
さらに、Zabbix は fping オプションとして、-i interval ms (上表の item パラメータ interval と
混同しないように注意してください) と-S source IP address(旧fpingバージョンでは-I)を使用します。
これらのオプションは、異なるオプションの組み合わせでチェックを実行することで、自動的に検出されます。
Zabbixは、fping が -i で使用できる最小値をミリ秒単位で検出するため、0、1、10の3つの値を試します。
最初に成功した値がその後のICMPチェックに使われます。この処理は、各ICMP pinger プロセスが個別に行います。
自動検出された fping オプションは、1時間ごとに無効化され、次回のICMP検査時に再度検出されます。
このプロセスの詳細を表示するには、DebugLevel>=4 に設定します。
server または proxy のログファイルにこのプロセスの詳細が表示されます。
警告: fping のデフォルトは、プラットフォームとバージョンによって異なる場合があります。
fping のドキュメントを確認してください。
Zabbixは、3つのicmppingキーでチェックするIPアドレスを一時ファイルに書き込み、
このファイルをfpingに渡します。item キーパラメータが異なる項目は、キーパラメータが同一のもの
のみ1つのファイルに書き込まれます。
1つのファイルに書き込まれた全てのIPアドレスを並列にfpingでチェックするため、Zabbixのicmpピンガープロセスは
ファイル内のIPアドレスの数に関係なく、一定の時間を費やします。
fping is not included with Zabbix and needs to be installed separately:
Various Unix-based platforms have the fping package in their default repositories, but it is not pre-installed. In this case you can use the package manager to install fping.
Zabbix provides fping packages for RHEL. Please note that these packages are provided without official support.
fping can also be compiled from source.
Specify fping location in the FpingLocation parameter of Zabbix server/proxy configuration file (or Fping6Location parameter for using IPv6 addresses).
fping should be executable by the user Zabbix server/proxy run as and this user should have sufficient rights.
See also: Known issues for processing simple checks with fping versions below 3.10.
Defaults, limits and description of values for ICMP check parameters:
Parameter | Unit | Description | Fping's flag | Defaults set by | Allowed limits by Zabbix |
||
---|---|---|---|---|---|---|---|
fping | Zabbix | min | max | ||||
packets | number | number of request packets sent to a target | -C | 3 | 1 | 10000 | |
interval | milliseconds | time to wait between successive packets to an individual target | -p | 1000 | 20 | unlimited | |
size | bytes | packet size in bytes 56 bytes on x86, 68 bytes on x86_64 |
-b | 56 or 68 | 24 | 65507 | |
timeout | milliseconds | fping v3.x - timeout to wait after last packet sent, affected by -C flag fping v4.x - individual timeout for each packet |
-t | fping v3.x - 500 fping v4.x and newer - inherited from -p flag, but not more than 2000 |
50 | unlimited |
The defaults may differ slightly depending on the platform and version.
In addition, Zabbix uses fping options -i interval ms (do not mix up with the item parameter interval mentioned in the table above, which corresponds to fping option -p) and -S source IP address (or -I in older fping versions). These options are auto-detected by running checks with different option combinations. Zabbix tries to detect the minimal value in milliseconds that fping allows to use with -i by trying 3 values: 0, 1 and 10. The value that first succeeds is then used for subsequent ICMP checks. This process is done by each ICMP pinger process individually.
Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set DebugLevel>=4 in order to view details of this process in the server or proxy log file.
Zabbix writes IP addresses to be checked by any of the three icmpping* keys to a temporary file, which is then passed to fping. If items have different key parameters, only the 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.