[comment]: # attributes: notoc [comment]: # ({4963afdf-4963afdf}) # 6 Zabbix エージェント 2 (Windows) [comment]: # ({/4963afdf-4963afdf}) [comment]: # ({00c81087-9fe069f9}) ### 概要 Zabbix エージェント 2 は Zabbix エージェントの新世代版であり、Zabbix エージェントの代わりに使用できます。 Windows 版 Zabbix エージェント 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 エージェント 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 コマンドの既定の検索パス。| すべてのパラメーターは、明示的に必須と記載されていない限り必須ではありません。 注意: - 既定値は、配布される設定ファイル内の値ではなく、プロセスの既定値を反映しています。 - Zabbix は、[BOM](https://en.wikipedia.org/wiki/Byte_order_mark) なしの UTF-8 エンコーディングの設定ファイルのみをサポートします。 - `\#` で始まるコメントは、行頭でのみサポートされます。
[comment]: # ({/00c81087-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** を使用する複数のディスカバリルールを設定できるようになります。たとえば、**vfs.fs.discovery[foo]**、**vfs.fs.discovery[bar]** などです。 [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 [ホストメタデータ](/manual/discovery/auto_registration#using-host-metadata)の取得に使用するZabbixエージェントのアイテムを定義するオプションのパラメータです。 このオプションは、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文字、行全体で2048文字 デフォルト: HostnameItem によって設定 [comment]: # ({/39406dda-542b591a}) [comment]: # ({77a62307-085b8ddc}) ##### HostnameItem ホスト名の取得に使用するアイテムを定義するオプションのパラメータです。 このオプションは、Hostname が定義されていない場合にのみ使用されます。 User parameters または aliases はサポートされませんが、[system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) アイテムは AllowKey/DenyKey の値に関係なくサポートされます。 デフォルト: `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アドレスのリストです。 接続する場合、アクティブチェックのリストを取得するために、最初の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エージェント 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' のアクティブチェックを処理する際に、1秒あたりに Zabbix サーバーまたはプロキシへ送信する新しい行の最大数です。 指定した値は、'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-69cf2ccd}) ##### PerfCounter 指定した期間 （秒）におけるシステムパフォーマンスカウンター の平均値となる新しいパラメータ を定義します。
構文: ,"", たとえば、直近1分間の1秒あたりのプロセッサ割り込み数の平均を取得したい場合は、次のように新しいパラメータ "interrupts" を定義できます。
```default PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 ``` パフォーマンスカウンターパスを二重引用符で囲んでいる点に注意してください。 パラメータ名（interrupts）は、アイテムを作成する際にアイテムキーとして使用します。 平均値を計算するためのサンプルは1秒ごとに取得されます。
Windowsで利用可能なすべてのパフォーマンスカウンターの一覧を取得するには、"typeperf -qx" を実行してください。 [comment]: # ({/444f6259-69cf2ccd}) [comment]: # ({c2cc7bf4-e983c97e}) ##### PerfCounterEn 指定した期間 （秒）におけるシステムパフォーマンスカウンター の平均値となる新しいパラメータ を定義します。 PerfCounter と比較して、perfcounter パスは英語である必要があります。 **Windows Server 2008/Vista** 以降でのみサポートされています。
構文: ,"", 例えば、直近 1 分間の 1 秒あたりのプロセッサ割り込み数の平均を受信したい場合、次のように新しいパラメータ "interrupts" を定義できます。
```default PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60 ``` パフォーマンスカウンターパスが二重引用符で囲まれていることに注意してください。 パラメータ名（interrupts）は、アイテムを作成する際のアイテムキーとして使用します。 平均値を計算するためのサンプルは 1 秒ごとに取得されます。
英語文字列の一覧は、次のレジストリキーを参照することで確認できます: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`。 [comment]: # ({/c2cc7bf4-e983c97e}) [comment]: # ({3d47a4c2-25e3871b}) ##### RefreshActiveChecks アクティブチェックのリストを更新する間隔を秒単位で指定します。 アクティブチェックの更新に失敗した場合、次回の更新は60秒後に試行されます。 デフォルト: `5`
範囲: 1-86400 [comment]: # ({/3d47a4c2-25e3871b}) [comment]: # ({bb2bfe8d-0ad80cbc}) ##### サーバー 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サーバーからの応答待機; - Zabbixサーバーへのリクエスト送信（アイテム設定のリクエストおよび[アクティブチェック](/manual/appendix/items/activepassive#active-checks)におけるアイテムデータの送信を含む）; - logfile または Windowsイベントログ監視によるログデータの取得; - ハートビートメッセージの送信; - `vfs.*` チェックの最大継続時間; - バージョン7.0より前のサーバーまたはプロキシがタイムアウトなしでチェックを送信する場合のフォールバックとしての使用。 このタイムアウトは、Webインターフェースでタイムアウト設定を構成できるエージェントチェック（グローバル、プロキシ、またはアイテム単位）には**使用されません**。 デフォルト: `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]: # ({a467b58d-fd228a11}) ##### TLSCipherAll13 OpenSSLの暗号文字列（TLS 1.3）。 証明書ベースおよびPSKベースの暗号化に対する、デフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` このパラメータは、Zabbix 7.0.4以降でサポートされています。 [comment]: # ({/a467b58d-fd228a11}) [comment]: # ({8e8a68b3-2900b2ec}) ##### TLSCipherCert13 OpenSSLの暗号文字列（TLS 1.3）です。 証明書ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。 このパラメータは `TLSAccept=cert,psk` と同時に使用できないことに注意してください。証明書接続（`TLSConnect=cert`）には、代わりに TLSCipherAll13 を使用してください。 このパラメータは Zabbix 7.0.4 以降でサポートされています。 [comment]: # ({/8e8a68b3-2900b2ec}) [comment]: # ({6cb7784a-e8316817}) ##### TLSCipherPSK13 OpenSSLの暗号文字列（TLS 1.3）。 PSKベースの暗号化に対するデフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` このパラメータは、Zabbix 7.0.4以降でサポートされています。 [comment]: # ({/6cb7784a-e8316817}) [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サーバーとの暗号化通信に使用される、事前共有キーの文字列 [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})