[comment]: # translation:outdated [comment]: # ({7f44ce82-7f44ce82}) # 4 Zabbix エージェント 2 (UNIX) [comment]: # ({/7f44ce82-7f44ce82}) [comment]: # ({d5608d34-d5608d34}) #### 概要 Zabbixエージェント2は新世代のZabbixエージェントであり、Zabbixエージェントの代わりに使用できます。このセクションでは、Zabbixエージェント2設定ファイル（zabbix \ _agent2.conf）でサポートされているパラメータの一覧を提示します。注意点: - デフォルト値は、出荷時設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 [comment]: # ({/d5608d34-d5608d34}) [comment]: # ({b6a975cd-d34644cb}) #### パラメータ |パラメータ|<|必須|範囲|デフォルト|説明| |-|----------|----------|----------|----------|--------------------------------------------------| |Alias|<|no| | |項目キーのエイリアスを設定します。長くて複雑な項目キーを、より短くて単純なものに置き換えるために使用できます。
複数の *Alias* パラメータが存在する場合があります。同じ *Alias* キーを持つ複数のパラメーターを使用できます。
異なる *Alias* キーが同じ項目キーを参照する場合があります。
*HostMetadataItem* ではエイリアスを使用できますが、*HostnameItem* パラメーターでは使用できません。
 例:

1.ユーザー`zabbix`の ID を取得します。
Alias=zabbix.userid:vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",, ,,\\1\]
これで短縮キー **zabbix.userid** を使用してデータを取得できます。

