2 シンプルチェック

概要

シンプルチェックは通常、サービスに対するリモートのエージェントレスチェックに使用されます。

シンプルチェックには Zabbix エージェントは不要であることに注意してください。シンプルチェックの処理（外部接続の実行など）は、Zabbix サーバー/プロキシ が担当します。

シンプルチェックの使用例:

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

サポートされているチェック

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[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

ICMP ping によるホストの到達性。
戻り値: 0 - ICMP ping 失敗; 1 - ICMP ping 成功。

パラメーター:

• target - ホストの IP または DNS 名;
• packets - パケット数;
• interval - 連続するパケット間の時間（ミリ秒）;
• size - パケットサイズ（バイト）;
• timeout - タイムアウト（ミリ秒）;
• options - リダイレクトを許可するために使用します。空の場合（デフォルト値）、リダイレクトされた応答は対象ホストがダウンしているものとして扱われます。allow_redirect に設定されている場合、リダイレクトされた応答は対象ホストが稼働中として扱われます。

デフォルト値 の表も参照してください。

コメント:

• packets パラメーターで定義されたパケットのうち少なくとも 1 つが返された場合、アイテムは 1 を返します。 すべてのパケットが返らなかった場合、アイテムは 0 を返します。

例:

icmpping[,4] #4 つのパケットのうち少なくとも 1 つが返された場合、アイテムは 1 を返します。

icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

パケットロスの割合
戻り値: Float

パラメータ:

• target - ホストのIPアドレスまたはDNS名
• packets - パケット数
• interval - パケット間隔（ミリ秒）
• size - パケットサイズ（バイト）
• timeout - タイムアウト（ミリ秒）
• options - リダイレクトの許可に使用します。空（デフォルト値）の場合、リダイレクトされた応答はターゲットホストがダウンしているものとして扱われます。allow_redirect に設定されている場合、リダイレクトされた応答はターゲットホストが稼働しているものとして扱われます。

デフォルト値の表も参照してください。

icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]

ICMP pingの応答時間（秒）
戻り値: Float

パラメータ:

• target - ホストのIPアドレスまたはDNS名
• packets - パケット数
• interval - パケット間隔（ミリ秒）
• size - パケットサイズ（バイト）
• timeout - タイムアウト（ミリ秒）
• mode - 可能な値: min、max、または avg（デフォルト）
• options - リダイレクトを許可するために使用します。空の場合（デフォルト値）、リダイレクトされた応答はターゲットホストがダウンしているものとして扱われます。 allow_redirect に設定されている場合、リダイレクトされた応答はターゲットホストが稼働中として扱われます。

コメント:

• 損失またはタイムアウトしたパケットは計算に使用されません。
• ホストが利用できない場合（タイムアウトに達した場合）、この項目は 0 を返します。
• 戻り値が 0.0001 秒未満の場合、値は 0.0001 秒に設定されます。
• デフォルト値 の表も参照してください。

net.tcp.service[service,<ip>,<port>]

サービスが実行中で、TCP接続を受け付けているかどうかを確認します。
戻り値: 0 - サービスは停止しています。1 - サービスは実行中です。

パラメーター:

• service - 指定可能な値: ssh、ldap、smtp、ftp、http、pop、nntp、imap、tcp、https、telnet (詳細 を参照)
• ip - IPアドレスまたはDNS名 (デフォルトではホストIP/DNSが使用されます)
• port - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます)

コメント:

• tcp service の場合、ポート番号は必須です。
• これらのチェックにより、システムデーモンのログファイルに追加メッセージが記録される可能性があります（通常、SMTP および SSH セッションはログに記録されます）
• 暗号化プロトコル（ポート 993 の IMAP やポート 995 の POP など）のチェックは現在サポートされていません。回避策として、これらのチェックには net.tcp.service[tcp,<ip>,port] を使用してください。

例:

net.tcp.service[ftp,,45] # この項目は、TCP ポート 45 上の FTP サーバーの可用性をテストするために使用できます。

