Table of Contents
4 Zabbix エージェント 2 (UNIX)
概要
Zabbixエージェント2は新世代のZabbixエージェントであり、Zabbixエージェントの代わりに使用できます。
このセクションでは、Zabbixエージェント2設定ファイル（zabbix _agent2.conf）でサポートされているパラメータの一覧を提示します。
注意点:
- デフォルト値は、出荷時設定ファイルの値ではなく、プロセスのデフォルト値です。
- ZabbixはBOMなしのUTF-8エンコーディングでのみ構成ファイルをサポートします。
- 行の先頭が"＃"で始まった場合のみコメントとして認識されます。
パラメータ
| パラメータ | 必須 | 範囲 | デフォルト | 説明 | |
|---|---|---|---|---|---|
| Alias | no | 項目キーのエイリアスを設定します。長くて複雑な項目キーを、より短くて単純なものに置き換えるために使用できます。 複数の Alias パラメータが存在する場合があります。同じ Alias キーを持つ複数のパラメーターを使用できます。 異なる Alias キーが同じ項目キーを参照する場合があります。 HostMetadataItem ではエイリアスを使用できますが、HostnameItem パラメーターでは使用できません。 < br>例: 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[*]< br>これにより、cpu.util キーを使用してデフォルト パラメータで CPU 使用率を取得したり、cpu.util[all, idle, avg15] を使用して CPU 使用率に関する特定のデータを取得したりできます。< br> 3.同じディスカバリー アイテムを処理する複数の ローレベルディスカバリ ルールを実行します。 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 以降でサポートされています。 参照: エージェント チェックの制限 |
|||
| 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からサポートされています。 参照: エージェントチェックの制限. |
|||
| EnablePersistentBuffer | no | 0-1 | 0 | アクティブなアイテムのローカル永続ストレージの使用を有効にします。 0 - 無効 1 - 有効 永続ストレージが無効の場合、メモリ バッファが使用されます。 |
|
| ForceActiveChecksOnStart | no | 0-1 | 0 | 最初に受信した構成の再起動直後にアクティブ チェックを実行します。 0 - 無効 1 - 有効 プラグイン構成パラメーターごとにも利用可能です。例: Plugins.Uptime.System.ForceActiveChecksOnStart=1 < br> 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/*.confZabbix 6.0.0以降、パスはzabbix_agent2.confファイルの場所からの相対パスにすることができます。 制限事項については特記事項を参照してください。 |
|||
| 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以降、ほとんどのプラグインには独自の設定ファイルがあります。 エージェント設定ファイルには、以下に示すプラグイン パラメータが含まれています。 | |||
| 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 アドレスを許可するために使用できます。< br>例: 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:<port>/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 |
|||