2 Zabbix プロキシ
概要
このセクションでは、Zabbix プロキシ設定ファイル(zabbix_proxy.conf)でサポートされているパラメータを一覧表示します。
パラメータは追加情報なしで一覧表示されています。 パラメータをクリックすると、詳細を確認できます。
| パラメータ | 説明 |
|---|---|
| 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 | TLS v1.2 までの TLS プロトコルで Zabbix プロキシが許可する暗号化暗号の一覧です。MySQL でのみサポートされます。 |
| DBTLSCipher13 | TLS v1.3 プロトコルで Zabbix プロキシが許可する暗号スイートの一覧です。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 | ヒストリ、ディスカバリ、自動登録データの保存方式(ディスク/メモリ/ハイブリッド)を指定します。 |
| ProxyConfigFrequency | プロキシが Zabbix サーバーから設定データを取得する間隔を秒単位で指定します。 |
| ProxyLocalBuffer | データがすでにサーバーと同期されている場合でも、プロキシがデータをローカルに保持する時間を N 時間で指定します。 |
| ProxyMemoryBufferAge | プロキシメモリバッファ内のデータの最大経過時間を秒単位で指定します。 |
| ProxyMemoryBufferSize | 収集したヒストリ、ディスカバリ、自動登録データ用の共有メモリキャッシュのサイズです。 |
| ProxyMode | プロキシの動作モード(アクティブ/パッシブ)です。 |
| ProxyOfflineBuffer | Zabbix サーバーに接続できない場合に、プロキシがデータを保持する時間を N 時間で指定します。 |
| Server | ProxyMode がアクティブモードに設定されている場合: 設定データの取得元およびデータの送信先となる Zabbix サーバーの IP アドレスまたは DNS 名(address:port)、またはクラスター(address:port;address2:port)です。 ProxyMode がパッシブモードに設定されている場合: Zabbix サーバーの IP アドレス(CIDR 表記も使用可能)のカンマ区切り一覧、または DNS 名です。 |
| SNMPTrapperFile | SNMP トラップデーモンからプロキシにデータを渡すために使用する一時ファイルです。 |
| SocketDir | 内部 Zabbix サービスが使用する IPC ソケットを保存するディレクトリです。 |
| SourceIP | 送信元 IP アドレスです。 |
| SSHKeyLocation | SSH チェックおよびアクション用の公開鍵と秘密鍵の場所です。 |
| SSLCertLocation | クライアント認証用の SSL クライアント証明書ファイルの場所です。 |
| SSLKeyLocation | クライアント認証用の SSL 秘密鍵ファイルの場所です。 |
| SSLCALocation | SSL サーバー証明書の検証に使用する認証局(CA)ファイルの場所を上書きします。 |
| StartAgentPollers | 事前にフォークされる非同期 Zabbix エージェントポーラーのインスタンス数です。 |
| StartBrowserPollers | 事前にフォークされるブラウザアイテムポーラーのインスタンス数です。 |
| StartDBSyncers | 事前にフォークされるヒストリ同期処理のインスタンス数です。 |
| StartDiscoverers | 事前にフォークされるディスカバリワーカーのインスタンス数です。 |
| StartHTTPAgentPollers | 事前にフォークされる非同期 HTTP エージェントポーラーのインスタンス数です。 |
| StartHTTPPollers | 事前にフォークされる HTTP ポーラーのインスタンス数です。 |
| StartIPMIPollers | 事前にフォークされる IPMI ポーラーのインスタンス数です。 |
| StartJavaPollers | 事前にフォークされる Java ポーラーのインスタンス数です。 |
| StartODBCPollers | 事前にフォークされる ODBC ポーラーのインスタンス数です。 |
| StartPingers | 事前にフォークされる ICMP ping 実行プロセスのインスタンス数です。 |
| StartPollersUnreachable | 到達不能なホスト(IPMI および Java を含む)用に事前にフォークされるポーラーのインスタンス数です。 |
| StartPollers | 事前にフォークされるポーラーのインスタンス数です。 |
| StartPreprocessors | 事前に起動される前処理ワーカーのインスタンス数です。 |
| StartSNMPPollers | 事前にフォークされる非同期 SNMP ポーラーのインスタンス数です。 |
| StartSNMPTrapper | 1 に設定すると、SNMP トラッパープロセスが起動します。 |
| StartTrappers | 事前にフォークされるトラッパーのインスタンス数です。 |
| StartVMwareCollectors | 事前にフォークされる VMware コレクターのインスタンス数です。 |
| StatsAllowedIP | 外部 Zabbix インスタンスの IP アドレス(CIDR 表記も使用可能)のカンマ区切り一覧、または DNS 名です。統計リクエストは、ここに一覧表示されたアドレスからのみ受け付けます。 |
| 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 で指定されたデータベース識別情報がその証明書と一致することを確認します。
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 が設定されている場合は無視されます。UserParameters、パフォーマンスカウンター、エイリアスはサポートしませんが、system.run[] はサポートします。
デフォルト: system.hostname
HousekeepingFrequency
Zabbix がハウスキーピング処理を実行する頻度(時間単位)。
ハウスキーピングとは、データベースから古くなった情報を削除する処理です。
注: プロキシ起動時の負荷を下げるため、ハウスキーピングはプロキシ起動後 30 分間延期されます。
そのため、HousekeepingFrequency が 1 の場合、プロキシ起動後の最初のハウスキーピング処理は 30 分後に実行され、その後は 1 時間ごとに繰り返されます。HousekeepingFrequency を 0 に設定すると、自動ハウスキーピングを無効にできます。
この場合、ハウスキーピング処理は housekeeper_execute ランタイムコントロールオプションでのみ開始できます。
ランタイムコントロール オプションも参照してください。
デフォルト: 1
範囲: 0-24
Include
設定ファイルに含めるディレクトリまたは個別のファイルを指定します。
Zabbix のインストール時、このパラメーターは /usr/local/etc に設定されます。ただし、コンパイル時にこれを変更した場合は除きます。
Include パラメーターに関する一般的なルール:
- パスは
zabbix_proxy.confファイルの場所からの相対パスにできます。 - 1つの設定ファイル内で複数の
Includeパラメーターを指定できます。 - Zabbix は
Includeパラメーターを読み取るとすぐに処理するため、設定ファイルの末尾に配置することを検討してください。
含まれるファイルに関するルール:
- 各ファイルは読み取り可能でなければなりません。
- 各ファイルは正しい構文でなければなりません。そうでない場合、そのコンポーネントは起動しません。
ディレクトリまたはファイルパターンを含める際のルール:
- 含める順序を前提にしないでください(たとえば、ファイルはアルファベット順には含まれません)。
- 1つの設定を上書きする目的であっても、同じパラメーターを複数の含まれるファイルで定義しないでください。どの値が使用されるか予測できないためです。
- 一部のテキストエディターが自動的に作成するバックアップコピーに注意してください(たとえば、
include/my_specific.confを編集するとinclude/my_specific.conf.BAKが作成される場合があります)。両方のファイルが含まれるためです。
ディレクトリ内の関連ファイルのみを含めるには、ワイルドカード (*) をパターンマッチングに使用します。
例:
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 - プロキシバッファーは通常、メモリモードと同様に動作しますが、メモリが不足するか、最も古いレコードが設定された経過時間を超えるまでそのままです。 その場合、バッファーはデータベースにフラッシュされ、すべてのデータがアップロードされるまでディスクモードのように動作し、その後メモリを使った動作に戻ります。 シャットダウン時にはメモリバッファーはデータベースにフラッシュされます。
関連情報: Proxy memory buffer。
デフォルト: disk
値: disk; memory; hybrid
ProxyConfigFrequency
プロキシが Zabbix サーバーから設定データを取得する頻度を秒単位で指定します。
アクティブプロキシのパラメーターです。
パッシブプロキシでは無視されます(ProxyMode パラメーターを参照)。
デフォルト: 10
範囲: 1-604800
ProxyLocalBuffer
データがサーバーと同期済みであっても、プロキシはデータをローカルにN時間保持します。
このパラメータは、ローカルデータがサードパーティ製アプリケーションで使用される場合に使用できます。
デフォルト: 0
範囲: 0-720
ProxyMemoryBufferAge
プロキシのメモリバッファ内のデータの最大保持時間(秒)です。
有効にすると(0以外)、プロキシのメモリバッファ内のレコードがこれより古い場合、すべてのレコードがサーバーにアップロードされるまで、プロキシバッファはデータベースモードに切り替わります。
このパラメーターは ProxyOfflineBuffer パラメーター以下である必要があります。
デフォルト: 0
範囲: 0;600-864000
ProxyMemoryBufferSize
収集された履歴、ディスカバリ、および自動登録データ用の共有メモリキャッシュのサイズ(バイト単位)です。
有効にした場合(0以外)、プロキシはキャッシュがいっぱいになるか、保存されたレコードが定義された ProxyMemoryBufferAge より古くなるまで、履歴、ディスカバリ、および自動登録データをメモリ内に保持します。
このパラメータは ProxyLocalBuffer パラメータと同時に使用できません。
Default: 0
Range: 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)、または cluster (address:port;address2:port)。
ポートが指定されていない場合は、デフォルトのポートが使用されます。
クラスターノードはセミコロンで区切る必要があります。ProxyMode が passive mode に設定されている場合:
カンマ区切りの IP アドレス一覧。必要に応じて CIDR 表記、または Zabbix サーバーの 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 オプションとして設定されることに注意してください。
libcurl 7.42.0 より前のバージョンでは、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エージェントのポーラーの事前フォークされたインスタンス数。
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
カンマ区切りの IP アドレスの一覧。必要に応じて CIDR 表記、または外部 Zabbix インスタンスの DNS 名を指定できます。
stats リクエストは、ここに列挙されたアドレスからのみ受け付けられます。
このパラメータが設定されていない場合、stats リクエストは受け付けられません。
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と証明書を使用した接続を受け入れます。
必須: パッシブプロキシでは必須です。TLS証明書またはPSKパラメータが定義されている場合も必須です(unencrypted 接続の場合でも)。それ以外の場合は不要です
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 version 2;
- CyberArk - CyberArk Central Credential Provider. Webインターフェースで設定された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 の認証トークンです。オプションの VaultDBPath 設定パラメータで指定されたパスに対する読み取り専用権限を持ち、Zabbix プロキシ専用に生成されている必要があります。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コレクターインスタンスが起動するように設定されていない場合、共有メモリは割り当てられないことに注意してください。
デフォルト: 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 は、プロキシ設定では相互排他的です。 どちらか一方のみを指定するか、両方とも未定義のままにしてください。