[comment]: # attributes: notoc [comment]: # ({4963afdf-4963afdf}) # 6 Zabbix エージェント 2 (Windows) [comment]: # ({/4963afdf-4963afdf}) [comment]: # ({21d67576-9fe069f9}) ### 概要 Zabbix agent 2 は Zabbix エージェントの新世代版であり、Zabbix エージェントの代わりに使用できます。 Windows 用 Zabbix agent 2 設定ファイル (zabbix\_agent2.conf) でサポートされるパラメーターを、このセクションに示します。 パラメーターは追加情報なしで一覧表示されています。 パラメーターをクリックすると、詳細を表示できます。 |Parameter|Description| |--|--------| |[Alias](#alias)|アイテムキーの別名を設定します。| |[AllowKey](#allowkey)|パターンに一致するアイテムキーの実行を許可します。| |[BufferSend](#buffersend)|データをバッファー内に N 秒より長く保持しません。| |[BufferSize](#buffersize)|メモリーバッファー内の値の最大数です。| |[ControlSocket](#controlsocket)|`-R` オプションでランタイムコマンドを送信するために使用する制御ソケットです。| |[DebugLevel](#debuglevel)|デバッグレベルです。| |[DenyKey](#denykey)|パターンに一致するアイテムキーの実行を拒否します。| |[EnablePersistentBuffer](#enablepersistentbuffer)|アクティブアイテムに対してローカルの永続ストレージの使用を有効にします。| |[ForceActiveChecksOnStart](#forceactivechecksonstart)|最初に受信した設定に対して、再起動直後にアクティブチェックを実行します。| |[HeartbeatFrequency](#heartbeatfrequency)|ハートビートメッセージの送信間隔を秒単位で指定します。| |[HostInterface](#hostinterface)|ホストインターフェースを定義する任意のパラメーターです。| |[HostInterfaceItem](#hostinterfaceitem)|ホストインターフェースを取得するために使用するアイテムを定義する任意のパラメーターです。| |[HostMetadata](#hostmetadata)|ホストメタデータを定義する任意のパラメーターです。| |[HostMetadataItem](#hostmetadataitem)|ホストメタデータを取得するために使用する Zabbix エージェントのアイテムを定義する任意のパラメーターです。| |[Hostname](#hostname)|ホスト名を定義する任意のパラメーターです。| |[HostnameItem](#hostnameitem)|ホスト名を取得するために使用する Zabbix エージェントのアイテムを定義する任意のパラメーターです。| |[Include](#include)|設定ファイルに個別のファイル、またはディレクトリ内のすべてのファイルを含めることができます。| |[ListenIP](#listenip)|エージェントが待ち受ける、カンマ区切りの IP アドレス一覧です。| |[ListenPort](#listenport)|エージェントはサーバーからの接続をこのポートで待ち受けます。| |[LogFile](#logfile)|ログファイル名です。| |[LogFileSize](#logfilesize)|ログファイルの最大サイズです。| |[LogType](#logtype)|ログ出力の種類です。| |[PersistentBufferFile](#persistentbufferfile)|Zabbix agent 2 が SQLite データベースを保持するファイルです。| |[PersistentBufferPeriod](#persistentbufferperiod)|サーバーまたはプロキシへの接続がない場合にデータを保存する期間です。| |[Plugins..System.Capacity](#plugins.systemcapacity)|同時に実行できるプラグインごとのチェック数の上限です。| |[Plugins.Log.MaxLinesPerSecond](#plugins.log.maxlinespersecond)|`log` および `logrt` のアクティブチェック処理時に、エージェントが 1 秒あたりに Zabbix サーバーまたはプロキシへ送信する新しい行の最大数です。| |[Plugins.SystemRun.LogRemoteCommands](#plugins.systemrun.logremotecommands)|実行されたシェルコマンドを警告としてログに記録するようにします。| |[PluginSocket](#pluginsocket)|ロード可能なプラグインとの通信に使用する Windows の名前付きパイプのパスです。| |[PluginTimeout](#plugintimeout)|ロード可能なプラグインとの接続タイムアウトを秒単位で指定します。| |[PerfCounter](#perfcounter)|新しいパラメーター を定義します。これは、指定した期間 (秒) におけるシステム パフォーマンス カウンター の平均値です。| |[PerfCounterEn](#perfcounteren)|新しいパラメーター を定義します。これは、指定した期間 (秒) におけるシステム パフォーマンス カウンター の平均値です。PerfCounter と比較して、perfcounter のパスは英語である必要があります。| |[RefreshActiveChecks](#refreshactivechecks)|アクティブチェックの一覧を更新する頻度です。| |[Server](#server)|Zabbix サーバーおよび Zabbix プロキシの IP アドレス一覧、必要に応じて CIDR 表記、または DNS 名をカンマ区切りで指定します。| |[ServerActive](#serveractive)|アクティブチェックを取得するための Zabbix サーバー/プロキシのアドレス、またはクラスタ設定です。| |[SourceIP](#sourceip)|送信元 IP アドレスです。| |[StatusPort](#statusport)|設定した場合、エージェントは HTTP ステータス要求 (http://localhost:/status) をこのポートで待ち受けます。| |[Timeout](#timeout)|Zabbix プロキシまたはサーバーとの接続確立およびデータ交換を待機する時間を秒単位で指定します。| |[TLSAccept](#tlsaccept)|受け入れる受信接続の種類です。| |[TLSCAFile](#tlscafile)|Zabbix コンポーネント間の暗号化通信で使用する、ピア証明書検証用の最上位 CA 証明書を含むファイルの完全パス名です。| |[TLSCertFile](#tlscertfile)|Zabbix コンポーネント間の暗号化通信で使用する、エージェント証明書または証明書チェーンを含むファイルの完全パス名です。| |[TLSCipherAll13](#tlscipherall13)|OpenSSL の暗号スイート文字列 (TLS 1.3) です。証明書ベースおよび PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。| |[TLSCipherCert13](#tlsciphercert13)|OpenSSL の暗号スイート文字列 (TLS 1.3) です。証明書ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。| |[TLSCipherPSK13](#tlscipherpsk13)|OpenSSL の暗号スイート文字列 (TLS 1.3) です。PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。| |[TLSConnect](#tlsconnect)|エージェントが Zabbix サーバーまたはプロキシに接続する方法です。| |[TLSCRLFile](#tlscrlfile)|失効した証明書を含むファイルの完全パス名です。このパラメーターは Zabbix コンポーネント間の暗号化通信に使用されます。| |[TLSKeyFile](#tlskeyfile)|Zabbix コンポーネント間の暗号化通信で使用する、エージェントの秘密鍵を含むファイルの完全パス名です。| |[TLSPSKFile](#tlspskfile)|Zabbix サーバーとの暗号化通信で使用する、エージェントの事前共有鍵を含むファイルの完全パス名です。| |[TLSPSKIdentity](#tlspskidentity)|Zabbix サーバーとの暗号化通信で使用する、事前共有鍵の識別文字列です。| |[TLSServerCertIssuer](#tlsservercertissuer)|許可されるサーバー (プロキシ) 証明書の発行者です。| |[TLSServerCertSubject](#tlsservercertsubject)|許可されるサーバー (プロキシ) 証明書のサブジェクトです。| |[UnsafeUserParameters](#unsafeuserparameters)|ユーザー定義パラメーターの引数として、すべての文字を渡せるようにします。| |[UserParameter](#userparameter)|監視するユーザー定義パラメーターです。| |[UserParameterDir](#userparameterdir)|UserParameter コマンドの既定の検索パスです。| パラメーターが必須であると明示されていない限り、すべてのパラメーターは必須ではありません。 注意: - 既定値は、配布される設定ファイル内の値ではなく、プロセスの既定値を反映しています。 - 値は [環境変数](/manual/appendix/config/environment_variables) をサポートします。 - Zabbix は [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) なしの UTF-8 エンコーディングの設定ファイルのみをサポートします。 - `\#` で始まるコメントは、行頭でのみサポートされます。 [comment]: # ({/21d67576-9fe069f9}) [comment]: # ({8085875f-324d4c30}) ### パラメータの詳細 [comment]: # ({/8085875f-324d4c30}) [comment]: # ({0e8f6372-fa6993fd}) ##### Alias アイテムキーのエイリアスを設定します。 長くて複雑なアイテムキーを、短くて簡単なものに置き換えるために使用できます。
複数の*Alias*パラメータを指定できます。 同じ*Alias*キーを持つ複数のパラメータは許可されていません。
異なる*Alias*キーが同じアイテムキーを参照することは可能です。
エイリアスは*HostMetadataItem*で使用できますが、*HostnameItem*パラメータでは使用できません。 例1: サーバーからページングファイルの使用率(%)を取得する。 ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` これで、短縮キー**pg_usage**を使用してデータを取得できます。 例2: デフォルトおよびカスタムパラメータでCPU負荷を取得する。 ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` これにより、**cpu.load**キーを使用してデフォルトパラメータでCPU負荷を取得したり、**cpu.load[percpu,avg15]**を使用してCPU負荷の特定のデータを取得したりできます。 例3: 同じディスカバリアイテムを処理する複数の[ローレベルディスカバリ](/manual/discovery/low_level_discovery)ルールを実行する。 ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` これで、各ルールに異なるパラメータ(**vfs.fs.discovery[foo]**、**vfs.fs.discovery[bar]**など)を指定して、**vfs.fs.discovery**を使用する複数のディスカバリルールを設定できます。 [comment]: # ({/0e8f6372-fa6993fd}) [comment]: # ({3ed0c834-e05b8a23}) ##### AllowKey パターンに一致するアイテムキーの実行を許可します。 キーのパターンはワイルドカード式であり、"\*"文字を使用して任意の文字列に一致させることができます。
DenyKeyと組み合わせて複数のキー一致ルールを定義できます。 パラメータは、出現順に1つずつ処理されます。 参考: [エージェントチェックの制限](/manual/config/items/restrict_checks)。 [comment]: # ({/3ed0c834-e05b8a23}) [comment]: # ({fc56d912-5d573779}) ##### BufferSend バッファからZabbixサーバーへ値を送信する間隔（秒単位）です。
バッファがいっぱいの場合、データはより早く送信されます。 デフォルト: `5`
範囲: 1-3600 [comment]: # ({/fc56d912-5d573779}) [comment]: # ({bd027b5f-adbf2018}) ##### BufferSize メモリバッファ内の値の最大数。 バッファがいっぱいの場合、エージェントは収集したすべてのデータをZabbixサーバーまたはプロキシに送信します。
このパラメータは、永続バッファが無効になっている場合(*EnablePersistentBuffer=0*)のみ使用してください。 デフォルト: `1000`
範囲: 2-65535 [comment]: # ({/bd027b5f-adbf2018}) [comment]: # ({78069119-dee4d084}) ##### ControlSocket '-R' オプションを指定したランタイムコマンドの送信に使用する制御ソケット デフォルト: `\\.\pipe\agent.sock` [comment]: # ({/78069119-dee4d084}) [comment]: # ({9c071f70-74594585}) ##### DebugLevel デバッグレベルを指定します。
*0* - Zabbix プロセスの起動と停止に関する基本情報
*1* - 重要な情報
*2* - エラー情報
*3* - 警告
*4* - デバッグ用（多くの情報を生成します）
*5* - 拡張デバッグ（さらに多くの情報を生成します） デフォルト: `3`
範囲: 0-5 [comment]: # ({/9c071f70-74594585}) [comment]: # ({26eddabd-ad027e43}) ##### DenyKey パターンに一致するアイテムキーの実行を拒否します。 キーのパターンはワイルドカード式であり、"\*"文字を使用して任意の文字列に一致させることができます。
AllowKeyと組み合わせて複数のキー一致ルールを定義できます。 パラメータは、記述された順に1つずつ処理されます。 参考: [エージェントチェックの制限](/manual/config/items/restrict_checks) [comment]: # ({/26eddabd-ad027e43}) [comment]: # ({ae3ff74a-d9d538db}) ##### EnablePersistentBuffer アクティブアイテムのローカル永続ストレージの使用を有効にします。 永続ストレージが無効になっている場合は、メモリバッファが使用されます。 デフォルト: `0`
値: 0 - 無効, 1 - 有効 [comment]: # ({/ae3ff74a-d9d538db}) [comment]: # ({da2ce1bd-1970c2c5}) ##### ForceActiveChecksOnStart 再起動後、最初に受信した設定に対してアクティブチェックを直ちに実行します。 また、プラグインごとの設定パラメータとしても利用可能です。例: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` デフォルト: `0`
値: 0 - 無効, 1 - 有効 [comment]: # ({/da2ce1bd-1970c2c5}) [comment]: # ({70ff69c8-bce527af}) ##### HeartbeatFrequency ハートビートメッセージの間隔（秒単位）。
アクティブチェックの可用性を監視するために使用します。
0 - ハートビートメッセージを無効にします。 デフォルト: `60`
範囲: 0-3600 [comment]: # ({/70ff69c8-bce527af}) [comment]: # ({cd35abda-9d3624af}) ##### HostInterface ホストの[自動登録](/manual/discovery/auto_registration)プロセス中に使用されるホストインターフェース（IPアドレスまたはDNS名）を定義する任意のパラメータです。 この値は、新しく作成されたホストのインターフェースを設定するために使用され、IPアドレスまたはDNSアドレスのいずれかを明示的に設定できます。 詳細については、[DNSをデフォルトインターフェースとして使用する](/manual/discovery/auto_registration#using-dns-as-default-interface)を参照してください。 定義されていない場合、この値はHostInterfaceItemから取得されます。 値が255文字の制限を超えると、エージェントはエラーを出力して起動しません。 範囲: 0～255文字 [comment]: # ({/cd35abda-9d3624af}) [comment]: # ({dc29c465-7378e07f}) ##### HostInterfaceItem ホストの[自動登録](/manual/discovery/auto_registration)プロセス中に、ホストインターフェース（IPアドレスまたはDNS名）を決定するために使用されるアイテムを定義するオプションのパラメータです。 この値は、HostInterface が定義されていない場合にのみ使用されます。 詳細は、[DNSをデフォルトインターフェースとして使用する](/manual/discovery/auto_registration#using-dns-as-default-interface)を参照してください。 自動登録リクエスト中、指定されたアイテムが返す値が255文字の制限を超える場合、エージェントは警告メッセージをログに記録します。 [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) アイテムは、AllowKey/DenyKey の設定に関係なくサポートされています。 [comment]: # ({/dc29c465-7378e07f}) [comment]: # ({ed067cab-3b42353f}) ##### HostMetadata [ホストの自動登録](/manual/discovery/auto_registration)プロセス（アクティブエージェント）中にホストを識別または区別するために使用される[メタデータ](/manual/discovery/auto_registration#using-host-metadata)を定義するオプションパラメータです。 HostMetadataを使用すると、ホスト名以外でホストを区別できます。 定義されていない場合は、HostMetadataItemから値が取得されます。 指定された値が2034バイトを超える場合やUTF-8以外の文字列の場合、エージェントはエラーを出して起動しません。 パラメータがIPアドレスまたはDNS名を期待する場合、有効なUTF-8であっても有効なIPまたはDNS名でない値は無効として拒否され、報告されます。 複数行のメタデータはサポートされていません。出力は最初の改行で切り捨てられます。 範囲: 0-2034バイト [comment]: # ({/ed067cab-3b42353f}) [comment]: # ({1ef8844f-eff97518}) ##### HostMetadataItem Zabbixエージェントアイテムを定義するオプションパラメータで、[ホストメタデータ](/manual/discovery/auto_registration#using-host-metadata)の取得に使用されます。 このオプションは、HostMetadataが定義されていない場合にのみ使用されます。 HostMetadataItemの値は、各[自動登録](/manual/discovery/auto_registration)の試行時に取得され、ホストの自動登録プロセス（アクティブエージェント）でのみ使用されます。 HostMetadataItemを使用すると、ホスト名以外でホストを区別できます。 ユーザーパラメータとエイリアスがサポートされています。 [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run)アイテムは、AllowKey/DenyKeyの設定に関係なくサポートされます。 自動登録リクエスト中に、指定されたアイテムによって返される値が65535 UTF-8コードポイントの制限を超える場合、エージェントは警告メッセージをログに記録します。 アイテムによって返される値はUTF-8文字列でなければならず、そうでない場合は無視されます。 パラメータがIPアドレスまたはDNS名を期待する場合、有効なUTF-8であっても有効なIPまたはDNS名でない値は拒否され、無効として報告されます。 複数行のメタデータはサポートされていません — 出力は最初の改行で切り捨てられます。 [comment]: # ({/1ef8844f-eff97518}) [comment]: # ({39406dda-542b591a}) ##### Hostname カンマ区切りで指定された一意の大文字小文字を区別するホスト名のリスト。 アクティブチェックに必要であり、サーバーで設定されたホスト名と一致する必要があります。 未定義の場合はHostnameItemから値が取得されます。
使用可能な文字: 英数字、'.'、' '、'\_'、'-'。 最大長: ホスト名ごとに128文字、1行あたり2048文字。 デフォルト: HostnameItemで設定 [comment]: # ({/39406dda-542b591a}) [comment]: # ({77a62307-085b8ddc}) ##### HostnameItem ホスト名を取得するために使用されるアイテムを定義するオプションパラメータです。 このオプションは、Hostnameが定義されていない場合にのみ使用されます。 ユーザーパラメータやエイリアスはサポートされていませんが、AllowKey/DenyKeyの値に関係なく[system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run)アイテムはサポートされています。 デフォルト: `system.hostname` [comment]: # ({/77a62307-085b8ddc}) [comment]: # ({183802f3-d06cc342}) ##### Include 個別のファイルまたはディレクトリ内のすべてのファイルを設定ファイルに含めることができます（ZabbixエージェントがWindows MSIインストーラーパッケージを使用してインストールされた場合、デフォルトで`C:\Program Files\Zabbix Agent 2`にあります。Zabbixエージェントがzipアーカイブとしてインストールされた場合は、インストール時に指定したフォルダーにあります）。 含めるすべてのファイルは正しい構文である必要があります。そうでない場合、エージェントは起動しません。 パスは*zabbix_agent2.conf*ファイルの場所からの相対パスで指定できます（例：`Include=.\zabbix_agent2.d\plugins.d\*.conf`）。
指定したディレクトリ内の関連ファイルのみを含めるために、アスタリスクワイルドカード文字によるパターンマッチングがサポートされています。
制限事項については[特記事項](special_notes_include)を参照してください。 例: ```default Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf ``` [comment]: # ({/183802f3-d06cc342}) [comment]: # ({43e741ee-21abf7b1}) ##### ListenIP エージェントがリッスンするIPアドレスのカンマ区切りリスト。 アクティブチェックのリストを取得するためにZabbixサーバーに接続する場合、最初のIPアドレスがZabbixサーバーに送信されます。 デフォルト: `0.0.0.0` [comment]: # ({/43e741ee-21abf7b1}) [comment]: # ({5f95bc53-2f2c8140}) ##### ListenPort エージェントは、サーバーからの接続をこのポートで待ち受けします。 デフォルト: `10050`
範囲: 1024-32767 [comment]: # ({/5f95bc53-2f2c8140}) [comment]: # ({d3241aab-988826b6}) ##### LogFile エージェントのログファイル名。 デフォルト: `c:\zabbix_agent2.log`
必須: LogTypeが*file*に設定されている場合は必須、それ以外は不要 [comment]: # ({/d3241aab-988826b6}) [comment]: # ({f7604f8f-ae05fc8d}) ##### LogFileSize ログファイルの最大サイズ（MB）
0 - 自動ログローテーションを無効にします。
*注*: ログファイルのサイズ制限に達し、何らかの理由でファイルローテーションが失敗した場合、既存のログファイルは切り捨てられ、新たに開始されます。 デフォルト: `1`
範囲: 0-1024 [comment]: # ({/f7604f8f-ae05fc8d}) [comment]: # ({4226072e-e8dc6df9}) ##### LogType ログ出力の種類:
*file* - LogFile パラメータで指定されたファイルにログを書き込みます。
*console* - 標準出力にログを書き出します。 デフォルト: `file` [comment]: # ({/4226072e-e8dc6df9}) [comment]: # ({357a4f09-dde3e6b9}) ##### PersistentBufferFile Zabbix agent 2 が SQLite データベースを保持するファイル。 完全なファイル名でなければなりません。 このパラメータは、永続バッファが有効になっている場合 (*EnablePersistentBuffer=1*) のみ使用されます。 [comment]: # ({/357a4f09-dde3e6b9}) [comment]: # ({2937cc76-379dc265}) ##### PersistentBufferPeriod サーバーまたはプロキシへの接続がない場合にデータを保存する期間。 古いデータは失われます。 ログデータは保持されます。 このパラメータは、永続バッファが有効になっている場合（*EnablePersistentBuffer=1*）のみ使用されます。 デフォルト: `1h`
範囲: 1m-365d [comment]: # ({/2937cc76-379dc265}) [comment]: # ({9b0fb2d6-a2a522ee}) ##### Plugins..System.Capacity {#plugins.systemcapacity} `` プラグインごとに同時に実行できるチェックの上限。 デフォルト: `1000` 範囲: 1-1000 [comment]: # ({/9b0fb2d6-a2a522ee}) [comment]: # ({99218c04-c6daef84}) ##### Plugins.Log.MaxLinesPerSecond 'log'、'logrt'、'eventlog'のアクティブチェックを処理する際に、エージェントがZabbixサーバーまたはプロキシに1秒あたりに送信する新しい行の最大数。 指定された値は、'log'、'logrt'、'eventlog'アイテムキーで指定された'maxlines'パラメータによって上書きされます。
*注*: Zabbixは、ログアイテムで必要な文字列を検索するために、*MaxLinesPerSecond*で設定された値の10倍の新しい行を処理します。 デフォルト: `20`
範囲: 1-1000 [comment]: # ({/99218c04-c6daef84}) [comment]: # ({487e5b60-d7133c6e}) ##### Plugins.SystemRun.LogRemoteCommands 実行されたシェルコマンドを警告としてログに記録するかどうかを指定します。 コマンドはリモートで実行された場合のみログに記録されます。 system.run\[\]がHostMetadataItem、HostInterfaceItem、HostnameItemパラメータによってローカルで起動された場合、ログエントリは作成されません。 デフォルト: `0`
値: 0 - 無効、1 - 有効 [comment]: # ({/487e5b60-d7133c6e}) [comment]: # ({e879decb-c712bfb8}) ##### PluginSocket ロード可能なプラグイン通信用のWindows名前付きパイプへのパス。 デフォルト: `\\.\pipe\agent.plugin.sock` [comment]: # ({/e879decb-c712bfb8}) [comment]: # ({14afe8ce-1db534a6}) ##### PluginTimeout 読み込み可能なプラグインとの接続のタイムアウト（秒単位） デフォルト: `Timeout`
範囲: 1-30 [comment]: # ({/14afe8ce-1db534a6}) [comment]: # ({444f6259-104bd089}) ##### PerfCounter 指定された時間間隔（秒単位）に対して、システムパフォーマンスカウンタの平均値となる新しいパラメータを定義します。
構文: ,"", 例えば、過去1分間のプロセッサ割り込み回数の平均値を取得したい場合は、次のように新しいパラメータ"interrupts"を定義できます。
```default PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 ``` パフォーマンスカウンタパスの周囲に二重引用符が必要であることに注意してください。 パラメータ名（interrupts）は、アイテム作成時のアイテムキーとして使用します。 平均値を計算するためのサンプルは毎秒取得されます。
Windowsで利用可能なすべてのパフォーマンスカウンタのリストを取得するには、"typeperf -qx"を実行してください。 [comment]: # ({/444f6259-104bd089}) [comment]: # ({c2cc7bf4-b31fd405}) ##### PerfCounterEn 指定された時間間隔（秒単位）に対して、システムパフォーマンスカウンターの平均値を表す新しいパラメータを定義します。 PerfCounterと比較して、perfcounterのパスは英語でなければなりません。 **Windows Server 2008/Vista**以降でのみサポートされます。
構文: ,"", 例えば、過去1分間のプロセッサ割り込み回数の平均値を取得したい場合は、次のように新しいパラメータ"interrupts"を定義できます:
```default PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60 ``` パフォーマンスカウンターパスの周囲のダブルクォーテーションに注意してください。 パラメータ名（interrupts）は、アイテム作成時のアイテムキーとして使用します。 平均値を計算するためのサンプルは毎秒取得されます。
英語の文字列のリストは、次のレジストリキーを参照してください: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`。 [comment]: # ({/c2cc7bf4-b31fd405}) [comment]: # ({3d47a4c2-25e3871b}) ##### RefreshActiveChecks アクティブチェックのリストをリフレッシュする間隔(秒)。 アクティブチェックのリフレッシュに失敗した場合、次のリフレッシュは60秒後に試行されます。 デフォルト: `5`
範囲: 1-86400 [comment]: # ({/3d47a4c2-25e3871b}) [comment]: # ({bb2bfe8d-0ad80cbc}) ##### Server ZabbixサーバーまたはZabbixプロキシのIPアドレス(カンマ区切り、CIDR表記も可)またはDNS名のリスト。 ここに記載されたホストからの接続のみ受け付けます。 IPv6サポートが有効な場合、'127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1'は同等に扱われ、'::/0'は任意のIPv4またはIPv6アドレスを許可します。 '0.0.0.0/0'は任意のIPv4アドレスを許可するために使用できます。 スペースも許可されます。 このパラメータが指定されていない場合、パッシブチェックは無効になり、エージェントはTCPポートで待ち受けしません。 例: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` [comment]: # ({/bb2bfe8d-0ad80cbc}) [comment]: # ({56b8410d-0d31e03a}) ##### ServerActive アクティブチェックを取得するZabbixサーバー/プロキシのアドレスまたはクラスタ構成を指定します。 サーバー/プロキシのアドレスは、IPアドレスまたはDNS名と、コロンで区切ったオプションのポート番号です。
クラスタ構成は、セミコロンで区切った1つ以上のサーバーまたはプロキシグループメンバーのアドレスです。 複数のZabbixサーバー/クラスタおよびZabbixプロキシをカンマで区切って指定できます。 プロキシグループを使用しない場合、各Zabbixサーバー/クラスタから複数のZabbixプロキシを指定すべきではありません。 Zabbixプロキシを指定した場合、そのプロキシのZabbixサーバー/クラスタは指定しないでください。
複数のカンマ区切りのアドレスを指定することで、複数の独立したZabbixサーバーを並列で利用できます。 スペースも使用できます。
ポートが指定されていない場合は、デフォルトのポートが使用されます。
IPv6アドレスでホストのポートを指定する場合は、角括弧で囲む必要があります。 ポートが指定されていない場合、IPv6アドレスの角括弧は省略可能です。
このパラメータが指定されていない場合、アクティブチェックは無効になります。 Zabbixプロキシの例: ```default ServerActive=127.0.0.1:10051 ``` Zabbixプロキシグループの例: ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com 複数サーバーの例: ```default ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\] ``` 高可用性の例: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` 2つのクラスタと1つのサーバーによる高可用性の例: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/56b8410d-0d31e03a}) [comment]: # ({76194937-f96761ad}) ##### SourceIP 以下のための送信元IPアドレス: - ZabbixサーバーまたはZabbixプロキシへの外部接続 - 一部のアイテム(web.page.get、net.tcp.portなど)を実行する際の接続 [comment]: # ({/76194937-f96761ad}) [comment]: # ({7d3f343b-8b9a658a}) ##### StatusPort 設定されている場合、エージェントはこのポートでHTTPステータスリクエスト（http://localhost:/status）を待受します。 範囲: 1024-32767 [comment]: # ({/7d3f343b-8b9a658a}) [comment]: # ({37e987ac-baa42b03}) ##### Timeout Zabbixプロキシまたはサーバーとの接続確立およびデータ交換を待機する時間（秒単位）を指定します。
このパラメータは、以下を含むさまざまな通信操作の期間を定義します。 - Zabbixサーバーからの応答を待つ - アイテム設定リクエストや[アクティブチェック](/manual/appendix/items/activepassive#active-checks)でのアイテムデータなど、Zabbixサーバーへのリクエスト送信 - logfileまたはWindowsイベントログ監視によるログデータの取得 - ハートビートメッセージの送信 - `vfs.*`チェックの最大継続時間 - タイムアウトなしでチェックを送信するバージョン7.0より前のサーバーまたはプロキシからのフォールバックとして機能 このタイムアウトは、フロントエンドでタイムアウト設定が可能なエージェントチェック（グローバル、プロキシ、またはアイテム単位）には**使用されません**。 デフォルト: `3`
範囲: 1-30 [comment]: # ({/37e987ac-baa42b03}) [comment]: # ({2200adc7-5fffe23e}) ##### TLSAccept 受け入れる着信接続。 パッシブチェックに使用されます。 複数の値をカンマで区切って指定できます。
*unencrypted* - 暗号化なしの接続を受け入れる（デフォルト）
*psk* - TLSおよび事前共有鍵（PSK）による接続を受け入れる
*cert* - TLSおよび証明書による接続を受け入れる 必須: TLS証明書またはPSKパラメータが定義されている場合は必須（*unencrypted*接続の場合でも）。それ以外の場合は不要 [comment]: # ({/2200adc7-5fffe23e}) [comment]: # ({65d07bda-01a58fb9}) ##### TLSCAFile Zabbix コンポーネント間の暗号化通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名 [comment]: # ({/65d07bda-01a58fb9}) [comment]: # ({005f60f1-64ff2b38}) ##### TLSCertFile Zabbix コンポーネントとの暗号化通信に使用されるエージェント証明書または証明書チェーンを含むファイルのフルパス名 [comment]: # ({/005f60f1-64ff2b38}) [comment]: # ({22f70994-63d2a63f}) ##### TLSCipherAll13 OpenSSL暗号文字列（TLS 1.3）。 証明書およびPSKベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/22f70994-63d2a63f}) [comment]: # ({f390777c-4312ca04}) ##### TLSCipherCert13 OpenSSL暗号文字列（TLS 1.3）。 証明書ベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 このパラメータは`TLSAccept=cert,psk`と一緒に使用できないことに注意してください。証明書接続（`TLSConnect=cert`）の場合は、代わりにTLSCipherAll13を使用してください。 [comment]: # ({/f390777c-4312ca04}) [comment]: # ({07c8874d-6944686a}) ##### TLSCipherPSK13 OpenSSLの暗号文字列（TLS 1.3）。 PSKベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/07c8874d-6944686a}) [comment]: # ({e2ebc18f-0c14341a}) ##### TLSConnect エージェントがZabbixサーバーまたはプロキシにどのように接続するか。 アクティブチェックで使用されます。 1つの値のみ指定できます:
*unencrypted* - 暗号化せずに接続（デフォルト）
*psk* - TLSおよび事前共有鍵（PSK）を使用して接続
*cert* - TLSおよび証明書を使用して接続 必須: TLS証明書またはPSKパラメータが定義されている場合は必須（*unencrypted*接続でも）; それ以外は不要 [comment]: # ({/e2ebc18f-0c14341a}) [comment]: # ({ad4dc889-353fa6b2}) ##### TLSCRLFile 失効した証明書を含むファイルのフルパス名です。 このパラメータは、Zabbixコンポーネント間の暗号化通信に使用されます。 [comment]: # ({/ad4dc889-353fa6b2}) [comment]: # ({c2aa4315-40db7da5}) ##### TLSKeyFile Zabbix コンポーネント間の暗号化通信に使用されるエージェント秘密鍵を含むファイルのフルパス名 [comment]: # ({/c2aa4315-40db7da5}) [comment]: # ({11defa44-216346d5}) ##### TLSPSKFile Zabbix サーバーとの暗号化通信に使用されるエージェントの事前共有キーを含むファイルのフルパス名 [comment]: # ({/11defa44-216346d5}) [comment]: # ({92d3eff0-d9d037af}) ##### TLSPSKIdentity Zabbixサーバーとの暗号化通信に使用される、事前共有キーのID文字列 [comment]: # ({/92d3eff0-d9d037af}) [comment]: # ({ae5c568f-4a08c667}) ##### TLSServerCertIssuer 許可されたサーバー（プロキシ）証明書の発行者 [comment]: # ({/ae5c568f-4a08c667}) [comment]: # ({fb69617f-6446ac76}) ##### TLSServerCertSubject 許可されたサーバー（プロキシ）証明書のサブジェクト [comment]: # ({/fb69617f-6446ac76}) [comment]: # ({8fffe818-42a95de3}) ##### UnsafeUserParameters ユーザー定義パラメータの引数に、すべての文字を渡せるようにします。 次の文字は使用できません: \\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @
さらに、改行文字も使用できません。 デフォルト: `0`
値: 0 - 許可しない、1 - 許可する [comment]: # ({/8fffe818-42a95de3}) [comment]: # ({e817d9a2-cba7618d}) ##### UserParameter 監視するユーザー定義パラメータ。 ユーザー定義パラメータは複数指定できます。
フォーマット: UserParameter=<キー>,<シェルコマンド>
シェルコマンドは空文字列やEOLのみを返してはいけません。 UserParameterDirパラメータが指定されている場合、シェルコマンドは相対パスを持つことができます。 例: ```default UserParameter=system.test,dir /b | find /c /v "" UserParameter=check_cpu,.\custom\_script.bat ``` [comment]: # ({/e817d9a2-cba7618d}) [comment]: # ({c9cc7c82-f6be7620}) ##### UserParameterDir UserParameterコマンドのデフォルトの検索パスです。 使用する場合、エージェントはコマンドを実行する前にここで指定された作業ディレクトリに変更します。 これにより、UserParameterコマンドはフルパスの代わりに相対的な`.\`プレフィックスを持つことができます。
1つのエントリのみ許可されます。 例: ```default UserParameterDir=C:\opt\myscripts ``` [comment]: # ({/c9cc7c82-f6be7620})