[comment]: # attributes: notoc [comment]: # ({c52b2df3-c52b2df3}) # 3 Zabbix エージェント (UNIX) [comment]: # ({/c52b2df3-c52b2df3}) [comment]: # ({069cb6ac-2773fc24}) ### 概要 Zabbixエージェントの設定ファイル（zabbix_agentd.conf）でサポートされているパラメータをこのセクションに一覧表示します。 パラメータは追加情報なしでリストされています。 パラメータをクリックすると、詳細情報が表示されます。 |パラメータ|説明| |--|--------| |[Alias](#alias)|アイテムキーのエイリアスを設定します。| |[AllowKey](#allowkey)|パターンに一致するアイテムキーの実行を許可します。| |[AllowRoot](#allowroot)|エージェントを 'root' として実行することを許可します。| |[BufferSend](#buffersend)|バッファ内のデータをN秒以上保持しません。| |[BufferSize](#buffersize)|メモリバッファ内の値の最大数です。| |[DebugLevel](#debuglevel)|デバッグレベルです。| |[DenyKey](#denykey)|パターンに一致するアイテムキーの実行を拒否します。| |[EnableRemoteCommands](#enableremotecommands)|Zabbixサーバーからのリモートコマンドを許可するかどうか。| |[HeartbeatFrequency](#heartbeatfrequency)|ハートビートメッセージの頻度（秒単位）です。| |[HostInterface](#hostinterface)|ホストインターフェースを定義するオプションパラメータです。| |[HostInterfaceItem](#hostinterfaceitem)|ホストインターフェースを取得するために使用するアイテムを定義するオプションパラメータです。| |[HostMetadata](#hostmetadata)|ホストメタデータを定義するオプションパラメータです。| |[HostMetadataItem](#hostmetadataitem)|ホストメタデータを取得するために使用するZabbixエージェントアイテムを定義するオプションパラメータです。| |[Hostname](#hostname)|ホスト名を定義するオプションパラメータです。| |[HostnameItem](#hostnameitem)|ホスト名を取得するために使用するZabbixエージェントアイテムを定義するオプションパラメータです。| |[Include](#include)|個別のファイルまたはディレクトリ内のすべてのファイルを設定ファイルに含めることができます。| |[ListenBacklog](#listenbacklog)|TCPキュー内の保留中の接続の最大数です。| |[ListenIP](#listenip)|エージェントがリッスンするカンマ区切りのIPアドレスのリストです。| |[ListenPort](#listenport)|エージェントはこのポートでサーバーからの接続を待ち受けます。| |[LoadModule](#loadmodule)|エージェント起動時にロードするモジュールです。| |[LoadModulePath](#loadmodulepath)|エージェントモジュールの場所へのフルパスです。| |[LogFile](#logfile)|ログファイル名です。| |[LogFileSize](#logfilesize)|ログファイルの最大サイズです。| |[LogRemoteCommands](#logremotecommands)|実行されたシェルコマンドを警告としてログに記録します。| |[LogType](#logtype)|ログ出力のタイプです。| |[MaxLinesPerSecond](#maxlinespersecond)|'log'および'logrt'のアクティブチェックを処理する際に、エージェントが1秒あたりにZabbixサーバーまたはプロキシに送信する新しい行の最大数です。| |[PidFile](#pidfile)|PIDファイル名です。| |[RefreshActiveChecks](#refreshactivechecks)|アクティブチェックのリストを更新する頻度です。| |[Server](#server)|カンマ区切りのIPアドレス（CIDR表記も可）、またはZabbixサーバーおよびZabbixプロキシのDNS名のリストです。| |[ServerActive](#serveractive)|アクティブチェックを取得するためのZabbixサーバー/プロキシのアドレスまたはクラスタ設定です。| |[SourceIP](#sourceip)|送信元IPアドレスです。| |[StartAgents](#startagents)|パッシブチェックを処理するzabbix_agentdの事前フォークインスタンス数です。| |[Timeout](#timeout)|Zabbixプロキシまたはサーバーとの接続確立およびデータ交換を待機する秒数を指定します。| |[TLSAccept](#tlsaccept)|受け入れる着信接続の種類です。| |[TLSCAFile](#tlscafile)|ピア証明書の検証に使用する、最上位CA証明書を含むファイルのフルパス名です。Zabbixコンポーネント間の暗号化通信に使用されます。| |[TLSCertFile](#tlscertfile)|エージェント証明書または証明書チェーンを含むファイルのフルパス名です。Zabbixコンポーネント間の暗号化通信に使用されます。| |[TLSCipherAll](#tlscipherall)|GnuTLSの優先文字列またはOpenSSL（TLS 1.2）の暗号文字列です。証明書およびPSKベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSCipherAll13](#tlscipherall13)|TLS 1.3でのOpenSSL 1.1.1以降の暗号文字列です。証明書およびPSKベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSCipherCert](#tlsciphercert)|GnuTLSの優先文字列またはOpenSSL（TLS 1.2）の暗号文字列です。証明書ベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSCipherCert13](#tlsciphercert13)|TLS 1.3でのOpenSSL 1.1.1以降の暗号文字列です。証明書ベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSCipherPSK](#tlscipherpsk)|GnuTLSの優先文字列またはOpenSSL（TLS 1.2）の暗号文字列です。PSKベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSCipherPSK13](#tlscipherpsk13)|TLS 1.3でのOpenSSL 1.1.1以降の暗号文字列です。PSKベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。| |[TLSConnect](#tlsconnect)|エージェントがZabbixサーバーまたはプロキシにどのように接続するか。| |[TLSCRLFile](#tlscrlfile)|失効した証明書を含むファイルのフルパス名です。このパラメータはZabbixコンポーネント間の暗号化通信に使用されます。| |[TLSKeyFile](#tlskeyfile)|エージェントの秘密鍵を含むファイルのフルパス名です。Zabbixコンポーネント間の暗号化通信に使用されます。| |[TLSPSKFile](#tlspskfile)|Zabbixサーバーとの暗号化通信に使用する、エージェントの事前共有鍵を含むファイルのフルパス名です。| |[TLSPSKIdentity](#tlspskidentity)|Zabbixサーバーとの暗号化通信に使用する事前共有鍵の識別文字列です。| |[TLSServerCertIssuer](#tlsservercertissuer)|許可されるサーバー（プロキシ）の証明書発行者です。| |[TLSServerCertSubject](#tlsservercertsubject)|許可されるサーバー（プロキシ）の証明書サブジェクトです。| |[UnsafeUserParameters](#unsafeuserparameters)|ユーザー定義パラメータへの引数にすべての文字を渡すことを許可します。| |[User](#user)|システム上の特定の既存ユーザーに権限をドロップします。| |[UserParameter](#userparameter)|監視するユーザー定義パラメータです。| |[UserParameterDir](#userparameterdir)|UserParameterコマンドのデフォルトの検索パスです。| パラメータが必須であると明示的に記載されていない限り、すべてのパラメータは必須ではありません。 注意: - デフォルト値はデーモンのデフォルト値を反映しており、配布されている設定ファイルの値ではありません。 - 値は[環境変数](/manual/appendix/config/environment_variables)をサポートします。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみの設定ファイルをサポートします。 - "\#"で始まるコメントは行頭のみサポートされます。 [comment]: # ({/069cb6ac-2773fc24}) [comment]: # ({8085875f-bb271b3c}) ### パラメータの詳細 [comment]: # ({/8085875f-bb271b3c}) [comment]: # ({f3842378-20d32ed1}) ##### Alias アイテムキーのエイリアスを設定します。 長くて複雑なアイテムキーを、より短くてシンプルなものに置き換えるために使用できます。
複数の*Alias*パラメータを指定できます。 同じ*Alias*キーの複数のパラメータは許可されていません。
異なる*Alias*キーが同じアイテムキーを参照することができます。
エイリアスは*HostMetadataItem*で使用できますが、*HostnameItem*パラメータでは使用できません。 例1: ユーザー'zabbix'のIDを取得する。 ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` これで、**zabbix.userid**の短縮キーを使用してデータを取得できます。 例2: デフォルトおよびカスタムパラメータでCPU使用率を取得する。 ```default 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)ルールを実行する。 ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` これで、**vfs.fs.discovery**を使用して、各ルールに異なるパラメータ(**vfs.fs.discovery[foo]**、**vfs.fs.discovery[bar]**など)で複数のディスカバリルールを設定できるようになりました。 [comment]: # ({/f3842378-20d32ed1}) [comment]: # ({3ed0c834-f52682cc}) ##### AllowKey パターンに一致するアイテムキーの実行を許可します。 キーのパターンはワイルドカード式であり、"\*" 文字を使用して任意の文字列に一致させることができます。
DenyKeyと組み合わせて複数のキー一致ルールを定義できます。 パラメータは、記述された順に1つずつ処理されます。 参考: [エージェントチェックの制限](/manual/config/items/restrict_checks) [comment]: # ({/3ed0c834-f52682cc}) [comment]: # ({f4e3ae7a-a02d0dc0}) ##### AllowRoot エージェントを 'root' として実行することを許可します。 無効にした場合、エージェントが 'root' によって開始された場合、代わりに 'zabbix' ユーザーに切り替えようとします。 通常のユーザーで開始した場合は効果がありません。 デフォルト: `0`
値: 0 - 許可しない; 1 - 許可する [comment]: # ({/f4e3ae7a-a02d0dc0}) [comment]: # ({fce8e2ee-12f60552}) ##### BufferSend N秒を超えてバッファ内にデータを保持しません。 デフォルト: `5`
範囲: 1-3600 [comment]: # ({/fce8e2ee-12f60552}) [comment]: # ({3033154f-397065ee}) ##### BufferSize メモリバッファ内の値の最大数。 バッファがいっぱいになると、エージェントは収集したすべてのデータをZabbixサーバーまたはプロキシに送信します。 デフォルト: `100`
範囲: 2-65535 [comment]: # ({/3033154f-397065ee}) [comment]: # ({9c071f70-e5288ea7}) ##### DebugLevel デバッグレベルを指定します。
*0* - Zabbix プロセスの起動と停止に関する基本情報
*1* - 重要な情報
*2* - エラー情報
*3* - 警告
*4* - デバッグ用（多くの情報を生成します）
*5* - 拡張デバッグ（さらに多くの情報を生成します） デフォルト: `3`
範囲: 0-5 [comment]: # ({/9c071f70-e5288ea7}) [comment]: # ({26eddabd-ef1d8b77}) ##### DenyKey パターンに一致するアイテムキーの実行を拒否します。 キーのパターンはワイルドカード式であり、"\*" 文字を使用して任意の文字列に一致させることができます。
AllowKeyと組み合わせて複数のキー一致ルールを定義できます。 パラメータは、記述順に1つずつ処理されます。 参考: [エージェントチェックの制限](/manual/config/items/restrict_checks) [comment]: # ({/26eddabd-ef1d8b77}) [comment]: # ({80a7ec45-50dcbfc8}) ##### EnableRemoteCommands Zabbixサーバーからのリモートコマンドを許可するかどうか。 このパラメータは**非推奨**です。代わりにAllowKey=system.run\[\*\]またはDenyKey=system.run\[\*\]を使用してください。
値に応じてAllowKey/DenyKeyパラメータの内部エイリアスです。
0 - DenyKey=system.run\[\*\]
1 - AllowKey=system.run\[\*\] デフォルト: `0`
値: 0 - 許可しない, 1 - 許可する [comment]: # ({/80a7ec45-50dcbfc8}) [comment]: # ({70ff69c8-764c3d3c}) ##### HeartbeatFrequency ハートビートメッセージの頻度（秒単位）。 アクティブチェックの可用性を監視するために使用されます。
0 - ハートビートメッセージを無効にします。 デフォルト: `60`
範囲: 0-3600 [comment]: # ({/70ff69c8-764c3d3c}) [comment]: # ({cd35abda-e514f4a5}) ##### 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-e514f4a5}) [comment]: # ({dc29c465-4965ac2b}) ##### 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-4965ac2b}) [comment]: # ({ed067cab-42990e42}) ##### 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-42990e42}) [comment]: # ({b83b65c3-953ee255}) ##### 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]: # ({/b83b65c3-953ee255}) [comment]: # ({39406dda-79d09548}) ##### Hostname カンマ区切りの一意で大文字と小文字を区別するホスト名のリスト。 アクティブチェックに必要で、サーバーで設定されたホスト名と一致する必要があります。 未定義の場合はHostnameItemから値が取得されます。
使用可能な文字: 英数字、'.'、' '、'\_'、'-' 最大長: ホスト名ごとに128文字、1行全体で2048文字。 デフォルト: HostnameItemで設定 [comment]: # ({/39406dda-79d09548}) [comment]: # ({5dd0215d-14aaef49}) ##### HostnameItem ホスト名を取得するために使用されるZabbixエージェントアイテムを定義するオプションパラメータです。 このオプションは、Hostnameが定義されていない場合にのみ使用されます。 ユーザーパラメータやエイリアスはサポートされていませんが、AllowKey/DenyKeyの値に関係なく[system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run)アイテムはサポートされています。 デフォルト: `system.hostname` [comment]: # ({/5dd0215d-14aaef49}) [comment]: # ({3ae9ed9c-1e31f1b3}) ##### Include 個々のファイルまたはディレクトリ内のすべてのファイルを設定ファイルに含めることができます。 指定したディレクトリ内の関連ファイルのみを含めるために、パターンマッチング用のアスタリスクワイルドカード文字がサポートされています。
制限事項については[特記事項](special_notes_include)を参照してください。 例: ```default Include=/absolute/path/to/config/files/*.conf ``` [comment]: # ({/3ae9ed9c-1e31f1b3}) [comment]: # ({fcd70e26-d49e31a2}) ##### ListenBacklog TCP キュー内の保留中の接続の最大数。
デフォルト値はシステムに依存するハードコードされた定数です。
サポートされる最大値はシステムに依存し、値が大きすぎる場合は'実装で指定された最大値' で自動的に切り捨てられる場合があります。 デフォルト: `SOMAXCONN`
範囲: 0 - INT\_MAX [comment]: # ({/fcd70e26-d49e31a2}) [comment]: # ({35f278c7-62349c68}) ##### ListenIP エージェントが待受するIPアドレスのカンマ区切りリスト デフォルト: `0.0.0.0` [comment]: # ({/35f278c7-62349c68}) [comment]: # ({5f95bc53-e99b72c0}) ##### ListenPort エージェントは、サーバーからの接続をこのポートで待受します。 デフォルト: `10050`
範囲: 1024-32767 [comment]: # ({/5f95bc53-e99b72c0}) [comment]: # ({f4dfc794-fb75d239}) ##### LoadModule エージェントの起動時にロードするモジュール。 モジュールは、エージェントの機能を拡張するために使用されます。 モジュールは、LoadModulePathで指定されたディレクトリに配置するか、モジュール名の前にパスを付ける必要があります。 先頭のパスが絶対パス（'/'で始まる）場合は、LoadModulePathは無視されます。
フォーマット:
LoadModule=
LoadModule=
LoadModule=
複数のLoadModuleパラメータを含めることができます。 [comment]: # ({/f4dfc794-fb75d239}) [comment]: # ({b88f1651-bd604c99}) ##### LoadModulePath エージェントモジュールの場所へのフルパス。 デフォルトはコンパイルオプションによって異なります。 [comment]: # ({/b88f1651-bd604c99}) [comment]: # ({ce9b40ca-bb5252d8}) ##### LogFile ログファイル名 必須: LogType が *file* に設定されている場合は必須、それ以外の場合は必須ではありません。 [comment]: # ({/ce9b40ca-bb5252d8}) [comment]: # ({f7604f8f-778f1edc}) ##### LogFileSize ログファイルの最大サイズ（MB）
0 - 自動ログローテーションを無効にします。
*注*: ログファイルのサイズ制限に達し、何らかの理由でファイルローテーションが失敗した場合、既存のログファイルは切り捨てられ、新たに開始されます。 デフォルト: `1`
範囲: 0-1024 [comment]: # ({/f7604f8f-778f1edc}) [comment]: # ({0dac5c2b-3d97cc10}) ##### LogRemoteCommands 実行されたシェルコマンドを警告としてログに記録するかどうかを設定します。 コマンドはリモートで実行された場合のみログに記録されます。 system.run\[\]がHostMetadataItem、HostInterfaceItem、HostnameItemパラメータによってローカルで起動された場合は、ログエントリは作成されません。 デフォルト: `0`
値: 0 - 無効、1 - 有効 [comment]: # ({/0dac5c2b-3d97cc10}) [comment]: # ({ae46be35-9d26f327}) ##### LogType ログ出力の種類:
*file* - LogFile パラメータで指定されたファイルにログを書き込みます。
*system* - syslog にログを書き込みます。
*console* - 標準出力にログを書き込みます。 デフォルト: `file` [comment]: # ({/ae46be35-9d26f327}) [comment]: # ({8e341c19-7d39adb8}) ##### MaxLinesPerSecond 'log'および'logrt'のアクティブチェックを処理する際に、エージェントがZabbixサーバーまたはプロキシに1秒あたりに送信する新しい行の最大数。 指定された値は、'log'または'logrt'アイテムキーで指定された'maxlines'パラメータによって上書きされます。
*注*: Zabbixは、ログアイテムで必要な文字列を検索するために、*MaxLinesPerSecond*で設定された値の10倍の新しい行を処理します。 デフォルト: `20`
範囲: 1-1000 [comment]: # ({/8e341c19-7d39adb8}) [comment]: # ({3d558d6c-8a5c9259}) ##### PidFile PIDファイルの名前 デフォルト: `/tmp/zabbix_agentd.pid` [comment]: # ({/3d558d6c-8a5c9259}) [comment]: # ({3d47a4c2-b62afa60}) ##### RefreshActiveChecks アクティブチェックのリストをリフレッシュする間隔(秒)。 アクティブチェックのリフレッシュに失敗した場合、次のリフレッシュは60秒後に試行されます。 デフォルト: `5`
範囲: 1-86400 [comment]: # ({/3d47a4c2-b62afa60}) [comment]: # ({b967fca0-46329efe}) ##### 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アドレスを許可できます。 「IPv4互換IPv6アドレス」（0000::/96プレフィックス）はサポートされていますが、[RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5)で非推奨となっています。 スペースも許可されます。 例: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` 必須: StartAgentsが明示的に0に設定されていない場合は必須 [comment]: # ({/b967fca0-46329efe}) [comment]: # ({a0948b80-d6a09b20}) ##### 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]: # ({/a0948b80-d6a09b20}) [comment]: # ({76194937-020cc066}) ##### SourceIP 以下のための送信元IPアドレス: - ZabbixサーバーまたはZabbixプロキシへの外部接続 - 一部のアイテム（web.page.get、net.tcp.portなど）を実行する際の接続 [comment]: # ({/76194937-020cc066}) [comment]: # ({8e63fa32-6e2d3567}) ##### StartAgents パッシブチェックを処理するzabbix\_agentdの事前フォークインスタンス数。 0に設定するとパッシブチェックが無効になり、エージェントはTCPポートで待ち受けしません。 デフォルト: `10`
範囲: 0-100 [comment]: # ({/8e63fa32-6e2d3567}) [comment]: # ({b0f05ae1-ee64bcdf}) ##### Timeout Zabbixプロキシまたはサーバーとの接続確立およびデータ交換を待機する時間（秒単位）を指定します。
このパラメータは、以下を含むさまざまな通信操作の期間を定義します。 - Zabbixサーバーからの応答を待つ - アイテム設定リクエストや[アクティブチェック](/manual/appendix/items/activepassive#active-checks)のアイテムデータなど、Zabbixサーバーへのリクエスト送信 - logfileを介したログデータの取得 - ハートビートメッセージの送信 - `vfs.*`チェックの最大継続時間 - Zabbixエージェントモジュールによる使用 - タイムアウトなしでチェックを送信するバージョン7.0より前のサーバーまたはプロキシからのフォールバックとして機能 このタイムアウトは、フロントエンドでタイムアウト設定が可能なエージェントチェック（グローバル、プロキシ、またはアイテム単位）には**使用されません**。 デフォルト: `3`
範囲: 1-30 [comment]: # ({/b0f05ae1-ee64bcdf}) [comment]: # ({613f7954-849f8496}) ##### TLSAccept 受け入れる着信接続の種類。 パッシブチェックに使用されます。 複数の値をカンマで区切って指定できます。
*unencrypted* - 暗号化なしの接続を受け入れる（デフォルト）
*psk* - TLSおよび事前共有鍵（PSK）による接続を受け入れる
*cert* - TLSおよび証明書による接続を受け入れる 必須: TLS証明書またはPSKパラメータが定義されている場合は必須（*unencrypted*接続でも必須）、それ以外は不要 [comment]: # ({/613f7954-849f8496}) [comment]: # ({65d07bda-336a620d}) ##### TLSCAFile Zabbix コンポーネント間の暗号化通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名 [comment]: # ({/65d07bda-336a620d}) [comment]: # ({005f60f1-185ad3c6}) ##### TLSCertFile Zabbix コンポーネントとの暗号化通信に使用されるエージェント証明書または証明書チェーンを含むファイルのフルパス名 [comment]: # ({/005f60f1-185ad3c6}) [comment]: # ({84033417-3e9bf2b8}) ##### TLSCipherAll GnuTLSの優先順位文字列またはOpenSSL（TLS 1.2）の暗号文字列。 証明書およびPSKベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/84033417-3e9bf2b8}) [comment]: # ({a9e7f94f-03e7f520}) ##### TLSCipherAll13 TLS 1.3でのOpenSSL 1.1.1以降の暗号文字列。 証明書ベースおよびPSKベースの暗号化のデフォルトの暗号スイート選択基準を上書きします。 GnuTLSの例: ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509 ``` OpenSSLの例: ``` EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/a9e7f94f-03e7f520}) [comment]: # ({00c9e2e3-f7468437}) ##### TLSCipherCert GnuTLSの優先度文字列またはOpenSSL（TLS 1.2）の暗号文字列。 証明書ベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 GnuTLSの例: ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509 ``` OpenSSLの例: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128 ``` [comment]: # ({/00c9e2e3-f7468437}) [comment]: # ({fdf185a8-717d9f51}) ##### TLSCipherCert13 TLS 1.3でOpenSSL 1.1.1以降の暗号文字列。 証明書ベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 [comment]: # ({/fdf185a8-717d9f51}) [comment]: # ({c201c168-3a633a0a}) ##### TLSCipherPSK GnuTLSの優先順位文字列またはOpenSSL（TLS 1.2）の暗号文字列。 PSKベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 GnuTLSの例: ```default NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL ``` OpenSSLの例: ```default kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/c201c168-3a633a0a}) [comment]: # ({c74deda4-8208c770}) ##### TLSCipherPSK13 TLS 1.3でOpenSSL 1.1.1以降の暗号文字列。 PSKベースの暗号化のためのデフォルトの暗号スイート選択基準を上書きします。 例: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/c74deda4-8208c770}) [comment]: # ({e2ebc18f-b1151069}) ##### TLSConnect エージェントがZabbixサーバーまたはプロキシにどのように接続するかを指定します。 アクティブチェックで使用されます。 1つの値のみ指定できます:
*unencrypted* - 暗号化せずに接続（デフォルト）
*psk* - TLSと事前共有鍵（PSK）を使用して接続
*cert* - TLSと証明書を使用して接続 必須: TLS証明書またはPSKパラメータが定義されている場合は必須（*unencrypted*接続でも）; それ以外は不要 [comment]: # ({/e2ebc18f-b1151069}) [comment]: # ({ad4dc889-28aef301}) ##### TLSCRLFile 失効した証明書を含むファイルのフルパス名です。 このパラメータは、Zabbixコンポーネント間の暗号化通信に使用されます。 [comment]: # ({/ad4dc889-28aef301}) [comment]: # ({c2aa4315-cbcbba0a}) ##### TLSKeyFile Zabbix コンポーネント間の暗号化通信に使用されるエージェント秘密鍵を含むファイルのフルパス名 [comment]: # ({/c2aa4315-cbcbba0a}) [comment]: # ({11defa44-845f5b70}) ##### TLSPSKFile Zabbix サーバーとの暗号化通信に使用されるエージェントの事前共有キーを含むファイルのフルパス名 [comment]: # ({/11defa44-845f5b70}) [comment]: # ({92d3eff0-b02e4942}) ##### TLSPSKIdentity Zabbixサーバーとの暗号化通信に使用される、事前共有キーのID文字列 [comment]: # ({/92d3eff0-b02e4942}) [comment]: # ({ae5c568f-7a78525c}) ##### TLSServerCertIssuer 許可されたサーバー（プロキシ）証明書の発行者 [comment]: # ({/ae5c568f-7a78525c}) [comment]: # ({fb69617f-c8d1ac8b}) ##### TLSServerCertSubject 許可されたサーバー（プロキシ）証明書のサブジェクト [comment]: # ({/fb69617f-c8d1ac8b}) [comment]: # ({bac62bc8-676eb24d}) ##### UnsafeUserParameters ユーザー定義パラメータの引数にすべての文字を渡すことを許可します。 次の文字は許可されません: \\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @ %
さらに、改行文字も許可されません。 デフォルト: `0`
値: 0 - 許可しない、1 - 許可する [comment]: # ({/bac62bc8-676eb24d}) [comment]: # ({ee4ad0a4-e9779b31}) ##### ユーザー システム上の特定の既存ユーザーの権限を削除します。
'root'として実行され、AllowRoot が無効になっている場合にのみ有効です。 デフォルト: `zabbix` [comment]: # ({/ee4ad0a4-e9779b31}) [comment]: # ({1a5d86ec-1591e129}) ##### UserParameter 監視するユーザー定義パラメータ。 ユーザー定義パラメータは複数指定できます。
フォーマット: UserParameter=<キー>,<シェルコマンド>
シェルコマンドは空文字列やEOLのみを返してはいけません。 UserParameterDirパラメータが指定されている場合、シェルコマンドは相対パスを使用できます。 例: ```default UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh ``` [comment]: # ({/1a5d86ec-1591e129}) [comment]: # ({0a46abda-493da8fd}) ##### UserParameterDir UserParameterコマンドのデフォルトの検索パスです。 このパラメータを使用すると、エージェントはコマンドを実行する前にここで指定された作業ディレクトリに移動します。 これにより、UserParameterコマンドはフルパスの代わりに相対パスの`./`プレフィックスを使用できます。
1つだけ指定できます。 例: ```default UserParameterDir=/opt/myscripts ``` [comment]: # ({/0a46abda-493da8fd}) [comment]: # ({94f69fcc-9170c364}) #### 参考 1. [バージョン2.0.0以降のアクティブチェックとパッシブチェックのZabbixエージェント設定の違い](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858) [comment]: # ({/94f69fcc-9170c364})