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 - サービスがダウンしている; 秒 - サービスへの接続にかかった秒数。

パラメータ:

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

タイムアウト処理

柔軟なアイテムタイムアウトは、シンプルチェックでもサポートされていますが、icmpping*およびVMwareアイテムには適用されません。柔軟なタイムアウトサポートを参照してください。

ICMP ping

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

インストール

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

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

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

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

設定

Zabbixサーバー/プロキシの設定ファイルのFpingLocationパラメータでfpingの場所を指定します (または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アドレス数に関係なく一定時間で処理を完了します。