::: 重要 SELinux が強制モードで実行されている場合、カスタム TCP/UDP 簡易チェックがポリシーによってブロックされる可能性があります。新しい送信接続を確認して許可するには、`grep denied /var/log/audit/audit.log`` で監査拒否を確認してください。 :::

net.tcp.service.perf[service,<ip>,<port>]

TCP サービスのパフォーマンスをチェックします。
戻り値: Float: 0.000000 - サービスはダウンしています。 seconds - サービスへの接続にかかった秒数

パラメーター:

• service - 可能な値: ssh、ldap、smtp、ftp、http、pop、nntp、imap、tcp、https、telnet (詳細 を参照)
• ip - IP アドレスまたは DNS 名 (デフォルトではホスト IP/DNS が使用されます)
• port - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます)

コメント:

• tcp サービスを使用する場合、ポートの指定は必須です。
• 暗号化プロトコル（ポート993のIMAPやポート995のPOPなど）のチェックは現在サポートされていません。回避策として、これらのチェックには net.tcp.service[tcp,<ip>,port] を使用してください。

例:

net.tcp.service.perf[ssh] # この項目は、SSHサーバーからの初期応答速度をテストするために使用できます。

net.udp.service[service,<ip>,<port>]

サービスが実行中で、UDP 要求に応答しているかどうかを確認します。
戻り値: 0 - サービスが停止しています。 1 - サービスは実行中です。

パラメーター:

• service - 指定可能な値: ntp (詳細 を参照)
• ip - IP アドレスまたは DNS 名 (デフォルトではホスト IP/DNS が使用されます)
• port - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます)

例:

net.udp.service[ntp,,45] #この項目は、UDP ポート 45 での NTP サービスの可用性をテストするために使用できます。

net.udp.service.perf[service,<ip>,<port>]

UDPサービスのパフォーマンスをチェックします。
戻り値: Float: 0.000000 - サービスがダウンしています。 seconds - サービスからの応答を待機した秒数

パラメーター:

• service - 可能な値: ntp (詳細 を参照)
• ip - IPアドレスまたはDNS名 (デフォルトではホストIP/DNSが使用されます)
• port - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます)

例:

net.udp.service.perf[ntp] #この項目は、NTPサービスからの応答時間をテストするために使用できます。

::: 重要 LDAP シンプルチェック（例: net.tcp.service[ldap]）での SourceIP サポートには、OpenLDAP バージョン 2.6.1 以降が必要です。 :::

タイムアウト処理

Zabbix は、アイテム設定 フォームで定義された Timeout 秒を超えて、シンプルチェックを処理しません。 VMware アイテム の場合、 Zabbix は、Zabbix のサーバー または プロキシ の設定ファイルで定義された Timeout 秒を超えて、シンプルチェックを処理しません。icmpping* アイテムについては、タイムアウト値とリトライ値はアイテムキー内で直接指定され、グローバルな Timeout パラメータの影響を受けません。これらの値がアイテムキー内で適切に設定されていることを確認してください。icmpping* アイテムには、ハードコードされた最大タイムアウト値 600 秒が適用されることに注意してください（Zabbix 7.0.22 以降）。

ICMP ping

ZabbixはICMP pingの処理に外部ユーティリティfpingを使用しています。

このユーティリティはZabbixの配布物には含まれていないため、追加でインストールする必要があります。
ユーティリティがない場合、パーミッションが正しくない場合、またはユーティリティの場所が
Zabbix server / proxy 設定ファイル('FpingLocation'パラメータ)で設定した場所と一致しない場合、 ICMP Ping(icmpping, icmppingloss, icmppingsec) は処理されません。

known issues もあわせて参照してください。

fpingは、Zabbix daemon が実行されるユーザで実行可能である必要があります。setuid root で実行する必要があります。
正しいパーミッションを設定するために、ユーザrootとして以下のコマンドを実行してください。

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

上記 2 つのコマンドを実行した後、fping 実行ファイルの所有権を確認します。 場合によっては、chmod コマンドを実行することで、所有権をリセットできる場合があります。

また、ユーザ zabbix がグループ zabbix に属しているかどうかも確認してください。

shell> groups zabbix

zabbix グループに追加されていない場合は、以下を実行してください。

shell> usermod -a -G zabbix zabbix

ICMPチェックパラメータのデフォルト値、制限値の説明:

さらに、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 のログファイルにこのプロセスの詳細が表示されます。

Zabbixは、3つのicmppingキーでチェックするIPアドレスを一時ファイルに書き込み、
このファイルをfpingに渡します。item キーパラメータが異なる項目は、キーパラメータが同一のもの
のみ1つのファイルに書き込まれます。
1つのファイルに書き込まれた全てのIPアドレスを並列にfpingでチェックするため、Zabbixのicmpピンガープロセスは
ファイル内のIPアドレスの数に関係なく、一定の時間を費やします。

インストール

fping は Zabbix に含まれていないため、別途インストールする必要があります。

• さまざまな Unix ベースプラットフォームでは、デフォルトのリポジトリに fping パッケージが含まれていますが、プリインストールされていません。その場合は、パッケージマネージャーを使用して fping をインストールできます。

• Zabbix は RHEL 用の fping パッケージ を提供しています。これらのパッケージは公式サポートなしで提供されることにご注意ください。

• fping は ソースから コンパイルすることもできます。

設定

fping の場所を Zabbix サーバー/プロキシ設定ファイルの FpingLocation パラメータ （IPv6 アドレスを使用する場合は Fping6Location パラメータ）で指定します。

fping は Zabbix サーバー/プロキシが実行されるユーザーによって実行可能である必要があり、このユーザーには十分な権限が必要です。

あわせて参照: 3.10 未満の fping バージョンでシンプルチェックを処理する際の 既知の問題。

デフォルト値

ICMPチェックパラメータのデフォルト、制限、および値の説明:

デフォルト値は、プラットフォームやバージョンによって若干異なる場合があります。

さらに、Zabbixは fping のオプション -i interval ms（上の表で示したアイテムパラメータ interval と混同しないでください。これは fping のオプション -p に対応します）および -S source IP address（古い fping バージョンでは -I）を使用します。 これらのオプションは、異なるオプションの組み合わせでチェックを実行することにより自動検出されます。 Zabbixは、 -i で使用可能な fping の最小値（ミリ秒）を、0、1、10 の3つの値を試すことで検出しようとします。 最初に成功した値が、その後のICMPチェックで使用されます。 この処理は各 ICMP pinger プロセスごとに個別に行われます。

自動検出された fping オプションは1時間ごとに無効化され、次回のICMPチェック実行時に再検出されます。 サーバーまたはプロキシのログファイルでこの処理の詳細を確認するには、DebugLevel>=4 を設定してください。

Zabbixは、3つの icmpping* キーのいずれかでチェックするIPアドレスを一時ファイルに書き込み、その後それを fping に渡します。 アイテムに異なるキー パラメータがある場合、同一のキー パラメータを持つものだけが1つのファイルに書き込まれます。 単一ファイルに書き込まれたすべてのIPアドレスは fping によって並列にチェックされるため、ZabbixのICMP pingerプロセスは、ファイル内のIPアドレス数に関係なく一定時間を消費します。