[comment]: # translation:outdated
[comment]: # ({22d75789-22d75789})
# 1 Zabbix エージェント
[comment]: # ({/22d75789-22d75789})
[comment]: # ({46b00e5b-46b00e5b})
#### 概要
これらのチェックは、Zabbix agent との通信を利用してデータを収集します。
agent チェックには[passive and active](/manual/appendix/items/activepassive) （パッシブとアクティブ）の2種類あります。
アイテムの設定時に、必要なタイプを選択することができます。
- *Zabbix agent* - パッシブチェック用
- *Zabbix agent(active)* -アクティブチェック用
[comment]: # ({/46b00e5b-46b00e5b})
[comment]: # ({ab69441b-ab69441b})
#### サポートされているアイテムキー
この表は、Zabbix agentアイテムに使用できるアイテムキーの詳細を示します。
こちらもご参照ください。
- [プラットフォームがサポートするアイテム](/manual/appendix/items/supported_by_platform)
- [Zabbix エージェント 2 でサポートされているアイテムキー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)
- [Windows エージェント固有のアイテムキー](/manual/config/items/itemtypes/zabbix_agent/win_keys)
- [Windows エージェント アイテムの最小アクセス許可レベル](/manual/appendix/items/win_permissions)
[comment]: # ({/ab69441b-ab69441b})
[comment]: # ({801c55c5-6ef16440})
**必須パラメータとオプションパラメータ**
角括弧のないパラメータは必須です。**<** **>** でマークされたパラメータはオプションです。
**コマンドラインユーティリティでの使用方法**
コマンドラインから zabbix_agentd または zabbix_get を使用してアイテムキーをテストまたは使用する場合、シェルの構文も考慮する必要があります。
例えば、キーの特定のパラメータを二重引用符(")で囲む必要がある場合、二重引用符を明示的にエスケープする必要があります。
明示的にエスケープしないと、シェルによって二重引用符が特殊文字としてトリミングされ、Zabbixユーティリティに渡されません。
例:
$ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
$ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
[comment]: # ({/801c55c5-6ef16440})
[comment]: # ({d48fdbc9-531dbc08})
##### カーネルデータ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**kernel.maxfiles**|<|<|<|
|OS がサポートするオープン ファイルの最大数|Integer| | |
|**kernel.maxproc**|<|<|<|
|OS がサポートするプロセスの最大数|Integer| | |
|**kernel.openfiles**|<|<|<|
|現在開いているファイル記述子の数|Integer| |このアイテムは Zabbix 6.0 以降でサポートされています|
[comment]: # ({/d48fdbc9-531dbc08})
[comment]: # ({0633995a-597a0b85})
##### ログデータ
[ログ監視](log_items)に関する追加情報も参照してください。
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**log**\[file,\,\,\,\,\,\,\,\\]|<|<|<|
|ログファイル監視|Log|**file** - ログファイルのフルパスとファイル名
**regexp** - [正規表現](/manual/regular_expressions#overview)に必要なパターンを記述
**encoding** - コードページ[識別子](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)
**maxlines** - エージェントが Zabbix サーバーまたはプロキシに送信する 1 秒あたりの最大改行数。 このパラメータは[zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)の'MaxLinesPerSecond'の値を上書きします。
**mode** (バージョン 2.0 以降) - 使用可能な値:
*all* (デフォルト), *skip* - 古いデータの処理をスキップします (新しく作成されたアイテムのみに影響します)
**output** (バージョン 2.2 以降) - オプションの出力フォーマット テンプレート。 **\\0** エスケープ シーケンスは、テキストの一致した部分 (一致が始まる最初の文字から一致が終了する文字まで) に置き換えられますが、**\\N** (N=1... 9) エスケープ シーケンスは、N 番目に一致したグループ (または N がキャプチャされたグループの数を超える場合は空の文字列) に置き換えられます。
**maxdelay** (バージョン 3.2 以降) - 秒単位の最大遅延。 タイプ：浮動小数点。 値: 0 - (デフォルト) ログ ファイルの行を無視しません。 > 0.0 - "maxdelay"秒以内に分析された最新の行を取得するために古い行を無視します。 使用する前に [maxdelay](log_items#using_maxdelay_parameter) の注意事項を確認してください!
**options** (バージョン 4.4.7以降) - 追加オプション:
*mtime-noreread* - 一意でないレコード。ファイル サイズが変更された場合にのみ再読み込みされます (更新時間の変更は無視されます)。 (このパラメーターは 5.0.2 以降では非推奨です。現在は mtime が無視されるためです。)
**persistent\_dir** (バージョン 5.0.18、5.4.9 以降、Unix システムの zabbix\_agentd のみ。Agent2 ではサポートされていません) - 永続ファイルを保存するディレクトリの絶対パス名。 [永続ファイル](log_items#notes-on-persistent-files-for-log-items)に関する追加の注意事項も参照してください。|項目は [アクティブ チェック](/manual/appendix/items/activepassive#active_checks)として設定する必要があります。
ファイルが見つからないか、アクセス許可が許可されていない場合、アイテムはサポートされなくなります。
`output` が空のままの場合 - 一致したテキストを含む行全体が返されます。'Result is TRUE'を除くすべてのグローバル正規表現タイプは、常に一致した行全体を返し、`output` パラメータは無視されることに注意してください。
`output` パラメータを使用したコンテンツの抽出は、エージェントで行われます。
例:
=> log\[/var/log/syslog\]
=> log\[/var/log/syslog,error\]
=> log\[/home/zabbix/logs/logfile,,,100\]
*ログ レコードから数値を抽出するための`output`パラメータの使用:*
=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → ログ レコード"2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors"に一致し、'6080'のみをサーバーに送信します。 数値を送信するため、この項目の"情報の種類"を"数値（符号なし）"に設定し、その値をグラフやトリガーなどで利用することができます。
*サーバーに送信する前にログ レコードを書き換えるための `output` パラメータの使用:*
=> log\[/app1/app.log,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → ログ レコード"2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors"に一致し、そこから変更されたレコード"2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08"をサーバーに送信します。 |
|**log.count**\[file,\,\,\,\,\,\,\\]|<|<|<|
|監視対象のログ ファイルで一致した行の数|Integer|**file** - ログファイルのフルパスとファイル名
**regexp** - [正規表現](/manual/regular_expressions#overview)に必要なパターンを記述
**encoding** - コードページ[識別子](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)
**maxproclines** - エージェントが分析する 1 秒あたりの新しい行の最大数 (10000 を超えることはできません)。 [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)のデフォルト値は10\*'MaxLinesPerSecond' です。
**mode** - 使用可能な値:
*all* (デフォルト), *skip* - 古いデータの処理をスキップします (新しく作成されたアイテムのみに影響します)
**maxdelay** - 秒単位の最大遅延。 タイプ:浮動小数点 値: 0 - (デフォルト) ログ ファイルの行を無視しません。 > 0.0 - "maxdelay"秒以内に分析された最新の行を取得するために、古い行を無視します。 使用する前に[maxdelay](log_items#using_maxdelay_parameter) の注意事項をお読みください!
**options** (バージョン 4.4.7 以降) - 追加オプション:
*mtime-noreread* - 一意でないレコード。ファイル サイズが変更された場合にのみ再読み込みされます (更新時間の変更は無視されます)。(このパラメーターは 5.0.2 以降では非推奨です。現在は mtime が無視されるためです。)
**persistent\_dir** (バージョン 5.0.18、5.4.9 以降、Unix システムの zabbix\_agentd のみ。Agent2 ではサポートされていません) - 永続ファイルを保存するディレクトリの絶対パス名。 [永続ファイル](log_items#notes-on-persistent-files-for-log-items) に関する追加の注意事項も参照してください。|項目は [アクティブ チェック](/manual/appendix/items/activepassive#active_checks)として設定する必要があります
一致する行は、エージェントによる最後のログ チェック以降の新しい行でカウントされるため、アイテムの更新間隔に依存します。
ファイルが見つからないか、アクセスが許可されていない場合、アイテムはサポートされなくなります。
この項目は、Windows イベント ログではサポートされていません。
Zabbix 3.2.0 以降でサポートされています。|
|**logrt**\[file\_regexp,\,\,\,\,\,\,\,\\]|<|<|<|
|ローテーションされるログファイルの監視|Log|**file\_regexp** - ファイルの絶対パスと[正規表現](/manual/regular_expressions#overview)で記述したファイル名。 *注* ファイル名だけが正規表現であること。
**regexp** - [正規表現](/manual/regular_expressions#overview)に必要なパターンを記述
**encoding** - コードページ[識別子](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)
**maxlines** - エージェントが Zabbix サーバーまたはプロキシに送信する 1 秒あたりの最大改行数。 このパラメータは、[zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)の'MaxLinesPerSecond'の値を上書きします。
**mode** (バージョン 2.0 以降) - 使用可能な値:
*all* (デフォルト), *skip* - 古いデータの処理をスキップします (新しく作成されたアイテムのみに影響します)
**output** (バージョン 2.2 以降) - オプションの出力フォーマット テンプレート。 **\\0** エスケープ シーケンスは、テキストの一致した部分 (一致が始まる最初の文字から一致が終了する文字まで) に置き換えられますが、**\\N** (N=1... 9) エスケープ シーケンスは、N 番目に一致したグループ (または N がキャプチャされたグループの数を超える場合は空の文字列) に置き換えられます。
**maxdelay** (バージョン 3.2 以降) - 秒単位の最大遅延。 タイプ:浮動小数点。 値: 0 - (デフォルト) ログ ファイルの行を無視しません。 > 0.0 - "maxdelay"秒以内に分析された最新の行を取得するために、古い行を無視します。 使用する前に [maxdelay](log_items#using_maxdelay_parameter) の注意事項をお読みください!
**options** (バージョン 4.0 以降。*mtime-reread*, *mtime-noreread* オプション 4.4.7 以降) - ログ ファイルのローテーションの種類とその他のオプション。使用可能な値:
*rotate* (デフォルト),
*copytruncate* - *copytruncate* は *maxdelay* と一緒に使用できないことに注意してください。 この場合、*maxdelay* は 0 にするか指定しないでください。 [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation)メモを参照してください。
*mtime-reread* - 一意でないレコード、変更時間またはサイズが変更された場合に再読み込み (デフォルト),
*mtime-noreread* - 一意でないレコード。サイズが変更された場合にのみ再読み取りされます (更新時間の変更は無視されます)
**persistent\_dir** (バージョン 5.0.18、5.4.9 以降、Unix システムの zabbix\_agentd のみ。Agent2 ではサポートされていません) - 永続ファイルを保存するディレクトリの絶対パス名。 [永続ファイル](log_items#notes-on-persistent-files-for-log-items)に関する追加の注意事項も参照してください。|アイテムは [アクティブ チェック](/manual/appendix/items/activepassive#active_checks) として構成する必要があります。
ログ ローテーションは、ファイルの最終更新時刻に基づいています。
logrt は設計されていることに注意してください。 1 つの現在アクティブなログ ファイルを処理し、他のいくつかの一致する非アクティブなファイルをローテーションします。 たとえば、ディレクトリに多数のアクティブなログ ファイルがある場合は、各ログ ファイルに対して個別の logrt 項目を作成する必要があります。 そうしないと、1 つの logrt アイテムがあまりにも多くのファイルを取得すると、メモリが枯渇し、監視がクラッシュする可能性があります。
`output` が空のままの場合 - 一致したテキストを含む行全体が返されます。'Result is TRUE'を除くすべてのグローバル正規表現タイプは、常に一致した行全体を返し、`output` パラメータは無視されることに注意してください。
`output` パラメータを使用したコンテンツ抽出はエージェントで行われます。
例:
=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}$",,,100\] → "logfile1"のようなファイルに一致します(".logfile1"には一致しません)
=> logrt\["/home/user/\^logfile\_.\*\_\[0-9\]{1,3}$","pattern\_to\_match","UTF-8",100\] → "logfile\_abc\_1"や"logfile\_\_001"などのファイルからデータを収集します。
*ログ レコードから数値を抽出するための`output`パラメータの使用:*
=> logrt\[/app1/\^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → ログ レコード"2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors"に一致し、'6080'のみをサーバーに送信します。 数値を送信するため、この項目の"情報の種類"を"数値（符号なし）"に設定し、その値をグラフやトリガーなどで利用することができます。
*サーバーに送信する前にログ レコードを書き換えるための `output` パラメータの使用:*
=> logrt\[/app1/\^test.\*log$,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → ログ レコード"2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors"に一致し、変更されたレコード"2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08"をサーバーに送信します。|
|**logrt.count**\[file\_regexp,\,\,\,\,\,\,\\]|<|<|<|
|ローテーションされる監視対象ログ ファイル内の一致する行の数|Integer|**file\_regexp** - ファイルへの絶対パスと [正規表現](/manual/regular_expressions#overview) ファイル名のパターンを記述
**regexp** - [正規表現](/manual/regular_expressions#overview)に必要なパターンを記述
**encoding** - コードページ[識別子](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)
**maxproclines** - エージェントが分析する 1 秒あたりの新しい行の最大数 (10000 を超えることはできません)。 [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd) のデフォルト値は 10\*'MaxLinesPerSecond' です。
**mode** - 使用可能な値:
*all* (デフォルト), *skip* - 古いデータの処理をスキップします (新しく作成されたアイテムのみに影響します)
**maxdelay** - 秒単位の最大遅延。 タイプ：フロート。 値: 0 - (デフォルト) ログ ファイルの行を無視しません。 > 0.0 - 「maxdelay」秒以内に分析された最新の行を取得するために、古い行を無視します。 使用する前に [maxdelay](log_items#using_maxdelay_parameter) の注意事項をお読みください!
**options** (バージョン 4.0 以降; 4.4.7 以降の *mtime-reread*、*mtime-noreread* オプション) - ログ ファイルのローテーションのタイプとその他のオプション。使用可能な値:
*rotate* (デフォルト),
*copytruncate* - *copytruncate* は *maxdelay* と一緒に使用できないことに注意してください。 この場合、*maxdelay* は 0 にするか指定しないでください。 [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) メモを参照,
*mtime-reread* - 一意でないレコード、更新時刻またはサイズが変更された場合に再読み込み (デフォルト),
*mtime-noreread* - 一意でないレコード。サイズが変更された場合にのみ再読み取りされます (更新時間の変更は無視されます)
**persistent\_dir** (バージョン 5.0.18、5.4.9 以降、Unix システムの zabbix\_agentd のみ。Agent2 ではサポートされていません) - 永続ファイルを保存するディレクトリの絶対パス名。 [永続ファイル](log_items#notes-on-persistent-files-for-log-items)に関する追加の注意事項も参照してください。|項目は [アクティブ チェック](/manual/appendix/items/activepassive#active_checks)として設定する必要があります
一致する行は、エージェントによる最後のログ チェック以降の新しい行でカウントされるため、アイテムの更新間隔に依存します。
ログのローテーションは、ファイルの最終変更時刻に基づいています。
この項目は、Windows イベント ログではサポートされていません。
Zabbix 3.2.0 以降でサポートされています。|
[comment]: # ({/0633995a-597a0b85})
[comment]: # ({f51b20ca-06d13165})
##### Modbus データ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**modbus.get**\[endpoint,,,,,,,\]|<|<|<|
|Modbus データを読み取ります|JSON object|**endpoint** - `protocol://connection_string`として定義されたエンドポイント
**slave id** - スレーブID
**function** - Modbus 機能
**address** - 最初のレジストリ、コイル、または入力アドレス
**count** - 読み取るレコード数
**type** - データタイプ
**endianness** - エンディアンの設定
**offset** - 'address' から始まるレジスタの数。結果は破棄されます。
パラメータの[詳細説明](/manual/appendix/items/modbus)を参照してください。|Zabbix 5.2.0 以降でサポートされています。|
[comment]: # ({/f51b20ca-06d13165})
[comment]: # ({c3c0e137-8ffc49c1})
##### ネットワークデータ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**net.dns**\[,name,,,,\]|<|<|<|
|DNS サービスが稼働しているかどうかを確認します|0 - DNS がダウンしています (サーバーが応答しなかったか、DNSの解決に失敗しました)
1 - DNS がアップしています|**ip** - DNS サーバーの IP アドレス (デフォルトの DNS サーバーの場合は空のままにします。Windows では Zabbix エージェント 2 でサポートされています。Zabbix エージェントでは無視されます)
**name** - クエリする DNS 名
* *type** - クエリされるレコード タイプ (デフォルトは *SOA*)
**timeout** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - 秒単位のリクエストのタイムアウト ( デフォルトは 1 秒)
**count** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストの試行回数 (デフォルトは 2)
**プロトコル** (バージョン 3.0 以降) - DNS クエリの実行に使用されるプロトコル: *udp* (デフォルト) または *tcp*|例:
=> net.dns\[8.8.8.8,example.com,MX,2,1\]
`type` の可能な値は次のとおりです。
*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA* 、*NULL*、*WKS* (Windows の Zabbix エージェント、すべての OS の Zabbix エージェント 2 ではサポートされていません)、*HINFO*、*MINFO*、*TXT*、*AAAA*、*SRV*
国際化されたドメイン名はサポートされていません。代わりに IDNA でエンコードされた名前を使用してください。
SRV レコード タイプは、Zabbix 1.8.6 (Unix) および 2.0.0 (Windows) 以降でサポートされています。
Zabbix 2.0以前の命名 (引き続きサポートされています): *net.tcp.dns*|
|**net.dns.record**\[,name,,,,\]|<|<|<|
|DNS クエリを実行します|必要な種類の情報を含む文字列|**ip** - DNS サーバーの IP アドレス (デフォルトの DNS サーバーの場合は空のままにします。Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます)
**name** - クエリする DNS 名< br>**type** - クエリするレコード タイプ (デフォルトは *SOA*)
**timeout** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストのタイムアウト 秒単位 (デフォルトは 1 秒)
**count** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストの試行回数 (デフォルトは 2)
** protocol** (バージョン 3.0 以降) - DNS クエリの実行に使用されるプロトコル: *udp* (デフォルト) または *tcp*|例:
=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]
`type` の可能な値は次のとおりです:
*ANY* , *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, * WKS* (Windows の Zabbix エージェント、すべての OS の Zabbix エージェント 2 ではサポートされていません)、*HINFO*、*MINFO*、*TXT*、*AAAA*、*SRV*
国際化されたドメイン名はサポートされていません 代わりに IDNA でエンコードされた名前を使用してください。
SRV レコード タイプは、Zabbix 1.8.6 (Unix) および 2.0.0 (Windows) 以降でサポートされています。
Zabbix 2.0 より前の命名 (引き続きサポートされています): *net.tcp.dns.クエリ*|
|**net.if.collisions**\[if\]|<|<|<|
|ウィンドウ外コリジョン数|Integer|**if** - ネットワーク インターフェース名| |
|**net.if.discovery**|<|<|<|
|ネットワーク インターフェイスのリスト。 ローレベルディスカバリに使用されます。|JSON オブジェクト| |Zabbix 2.0 以降でサポートされています。
FreeBSD、OpenBSD、NetBSDはZabbix 2.2以降で対応。
一部の Windows バージョン (Server 2008 など) では、インターフェース名で非 ASCII 文字をサポートするために、最新の更新プログラムをインストールする必要がある場合があります。|
|**net.if.in**\[if,\]|<|<|<|
|ネットワーク インターフェースの受信トラフィック統計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)
**mode** - 使用可能な値:
*bytes* - バイト数 (デフォルト)
*packets* - パケット数
*errors* - エラーの数
*dropped* - ドロップされたパケットの数
*overruns (fifo)* - FIFO バッファ エラーの数
*frame* - パケット フレーミング エラーの数
*compressed* - デバイス ドライバーによって送信または受信された圧縮パケットの数
*multicast* - デバイス ドライバーによって受信されたマルチキャスト フレームの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。
Zabbix 1.8.6 以降、Windows でのマルチバイト インターフェース名がサポートされています。
例:
=> net.if.in\[eth0,errors\]
=> net.if.in\[eth0\]
net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェースの説明を取得できます。
このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。|
|**net.if.out**\[if,\]|<|<|<|
|ネットワーク インターフェースの発信トラフィック統計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)
**mode** - 使用可能な値:
*bytes* - バイト数 (デフォルト)
*packets* - パケット数
*errors* - エラーの数
*dropped* - ドロップされたパケットの数
*overruns (fifo)* - FIFO バッファ エラーの数
*collisions (colls)* - 検出された衝突の数 インターフェイス
*carrier* - デバイス ドライバによって検出されたキャリア損失の数
*compressed* - デバイス ドライバによって送信された圧縮パケットの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。
Zabbix エージェント 1.8.6 バージョン以降、Windows でのマルチバイト インターフェイス名がサポートされています。
例:
=> net.if.out\[eth0,errors\]
=> net.if.out\[eth0\]
net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェイスの説明を取得できます。
このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。|
|**net.if.total**\[if,\]|<|<|<|
|ネットワーク インターフェイスの着信および発信トラフィック統計の合計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)
**mode** - 使用可能な値:
*bytes* - バイト数 (デフォルト)
*packets* - パケット数
*errors* - エラーの数
*dropped* - ドロップされたパケットの数
*overruns (fifo)* - FIFO バッファ エラーの数
*compressed* - デバイス ドライバーによって送受信された圧縮パケットの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。
例:
=> net.if.total\[eth0,errors\]
=> net.if.total\[eth0\]
net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェイスの説明を取得できます。
このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。
ドロップされたパケットは、net.if.in と net.if.out の両方がプラットフォーム上でドロップされたパケットに対して機能する場合にのみサポートされることに注意してください。|
|**net.tcp.listen**\[port\]|<|<|<|
|この TCP ポートが LISTEN 状態かどうかを確認します|0 - LISTEN 状態ではありません
1 - LISTEN 状態です|**port** - TCP ポート番号|例:
=> net.tcp.listen\[80\]
Zabbix 1.8.4 以降でサポートされている Linux の場合
Zabbix 3.0.0 以降、Linux カーネル 2.6.14 以降では、TCP ソケットのリスニングに関する情報は、可能であればカーネルの NETLINK インターフェイスから取得されます。 それ以外の場合、情報は /proc/net/tcp および /proc/net/tcp6 ファイルから取得されます。|
|**net.tcp.port**\[,port\]|<|<|<|
|指定したポートに TCP 接続できるかどうかをチェックします|0 - 接続できません
1 - 接続できます|**ip** - IP または DNS 名 (デフォルトは 127.0.0.1)
* *ポート** - ポート番号|例:
=> net.tcp.port\[,80\] → ポート 80 で実行されている Web サーバーの可用性をテストするために使用できます。
単純な TCP パフォーマンス テストには、net.tcp.service.perf\[tcp,,\] を使用します。
これらのチェックにより、システム デーモンのログファイルに追加のメッセージが記録される場合があることに注意してください (通常、SMTP および SSH セッションがログに記録されます)|
|**net.tcp.service**\[service,,\]|<|<|<|
|サービスが実行中であり、TCP 接続を受け入れているかどうかを確認します。|0 - サービスがダウンしています
1 - サービスが実行されています|**service** - 次のいずれか:
*ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https *, *telnet* ([詳細](/manual/appendix/items/service_check_details) を参照)
**ip** - IP アドレス (デフォルトは 127.0.0.1)
**port** - ポート番号 (デフォルトでは、標準のサービス ポート番号が使用されます)|例:
=> net.tcp.service\[ftp,,45\] → TCP ポート 45 で FTP サーバーの可用性をテストするために使用できます。
これらのチェックにより、システム デーモンのログファイルに追加のメッセージが記録される場合があることに注意してください (通常、SMTP および SSH セッションがログに記録されます)。
暗号化されたプロトコル (ポート 993 の IMAP やポート 995 の POP など) のチェックは現在サポートされていません。 回避策として、このようなチェックには net.tcp.port を使用してください。
Windows での LDAP と HTTPS のチェックは、Zabbix エージェント 2 でのみサポートされています。
telnet チェックでは、ログイン プロンプト (末尾の「:」) が検索されることに注意してください。
HTTPS サービスの確認については、[既知の問題](/manual/installation/known_issues#https_checks)も参照してください。
*https* および *telnet* サービスは、Zabbix 2.0 以降でサポートされています。|
|**net.tcp.service.perf**\[service,,\]|<|<|<|
|TCP サービスのパフォーマンスをチェックします。|0 - サービスがダウンしています
seconds - サービスへの接続にかかった秒数|**サービス** - 次のいずれか:
*ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https*, *telnet* ([詳細](/manual/appendix/items/service_check_details) を参照)
**ip** - IP アドレス (デフォルトは 127.0.0.1)
**port** - ポート番号 (デフォルトでは、標準のサービス ポート番号が使用されます)|例:
=> net.tcp.service.perf\[ssh\] → SSH サーバーからの初期応答速度をテストするために使用できます。
暗号化されたプロトコル (ポート 993 の IMAP やポート 995 の POP など) のチェックは現在サポートされていません。 回避策として、このようなチェックには net.tcp.service.perf\[tcp,,\] を使用してください。
Windows での LDAP と HTTPS のチェックは、Zabbix エージェント 2 でのみサポートされています。
telnet チェックでは、ログイン プロンプト (末尾の「:」) が検索されることに注意してください。
HTTPS サービスの確認については、[既知の問題](/manual/installation/known_issues#https_checks)も参照してください。
*https* および *telnet* サービスは、Zabbix 2.0 以降でサポートされています。|
|**net.tcp.socket.count**\[,,,,\]|<|<|<|
|パラメータに一致する TCP ソケットの数を返します。|Integer|**laddr** - ローカル IPv4/6 アドレスまたは CIDR サブネット
**lport** - ローカル ポート番号またはサービス名
**raddr** - リモート IPv4/6 アドレスまたは CIDR サブネット
**rport** - リモート ポート番号またはサービス名
**state** - 接続状態(*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|この項目は、Zabbix エージェント/エージェント 2 の両方の Linux でのみサポートされています。Zabbix エージェント 2 では、64 ビット Windows でもサポートされています。
例:
=> net.tcp.socket.count\[,80,,,established\] → ローカル TCP ポート 80 が「確立」状態かどうかを確認する
この項目は Zabbix 6.0 以降でサポートされています。|
|**net.udp.listen**\[port\]|<|<|<|
|この UDP ポートが LISTEN 状態かどうかを確認します。|0 - LISTEN 状態ではありません
1 - LISTEN 状態です|**port** - UDP ポート番号|例:
=> net.udp.listen\[68\]
Zabbix 1.8.4 以降でサポートされている Linux の場合|
|**net.udp.service**\[service,,\]|<|<|<|
|サービスが実行中で、UDP 要求に応答しているかどうかを確認します。|0 - サービスがダウンしています
1 - サービスは実行中です|**サービス** - *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照)
**ip** - IP アドレス (デフォルトは 127.0.0.1)
**port** - ポート番号 (デフォルトでは標準サービスのポート番号が使用されます)|例：
=> net.udp.service\[ntp,,45\] → UDP ポート 45 で NTP サービスの可用性をテストするために使用できます。
このアイテムは Zabbix 3.0.0 以降でサポートされていますが、以前のバージョンでは net.tcp.service\[\] アイテムに対して *ntp* サービスが利用可能でした。|
|**net.udp.service.perf**\[service,,\]|<|<|<|
|UDP サービスのパフォーマンスをチェックします。|0 - サービスがダウンしています
seconds - サービスからの応答を待機するのに費やされた秒数|**service** - *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照)
**ip** - IP アドレス (デフォルトは 127.0.0.1)
**port** - ポート番号 (デフォルトでは標準サービスのポート番号が使用されます)|例:
=> net.udp.service.perf\[ntp\] → NTP サービスからの応答時間をテストするために使用できます。
このアイテムは Zabbix 3.0.0 以降でサポートされていますが、*ntp * サービスは以前のバージョンの net.tcp.service\[\] アイテムで利用できました。|
|**net.udp.socket.count**\[,,,,\]|<|<|<|
|パラメータに一致する TCP ソケットの数を返します|Integer|**laddr** - ローカル IPv4/6 アドレスまたは CIDR サブネット
**lport** - ローカル ポート番号またはサービス名
**raddr** - リモート IPv4/6 アドレスまたは CIDR サブネット
* *rport** - リモート ポート番号またはサービス名
**state** - 接続状態(*established*, *unconn*)|この項目は、Zabbix エージェント/エージェント 2 の両方の Linux でのみサポートされています。Zabbix エージェント 2 では、64 ビット Windows でもサポートされています。
例:
=> net.udp.socket.count\ [,,,,listening\] → UDP ソケットが"listening"状態にあるかどうかを確認します
この項目は Zabbix 6.0 以降でサポートされています。|
[comment]: # ({/c3c0e137-8ffc49c1})
[comment]: # ({af55fcc2-ab88c2ca})
##### プロセスデータ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**proc.cpu.util**\[,,,,,\]|<|<|<|
|プロセスの CPU 使用率|Float|**name** - プロセス名 (デフォルトは *すべてのプロセス*)
**user** - ユーザー名 (デフォルトは *すべてのユーザー*)
**type** - CPU 使用率のタイプ:
*total* (デフォルト), *user*, *system*
**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)
**mode** - データ収集モード: *avg1* (デフォルト), *avg5*, *avg15*
**zone** - ターゲットゾーン: *current* (デフォルト), *all*. このパラメータは、Solaris でのみサポートされています|例:
=> proc.cpu.util\[,root\] → "root"ユーザーの下で実行されているすべてのプロセスの CPU 使用率
=> proc.cpu.util\[zabbix\_server,zabbix\] → zabbix ユーザーの下で実行されているすべての zabbix\_server プロセスの CPU 使用率
返される値は、単一の CPU コアの使用率に基づいています。 たとえば、2 つのコアを完全に使用するプロセスの CPU 使用率は 200% です。
プロセスの CPU 使用率データは、最大 1024 個の一意の (名前、ユーザー、およびコマンド ラインによる) クエリをサポートするコレクターによって収集されます。 過去 24 時間にアクセスされなかったクエリは、コレクターから削除されます。
*注意* エージェントがゾーンをサポートしていない Solaris でコンパイルされているが、ゾーンがサポートされている新しい Solaris で実行されている場合、`zone` パラメータを *current* (またはデフォルト) に設定すると、エージェントは NOTSUPPORTED を返します。 (エージェントは結果を現在のゾーンのみに制限することはできません)。 ただし、この場合は *all* がサポートされます。
このキーは Zabbix 3.0.0 以降でサポートされており、複数のプラットフォームで利用できます ([プラットフォームでサポートされている項目](/manual/appendix/items/supported_by_platform)を参照))|
|**proc.mem**\[,,,,\]|<|<|<|
|プロセスが使用するメモリ (バイト単位)|Integer - `mode`が*max*, *min*, *sum*の時
Float - `mode`が*avg*の時|**name** - プロセス名(デフォルトは*すべてのプロセス*)
**user** - ユーザー名 (デフォルトは *すべてのユーザー*)
**mode** - 使用可能な値:
*avg*, *max*, *min*, *sum* (デフォルト)
**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)
**memtype** - [メモリの種類](/manual/appendix/items/proc_mem_notes)プロセスで使用|例:
=> proc.mem\[,root\] → "root"ユーザーの下で実行されているすべてのプロセスで使用されるメモリ
=> proc.mem\[zabbix\_server,zabbix\] → zabbix ユーザーの下で実行されているすべての zabbix\_server プロセスによって使用されるメモリ
=> proc.mem\[,oracle,max,oracleZABBIX\] → コマンドラインに oracleZABBIX が含まれているオラクルの下で実行されている、最もメモリを消費するプロセスによって使用されるメモリ
*注意*: 複数のプロセスが共有メモリを使用する場合、プロセスが使用するメモリの合計は、非現実的な大きな値になる可能性があります。
[注意事項](/manual/appendix/items/proc_mem_num_notes)を参照して`name` および `cmdline` パラメータ (Linux 固有) でプロセスを選択します。
このアイテムがコマンド ラインから呼び出され、コマンド ライン パラメーターが含まれている場合 (たとえばエージェント テスト モードで: `zabbix_agentd -t proc.mem[,,,apache2]`)、1 つ余分なプロセスが実行されているようにみえます。これはエージェントが自分自身をカウントするためです。
`memtype`パラメータは、Zabbix 3.0.0 以降のいくつかの [プラットフォーム](/manual/appendix/items/supported_by_platform)でサポートされています。|
|**proc.num**\[,,,,\]|<|<|<|
|プロセス数|Integer|**name** - プロセス名 (デフォルトは*すべてのプロセス*)
**user** - ユーザー名 (デフォルトは *すべてのユーザー*)
**state** (*disk* および *trace* オプションはバージョン 3.4.0 以降) - 使用可能な値:
*all* (デフォルト),
*disk* - 中断不能なsleep,
*run* - 実行中,
*sleep* - 中断可能なsleep,
*trace* - 停止,
*zomb* - ゾンビプロセス
**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)
**zone** - ターゲットゾーン: *current* (デフォルト), *all*. このパラメータはSolaris でのみサポートされています。|例:
=> proc.num\[,mysql\] → mysql ユーザーの下で実行されているプロセスの数
=> proc.num\[apache2,www-data\] → www-data ユーザーの下で実行されている apache2 プロセスの数
=> proc.num\[,oracle,sleep,oracleZABBIX\] → コマンド ラインに oracleZABBIX を含む Oracle で実行されているスリープ状態のプロセスの数
[注意事項](/manual/appendix/items/proc_mem_num_notes)を参照して`name` および `cmdline` パラメータ (Linux 固有) でプロセスを選択します。
Windows では、`name` および `user` パラメータのみがサポートされています。
このアイテムがコマンド ラインから呼び出され、コマンド ライン パラメーターが含まれている場合 (たとえばエージェント テスト モードで: `zabbix_agentd -t proc.mem[,,,apache2]`)、1 つ余分なプロセスが実行されているようにみえます。これはエージェントが自分自身をカウントするためです。
*注意* エージェントがゾーンをサポートしていない Solaris でコンパイルされているが、ゾーンがサポートされている新しい Solaris で実行されている場合、`zone` パラメータを *current* (またはデフォルト) に設定すると、エージェントは NOTSUPPORTED を返します。 (エージェントは結果を現在のゾーンのみに制限することはできません)。 ただし、この場合は *all* がサポートされます。|
[comment]: # ({/af55fcc2-ab88c2ca})
[comment]: # ({b778ea75-b9de65a2})
##### センサーデータ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**sensor**\[device,sensor,\]|<|<|<|
|ハードウェア センサー読取|Float|**device** - デバイス名
**sensor** - センサー名
**mode** - 使用可能な値:
*avg*, *max*, *min* (このパラメータを省略するとデバイスとセンサーで取得した値がそのまま扱われます)|Linux 2.4 では /proc/sys/dev/sensors を読み取ります。
例:
=> sensor\[w83781d-i2c-0-2d,temp1\]
Zabbix 1.8.4 より前では、*sensor\[temp1\]* 形式が使用されていました。|
|^|^|^|Linux 2.6 以降では /sys/class/hwmon を読み取ります。
Linux の [センサー](/manual/appendix/items/sensor) アイテムの詳細な説明を参照してください。|
|^|^|^|OpenBSD で *hw.sensors* MIB を読み取ります。
例:
=> sensor\[cpu0,temp0\] → 1 つの CPU の温度
=> sensor\["cpu\[0-2\]$",temp,avg\] → 最初の 3 つの CPU の平均温度
Zabbix 1.8.4 以降の OpenBSD でサポートされています。|
[comment]: # ({/b778ea75-b9de65a2})
[comment]: # ({f6548db3-3e2abe66})
##### システムデータ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**system.boottime**|<|<|<|
|システムの起動時間|Integer (Unix タイムスタンプ)| | |
|**system.cpu.discovery**|<|<|<|
|検出された CPU/CPU コアのリスト。ローレベルディスカバリに使用されます。|JSON オブジェクト| |2.4.0 以降のすべてのプラットフォームでサポートされています|
|**system.cpu.intr**|<|<|<|
|デバイスの割り込み|Integer| | |
|**system.cpu.load**\[,\]|<|<|<|
|[CPU 負荷](http://en.wikipedia.org/wiki/Load_(computing)).|Float|**cpu** - 使用可能な値:
*all* (デフォルト)、*percpu* (バージョン2.0以降; 総負荷をオンライン CPU 数で割ったもの)
**mode** - 使用可能な値:
*avg1* (1 分間の平均、デフォルト)、*avg5*、*avg15*|例:
=> system.cpu.load\[,avg5\].|
|**system.cpu.num**\[\]|<|<|<|
|CPU の数。|Integer|**type** - 使用可能な値:
*online* (デフォルト)、*max*|例:
=> system.cpu.num|
|**system.cpu.switches**|<|<|<|
|コンテキスト スイッチの数|Integer| | |
|**system.cpu.util**\[,,,\]|<|<|<|
|CPU 使用率|Float|**cpu** - ** または *all* (デフォルト)
**type** - 使用可能な値:
*user*(デフォルト)、*idle*、*nice*、*system* (Windows のデフォルト)、*iowait*、*interrupt*、*softirq* 、*steal*、*guest* (Linux カーネル 2.6.24 以降)、*guest\_nice* (Linux カーネル 2.6.33 以降)
このパラメータの詳細については、[プラットフォーム固有](/manual/appendix/items/supported_by_platform) も参照してください。
**モード** - 使用可能な値:
*avg1* (1 分間の平均、デフォルト)、*avg5*、*avg15*
**logical\_or\_physical** (バージョン 5.0.3 以降、AIX のみ) - 使用可能な値: *logical* (デフォルト)、*physical*。このパラメーターは AIX でのみサポートされます。|Windows では、値は *Processor Time* パフォーマンス カウンターを使用して取得されます。 Windows 8 以降、タスク マネージャーは *Processor Utility* パフォーマンス カウンターに基づいて CPU 使用率を表示しますが、以前のバージョンでは *Processor Time* カウンターでした。
例:
=> system.cpu.util\[0,user,avg5\]
旧名称: *system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX*|
|**system.hostname**\[, \]|<|<|<|
|システムのホスト名|String|**type** (Windows でのみサポートされるバージョン 5.4.7 より前) - 使用可能な値:*netbios* (Windows のデフォルト),*host* (Linux のデフォルト),*shorthost* (バージョン 5.4.7 以降; 最初のドットの前のホスト名の一部、ドットのない名前の完全な文字列を返します)
**transform** (バージョン 5.4.7 以降) - 使用可能な値:
*none* (デフォルト)、*lower* (小文字に変換)|この値は、Windows では GetComputerName() (**netbios** の場合) または gethostname() (**host** の場合) 関数によって取得され、他のシステムでは uname() システム API 出力から `nodename` を取得することによって取得されます。
戻り値の例:
*Linux* の場合:
=> system.hostname → linux-w7x1
=> system.hostname → example.com
=> system.hostname\[shorthost\] → 例
*Windows の場合*:
=> system.hostname → WIN-SERV2008-I6
=> system.hostname\[host\] → Win-Serv2008-I6LonG
=> system.hostname\[host,lower\] → win -serv2008-i6long
[より詳細な説明](/manual/appendix/install/windows_agent#configuration)も参照してください。|
|**system.hw.chassis**\[\]|<|<|<|
|シャーシ情報|String|**情報** - フル (デフォルト)、モデル、シリアル、タイプ、ベンダーのいずれか|例: system.hw.chassis\[full\]
Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop\]
このキーは、[SMBIOS](http://en.wikipedia.org/wiki/System_Management_BIOS) テーブルの可用性に依存します。
sysfs から DMI テーブルを読み込もうとします。sysfs アクセスが失敗した場合は、メモリから直接読み込もうとします。
sysfsやメモリから読み込んで値を取得するため、**rootパーミッション**が必要です。
Zabbix 2.0 以降でサポートされています。|
|**system.hw.cpu**\[,\]|<|<|<|
|CPU情報|String または integer|**cpu** - ** または *all* (デフォルト)
**info** - 使用可能な値:
*full* (デフォルト),*curfreq*, *maxfreq*, *model*, *vendor*|例:
=> system.hw.cpu\[0,vendor\] → AuthenticAMD
/proc/cpuinfo および /sys/devices/system/cpu/\[cpunum\]/cpufreq/cpuinfo\_max\_freq から情報を収集します。
CPU 番号と *curfreq の場合 * または *maxfreq* が指定されている場合は、数値 (Hz) が返されます。
Zabbix 2.0 以降でサポートされています|
|**system.hw.devices**\[\]|<|<|<|
|PCI または USB デバイスのリスト|Text|**type** (バージョン 2.0 以降) - *pci* (デフォルト) または *usb*|例:
=> system.hw.devices\[pci\] → 00:00.0 Host bridge: Advanced Micro Devices \[AMD\] RS780 Host Bridge
\[..\]
lspci または lsusb ユーティリティ (パラメータなしで実行) の出力を返します。|
|**system.hw.macaddr**\[,\]|<|<|<|
|MAC アドレスのリスト|String|**インターフェース** - *all* (デフォルト) または [正規表現](/manual/regular_expressions#overview)
**format** - *full* (デフォルト) または *short*|名前が指定された `interface` [正規表現](/manual/regular_expressions#overview) に一致するインターフェイスの MAC アドレスを一覧表示します (*all* すべてのインターフェイスのリスト)。
例:
=> system .hw.macaddr\["eth0$",full\] → \[eth0\] 00:11:22:33:44:55
format が *short* と指定されている場合、インターフェース名と同一の MAC アドレスはリストされません。
Zabbix 2.0 以降でサポートされています。|
|**system.localtime**\[\]|<|<|<|
|システム時刻|Integer - `type` を *utc* として使用
String - `type` を *local* として使用|**type** (バージョン 2.0 以降) - 使用可能な値:
*utc* - (デフォルト) エポック (00:00:00 UTC、1970 年 1 月 1 日) からの時間 (秒単位)
*local* - "yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm"形式の時刻|[パッシブ チェック](/manual/appendix/items/activepassive#passive_checks) としてのみ使用する必要があります。
例:
=> system.localtime\[local\] → このキーを使用してアイテムを作成し、それを使用して *Clock* [ダッシュボード ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#clock)にホスト時間を表示します|
|**system.run**\[command,\]|<|<|<|
|ホスト上で指定されたコマンドを実行します|コマンドの結果テキスト
1 - `mode` を *nowait* として使用 (コマンドの結果に関係なく)|**command** - 実行のためのコマンド
**mode** - 使用可能な値:
*wait* - 実行の終了を待つ (デフォルト),
*nowait* - 終了を待たない|切り捨てられた末尾の空白を含め、最大 512KB のデータを返すことができます。
正しく処理するには、コマンドの出力がテキストである必要があります。
例:
=> system.run\[ls -l /\] → ルートディレクトリの詳細ファイル一覧。
*注*: system.run 項目はデフォルトで無効になっています。 [有効にする](/manual/config/items/restrict_checks)方法。
項目の戻り値は、コマンドが生成する標準エラーとともに標準出力となります。 終了コードはチェックされません。
Zabbix 2.4.0以降、空の結果が許可されます。
[コマンド実行](/manual/appendix/command_execution)も参照してください。|
|**system.stat**\[resource,\]|<|<|<|
|システム統計|Integer または float|**ent** - このパーティションが受け取る資格のあるプロセッサ ユニットの数 (float)
**kthr,** - カーネル スレッドの状態に関する情報:
*r* - 実行可能なカーネルの平均数スレッド (float)
*b* - 仮想メモリ マネージャーの待機キューに配置されたカーネル スレッドの平均数 (float)
**memory,** - 仮想メモリと実メモリの使用に関する情報:
*avm* - アクティブな仮想ページ (整数)
*fre* - フリー リストのサイズ (整数)
**page,** - ページ フォールトとページング アクティビティに関する情報:< br>*fi* - 1 秒あたりのファイル ページイン (float)
*fo* - 1 秒あたりのファイル ページアウト (float)
*pi* - ページング スペースからページ インされたページ (float)
*po* - ページング スペースにページ アウトされたページ (float)
*fr* - 解放されたページ (ページ置換) (float)
*sr* - ページ置換アルゴリズムによってスキャンされたページ (float)
* *faults,** - トラップと割り込みレート:
*in* - デバイス割り込み (float)
*sy* - システム コール (float)
*cs* - カーネル スレッド コンテキスト スイッチ ( float)**cpu,** - プロセッサ時間の使用率の内訳:
*us* - ユーザー時間 (float)
*sy* - システム時間 (float)
*id* - アイドル時間 (float)
*wa* - システムに未処理のディスク/NFS I/O 要求があったアイドル時間 (float)
*pc* - 消費された物理プロセッサの数 (float)< br>*ec* - 消費されたライセンス容量のパーセンテージ (float)
*lbusy* - ユーザーおよびシステム レベルで実行中に発生した論理プロセッサの使用率を示します (float)
*app * - 共有プールで使用可能な物理プロセッサを示します (float)
**disk,** - ディスク統計:
*bps* - ドライブに転送 (読み取りまたは書き込み) されたデータの量を 1 秒あたりのバイト数 (整数) で示します。
*tps* - 物理ディスク/テープに発行された 1 秒あたりの転送数を示します (float)|
|**system.sw.arch**|<|<|<|
|ソフトウェア アーキテクチャ情報|String| |例:
=> system.sw.arch → i686
uname()関数から情報を取得します。
Zabbix 2.0 以降でサポートされています。|
|**system.sw.os**\[\]|<|<|<|
|OS情報|String|**info** - 使用可能な値:
*full* (デフォルト)、*short* または *name*|例:
=> system.sw.os\[short\]→ Ubuntu 2.6.35-28.50-generic 2.6.35.11
情報は以下から取得されます (すべてのディストリビューションにすべてのファイルとオプションが存在するわけではないことに注意してください):
/proc/version (*full*)
/proc/version\_signature (*short*)
サポートしているシステムの /etc/os-release の PRETTY\_NAME パラメータ、または /etc/issue.net (*name*)
Zabbix 2.0 以降でサポートされています。|
|**system.sw.packages**\[,,\]|<|<|<|
|インストール済みパッケージのリスト|Text|**パッケージ** - *all* (デフォルト) または [正規表現](/manual/regular_expressions#overview)
**manager** - *all* (デフォルト) またはパッケージ マネージャー
** format** - *full* (デフォルト) または *short*|指定された `package` [正規表現](/manual/regular_expressions#overview) と名前が一致するインストール済みパッケージを (アルファベット順に) リストします (*all* はそれらすべてをリストします)。
例:
=> system. sw.packages\[mini,dpkg,short\] → python-minimal, python2.6-minimal, ubuntu-minimal
対応パッケージマネージャー(実行コマンド):
dpkg (dpkg --get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)
`format` が *full* と指定されている場合、パッケージはパッケージ マネージャーごとにグループ化されます (各マネージャーは角かっこで囲まれた名前で始まる別の行にあります)。
`format` が * と指定されている場合 short*、パッケージはグループ化されず、1 行にリストされます。
Zabbix 2.0 以降でサポートされています。|
|**system.swap.in**\[,\]|<|<|<|
|(デバイスからメモリに) 統計情報をスワップします|Integer|**device** - スワップに使用されるデバイス (デフォルトは *all*)
**type** - 使用可能な値:
*count* (スワップインの数)、*sectors* (スワップインされたセクター)、 *pages* (スワップインされたページ)。
このパラメーターの詳細については、[プラットフォーム固有](/manual/appendix/items/supported_by_platform) も参照してください。|例:
=> system.swap.in\[,pages\]
この情報のソース:
/proc/swaps、/proc/partitions、/proc/stat (Linux 2.4)
/proc/swaps、/proc/diskstats、/proc/vmstat (Linux 2.6)|
|**system.swap.out**\[,\]|<|<|<|
|(メモリからデバイスに) 統計情報をスワップアウトします|Integer|**device** - スワップに使用されるデバイス (デフォルトは *all*)
**type** - 使用可能な値:
*count* (スワップアウトの数)、*sectors* (スワップアウトされたセクター)、 *pages* (スワップアウトされたページ)。
このパラメーターの詳細については、[プラットフォーム固有](/manual/appendix/items/supported_by_platform) も参照してください。|例:
=> system.swap.out\[,pages\]
この情報のソース:
/proc/swaps、/proc/partitions、/proc/stat (Linux 2.4)
/proc/swaps、/proc/diskstats、/proc/vmstat (Linux 2.6)|
|**system.swap.size**\[,\]|<|<|<|
|スワップ領域のサイズ (バイト単位または合計に対する割合)|Integer - バイトの場合
Float - パーセンテージの場合|**device** - スワップに使用されるデバイス (デフォルトは *all*)
**type** - 使用可能な値:
*free* (空きスワップ領域、デフォルト)、*pfree* (空きスワップ領域、パーセント)、*pused* (使用済みスワップ領域、パーセント)、*total* (合計スワップ領域)、*used* (使用済みスワップ領域)
スワップ サイズが 0 の場合、*pfree*、*pused* は Windows ではサポートされないことに注意してください。
このパラメータの詳細については、[プラットフォーム固有](/manual/appendix/items/supported_by_platform) も参照してください。|例:
=> system.swap.size\[,pfree\] → 空きスワップ領域の割合
*device* が指定されていない場合、Zabbix エージェントはスワップ デバイス (ファイル) のみを考慮し、物理メモリは無視されます。 たとえば、Solaris システムでは、*swap -s* コマンドには物理メモリとスワップ デバイスの一部が含まれます (*swap -l* とは異なります)
このキーは、仮想化 (VMware ESXi、VirtualBox) Windows プラットフォームで誤ったスワップ領域のサイズ/割合を報告する場合があることに注意してください。 この場合、`perf_counter[\700(_Total)\702]` キーを使用して正しいスワップ領域のパーセンテージを取得できます。|
|**system.uname**|<|<|<|
|システムのID|String| |戻り値の例 (Unix):
FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE \#0: 月 11 月 i386
戻り値の例 (Windows):
Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86
Zabbix 2.2.0以降のUnixでは、このアイテムの値はuname()システムコールで取得されます。以前は"uname -a"を呼び出すことによって取得されていました。この項目の値は、"uname -a"の出力とは異なる場合があり、他のソースに基づいて"uname -a"が出力する追加情報は含まれません。
Zabbix 3.0 以降の Windows では、この項目の値は Win32\_OperatingSystem および Win32\_Processor WMI クラスから取得されます。以前は、揮発性の Windows API および文書化されていないレジストリ キーから取得されていました。 OS 名 (エディションを含む) は、ユーザーの表示言語に翻訳される場合があります。一部のバージョンの Windows では、商標記号と余分なスペースが含まれています。
Windows では OS アーキテクチャを返しますが、Unix では CPU アーキテクチャを返します。|
|**system.uptime**|<|<|<|
|システム稼働時間 (秒単位)|Integer| |[item configuration](/manual/config/items/item#configuration) では、**s** または **uptime** 単位を使用して読み取り可能な値を取得します。|
|**system.users.num**|<|<|<|
|ログインしているユーザーの数|Integer| |**who** コマンドは、エージェント側で値を取得するために使用されます|
[comment]: # ({/f6548db3-3e2abe66})
[comment]: # ({7ea16e22-c56d4a08})
##### 仮想ファイル システム データ
|アイテムキー|<|<|<|
|--|--|------|------|
|説明|戻り値|パラメータ|コメント|
|**vfs.dev.discovery**|<|<|<|
|ブロック デバイスとそのタイプのリスト。 ローレベルディスカバリに使用されます。|JSON object| |この項目は Linux プラットフォームでのみサポートされています。
Zabbix 4.4.0 以降でサポートされています。|
|**vfs.dev.read**\[,,\]|<|<|<|
|ディスク読み取り統計|Integer - *sectors*、*operations*、*bytes* で `type` を使用
Float - *sps*、*ops*、*bps* で `type` を使用
*注*: 更新間隔が 3 時間以上の場合^**[2](#footnotes)**^、常に '0' を返します|**device** - ディスクデバイス(デフォルトは *all* ^**[3](#footnotes)**^)
**type** - 使用可能な値: *sectors*、*operations*、*bytes *, *sps*, *ops*, *bps*
'type'パラメータのサポートとデフォルトはプラットフォームに依存することに注意してください。 [プラットフォーム固有](/manual/appendix/items/supported_by_platform) の詳細を参照してください。
*sps*、*ops*、*bps* は、それぞれ1 秒あたりのセクター、オペレーション、バイト数を表します。
**mode** - 使用可能な値: *avg1* (1分間の平均、デフォルト) 、*avg5*、*avg15*。
このパラメータは、sps、ops、bps の `type` でのみサポートされます。|相対デバイス名 (`sda` など) とオプションの /dev/ プレフィックス (`/dev/sda`)。
LVM 論理ボリュームがサポートされています。
さまざまな OS の'type'パラメータのデフォルト値:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes
例:
=> vfs.dev.read\[,operations\]
サポートされているプラットフォームの *sps*、*ops*、および *bps* は、以前は 8 つのデバイス (個別に 7 つ、*すべて* に 1 つ) に制限されていました。 Zabbix 2.0.1 以降、この制限は 1024 デバイスです (1023 個の個別デバイスと 1 個の*すべて*)|
|**vfs.dev.write**\[,,\]|<|<|<|
|ディスク書き込み統計|Integer - *sectors*、*operations*、*bytes* で `type` を使用
Float - *sps*、*ops*、*bps* で `type` を使用
*注 *: 更新間隔が 3 時間以上の場合^**[2](#footnotes)**^、常に '0' を返します|**device** - ディスクデバイス(デフォルトは *all* ^**[3](#footnotes)**^)
**type** - 使用可能な値: *sectors*、*operations*、*bytes *, *sps*, *ops*, *bps*
'type'パラメータのサポートとデフォルトはプラットフォームに依存することに注意してください。 [プラットフォーム固有](/manual/appendix/items/supported_by_platform) の詳細を参照してください。
*sps*、*ops*、*bps* は、それぞれ1 秒あたりのセクター、オペレーション、バイト数を表します。
**mode** - 使用可能な値: *avg1* (1分間の平均、デフォルト) 、*avg5*、*avg15*。
このパラメータは、sps、ops、bps の `type` でのみサポートされます。|相対デバイス名 (`sda` など) とオプションの /dev/ プレフィックス (`/dev/sda`)。
LVM 論理ボリュームがサポートされています。
さまざまな OS の'type'パラメータのデフォルト値:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes
例:
=> vfs.dev.read\[,operations\]
サポートされているプラットフォームの *sps*、*ops*、および *bps* は、以前は 8 つのデバイス (個別に 7 つ、*すべて* に 1 つ) に制限されていました。 Zabbix 2.0.1 以降、この制限は 1024 デバイスです (1023 個の個別デバイスと 1 個の*すべて*)|
|**vfs.dir.count**\[dir,,,,,,,,,,\]|<|<|<|
|ディレクトリ エントリ数|Integer|**dir** - ディレクトリへの絶対パス
**regex\_incl** - 含めるエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述する[正規表現](/manual/regular_expressions#overview)。空の場合はすべて含める (デフォルト値)
**regex\_excl** - [正規表現](/manual/regular_expressions#overview) 除外するエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述します。空の場合は除外しない (デフォルト値)
**types\_incl** - カウントするディレクトリ エントリの種類、使用可能な値:
*file* - 通常のファイル、*dir* - サブディレクトリ、*sym* - シンボリック リンク、*sock* - ソケット、*bdev* - ブロック デバイス、*cdev* - キャラクター デバイス、*fifo* - FIFO、* dev* - "bdev,cdev"、*all* - すべてのタイプ (デフォルト)、つまり "file,dir,sym,sock,bdev,cdev,fifo" と同義。複数のタイプはコンマで区切り、引用符で囲む必要があります。
**types\_excl** - カウントしないディレクトリ エントリ タイプ ( を参照)。 と の両方にエントリ タイプがある場合、このタイプのディレクトリ エントリはカウントされません。
**max\_depth** - 走査するサブディレクトリの最大深度。 **-1** (デフォルト) - 無制限、**0** - サブディレクトリへの下降なし。
**min\_size** - カウントするファイルの最小サイズ (バイト単位)。それより小さいファイルはカウントされません。 [メモリサフィックス](/manual/appendix/suffixes#memory_suffixes)を使用できます。
**max\_size** - カウントするファイルの最大サイズ (バイト単位)。それより大きいファイルはカウントされません。 [メモリサフィックス](/manual/appendix/suffixes#memory_suffixes)を使用できます。
**min\_age** - カウントされるディレクトリ エントリの最小経過時間 (秒単位)。最近のエントリはカウントされません。 [時間のサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。
**max\_age** - カウントされるディレクトリ エントリの最大経過時間 (秒単位)。古いエントリはカウントされません (変更時間)。 [タイムサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。
**regex\_excl\_dir** - [正規表現](/manual/regular_expressions#overview) 除外するディレクトリの名前パターンを記述します。ディレクトリのすべてのコンテンツが除外されます (regex\_excl とは対照的)|環境変数。 %APP\_HOME%、$HOME、および %TEMP% はサポートされていません。
疑似ディレクトリ "."および".."はカウントされません。
ディレクトリ トラバーサルでシンボリック リンクをたどることはありません。
Windows では、ディレクトリのシンボリック リンクはスキップされます。
エントリのサイズを計算するとき、`regex_incl` と `regex_excl` の両方がファイルとディレクトリに適用されますが、トラバースするサブディレクトリを選択するときは無視されます(regex\_incl が "(?i)\^.+\\.zip$" で max\_depth が設定されていない場合、すべてのサブディレクトリがトラバースされますが、zip タイプのファイルのみがカウントされます)。
実行時間は、エージェントのデフォルトのタイムアウト値 [構成](/manual/appendix/config/zabbix_agentd) (3 秒) によって制限されます。大規模なディレクトリ トラバーサルにはそれよりも時間がかかる可能性があるため、データは返されず、アイテムはサポートされなくなります。部分カウントは返されません。
サイズでフィルタリングすると、通常のファイルのみが意味のあるサイズになります。 Linux および BSD では、ディレクトリのサイズもゼロ以外です (通常は数 Kb)。デバイスのサイズはゼロです。 **/dev/sda1** のサイズは、それぞれのパーティション サイズを反映していません。したがって、`` と `` を使用する場合は、驚きを避けるために `` を"*file*"として指定することをお勧めします。
例:
⇒ vfs.dir.count\[/dev\] - /dev 内のデバイス数を監視 (Linux)
⇒ vfs.dir.count\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - 一時ディレクトリ内のファイル数を監視 (Windows)
Zabbix 4.0.0 以降でサポートされています。|
|**vfs.dir.get**\[dir,,,,,,,,,,\]|<|<|<|
|ディレクトリ エントリ リスト|JSON|**dir** - ディレクトリへの絶対パス
**regex\_incl** - 含めるエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述する[正規表現](/manual/regular_expressions#overview)。空の場合はすべて含める (デフォルト値)
**regex\_excl** - 除外するエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述する[正規表現](/manual/regular_expressions#overview)。空の場合は除外しない (デフォルト値)
**types\_incl** - リストするディレクトリ エントリの種類。使用可能な値:
*file* - 通常のファイル、*dir* - サブディレクトリ、*sym* - シンボリック リンク、*sock* - ソケット、*bdev* - ブロック デバイス、*cdev* - キャラクター デバイス、*fifo* - FIFO、* dev* - "bdev,cdev"、*all* - すべてのタイプ (デフォルト)、つまり "file,dir,sym,sock,bdev,cdev,fifo" と同義。複数のタイプはコンマで区切り、引用符で囲む必要があります。
**types\_excl** - リストしないディレクトリ エントリ タイプ ( を参照)。 と の両方にエントリ タイプがある場合、このタイプのディレクトリ エントリはリストされません。
**max\_depth** - 走査するサブディレクトリの最大深度。 **-1** (デフォルト) - 無制限、**0** - サブディレクトリへの下降なし。
**min\_size** - リストされるファイルの最小サイズ (バイト単位)。それより小さいファイルはリストされません。[メモリサフィックス](/manual/appendix/suffixes#memory_suffixes)を使用できます。
**max\_size** - リストされるファイルの最大サイズ (バイト単位)。それより大きいファイルはカウントされません。 [メモリサフィックス](/manual/appendix/suffixes#memory_suffixes)を使用できます。
**min\_age** - リストされるディレクトリ エントリの最小経過時間 (秒単位)。最近のエントリは表示されません。 [タイムサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。
**max\_age** - リストされるディレクトリ エントリの最大経過時間 (秒単位)。古いエントリはリストされません（変更時間） [タイムサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。
**regex\_excl\_dir** - 除外するディレクトリの名前パターンを記述する[正規表現](/manual/regular_expressions#overview)。ディレクトリのすべてのコンテンツが除外されます (regex\_excl とは対照的)|環境変数。 %APP\_HOME%、$HOME、および %TEMP% はサポートされていません。
疑似ディレクトリ "."
ディレクトリ トラバーサルでシンボリック リンクをたどることはありません。
Windows では、ディレクトリのシンボリック リンクはスキップされます。
エントリのサイズを計算するとき、`regex_incl` と `regex_excl` の両方がファイルとディレクトリに適用されますが、トラバースするサブディレクトリを選択するときは無視されます (regex\_incl が "(?i)\^.+\ の場合) \.zip$" で max\_depth が設定されていない場合、すべてのサブディレクトリが走査されますが、タイプが zip のファイルのみが一覧表示されます)。
実行時間は、エージェントのデフォルトのタイムアウト値 [構成](/manual/appendix/config/zabbix_agentd) (3 秒) によって制限されます。大規模なディレクトリ トラバーサルにはそれよりも時間がかかる可能性があるため、データは返されず、アイテムはサポートされなくなります。部分的なリストは返されません。
サイズでフィルタリングすると、通常のファイルのみが意味のあるサイズになります。 Linux および BSD では、ディレクトリのサイズもゼロ以外です (通常は数 Kb)。デバイスのサイズはゼロです。 **/dev/sda1** のサイズは、それぞれのパーティション サイズを反映していません。したがって、`` と `` を使用する場合は、驚きを避けるために `` を "*file*" として指定することをお勧めします。
例:
⇒ vfs.dir.get\[/dev\] - /dev のデバイス一覧を取得 (Linux)
⇒ vfs.dir.get\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - 一時ディレクトリのファイル一覧を取得 (Windows)
Zabbix 6.0.0 以降でサポートされています。|
|**vfs.dir.size**\[dir,,,,,\]|<|<|<|
|ディレクトリのサイズ (バイト単位)|Integer|**dir** - ディレクトリへの絶対パス
**regex\_incl** - 含めるエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述する正規の [式](/manual/regular_expressions#overview) ;空の場合はすべて含める (デフォルト値)
**regex\_excl** - 除外するエンティティ (ファイル、ディレクトリ、シンボリック リンク) の名前パターンを記述する正規の [式](/manual/regular_expressions#overview)。空の場合は除外しない (デフォルト値)
**mode** - 可能な値:
*apparent* (デフォルト) - ディスク使用量ではなく見かけのファイル サイズを取得します (「du -sb dir」として機能します) ), *disk* - ディスクの使用状況を取得します (「du -s -B1 dir」として機能します)。 du コマンドとは異なり、vfs.dir.size アイテムは、ディレクトリ サイズを計算するときに隠しファイルを考慮に入れます (dir 内で「du -sb .[^.]* *」として機能します)。
**max\_depth** - 最大トラバースするサブディレクトリの深さ。 **-1** (デフォルト) - 無制限、**0** - サブディレクトリへの下降なし。
**regex\_excl\_dir** - 正規の [式](/manual/regular_expressions#overview)除外するディレクトリの名前パターン。ディレクトリのすべてのコンテンツが除外されます (regex\_excl とは対照的)|少なくとも *zabbix* ユーザーの読み取り権限を持つディレクトリのみが計算されます。
Windows では、シンボリック リンクはスキップされ、ハード リンクが取り込まれます。
ディレクトリが大きい場合やドライブが遅い場合、[エージェント](/manual/appendix/config/zabbix_agentd) と [サーバー](/manual/appendix/ config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) 構成ファイル。必要に応じてタイムアウト値を増やしてください。
例:
⇒ vfs.dir.size\[/tmp,log\] - 'log' を含む /tmp 内のすべてのファイルのサイズを計算します
⇒ vfs.dir.size\[/tmp,log,\^.+\\.old$\] - '.old' を含むファイルを除く、'log' を含む /tmp 内のすべてのファイルのサイズを計算します
ファイル サイズの制限は、[大きなファイルのサポート](/manual/appendix/items/large_file_support) によって異なります。
Zabbix 3.4.0 以降でサポートされています。|
|**vfs.file.cksum**\[file,\]|<|<|<|
|UNIX cksum アルゴリズムによって計算されたファイル チェックサム|整数 - `mode` を *crc32* として使用
文字列 - `mode` を *md5*、*sha256* として使用|**ファイル** - ファイルへのフル パス
**モード** - *crc32* (デフォルト)、*md5*、*sha256*|例:
=> vfs.file.cksum\[/etc/passwd\]
戻り値の例(それぞれcrc32/md5/sha256):
675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
ファイル サイズの制限は、[大きなファイルのサポート](/manual/appendix/items/large_file_support) によって異なります。
`mode` パラメータは Zabbix 6.0 以降でサポートされています。|
|**vfs.file.contents**\[file,\]|<|<|<|
|ファイル内容取得|Text|**file** - ファイルへのフルパス
**encoding** - コードページ [識別子](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)|ファイルが空であるか、LF/CR 文字のみが含まれている場合は、空の文字列を返します。
バイト オーダー マーク (BOM) は出力から除外されます。
例:
=> vfs.file.contents\[/etc/passwd\]
このアイテムは、64K バイト以下のファイルに限定されています。
Zabbix 2.0 以降でサポートされています。|
|**vfs.file.exists**\[file,,\]|<|<|<|
|ファイルが存在するか確認|0 - 見つかりません
1 - 指定したタイプのファイルが存在します|**file** - ファイルへのフル パス
**types\_incl** - 含めるファイルタイプのリスト。使用可能な値: *file* (通常のファイル、デフォルト (types\_excl が設定されていない場合))、 *dir* (ディレクトリ), *sym* (シンボリック リンク), *sock* (ソケット), *bdev* (ブロック デバイス), *cdev* (キャラクター デバイス), *fifo* (FIFO), *dev* (同義語) "bdev,cdev")、*all* (言及されているすべてのタイプ、types\_excl が設定されている場合のデフォルト)。
**types\_excl** - 除外するファイル タイプのリスト。可能な値については types\_incl を参照してください。 (デフォルトでは、除外されるタイプはありません)|複数のタイプはコンマで区切り、セット全体を引用符 "" で囲む必要があります。
Windows では、コマンド ライン ユーティリティを使用して zabbix\_get.exe または agent2 を呼び出す場合、二重引用符をバックスラッシュ '\\' でエスケープし、アイテム キー全体を二重引用符で囲む必要があります。
同じタイプが と の両方にある場合、このタイプのファイルは除外されます。
例:
=> vfs.file.exists\[/tmp/application.pid\]
=> vfs.file.exists\[/tmp/application.pid,"file,dir,sym"\]
=> vfs.file.exists\[/tmp/application\_dir,dir\]
ファイル サイズの制限は、[大きなファイルのサポート](/manual/appendix/items/large_file_support) によって異なります。
ディレクトリが存在しないディレクトリ内で検索された場合、アイテムが Windows でサポートされなくなる可能性があることに注意してください。 vfs.file.exists\[C:\\no\\dir,dir\] ('no'は存在しません)。|
|**vfs.file.get**\[file\]|<|<|<|
|ファイルに関する情報を返す|JSON object|**file** - ファイルへのフルパス|UNIX ライクなシステムでサポートされているファイル タイプ: 通常のファイル、ディレクトリ、シンボリック リンク、ソケット、ブロック デバイス、キャラクター デバイス、FIFO
Windows でサポートされているファイル タイプ: 通常のファイル、ディレクトリ、シンボリック リンク
例:
=> vfs.file.get\[/etc/passwd\] → /etc/passwd ファイルに関する情報 (タイプ、ユーザー、権限、SID、uid など) を含む JSON を返す
Zabbix 6.0 以降でサポートされています。|
|**vfs.file.md5sum**\[file\]|<|<|<|
|ファイルの MD5 チェックサム|string(ファイルのMD5ハッシュ)|**file** - ファイルへのフルパス|例：
=> vfs.file.md5sum\[/usr/local/etc/zabbix\_agentd.conf\]
戻り値の例:
b5052decb577e0fffd622d6ddc017e82
このアイテムのファイル サイズ制限 (64 MB) は、バージョン 1.8.6 で削除されました。
ファイル サイズの制限は、[大きなファイルのサポート](/manual/appendix/items/large_file_support) によって異なります。|
|**vfs.file.owner**\[file,,\]|<|<|<|
|ファイル所有者取得|Character string|**file** - ファイルへのフルパス
**ownertype** - *user* (デフォルト) または *group* (Unix のみ)
**resulttype** - *name* (デフォルト) または *id*; for id - Unix では uid/gid、Windows では SID を返します|例:
=> vfs.file.owner\[/tmp/zabbix\_server.log\] → /tmp/zabbix\_server.log のファイル所有者を返す
=> vfs.file.owner\[/tmp/zabbix\_server.log,,id\] → /tmp/zabbix\_server.log のファイル所有者 ID を返す
Zabbix 6.0 以降でサポートされています。|
|**vfs.file.permissions**\[file\]|<|<|<|
|Unix パーミッションを持つ 8 進数を含む 4 桁の文字列を返す|String|**file** - ファイルへのフル パス|Windows ではサポートされていません。
例:
=> vfs.file.permissions\[/etc/passwd\] → /etc/passwd のパーミッションを返す (例: '0644')
Zabbix 6.0 以降でサポートされています。|
|**vfs.file.regexp**\[file,regexp,,,,