5 シンプルチェック

概要

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

シンプルチェックには 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 に設定した場合、リダイレクトされた応答はターゲットホストが稼働しているものとして扱われます。

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

例:

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 - サービスが停止しています。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サービスからの応答時間をテストするために使用できます。

タイムアウト処理

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アドレス数に関係なく一定の時間で処理を行います。