2.デフォルトおよびカスタムパラメータで CPU 使用率を取得します。
Alias=cpu.util:system.cpu.util
Alias=cpu.util\[\*\]:system.cpu.util\[\*\] これにより、**cpu.util** キーを使用してデフォルトパラメータで CPU 使用率を取得したり、**cpu.util\[all, idle, avg15\]** を使用して CPU 使用率に関する特定のデータを取得したりできます。 
3.同じディスカバリーアイテムを処理する複数の [ローレベルディスカバリ](/manual/discovery/low_level_discovery) ルールを実行します。
Alias=vfs.fs.discovery\[\*\]:vfs.fs.discovery
**vfs.fs.discovery** を使用して、ルールごとに異なるパラメーターを使用して複数のディスカバリルールを設定できます (例: **vfs.fs.discovery\[foo\]**、**vfs.fs.discovery\)。 [bar\]** など| |AllowKey|<|no| | |パターンに一致する項目キーの実行を許可します。キーパターンは、任意の数の任意の文字に一致する"\*"文字をサポートするワイルドカード式です。
DenyKey と組み合わせて、複数のキーマッチングルールを定義できます。パラメーターは、出現順序に従って 1 つずつ処理されます。
このパラメータは、Zabbix 5.0.0 以降でサポートされています。
参照: [エージェントチェックの制限](/manual/config/items/restrict_checks)| |BufferSend|<|no|1-3600|5|値がバッファからZabbixサーバーに送信される時間間隔(秒単位)。
バッファがいっぱいの場合、データはより早く送信されることに注意してください。| |BufferSize|<|no|2-65535|100|メモリバッファ内の値の最大数。エージェントは、バッファがいっぱいになると、収集されたすべてのデータを Zabbix サーバーまたはプロキシに送信します。
このパラメータは、永続バッファが無効になっている場合 (*EnablePersistentBuffer=0*) にのみ使用してください。| |ControlSocket| |no| |/tmp/agent.sock|'-R'オプションを使用して実行時コマンドを送信するために使用される制御ソケット。| |DebugLevel|<|no|0-5|3|デバッグレベルを指定します。
0 - Zabbix プロセスの開始と停止に関する基本情報
1 - 重要な情報
2 - エラー情報
3 - 警告
4 - デバッグ用 (多くの情報を生成) )
5 - 拡張デバッグ (さらに多くの情報を生成)| |DenyKey|<|no| | |パターンに一致する項目キーの実行を拒否します。キーパターンは、任意の数の任意の文字に一致する"\*"文字をサポートするワイルドカード式です。
AllowKey と組み合わせて、複数のキー一致ルールを定義できます。パラメータは出現順に従って1つずつ処理されます。
このパラメータはZabbix 5.0.0からサポートされています。
参照: [エージェントチェックの制限](/manual/config/items/restrict_checks).| |EnablePersistentBuffer|<|no|0-1|0|アクティブなアイテムのローカル永続ストレージの使用を有効にします。
0 - 無効
1 - 有効
永続ストレージが無効の場合、メモリバッファが使用されます。| |ForceActiveChecksOnStart|<|no|0-1|0 |最初に受信した構成の再起動直後にアクティブチェックを実行します。
0 - 無効
1 - 有効
プラグイン構成パラメーターごとにも利用可能です。例: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Zabbix 6.0.2 以降でサポートされています。| |HostInterface| |no|0～255文字| |ホストインターフェースを定義するオプションパラメータ。
ホストインターフェースは、ホストの自動登録プロセスで使用されます。
値が 255 文字の制限を超えると、エージェントはエラーを発行し、起動しません。
定義されていない場合、値 HostInterfaceItem から取得されます。
Zabbix 4.4.0 以降でサポートされています。| |HostInterfaceItem|<|no| | |ホストインターフェースの取得に使用されるアイテムを定義するオプションパラメータ。
ホストインターフェースは、ホストの自動登録プロセスで使用されます。
自動登録リクエスト中に、指定されたアイテムによって返される値が 255 の制限を超えている場合、エージェントは警告メッセージを記録します。
このオプションは、HostInterface が定義されていない場合にのみ使用されます。
Zabbix 4.4.0 以降でサポートされています。| |HostMetadata|<|no|0～255文字| |ホストのメタデータを定義するオプションのパラメーター。ホストメタデータは、ホストの自動登録プロセスで使用されます。
指定された値が制限を超えているか、UTF-8 以外の文字列である場合、エージェントはエラーを発行し、起動しません。
未定義の場合、値は HostMetadataItem から取得されます。| |HostMetadataItem|<|no| | |ホストメタデータの取得に使用される項目を定義するオプションのパラメーター。ホストメタデータアイテム値は、ホスト自動登録プロセスの各自動登録試行で取得されます。
自動登録リクエスト中に、指定されたアイテムによって返される値が 255 文字の制限を超えている場合、エージェントは警告メッセージをログに記録します。
このオプション HostMetadata が定義されていない場合にのみ使用されます。
UserParameters とエイリアスをサポートします。 AllowKey/DenyKey の値に関係なく、*system.run\[\]* をサポートします。
アイテムによって返される値は、UTF-8 文字列でなければなりません。それ以外の場合は無視されます。| |Hostname|<|no| |HostnameItem で設定|コンマで区切られた一意のホスト名のリスト。大文字と小文字が区別されます。
アクティブチェックに必要であり、サーバーで構成されているホスト名と一致する必要があります。未定義の場合、値は HostnameItem から取得されます。
使用できる文字: 英数字、'.'、' '、'\_'、および'-'。
最大長: ホスト名ごとに 128 文字、行全体で 2048 文字。| |HostnameItem|<|no| |system.hostname|ホスト名が定義されていない場合に生成するために使用されるアイテム。 Hostname が定義されている場合は無視されます。
UserParameters またはエイリアスはサポートされませんが、AllowKey/DenyKey の値に関係なく、*system.run\[\]* はサポートされます。
出力の長さは 512 KB に制限されています。| |Include| |no| | |個々のファイルまたはディレクトリ内のすべてのファイルを構成ファイルに含めることができます。
コンパイル時に変更されない限り、Zabbix はインストール中に /usr/local/etc にインクルードディレクトリを作成します。
関連するもののみを含めるには指定したディレクトリ内のファイルの場合、パターンマッチングでアスタリスクワイルドカード文字がサポートされます。例: `/absolute/path/to/config/files/*.conf`
Zabbix 6.0.0以降、パスは*zabbix\_agent2.conf*ファイルの場所からの相対パスにすることができます。
制限事項については[特記事項](special_notes_include)を参照してください。| |ListenIP|<|no| |0.0.0.0|エージェントがリッスンするカンマ区切りの IP アドレスのリスト。
Zabbix サーバーに接続している場合、アクティブなチェックのリストを取得するために、最初の IP アドレスが Zabbix サーバーに送信されます。| |ListenPort|<|no|1024-32767|10050|エージェントは、この番号のポートでサーバーからの接続をリッスンします。| |LogFile|<|LogType が *file* に設定されている場合:yes
それ以外の場合:no| |/tmp/zabbix\_agent2.log|LogType が'file'の場合のログファイル名。| |LogFileSize|<|no|0-1024|1|ログファイルの最大サイズ (MB)。
0 - ログの自動ローテーションを無効にします。
*注*: ログファイルのサイズ制限に達し、ファイルのローテーションが何らかの理由で失敗した場合、既存のログファイルは切り捨てられ、新たに作成されます。| |LogType|<|no| |file|ログメッセージが書き込まれる場所を指定します。
*system* - syslog
*file* - LogFile パラメータで指定されたファイル
*console* - 標準出力| |PersistentBufferFile|<|no| | |Zabbix Agent2 が SQLite データベースを保持するファイル。
完全なファイル名である必要があります。
このパラメータは、永続バッファが有効な場合 (*EnablePersistentBuffer=1*) にのみ使用されます。| |PersistentBufferPeriod| |no|1m-365d|1h|サーバーまたはプロキシへの接続がない場合に、データを保存する期間。古いデータは失われます。ログデータは保持されます。
このパラメータは、永続バッファが有効な場合にのみ使用されます (*EnablePersistentBuffer=1*)| |PidFile|<|no| |/tmp/zabbix\_agent2.pid|PIDファイル名| |Plugin|<|no| | |Zabbix 6.0.0以降、ほとんどのプラグインには独自の[設定ファイル](/manual/appendix/config/zabbix_agent2_plugins)があります。エージェント設定ファイルには、以下に示すプラグインパラメータが含まれています。| | |Plugins.Log.MaxLinesPerSecond|no|1-1000|20|'ログ'および'イベントログ'のアクティブチェックを処理するときに、エージェントが Zabbix サーバーまたはプロキシに 1 秒あたりに送信する新しい行の最大数。
指定された値は、パラメータ'maxlines'によって上書きされます。
'log' または 'eventlog' アイテムキーで提供されます。
*注*: Zabbix は、*MaxLinesPerSecond* で設定されたよりも 10 倍多くの新しい行を処理して、ログ項目で必要な文字列を検索します。
このパラメータは 4.4.2 以降でサポートされており、MaxLinesPerSecond を置き換えます。| |^|Plugins.SystemRun.LogRemoteCommands|no| |0|実行されたシェルコマンドのログを警告として有効にします。
0 - 無効
1 - 有効
コマンドは、リモートで実行された場合にのみログに記録されます。 system.run\[\] が HostMetadataItem、HostInterfaceItem、または HostnameItem パラメータによってローカルで起動された場合、ログエントリは作成されません。
このパラメータは 4.4.2 以降でサポートされ、LogRemoteCommands を置き換えます。| |PluginSocket|<|no| |/tmp/agent.plugin.sock |ロード可能なプラグイン通信用の Unix ソケットパス| |PluginTimeout|<|no|1-30 |グローバルタイムアウト|ロード可能なプラグインとの接続のタイムアウト。| |RefreshActiveChecks|<|no|60-3600|120|アクティブチェックのリストを更新する頻度 (秒単位)。
アクティブチェックの更新に失敗すると、60 秒後に次の更新が試行されることに注意してください。| |Server|<|yes| | |カンマ区切りの IP アドレスのリスト (オプションで CIDR 表記、または Zabbix サーバーと Zabbix プロキシの DNS 名)。
着信接続は、ここにリストされているホストからのみ受け入れられます。
IPv6 サポートが有効になっている場合は、'127.0. 0.1'、'::ffff:127.0.0.1' は同等に扱われ、'::/0' はすべての IPv4 または IPv6 アドレスを許可します。
'0.0.0.0/0' はすべての IPv4 アドレスを許可するために使用できます。 例: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
スペースを使用できます。| |ServerActive|<|no| | |アクティブなチェックを取得するZabbixサーバー/プロキシアドレスまたはクラスター構成。
サーバー/プロキシアドレスは、コロンで区切られた IP アドレスまたは DNS 名とオプションのポートです。
クラスタ構成は、セミコロンで区切られた 1 つ以上のサーバーアドレスです。
複数のZabbixサーバー/クラスタおよびZabbixプロキシをカンマで区切って指定できます。
各 Zabbix サーバー/クラスタから複数の Zabbix プロキシを指定しないでください。
Zabbix プロキシが指定されている場合、そのプロキシの Zabbix サーバー/クラスタは指定しないでください。
カンマ区切りの複数のアドレスを指定して、複数の独立した Zabbix サーバーを並行して使用できます。スペースは使用できます。
ポートが指定されていない場合、デフォルトのポートが使用されます。
そのホストのポートを指定する場合は、IPv6 アドレスを角括弧で囲む必要があります。
ポートが指定されていない場合、IPv6 アドレスの角括弧はオプションです。
このパラメータが指定されていない場合、アクティブチェックは無効になります。
Zabbix プロキシの例:
ServerActive=127.0.0.1:10051
複数のサーバーの例:
ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\]
高可用性の例:
ServerActive= zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
2 つのクラスタと 1 つのサーバーによる高可用性の例:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain| |SourceIP|<|no| | |次の送信元 IP アドレス:
- Zabbix サーバーまたは Zabbix プロキシへの発信接続。
- 一部のアイテム (web.page.get、net.tcp.port など) の実行中に接続を確立する| |StatusPort|<|no|1024-32767| |設定されている場合、エージェントはこのポートで HTTP ステータスリクエストをリッスンします (http://localhost:/status)| |Timeout|<|no|1-30|3|処理にかかる時間は Timeout 秒以内です。| |TLSAccept|<|TLS 証明書または PSK パラメータが定義されている場合 (*暗号化されていない* 接続の場合でも):yes、それ以外の場合:no| | |受け入れる着信接続。パッシブチェックに使用されます。コンマで区切って複数の値を指定できます。
*unencrypted* - 暗号化なしで接続を受け入れる (デフォルト)
*psk* - TLS と事前共有キー (PSK) を使用した接続を受け入れる
*cert* - TLS と証明書による接続を受け入れる| |TLSCAFile|<|no| | |Zabbix コンポーネント間の暗号化された通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名。| |TLSCertFile|<|no| | |Zabbix コンポーネントとの暗号化通信に使用される、エージェント証明書または証明書チェーンを含むファイルのフルパス名。| |TLSConnect|<|TLS 証明書または PSK パラメータが定義されている場合 (*暗号化されていない* 接続の場合でも):yes、それ以外の場合:no| | |エージェントが Zabbix サーバーまたはプロキシに接続する方法。アクティブチェックに使用されます。指定できる値は 1 つだけです。
*unencrypted* - 暗号化なしで接続 (デフォルト)
*psk* - TLS と事前共有キー (PSK) を使用して接続
*cert* - TLS と証明書| |TLSCRLFile|<|no| | |失効した証明書を含むファイルのフルパス名。このパラメータは、Zabbix コンポーネントとの暗号化通信に使用されます。| |TLSKeyFile|<|no| | |Zabbix コンポーネントとの暗号化された通信に使用されるエージェントの秘密鍵を含むファイルのフルパス名。| |TLSPSKFile|<|no| | |Zabbix コンポーネントとの暗号化された通信に使用されるエージェントの事前共有キーを含むファイルのフルパス名。| |TLSPSKIdentity|<|no| | |Zabbix サーバーとの暗号化された通信に使用される事前共有キー ID 文字列。| |TLSServerCertIssuer|<|no| | |許可されたサーバー (プロキシ) 証明書の発行者。| |TLSServerCertSubject|<|no| | |許可されたサーバー (プロキシ) 証明書のサブジェクト。| |UnsafeUserParameters|<|no|0,1|0|ユーザー定義パラメータの引数にすべての文字を渡すことができます。
ただし次の文字は使用できません:
\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @
さらに、改行文字は使用できません。| |UserParameter|<|no| | |監視するユーザー定義のパラメーター。いくつかのユーザー定義パラメーターが存在する場合があります。
書式: UserParameter=<キー>,<シェルコマンド>
シェルコマンドは、空の文字列または EOL のみを返してはならないことに注意してください。
UserParameterDir パラメータが指定されている場合、シェルコマンドは相対パスを持つことができます。
例:
UserParameter=system.test,who\|wc -l
UserParameter=check\_cpu,./custom\_script.sh| |UserParameterDir|<|no| | |UserParameter コマンドのデフォルトの検索パス。使用すると、エージェントはコマンドを実行する前に、ここで指定されたディレクトリに作業ディレクトリを変更します。これにより、UserParameter コマンドは、フルパスの代わりに相対 `./` プレフィックスを持つことができます。
許可されるエントリは 1 つだけです。
例: UserParameterDir=/opt/myscripts| [comment]: # ({/b6a975cd-d34644cb})