2 シンプルチェック

概要

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

シンプルチェックには Zabbix エージェントは不要です。シンプルチェックの処理（外部接続の実行など）は Zabbix サーバー/プロキシが担当します。

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

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

サポートされるチェック

アイテムキーは、オプションのパラメーターと追加情報を省略して記載しています。アイテムキーをクリックすると、詳細を確認できます。

VMware監視のアイテムキーも参照してください。

アイテムキーの詳細

山括弧のないパラメーターは必須です。山括弧 < > で示されたパラメーターは任意です。

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 を設定した場合、リダイレクトされた応答はターゲットホストが稼働しているとみなされる

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

icmppingretry[<target>,<retries>,<backoff>,<size>,<timeout>,<options>]

ICMP pingによるホストの到達性をリトライ付きでチェックします。最初のパケットが成功した場合は停止し、パケットが失敗した場合はretriesパラメータで定義された最大試行回数までリトライします。このアイテムは、ネットワーク上で送信されるパケット数を減らすのに役立ちます。
戻り値: 0 - ICMP ping失敗; 1 - ICMP ping成功。

パラメータ:

• target - ホストのIPまたはDNS名
• retries - ターゲットへのpingを試行する回数(最初の試行は含まない、0以上; デフォルト1)
• backoff - 各リクエストごとに待機時間を乗算する数値(1.0-5.0の範囲; デフォルト1.0)
• 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サービスの場合、ポートの指定は必須です;
• これらのチェックは、システムデーモンのログファイルに追加のメッセージを生成する場合があります (通常、SMTPやSSHセッションが記録されます);
• 暗号化プロトコル (ポート993のIMAPやポート995のPOPなど) のチェックは現在サポートされていません。回避策として、このようなチェックには net.tcp.service[tcp,<ip>,port] を使用してください。

例:

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

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

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

パラメータ:

• 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 - サービスがダウンしている; 秒 - サービスからの応答を待った秒数。

パラメータ:

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

例:

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

タイムアウト処理

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

ICMP ping

Zabbix は、ICMP ping（icmpping、icmppingloss、icmppingretry、icmppingsec）を処理するために、外部ユーティリティ fping を使用します。

インストール

fpingはZabbixには含まれておらず、別途インストールする必要があります。

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

• ZabbixはRHELおよびその派生ディストリビューション向けにfpingパッケージを提供しています。これらのパッケージは公式サポートなしで提供されていることにご注意ください。

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

設定

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

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

参照: fping バージョン 3.10 未満でシンプルチェックを処理する場合は、既知の問題 も参照してください。

デフォルト値

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