[comment]: # attributes: notoc [comment]: # translation:outdated [comment]: # ({be4ab03d-be4ab03d}) # 5 シンプルチェック [comment]: # ({/be4ab03d-be4ab03d}) [comment]: # ({4488e3c2-76023448}) #### 概要 シンプルチェックは、通常、リモートエージェントを使用しないサービスをチェックするために使用します。 なお、シンプルチェックでは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] ::: noteclassic シンプルチェック項目の*User name*および*Password*フィールドはVMwareの監視項目に使用され、それ以外は無視されます。 ::: [comment]: # ({/4488e3c2-76023448}) [comment]: # ({9aaf2d21-f59a5ccc}) ### サポートされているチェック 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](/manual/vm_monitoring/vmware_keys) |アイテムキー|説明| |--|--------| |[icmpping](#icmpping)|ICMP ping によるホストのアクセス。| |[icmppingloss](#icmppingloss)|パケットロスの割合| |[icmppingsec](#icmppingsec)|ICMP ping の応答時間。| |[net.tcp.service](#nettcpservice)|サービスが実行中であり、TCP接続を受け入れているかどうかを確認します。| |[net.tcp.service.perf](#nettcpserviceperf)|TCPサービスのパフォーマンスチェック。| |[net.udp.service](#netudpservice)|サービスが実行中であり、UDPリクエストに応答しているかどうかを確認します。| |[net.udp.service.perf](#netudpserviceperf)|UDPサービスのパフォーマンスチェック| [comment]: # ({/9aaf2d21-f59a5ccc}) [comment]: # ({b1bc108a-23d7246f}) ### 項目キーの詳細 山括弧のないパラメータは必須です。山括弧 **<** **>** でマークされたパラメータはオプションです。 [comment]: # ({/b1bc108a-23d7246f}) [comment]: # ({52d234e4-7d8dff2e}) ##### icmpping\[,,,,,\] {#icmpping}
ICMP pingによるホストのアクセシビリティ
戻り値: *0* - ICMP ping失敗; *1* - ICMP ping成功 パラメータ: - **target** - ホストIPまたはDNS名 - **packets** - パケット数 - **interval** - パケット間隔（ミリ秒） - **size** - パケットサイズ（バイト） - **timeout** - タイムアウト（ミリ秒） - **options** - リダイレクトの許可に使用します。空（デフォルト値）の場合、リダイレクトされた応答はターゲットホストがダウンしているものとして扱われます。*allow_redirect*に設定すると、リダイレクトされた応答はターゲットホストが稼働しているものとして扱われます。 [デフォルト値](#default-values)の表も参照してください。 例: icmpping[,4] #4つのパケットのうち少なくとも1つが返された場合、項目は1を返します。 [comment]: # ({/52d234e4-7d8dff2e}) [comment]: # ({1976ee61-6cd0f1b1}) ##### icmppingloss\[,,,,,\] {#icmppingloss}
パケットロスの割合
戻り値: *Float* パラメータ: - **target** - ホストのIPアドレスまたはDNS名 - **packets** - パケット数 - **interval** - パケット間隔（ミリ秒） - **size** - パケットサイズ（バイト） - **timeout** - タイムアウト（ミリ秒） - **options** - リダイレクトの許可に使用します。空（デフォルト値）の場合、リダイレクトされた応答はターゲットホストがダウンしているものとして扱われます。*allow_redirect* に設定されている場合、リダイレクトされた応答はターゲットホストが稼働しているものとして扱われます。 [デフォルト値](#default-values)の表も参照してください。 [comment]: # ({/1976ee61-6cd0f1b1}) [comment]: # ({5c6701a7-b5636838}) ##### icmppingsec\[,,,,,,\] {#icmppingsec}
ICMP pingの応答時間（秒）
戻り値: *Float* パラメータ: - **target** - ホストのIPアドレスまたはDNS名 - **packets** - パケット数 - **interval** - パケット間隔（ミリ秒） - **size** - パケットサイズ（バイト） - **timeout** - タイムアウト（ミリ秒） - **mode** - 可能な値: *min*、*max*、または *avg*（デフォルト） - **options** - リダイレクトを許可するために使用します。空の場合（デフォルト値）、リダイレクトされた応答はターゲットホストがダウンしているものとして扱われます。 *allow_redirect* に設定されている場合、リダイレクトされた応答はターゲットホストが稼働中として扱われます。 コメント: - 損失またはタイムアウトしたパケットは計算に使用されません。 - ホストが利用できない場合（タイムアウトに達した場合）、この項目は 0 を返します。 - 戻り値が 0.0001 秒未満の場合、値は 0.0001 秒に設定されます。 - [デフォルト値](#default-values) の表も参照してください。 [comment]: # ({/5c6701a7-b5636838}) [comment]: # ({878d3b27-b0a71170}) ##### net.tcp.service[service,,] {#nettcpservice}
サービスが実行中で、TCP接続を受け付けているかどうかを確認します。
戻り値: *0* - サービスは停止しています。*1* - サービスは実行中です。 パラメーター: - **service** - 指定可能な値: *ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https*、*telnet* ([詳細](/manual/appendix/items/service_check_details) を参照)。 - **ip** - IPアドレスまたはDNS名 (デフォルトではホストIP/DNSが使用されます) - **port** - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます) コメント: - *tcp* service の場合、ポート番号は必須です。 - これらのチェックにより、システムデーモンのログファイルに追加メッセージが記録される可能性があります（通常、SMTP および SSH セッションはログに記録されます） - 暗号化プロトコル（ポート 993 の IMAP やポート 995 の POP など）のチェックは現在サポートされていません。回避策として、これらのチェックには `net.tcp.service[tcp,,port]` を使用してください。 例: net.tcp.service[ftp,,45] # この項目は、TCP ポート 45 上の FTP サーバーの可用性をテストするために使用できます。 ::: 重要 SELinux が強制モードで実行されている場合、カスタム TCP/UDP 簡易チェックがポリシーによってブロックされる可能性があります。新しい送信接続を確認して許可するには、`grep denied /var/log/audit/audit.log`` で監査拒否を確認してください。 ::: [comment]: # ({/878d3b27-b0a71170}) [comment]: # ({39da67f1-946385b4}) ##### net.tcp.service.perf[service,,] {#nettcpserviceperf}
TCP サービスのパフォーマンスをチェックします。
戻り値: *Float*: *0.000000* - サービスはダウンしています。 *seconds* - サービスへの接続にかかった秒数 パラメーター: - **service** - 可能な値: *ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https*、*telnet* ([詳細](/manual/appendix/items/service_check_details) を参照) - **ip** - IP アドレスまたは DNS 名 (デフォルトではホスト IP/DNS が使用されます) - **port** - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます) コメント: - *tcp* サービスを使用する場合、ポートの指定は必須です。 - 暗号化プロトコル（ポート993のIMAPやポート995のPOPなど）のチェックは現在サポートされていません。回避策として、これらのチェックには `net.tcp.service[tcp,,port]` を使用してください。 例: net.tcp.service.perf[ssh] # この項目は、SSHサーバーからの初期応答速度をテストするために使用できます。 [comment]: # ({/39da67f1-946385b4}) [comment]: # ({5cba2094-2859223a}) ##### net.udp.service[service,,] {#netudpservice}
サービスが実行中で、UDP 要求に応答しているかどうかを確認します。
戻り値: *0* - サービスが停止しています。 *1* - サービスは実行中です。 パラメーター: - **service** - 指定可能な値: *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照) - **ip** - IP アドレスまたは DNS 名 (デフォルトではホスト IP/DNS が使用されます) - **port** - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます) 例: net.udp.service[ntp,,45] #この項目は、UDP ポート 45 での NTP サービスの可用性をテストするために使用できます。 [comment]: # ({/5cba2094-2859223a}) [comment]: # ({bae0ccf0-9cf5922c}) ##### net.udp.service.perf[service,,] {#netudpserviceperf}
UDPサービスのパフォーマンスをチェックします。
戻り値: *Float*: *0.000000* - サービスがダウンしています。 *seconds* - サービスからの応答を待機した秒数。 パラメーター: - **service** - 可能な値: *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照) - **ip** - IPアドレスまたはDNS名 (デフォルトではホストIP/DNSが使用されます) - **port** - ポート番号 (デフォルトでは標準のサービスポート番号が使用されます) 例: net.udp.service.perf[ntp] #この項目は、NTPサービスからの応答時間をテストするために使用できます。 [comment]: # ({/bae0ccf0-9cf5922c}) [comment]: # ({621c13d4-85612a2b}) ::: 重要 LDAP シンプルチェック（例: `net.tcp.service[ldap]`）での SourceIP サポートには、OpenLDAP バージョン 2.6.1 以降が必要です。 ::: [comment]: # ({/621c13d4-85612a2b}) [comment]: # ({62c84a87-92a6c4ae}) ##### タイムアウト処理 Zabbixは、Zabbix server / proxy 設定ファイルに定義されたタイムアウト秒数以上のシンプルチェックは処理しません。 [comment]: # ({/62c84a87-92a6c4ae}) [comment]: # ({30611a67-b08a4508}) #### ICMP ping ZabbixはICMP pingの処理に外部ユーティリティ**fping**を使用しています。 このユーティリティはZabbixの配布物には含まれていないため、追加でインストールする必要があります。
ユーティリティがない場合、パーミッションが正しくない場合、またはユーティリティの場所が
Zabbix server / proxy 設定ファイル('FpingLocation'パラメータ)で設定した場所と一致しない場合、 ICMP Ping(**icmpping**, **icmppingloss**, **icmppingsec**) は処理されません。 [known issues](/manual/installation/known_issues#simple_checks) もあわせて参照してください。 **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チェックパラメータのデフォルト値、制限値の説明: |パラメータ|単位|説明|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](/manual/concepts/server#server_process_types) プロセスが個別に行います。 自動検出された fping オプションは、1時間ごとに無効化され、次回のICMP検査時に再度検出されます。
このプロセスの詳細を表示するには、DebugLevel>=4 に設定します。
server または proxy のログファイルにこのプロセスの詳細が表示されます。
::: notewarning 警告: fping のデフォルトは、プラットフォームとバージョンによって異なる場合があります。
fping のドキュメントを確認してください。 ::: Zabbixは、3つの**icmpping**キーでチェックするIPアドレスを一時ファイルに書き込み、
このファイルを**fping**に渡します。item キーパラメータが異なる項目は、キーパラメータが同一のもの
のみ1つのファイルに書き込まれます。
1つのファイルに書き込まれた全てのIPアドレスを並列にfpingでチェックするため、Zabbixのicmpピンガープロセスは
ファイル内のIPアドレスの数に関係なく、一定の時間を費やします。
[comment]: # ({/30611a67-b08a4508}) [comment]: # ({d8eb34a5-e3dd9826}) ##### インストール fping は Zabbix に含まれていないため、別途インストールする必要があります。 - さまざまな Unix ベースプラットフォームでは、デフォルトのリポジトリに fping パッケージが含まれていますが、プリインストールされていません。その場合は、パッケージマネージャーを使用して fping をインストールできます。 - Zabbix は、RHEL およびその派生 OS 向けに [fping パッケージ](https://repo.zabbix.com/third-party/2024-10/) を提供しています。これらのパッケージは公式サポートなしで提供されることにご注意ください。 - fping は [ソースから](https://github.com/schweikert/fping/blob/develop/README.md#installation) コンパイルすることもできます。 [comment]: # ({/d8eb34a5-e3dd9826}) [comment]: # ({b2c27900-9ced6345}) ##### 設定 Zabbixサーバー/プロキシ設定ファイルの*[FpingLocation](/manual/appendix/config/zabbix_server#fpinglocation)*パラメータでfpingの実行場所を指定します。 (IPv6アドレスを使用する場合は*[Fping6Location](/manual/appendix/config/zabbix_server#fping6location)*パラメータを使用します。) fpingは、Zabbixサーバー/プロキシを実行するユーザーが実行可能であり、十分な権限を持っている必要があります。 fpingバージョン3.10未満での簡易チェックの処理については、[既知の問題](/manual/installation/known_issues#simple_checks)も参照してください。 [comment]: # ({/b2c27900-9ced6345}) [comment]: # ({b0275ef4-3c21487d}) ##### デフォルト値 ICMPチェックパラメータのデフォルト値、制限値、および値の説明: |パラメータ|単位|説明|fpingのフラグ|デフォルト値の設定|<|Zabbixによる許容制限
|<| |--|--|--------|-|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |packets|number|ターゲットに送信するリクエストパケット数|-C||3|1|10000| |interval|milliseconds|個々のターゲットへの連続するパケット間の待機時間|-p|1000||20|unlimited| |size|バイト|パケットサイズ（バイト単位）
x86 では 56 バイト、x86_64 では 68 バイト|-b|56 または 68||24|65507| |timeout|ミリ秒|**fping v3.x** - 最後のパケット送信後のタイムアウト。*-C* フラグの影響を受けます。
**fping v4.x** - 各パケットのタイムアウトは個別に設定されます。|-t|**fping v3.x** - 500
**fping v4.x** 以降 - *-p* フラグから継承されますが、2000 を超えることはできません。||50|無制限| デフォルトは、プラットフォームとバージョンによって若干異なる場合があります。 さらに、Zabbixはfpingオプション *-i interval ms* （上記の表に記載されている、fpingオプション *-p* に対応する項目パラメータ *interval* と混同しないでください）と *-S source IP address* （または、以前のバージョンのfpingでは *-I* ）を使用します。 これらのオプションは、異なるオプションの組み合わせでチェックを実行することで自動検出されます。 Zabbixは、0、1、10の3つの値を試して、fpingが *-i* で使用できる最小のミリ秒値を検出しようとします。 最初に成功した値が、その後のICMPチェックに使用されます。 このプロセスは、各[ICMP pinger](/manual/concepts/server#server_process_types_and_threads)プロセスによって個別に実行されます。 自動検出されたfpingオプションは1時間ごとに無効化され、次回のICMPチェック実行時に再検出されます。 このプロセスの詳細をサーバーまたはプロキシのログファイルで表示するには、[DebugLevel](/manual/appendix/config/zabbix_server#debuglevel) を 4 以上に設定してください。 Zabbix は、3 つの *icmpping\** キーのいずれかでチェックされる IP アドレスを一時ファイルに書き込み、それを fping に渡します。 項目に異なるキーパラメータがある場合は、キーパラメータが同一の項目のみが 1 つのファイルに書き込まれます。 1 つのファイルに書き込まれたすべての IP アドレスは fping によって並行してチェックされるため、Zabbix ICMP ping プロセスは、ファイル内の IP アドレスの数に関係なく、一定の時間だけ実行します。 [comment]: # ({/b0275ef4-3c21487d})