Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

6 Zabbix エージェント 2 (Windows)

概要

Zabbixエージェント2は新世代のZabbixエージェントであり、Zabbixエージェントの代わりに使用できます。

このセクションではZabbixエージェント2設定ファイル(zabbix_agent2.win.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 \\.\pipe\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 とエイリアスをサポートします。 EnableRemoteCommandsの値に関係なく、system.run[] をサポートします。
アイテムによって返される値は、UTF-8 文字列でなければなりません。それ以外の場合は無視されます。
Hostname no HostnameItem で設定 コンマで区切られた一意のホスト名のリスト。大文字と小文字が区別されます。
アクティブ チェックに必要であり、サーバーで構成されているホスト名と一致する必要があります。 未定義の場合、値は HostnameItem から取得されます。
使用できる文字: 英数字、'.'、' '、'_'、および'-'。
最大長: ホスト名ごとに 128 文字、行全体で 2048 文字。
HostnameItem no system.hostname ホスト名が定義されていない場合に生成するために使用されるアイテム。 Hostname が定義されている場合は無視されます。
UserParameters またはエイリアスはサポートされませんが、EnableRemoteCommandsの値に関係なく、system.run[] はサポートされます。
出力の長さは 512 KB に制限されています。
Include no 個々のファイルまたはディレクトリ内のすべてのファイルを構成ファイルに含めることができます。
コンパイル時に変更されない限り、Zabbix はインストール中に /usr/local/etc にインクルード ディレクトリを作成します。
関連するもののみを含めるには 指定したディレクトリ内のファイルの場合、パターン マッチングでアスタリスク ワイルドカード文字がサポートされます。例: /absolute/path/to/config/files/*.conf
Zabbix 6.0.0以降、パスはzabbix_agent2.win.confファイルの場所からの相対パスにすることができます。
制限事項については特記事項を参照してください。
ListenIP no 0.0.0.0 エージェントがリッスンするカンマ区切りの IP アドレスのリスト。
Zabbix サーバーに接続している場合、アクティブなチェックのリストを取得するために、最初の IP アドレスが Zabbix サーバーに送信されます。
ListenPort no 1024-32767 10050 エージェントは、この番号のポートでサーバーからの接続をリッスンします。
LogFile LogType が file に設定されている場合:yes
それ以外の場合:no
c:\zabbix_agent2.log LogType が'file'の場合のログ ファイル名。
LogFileSize no 0-1024 1 ログ ファイルの最大サイズ (MB)。
0 - ログの自動ローテーションを無効にします。
: ログ ファイルのサイズ制限に達し、ファイルのローテーションが何らかの理由で失敗した場合、既存のログ ファイルは切り捨てられ、新たに作成されます。
LogType no file ログ メッセージが書き込まれる場所を指定します。
file - LogFile パラメータで指定されたファイル
console - 標準出力。
PersistentBufferFile no Zabbix Agent2 が SQLite データベースを保持するファイル。
完全なファイル名である必要があります。
このパラメータは、永続バッファが有効な場合 (EnablePersistentBuffer=1) にのみ使用されます。
PersistentBufferPeriod no 1m-365d 1h サーバーまたはプロキシへの接続がない場合に、データを保存する期間。 古いデータは失われます。 ログ データは保持されます。
このパラメータは、永続バッファが有効な場合にのみ使用されます (EnablePersistentBuffer=1)
Plugins 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 \\..plugin.sock ロード可能なプラグイン通信用の UNIX ソケットへのパス。
PluginTimeout no 1-30 Global timeout ロード可能なプラグインとの接続のタイムアウト。
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 つまたは複数のサーバー アドレスです。
br>複数の 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