2 Zabbix プロキシ
概要
Zabbix プロキシ設定ファイル (zabbix_proxy.conf) でサポートされるパラメーターを、このセクションに示します。
パラメーターは追加情報なしで一覧表示されています。 パラメーターをクリックすると、詳細を表示できます。
| Parameter | Description |
|---|---|
| AllowRoot | プロキシを 'root' として実行できるようにします。 |
| AllowUnsupportedDBVersions | サポートされていないデータベースバージョンでもプロキシが動作できるようにします。 |
| CacheSize | 設定キャッシュのサイズ。 |
| ConfigFrequency | このパラメーターは非推奨です (代わりに ProxyConfigFrequency を使用してください)。 プロキシが Zabbix サーバーから設定データを取得する頻度を秒単位で指定します。 |
| DataSenderFrequency | プロキシは収集したデータを N 秒ごとにサーバーへ送信します。 |
| DBHost | Zabbix データベースのホスト (またはソケットディレクトリ)。 |
| DBName | データベース名、または SQLite3 の場合はデータベースファイルへのパス。 |
| DBPassword | データベースのパスワード。 |
| DBPort | Zabbix データベースホストのポート。 |
| DBSchema | データベーススキーマ名。PostgreSQL で使用します。 |
| DBSocket | MySQL ソケットファイルへのパス。 |
| DBUser | データベースユーザー。 |
| DBTLSConnect | このオプションを指定した値に設定すると、データベースへの TLS 接続の使用が強制されます。 |
| DBTLSCAFile | データベース証明書検証用の最上位 CA 証明書を含むファイルの完全パス名。 |
| DBTLSCertFile | データベース認証用の Zabbix プロキシ証明書を含むファイルの完全パス名。 |
| DBTLSKeyFile | データベース認証用の秘密鍵を含むファイルの完全パス名。 |
| DBTLSCipher | Zabbix プロキシが TLS v1.2 までの TLS プロトコルで許可する暗号スイートの一覧。MySQL のみでサポートされます。 |
| DBTLSCipher13 | Zabbix プロキシが TLS v1.3 プロトコルで許可する暗号スイートの一覧。MySQL のみで、バージョン 8.0.16 以降でサポートされます。 |
| DebugLevel | デバッグレベル。 |
| EnableRemoteCommands | Zabbix サーバーからのリモートコマンドを許可するかどうか。 |
| ExternalScripts | 外部スクリプトの場所。 |
| Fping6Location | fping6 の場所。 |
| FpingLocation | fping の場所。 |
| HistoryCacheSize | 履歴キャッシュのサイズ。 |
| HistoryIndexCacheSize | 履歴インデックスキャッシュのサイズ。 |
| Hostname | 一意で、大文字小文字を区別するプロキシ名。 |
| HostnameItem | Hostname が未定義の場合に Hostname の設定に使用されるアイテム。 |
| HousekeepingFrequency | Zabbix がハウスキーピング処理を実行する頻度を時間単位で指定します。 |
| Include | 設定ファイル内で個別のファイル、またはディレクトリ内のすべてのファイルを含めることができます。 |
| JavaGateway | Zabbix Javaゲートウェイの IP アドレス (またはホスト名)。 |
| JavaGatewayPort | Zabbix Javaゲートウェイが待ち受けるポート。 |
| ListenBacklog | TCP キュー内の保留中接続の最大数。 |
| ListenIP | トラッパーが待ち受ける IP アドレスのカンマ区切り一覧。 |
| ListenPort | トラッパーの待ち受けポート。 |
| LoadModule | プロキシ起動時に読み込むモジュール。 |
| LoadModulePath | プロキシモジュールの場所への完全パス。 |
| LogFile | ログファイル名。 |
| LogFileSize | ログファイルの最大サイズ。 |
| LogRemoteCommands | 実行されたシェルコマンドを警告としてログに記録するようにします。 |
| LogSlowQueries | データベースクエリをログに記録するまでの許容時間。 |
| LogType | ログ出力の種類。 |
| MaxConcurrentChecksPerPoller | 各 HTTP エージェントポーラー、エージェントポーラー、または SNMP ポーラーが同時に実行できる非同期チェックの最大数。 |
| PidFile | PID ファイル名。 |
| ProxyBufferMode | 履歴、ディスカバリ、自動登録データの保存方式を指定します (disk/memory/hybrid)。 |
| ProxyConfigFrequency | プロキシが Zabbix サーバーから設定データを取得する頻度を秒単位で指定します。 |
| ProxyLocalBuffer | データがサーバーと同期済みであっても、プロキシは N 時間データをローカルに保持します。 |
| ProxyMemoryBufferAge | プロキシメモリバッファ内のデータの最大保持時間を秒単位で指定します。 |
| ProxyMemoryBufferSize | 収集した履歴、ディスカバリ、自動登録データ用の共有メモリキャッシュのサイズ。 |
| ProxyMode | プロキシの動作モード (active/passive)。 |
| ProxyOfflineBuffer | Zabbix サーバーとの接続がない場合に、プロキシは N 時間データを保持します。 |
| Server | ProxyMode が active モードの場合: 設定データの取得元およびデータ送信先となる Zabbix サーバーの IP アドレスまたは DNS 名 (address:port)、またはクラスタ (address:port;address2:port)。 ProxyMode が passive モードの場合: Zabbix サーバーの IP アドレスのカンマ区切り一覧 (必要に応じて CIDR 表記可)、または DNS 名。 |
| SNMPTrapperFile | SNMP トラップデーモンからプロキシへデータを渡すために使用される一時ファイル。 |
| SocketDir | 内部 Zabbix サービスが使用する IPC ソケットを保存するディレクトリ。 |
| SourceIP | 送信元 IP アドレス。 |
| SSHKeyLocation | SSH チェックおよびアクション用の公開鍵と秘密鍵の場所。 |
| SSLCertLocation | クライアント認証用の SSL クライアント証明書ファイルの場所。 |
| SSLKeyLocation | クライアント認証用の SSL 秘密鍵ファイルの場所。 |
| SSLCALocation | Zabbix サーバー証明書検証用の証明機関 (CA) ファイルの場所を上書きします。 |
| StartAgentPollers | 事前 fork された非同期 Zabbix エージェントポーラーのインスタンス数。 |
| StartBrowserPollers | 事前 fork された browser アイテムポーラーのインスタンス数。 |
| StartDBSyncers | 事前 fork された履歴同期ワーカーのインスタンス数。 |
| StartDiscoverers | 事前 fork されたディスカバリワーカーのインスタンス数。 |
| StartHTTPAgentPollers | 事前 fork された非同期 HTTP エージェントポーラーのインスタンス数。 |
| StartHTTPPollers | 事前 fork された HTTP ポーラーのインスタンス数。 |
| StartIPMIPollers | 事前 fork された IPMI ポーラーのインスタンス数。 |
| StartJavaPollers | 事前 fork された Java ポーラーのインスタンス数。 |
| StartODBCPollers | 事前 fork された ODBC ポーラーのインスタンス数。 |
| StartPingers | 事前 fork された ICMP ping 実行プロセスのインスタンス数。 |
| StartPollersUnreachable | 到達不能ホスト用ポーラーの事前 fork されたインスタンス数 (IPMI と Java を含む)。 |
| StartPollers | 事前 fork されたポーラーのインスタンス数。 |
| StartPreprocessors | 事前起動された前処理ワーカーのインスタンス数。 |
| StartSNMPPollers | 事前 fork された非同期 SNMP ポーラーのインスタンス数。 |
| StartSNMPTrapper | 1 に設定すると、SNMP トラッパープロセスが起動されます。 |
| StartTrappers | 事前 fork されたトラッパーのインスタンス数。 |
| StartVMwareCollectors | 事前 fork された VMware コレクターのインスタンス数。 |
| StatsAllowedIP | 外部 Zabbix インスタンスの IP アドレスのカンマ区切り一覧 (必要に応じて CIDR 表記可)、または DNS 名。stats リクエストは、ここに列挙されたアドレスからのみ受け付けられます。 |
| Timeout | Zabbix プロキシ、エージェント、Web サービスとの接続確立およびデータ交換、ならびに SNMP チェック (SNMP walk[OID] および get[OID] アイテムを除く) に対して、待機する時間を秒単位で指定します。 |
| TLSAccept | Zabbix サーバーから受け入れる受信接続の種類。 |
| TLSCAFile | Zabbix コンポーネント間の暗号化通信で使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルの完全パス名。 |
| TLSCertFile | Zabbix コンポーネント間の暗号化通信で使用される、サーバー証明書または証明書チェーンを含むファイルの完全パス名。 |
| TLSCipherAll | GnuTLS の優先度文字列、または OpenSSL (TLS 1.2) の暗号文字列。証明書ベースおよび PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSCipherAll13 | TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列。証明書ベースおよび PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSCipherCert | GnuTLS の優先度文字列、または OpenSSL (TLS 1.2) の暗号文字列。証明書ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSCipherCert13 | TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列。証明書ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSCipherPSK | GnuTLS の優先度文字列、または OpenSSL (TLS 1.2) の暗号文字列。PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSCipherPSK13 | TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列。PSK ベースの暗号化に対する既定の暗号スイート選択基準を上書きします。 |
| TLSConnect | プロキシが Zabbix サーバーへ接続する方法。 |
| TLSCRLFile | 失効した証明書を含むファイルの完全パス名。Zabbix コンポーネント間の暗号化通信で使用されます。 |
| TLSKeyFile | Zabbix コンポーネント間の暗号化通信で使用される、プロキシ秘密鍵を含むファイルの完全パス名。 |
| TLSPSKFile | Zabbix サーバーとの暗号化通信で使用される、プロキシの事前共有鍵を含むファイルの完全パス名。 |
| TLSPSKIdentity | Zabbix サーバーとの暗号化通信で使用される、事前共有鍵の識別文字列。 |
| TLSServerCertIssuer | 許可されるサーバー証明書の発行者。 |
| TLSServerCertSubject | 許可されるサーバー証明書のサブジェクト。 |
| TmpDir | 一時ディレクトリ。 |
| TrapperTimeout | 次の処理に対するタイムアウトを秒単位で指定します: - Zabbix サーバーからの設定データ取得; - グローバルスクリプトの実行またはリモートコマンドの実行。 |
| UnavailableDelay | 利用不可期間中にホストの可用性を確認する頻度。 |
| UnreachableDelay | 到達不能期間中にホストの可用性を確認する頻度。 |
| UnreachablePeriod | 何秒到達不能が続いたらホストを利用不可と見なすか。 |
| User | システム上の特定の既存ユーザーに権限を切り替えます。 |
| Vault | vault プロバイダー。 |
| VaultDBPath | データベース認証情報をキーで取得する場所。 |
| VaultPrefix | vault パスまたはクエリ用のカスタムプレフィックス。 |
| VaultTLSCertFile | クライアント認証に使用される SSL 証明書ファイル名。 |
| VaultTLSKeyFile | クライアント認証に使用される SSL 秘密鍵ファイル名。 |
| VaultToken | HashiCorp vault の認証トークン。 |
| VaultURL | vault サーバーの HTTP[S] URL。 |
| VMwareCacheSize | VMware データを保存するための共有メモリサイズ。 |
| VMwareFrequency | 単一の VMware サービスからデータを収集する間隔を秒単位で指定します。 |
| VMwarePerfFrequency | 単一の VMware サービスからパフォーマンスカウンター統計を取得する間隔を秒単位で指定します。 |
| VMwareTimeout | vmware コレクターが VMware サービスからの応答を待機する最大秒数。 |
| WebDriverURL | WebDriver インターフェースの HTTP[S] URL。 |
すべてのパラメーターは、明示的に必須と記載されていない限り任意です。
注意:
- 既定値はデーモンの既定値を反映しており、配布される設定ファイル内の値ではありません。
- Zabbix は、BOM なしの UTF-8 エンコーディングの設定ファイルのみをサポートします。
- "#" で始まるコメントは、行頭でのみサポートされます。
パラメータの詳細
AllowRoot
プロキシの実行を 'root' として許可します。
無効で、かつプロキシが 'root' によって起動された場合、代わりに 'zabbix' ユーザーへ切り替えようとします。
通常ユーザーで起動された場合は効果がありません。
デフォルト: 0
値: 0 - 許可しない; 1 - 許可する
AllowUnsupportedDBVersions
サポートされていないデータベースバージョンでプロキシが動作することを許可します。
デフォルト: 0
値: 0 - 許可しない、1 - 許可する
CacheSize
設定キャッシュのサイズ(バイト単位)。 ホストおよびアイテムのデータを保存するための共有メモリのサイズです。
デフォルト: 32M
範囲: 128K-64G
ConfigFrequency
このパラメータは非推奨です(代わりにProxyConfigFrequencyを使用してください)。
プロキシがZabbix serverから設定データを取得する頻度を秒単位で指定します。
アクティブプロキシのパラメータです。
パッシブプロキシでは無視されます(ProxyModeパラメータを参照)。
デフォルト: 3600
範囲: 1-604800
DataSenderFrequency
プロキシは、収集したデータを N 秒ごとにサーバーへ送信します。
アクティブプロキシは、リモートコマンドタスクのために引き続き毎秒 Zabbix server をポーリングする点に注意してください。
アクティブプロキシのパラメータです。
パッシブプロキシでは無視されます(ProxyMode パラメータを参照)。
デフォルト: 1
範囲: 1-3600
DBHost
Zabbixデータベースのホスト(またはソケットディレクトリ)。
MySQLの場合:
localhostまたは空文字列は、デフォルトの UNIX ドメインソケットを使用します。
PostgreSQLの場合:
localhostは DNS 経由で解決されます(通常は 127.0.0.1)。- 空文字列は、デフォルトの UNIX ドメインソケットを使用します。
- パス(たとえば
/var/run/pgbouncer)を指定すると、そのパス上の UNIX ソケットを使用します。 - カンマ区切りのリストには、複数の
host:port値を含めることができます。各ホストは、読み書き接続が確立されるまで順番に試行されます。 例:DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]
Oracle では、空文字列を指定すると Net Service Name 接続方式が使用されます。この場合、tnsnames.ora ファイルのディレクトリを指定するために TNS_ADMIN 環境変数の使用を検討してください。
デフォルト: localhost
DBName
SQLite3 のデータベース名またはデータベースファイルへのパス(Zabbix のマルチプロセスアーキテクチャでは、インメモリデータベース は使用できません。例: :memory:、file::memory:?cache=shared、file:memdb1?mode=memory&cache=shared)
警告: Zabbix サーバーが使用しているデータベースと同じデータベースを使用しないでください。
Oracle で、ネットサービス名接続方法を使用する場合は、tnsnames.ora からサービス名を指定するか、空の文字列に設定してください。DBName が空の文字列に設定されている場合は、TWO_TASK 環境変数を設定してください。
必須: 必須
DBPassword
データベースのパスワード。
パスワードを使用しない場合は、この行をコメントアウトしてください。
SQLite では無視されます。
DBPort
Zabbixデータベースホストのポート(DBHostを参照)。1 SQLiteでは無視されます。
Oracleでは、Net Service Name接続方式を使用する場合、このパラメータは無視され、代わりに tnsnames.ora ファイルのポート番号が使用されます。
MySQLのデフォルト: 3306
PostgreSQLのデフォルト: 5432
範囲: 1024-65535
DBSchema
データベーススキーマ名です。
PostgreSQLで使用されます。
DBSocket
MySQLソケットファイルへのパス。1
DBUser
データベースユーザー。
SQLite では無視されます。
DBTLSConnect
このオプションを設定すると、データベースへのTLS接続が強制されます。
required - TLSを使用して接続します。
verify_ca - TLSを使用して接続し、証明書を検証します。
verify_full - TLSを使用して接続し、証明書を検証し、DBHostで指定されたデータベースIDがその証明書と一致することを確認します。
MySQL 5.7.11以降およびPostgreSQLでは、次の値がサポートされています。"required"、"verify"、"verify_full"。
MariaDB バージョン10.2.6以降では、"required"および"verify_full"がサポートされています。
デフォルトではどのオプションも設定されておらず、動作はデータベースの設定によって異なります。
DBTLSCAFile
データベース証明書検証用の最上位CA証明書を含むファイルのフルパス名
必須: いいえ(DBTLSConnectがverify_caまたはverify_fullに設定されている場合は必須)
DBTLSCertFile
データベースへの認証に使用する Zabbix プロキシ証明書を含むファイルのフルパス名
DBTLSKeyFile
データベースへの認証に使用する秘密鍵を含むファイルのフルパス名
DBTLSCipher
ZabbixプロキシがTLS v1.2までのTLSプロトコルで許可する暗号化暗号スイートの一覧です。
MySQLでのみサポートされています。
DBTLSCipher13
ZabbixプロキシがTLS v1.3プロトコルに対して許可する暗号スイートの一覧です。
MySQLでのみサポートされ、バージョン8.0.16以降で利用できます。
DebugLevel
デバッグレベルの指定
0 - Zabbix プロセスの起動と停止に関する基本情報
1 - 重要な情報
2 - エラー情報
3 - 警告
4 - デバッグ用(多くの情報を生成します)
5 - 拡張デバッグ(さらに多くの情報を生成します)
デフォルト: 3
範囲: 0-5
EnableRemoteCommands
Zabbix サーバーからのリモートコマンドを許可するかどうか。
デフォルト: 0
値: 0 - 許可しない、1 - 許可する
外部スクリプト
外部スクリプトの場所(コンパイル時のインストール変数'datadir'に依存します)
デフォルト: '/usr/local/share/zabbix/externalscripts'
Fping6Location
fping6 の場所です。
fping6 バイナリの所有者が root であり、SUID フラグが設定されていることを確認してください。
使用している fping ユーティリティが IPv6 アドレスを処理できる場合は、空にしてください("Fping6Location=")。
デフォルト: /usr/sbin/fping6
FpingLocation
fping の場所です。
fping バイナリの所有者が root であり、SUID フラグが設定されていることを確認してください。
デフォルト: /usr/sbin/fping
HistoryCacheSize
履歴キャッシュのサイズ(バイト単位)。 履歴データを保存するための共有メモリのサイズです。
デフォルト: 16M
範囲: 128K-2G
HistoryIndexCacheSize
履歴インデックスキャッシュのサイズ(バイト単位)。 履歴キャッシュに保存される履歴データのインデックス作成に使用する共有メモリのサイズです。 1つのアイテムをキャッシュするには、インデックスキャッシュサイズとしておよそ100バイトが必要です。
デフォルト: 4M
範囲: 128K-2G
Hostname
大文字と小文字を区別する、一意のプロキシ名です。
プロキシ名がサーバーに認識されていることを確認してください。
使用可能な文字: 英数字、'.'、' '、'_'、'-'。
最大長: 128
デフォルト: HostnameItem で設定されます
HostnameItem
Hostname が未定義の場合に Hostname を設定するために使用されるアイテムです(これはエージェント上と同様にプロキシ上でも実行されます)。
Hostname が設定されている場合は無視されます。
UserParameter、パフォーマンスカウンター、エイリアスはサポートしていませんが、system.run[] はサポートしています。
デフォルト: system.hostname
HousekeepingFrequency
Zabbix がハウスキーピング処理を実行する頻度(時間単位)です。
ハウスキーピングとは、データベースから古い情報を削除することです。
注: プロキシ起動時の負荷を下げるため、ハウスキーピングはプロキシ起動後30分間延期されます。
したがって、HousekeepingFrequency が 1 の場合、プロキシ起動後の最初のハウスキーピング処理は30分後に実行され、その後は1時間ごとに繰り返されます。
HousekeepingFrequency を 0 に設定することで、自動ハウスキーピングを無効にできます。
この場合、ハウスキーピング処理は housekeeper_execute ランタイム制御オプションによってのみ開始できます。
あわせて runtime control オプションも参照してください。
デフォルト: 1
範囲: 0-24
インクルード
設定ファイルには、個別のファイル、またはディレクトリ内のすべてのファイルを含めることができます。
指定したディレクトリ内で関連するファイルのみを含めるために、パターンマッチング用のアスタリスクワイルドカード文字がサポートされています。
制限事項については、特記事項を参照してください。
例:
Include=/absolute/path/to/config/files/*.conf
JavaGateway
Zabbix JavaゲートウェイのIPアドレス(またはホスト名)。
Java pollerが起動している場合にのみ必要です。
JavaGatewayPort
Zabbix Java ゲートウェイが listen するポート
デフォルト: 10052
範囲: 1024-32767
ListenBacklog
TCP キュー内の保留中の接続の最大数
デフォルト値はシステムに依存するハードコードされた定数
サポートされる最大値はシステムに依存し、値が大きすぎる場合は「実装で指定された最大値」に自動的に切り捨てられる場合があります。
デフォルト: SOMAXCONN
範囲: 0 - INT_MAX
ListenIP
トラッパーが待ち受けるカンマ区切りの IP アドレスの一覧です。
このパラメーターが指定されていない場合、トラッパーはすべてのネットワークインターフェースで待ち受けます。
デフォルト: 0.0.0.0
ListenPort
トラッパーのリッスンポート
デフォルト: 10051
範囲: 1024-32767
LoadModule
プロキシの起動時に読み込むモジュールです。
モジュールは、プロキシの機能を拡張するために使用されます。
モジュールは、LoadModulePath で指定されたディレクトリに配置するか、モジュール名の前にパスを指定する必要があります。
前に付けるパスが絶対パス('/' で始まる)の場合、LoadModulePath は無視されます。
形式:
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
複数の LoadModule パラメータを含めることができます。
LoadModulePath
プロキシモジュールの配置場所へのフルパスです。
デフォルト値はコンパイルオプションによって異なります。
LogFile
ログファイル名
必須: LogType が file に設定されている場合は必須、それ以外の場合は必須ではありません。
LogFileSize
ログファイルの最大サイズ(MB)
0 - 自動ログローテーションを無効にします。
注: ログファイルのサイズ制限に達し、何らかの理由でファイルローテーションが失敗した場合、既存のログファイルは切り捨てられ、新たに開始されます。
デフォルト: 1
範囲: 0-1024
LogRemoteCommands
実行されたシェルコマンドを警告としてログに記録します。
デフォルト: 0
値: 0 - 無効、1 - 有効
LogType
ログ出力の種類:
file - LogFile パラメータで指定されたファイルにログを書き込みます。
system - syslog にログを書き込みます。
console - 標準出力にログを書き込みます。
デフォルト: file
LogSlowQueries
データベースクエリがログに記録されるまでの所要時間。(ミリ秒単位)
0 - スロー クエリをログに記録しません。
このオプションは、DebugLevel=3 以降で有効になります。
デフォルト: 0
範囲: 0-3600000
MaxConcurrentChecksPerPoller
各HTTPエージェントポーラー、エージェントポーラー、またはSNMPポーラーが一度に実行できる非同期チェックの最大数です。
StartHTTPAgentPollers、StartAgentPollers、およびStartSNMPPollersを参照してください。
デフォルト: 1000
範囲: 1-1000
PidFile
PID ファイルの名前
デフォルト: /tmp/zabbix_proxy.pid
ProxyBufferMode
履歴、ネットワークディスカバリ、自動登録データの保存メカニズムを指定します。disk - データはデータベースに保存され、データベースからアップロードされます。memory - データはメモリに保存され、メモリからアップロードされます。 バッファのメモリが不足した場合、古いデータは破棄されます。 シャットダウン時には、バッファは破棄されます。 hybrid - プロキシバッファは通常、メモリモードと同様に動作しますが、メモリが不足するか、最も古いレコードが設定された保存期間を超えるまでその状態が続きます。 その場合、バッファはデータベースにフラッシュされ、すべてのデータがアップロードされるまでディスクモードのように動作し、その後再びメモリで動作を開始します。 シャットダウン時には、メモリバッファはデータベースにフラッシュされます。
参照: プロキシメモリバッファ。
デフォルト: disk
値: disk; memory; hybrid
ProxyConfigFrequency
プロキシがZabbix serverから設定データを取得する頻度を秒単位で指定します。
アクティブプロキシのパラメータです。
パッシブプロキシでは無視されます(ProxyModeパラメータを参照)。
デフォルト: 10
範囲: 1-604800
ProxyLocalBuffer
データがサーバーと同期済みであっても、プロキシはデータをローカルにN時間保持します。
このパラメータは、ローカルデータがサードパーティ製アプリケーションで使用される場合に使用できます。
デフォルト: 0
範囲: 0-720
ProxyMemoryBufferAge
プロキシメモリバッファ内のデータの最大保持時間を秒単位で指定します。
有効(0以外)で、プロキシメモリバッファ内のレコードがこれより古い場合、すべてのレコードがサーバーにアップロードされるまで、プロキシバッファはデータベースモードに強制的に切り替えられます。
このパラメータは、ProxyOfflineBuffer パラメータ以下でなければなりません。
デフォルト: 0
範囲: 0;600-864000
ProxyMemoryBufferSize
収集された履歴、ディスカバリ、および自動登録データ用の共有メモリキャッシュのサイズを、バイト単位で指定します。
有効な場合(0以外)、プロキシは、キャッシュがいっぱいになるか、保存されたレコードが定義された ProxyMemoryBufferAge より古くなるまで、履歴、ディスカバリ、および自動登録データをメモリ内に保持します。
このパラメータは、ProxyLocalBuffer パラメータと同時に使用できません。
デフォルト: 0
範囲: 0;128K-2G
ProxyMode
プロキシの動作モード。
0 - アクティブモードのプロキシ
1 - パッシブモードのプロキシ
アクティブプロキシを使用する場合、(機密性の高い)プロキシ設定データが、Zabbixサーバーのtrapperポートにアクセスできる第三者に利用可能になる可能性があることに注意してください。
これは、誰でもアクティブプロキシを装って設定データを要求でき、認証が行われないためです。
デフォルト: 0
範囲: 0-1
ProxyOfflineBuffer
Zabbixサーバーとの接続が切断された場合、プロキシはN時間データを保持します。
古いデータは失われます。
デフォルト: 1
範囲: 1-720
サーバー
ProxyMode が active mode に設定されている場合:
設定データの取得元およびデータの送信先となる Zabbixサーバー の IP アドレスまたは DNS 名(address:port)、あるいは クラスター(address:port;address2:port)。
ポートが指定されていない場合は、デフォルトのポートが使用されます。
クラスターのノードはセミコロンで区切る必要があります。
ProxyMode が passive mode に設定されている場合:
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 アドレスを許可するために使用できます。
例:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
必須: はい
SNMPTrapperFile
SNMPトラップデーモンからプロキシへデータを渡すために使用される一時ファイル。
zabbix_trap_receiver.pl または SNMPTT 設定ファイルと同じである必要があります。
デフォルト: /tmp/zabbix_traps.tmp
SocketDir
Zabbix 内部サービスで使用される IPC ソケットを保存するディレクトリ
デフォルト: /tmp
SourceIP
以下の送信元IPアドレス:
- Zabbixサーバーへの送信接続
- エージェントレス接続(VMware、SSH、JMX、SNMP、Telnet、およびシンプルチェック)
- HTTPエージェント接続
- スクリプトアイテムのJavaScript HTTPリクエスト
- 前処理のJavaScript HTTPリクエスト
- Vaultへの接続
SSHKeyLocation
SSH チェックおよびアクションで使用する公開鍵と秘密鍵の保存場所
SSLCertLocation
クライアント認証用のSSLクライアント証明書ファイルの場所
このパラメータはWebモニタリングでのみ使用されます。
SSLKeyLocation
クライアント認証用のSSL秘密鍵ファイルの場所
このパラメータはWebモニタリングでのみ使用されます。
SSLCALocation
SSLサーバー証明書の検証に使用する認証局(CA)ファイルの場所。
このパラメータの値は、libcurl オプション CURLOPT_CAPATH として設定されます。
7.42.0 より前の libcurl バージョンでは、libcurl が OpenSSL を使用するようにコンパイルされている場合にのみ有効です。
詳細については、cURL web page を参照してください。
このパラメータは、Web監視および SMTP 認証で使用されます。
StartAgentPollers
Zabbix エージェント pollers の事前 fork 済みインスタンス数。 MaxConcurrentChecksPerPoller を参照してください。
デフォルト: 1
範囲: 0-1000
StartBrowserPollers
ブラウザアイテム ポーラー のpre-forked インスタンスの数
デフォルト: 1
範囲: 0-1000
StartDBSyncers
history syncers の事前フォークされたインスタンス数。
注: この値を変更する際は注意してください。増やしても、かえって悪影響を及ぼす場合があります。
デフォルト: 4
範囲: 1-100
StartDiscoverers
ディスカバリーワーカー の事前フォークされたインスタンス数。
デフォルト: 5
範囲: 0-1000
StartHTTPAgentPollers
HTTP エージェントの pollers の事前 fork 済みインスタンス数。 MaxConcurrentChecksPerPoller を参照してください。
デフォルト: 1
範囲: 0-1000
StartHTTPPollers
HTTP pollers の事前フォークされたインスタンス数。
デフォルト: 1
範囲: 0-1000
StartIPMIPollers
IPMI pollers の事前フォークされたインスタンス数。
デフォルト: 0
範囲: 0-1000
StartJavaPollers
Java pollers の事前フォークされたインスタンス数。
デフォルト: 0
範囲: 0-1000
StartODBCPollers
ODBC pollers の事前フォークされたインスタンス数。
デフォルト: 1
範囲: 0-1000
StartPingers
ICMP pingers の事前フォークされたインスタンス数。
デフォルト: 1
範囲: 0-1000
StartPollersUnreachable
到達不能なホスト用のポーラー(IPMI と Java を含む)の事前 fork されたインスタンス数です。 通常のポーラー、IPMI ポーラー、または Java ポーラーが起動している場合は、少なくとも 1 つの到達不能なホスト用ポーラーが稼働している必要があります。
デフォルト: 1
範囲: 0-1000
StartPollers
pollers の事前フォークされたインスタンス数。
デフォルト: 5
範囲: 0-1000
StartPreprocessors
事前起動する前処理 worker スレッドの数は、利用可能な CPU コア数以上に設定する必要があります。 前処理が CPU に依存せず、ネットワーク要求が多い場合は、より多くの worker を設定してください。
デフォルト: 16 (Zabbix 7.0.6 より前: 3)
範囲: 1-1000
StartSNMPPollers
SNMP pollers の事前フォークされたインスタンス数。 MaxConcurrentChecksPerPoller を参照してください。
デフォルト: 1
範囲: 0-1000
StartSNMPTrapper
1 に設定すると、SNMP trapper プロセスが起動します。
デフォルト: 0
範囲: 0-1
StartTrappers
trapper の事前フォークされたインスタンス数。
trapper は、Zabbix sender およびアクティブ エージェントからの着信接続を受け付けます。
デフォルト: 5
範囲: 0-1000
StartVMwareCollectors
事前に fork された VMware collector インスタンスの数。
デフォルト: 0
範囲: 0-250
StatsAllowedIP
外部Zabbixインスタンスの、CIDR表記を任意で含むカンマ区切りのIPアドレス、またはDNS名のリストです。
統計情報のリクエストは、ここに一覧表示されたアドレスからのみ受け付けられます。
このパラメータが設定されていない場合、統計情報のリクエストは一切受け付けられません。
IPv6サポートが有効な場合、'127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1' は同一として扱われ、'::/0' は任意のIPv4またはIPv6アドレスを許可します。
'0.0.0.0/0' を使用すると、任意のIPv4アドレスを許可できます。
例:
StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
タイムアウト
Zabbixサーバー、エージェント、Webサービス、および従来のSNMPチェック(単一のOID番号または文字列)との接続確立およびデータ交換を待機する時間(秒)を指定します。
このパラメータは、さまざまな通信処理の継続時間を定義します。
- Zabbixエージェントでのリモートコマンド実行
- SSH / Telnetコマンド実行
- IPMIインターフェースが利用不可になった場合のアイテムの再スケジュール
- 権限または暗号化の問題によりデータ交換に失敗した際に、Zabbixサーバーへ応答を送信する処理
- IPC非同期ソケットおよびランタイム制御オプションの期限
- 非同期ポーラーのDNSリクエスト
- アクティブチェックのハートビートへの応答
- アクティブエージェントからのZabbixエージェントデータ(値)の取得
- Zabbix senderからのデータ取得
- Zabbixエージェントへのアクティブチェックリストの送信
このタイムアウトは、Webインターフェースで柔軟なタイムアウト設定が構成されているチェックには使用されません(グローバル、プロキシ、またはアイテム単位)。
たとえば、SNMP walk[OID] および get[OID] アイテムはWebインターフェースで設定されたタイムアウトを使用しますが、従来のSNMPチェックは引き続きサーバーのタイムアウト値を使用します。
デフォルト: 3
範囲: 1-30
TLSAccept
Zabbixサーバーから受け入れる受信接続の種類を指定します。
パッシブプロキシで使用され、アクティブプロキシでは無視されます。
複数の値をカンマ区切りで指定できます。
unencrypted - 暗号化なしの接続を受け入れます(デフォルト)
psk - TLSおよび事前共有鍵(PSK)を使用した接続を受け入れます
cert - TLSおよび証明書を使用した接続を受け入れます
必須: パッシブプロキシでは yes。TLS証明書またはPSKパラメータが定義されている場合(unencrypted 接続の場合も含む)。それ以外の場合は no
TLSCAFile
Zabbix コンポーネント間の暗号化通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名
TLSCertFile
Zabbix コンポーネント間の暗号化通信に使用されるプロキシ証明書または証明書チェーンを含むファイルのフルパス名
TLSCipherAll
GnuTLSの優先順位文字列、またはOpenSSL(TLS 1.2)の暗号スイート文字列です。
証明書ベースおよびPSKベースの暗号化に対する、デフォルトの暗号スイート選択基準を上書きします。
例:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13
TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列です。
証明書ベースおよび PSK ベースの暗号化に対する、デフォルトの暗号スイート選択基準を上書きします。
GnuTLS の例:
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
TLSCipherCert
GnuTLSの優先順位文字列、またはOpenSSL(TLS 1.2)の暗号文字列です。
証明書ベースの暗号化における、デフォルトの暗号スイート選択基準を上書きします。
GnuTLSの例:
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の例:
EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13
TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列です。
証明書ベースの暗号化に対するデフォルトの暗号スイート選択基準を上書きします。
TLSCipherPSK
GnuTLSの優先順位文字列、またはOpenSSL(TLS 1.2)の暗号文字列です。
PSKベースの暗号化に対するデフォルトの暗号スイート選択基準を上書きします。
GnuTLSの例:
NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL
OpenSSLの例:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
TLS 1.3 における OpenSSL 1.1.1 以降用の暗号文字列です。
PSK ベースの暗号化に対するデフォルトの暗号スイート選択基準を上書きします。
例:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
プロキシがZabbixサーバーにどのように接続するかを指定します。
アクティブプロキシで使用され、パッシブプロキシでは無視されます。
指定できる値は1つだけです:
unencrypted - 暗号化なしで接続します(デフォルト)
psk - TLSおよび事前共有鍵(PSK)を使用して接続します
cert - TLSおよび証明書を使用して接続します
必須: アクティブプロキシで、TLS証明書またはPSKパラメータが定義されている場合は「はい」(unencrypted 接続の場合も含む)。それ以外の場合は「いいえ」
TLSCRLFile
失効した証明書を含むファイルの完全なパス名です。
このパラメータは、Zabbixコンポーネント間の暗号化通信に使用されます。
TLSKeyFile
Zabbix コンポーネント間の暗号化通信に使用されるプロキシ秘密鍵を含むファイルのフルパス名
TLSPSKFile
Zabbix サーバーとの暗号化通信に使用されるプロキシ事前共有キーを含むファイルのフルパス名
TLSPSKIdentity
Zabbixサーバーとの暗号化通信に使用される、事前共有キーのID文字列
TLSServerCertIssuer
許可されたサーバー証明書の発行者
TLSServerCertSubject
許可されたサーバー証明書のサブジェクト
TmpDir
一時ディレクトリ
デフォルト: /tmp
TrapperTimeout
以下のタイムアウトを秒単位で指定します。
- Zabbix サーバーからの設定データの取得
- グローバルスクリプトの実行またはリモートコマンドの実行
デフォルト: 300
範囲: 1-300
UnavailableDelay
非可用性 期間中にホストへの可用性をチェックする頻度(秒単位)
デフォルト: 60
範囲: 1-3600
UnreachableDelay
到達不能 期間中にホストへの可用性をチェックする頻度(秒単位)
デフォルト: 15
範囲: 1-3600
UnreachablePeriod
到達不能が何秒間続いた後にホストを利用不可とみなすかの指定
デフォルト: 45
範囲: 1-3600
ユーザー
システム上の特定の既存ユーザーの権限を削除
'root'として実行され、AllowRoot が無効になっている場合にのみ有効です。
デフォルト: zabbix
Vault
Vault プロバイダー:
HashiCorp - HashiCorp KV Secrets Engine バージョン 2
CyberArk - CyberArk Central 認証情報プロバイダー
フロントエンドで設定された Vault プロバイダーと一致する必要があります。
デフォルト: HashiCorp
VaultDBPath
データベースの認証情報をキーによって取得する元となる、Vaultに応じたVaultパスまたはクエリです。
HashiCorp で使用されるキーは、'password' および 'username' です。
VaultPrefix=/v1/secret/data/zabbix/ を使用する場合のパス例:
database
VaultPrefix を使用しない場合のパス例:
secret/zabbix/database
CyberArk で使用されるキーは、'Content' および 'UserName' です。
例:
AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_proxy_database
このオプションは、DBUser および DBPassword が指定されていない場合にのみ使用できます。
VaultPrefix
Vaultに応じて、Vaultパスまたはクエリに使用するカスタムプレフィックスです。
指定しない場合は、最適なデフォルト値が使用されます。
HashiCorpでは、VaultPrefixが指定されていない場合、マウントポイントの後に'data'が自動的に追加されることに注意してください。
Hashicorpのプレフィックスの例:
v1/secret/data/zabbix/
Cyberarkのプレフィックスの例:
/AIMWebService/api/Accounts?
VaultTLSCertFile
クライアント認証に使用するSSL証明書ファイルの名前です。
証明書ファイルはPEM1形式である必要があります。
証明書ファイルに秘密鍵も含まれている場合は、SSLキーファイルのフィールドを空のままにしてください。
このファイルを含むディレクトリは、設定パラメータSSLCertLocationで指定します。
このオプションは省略できますが、CyberArkCCP vaultでは推奨されます。
VaultTLSKeyFile
クライアント認証に使用するSSL秘密鍵ファイルの名前です。
秘密鍵ファイルはPEM1形式である必要があります。
このファイルを含むディレクトリは、設定パラメータSSLKeyLocationで指定します。
このオプションは省略できますが、CyberArkCCP vaultでは推奨されます。
VaultToken
HashiCorp Vault 認証トークン。Zabbix プロキシ専用に生成され、オプションの VaultDBPath 設定パラメータで指定されたパスへの読み取り専用権限を持ちます。
VaultToken と VAULT_TOKEN 環境変数が同時に定義されている場合はエラーになります。
必須: Vault が HashiCorp に設定されている場合は必須、それ以外の場合は必須ではありません。
VaultURL
vaultサーバーのHTTP[S] URL。
SSLCALocationが指定されていない場合は、システム全体のCA証明書ディレクトリが使用されます。
デフォルト: https://127.0.0.1:8200
VMwareCacheSize
VMware データを保存するための共有メモリのサイズ
VMware 内部チェック zabbix[vmware,buffer,...] を使用して、VMware キャッシュの使用状況を監視できます (内部チェック を参照)
起動するように構成された VMware Collector インスタンスがない場合、共有メモリは割り当てられません。
デフォルト: 8M
範囲: 256K-2G
VMwareFrequency
単一の VMware サービスからのデータ収集間隔(秒単位)
この間隔は、VMware 監視項目の中で最も短い更新間隔に設定する必要があります。
デフォルト: 60
範囲: 10-86400
VMwarePerfFrequency
単一の VMware サービスからパフォーマンスカウンタ統計情報を取得する間隔(秒単位)
この間隔は、VMware パフォーマンスカウンタを使用する VMware 監視 item のうち、最も短い更新間隔に設定する必要があります。
デフォルト: 60
範囲: 10-86400
VMwareTimeout
VMware コレクターが VMware サービス(vCenter または ESX ハイパーバイザー)からの応答を待機する最大秒数
デフォルト: 10
範囲: 1-300
WebDriverURL
WebDriverインターフェースのHTTP[S] URL。
例(Selenium WebDriverスタンドアロンサーバーで使用):
WebDriverURL=http://localhost:4444
脚注
1 DBSocket と DBPort は、プロキシ設定では相互排他的です。 どちらか一方のみを指定するか、両方とも未定義のままにしてください。