このページで
12 PostgreSQLプラグイン
概要
このセクションでは、PostgreSQL Zabbix エージェント 2 プラグインの設定ファイル（postgresql.conf）でサポートされるパラメータを一覧表示します。
PostgreSQL プラグインはロード可能なプラグインであり、PostgreSQL plugin repository で利用でき、詳細に説明されています。
以下の点に注意してください。
- デフォルト値は、配布される設定ファイル内の値ではなく、プロセスのデフォルト値を反映しています。
- 値では環境変数をサポートしています。
- Zabbix は、BOM なしの UTF-8 エンコーディングの設定ファイルのみをサポートします。
- "#" で始まるコメントは、行頭でのみサポートされます。
オプション
| Parameter | Description |
|---|---|
| -V --version | プラグインのバージョンおよびライセンス情報を表示します。 |
| -h --help | ヘルプ情報を表示します（短縮形）。 |
パラメータ
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.PostgreSQL.Default.CacheMode | いいえ | prepare | PostgreSQL接続のキャッシュモード。 サポートされる値: prepare (デフォルト) - PostgreSQLサーバー上に準備済みステートメントを作成します。 describe - サーバー上にステートメントを作成せずに、匿名の準備済みステートメントを使用してステートメントを記述します。 「describe」は、PgBouncer のような接続プーラーを実行している場合など、環境で準備済みステートメントが許可されていない場合に主に有用であることに注意してください。 |
|
| Plugins.PostgreSQL.CallTimeout | いいえ | 1-30 | global timeout | リクエストが完了するまでの最大待機時間（秒）。 |
| Plugins.PostgreSQL.CustomQueriesPath | いいえ | /usr/local/share/zabbix/custom-queries/postgreSQL for Unix systems*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL for Windows systems, where * is the drive name from the ProgramFiles environment variable |
カスタムクエリを含む .sql ファイルが格納されたディレクトリのフルパス名。 |
|
| Plugins.PostgreSQL.CustomQueriesEnabled | いいえ | false | 設定すると、postgresql.custom.query アイテムキーの実行を有効にします。無効な場合、カスタムクエリディレクトリパスからクエリは読み込まれません。 |
|
| Plugins.PostgreSQL.Default.Database | いいえ | PostgreSQLへの接続に使用するデフォルトのデータベース。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.Default.Password | いいえ | PostgreSQLへの接続に使用するデフォルトのパスワード。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.Default.TLSCAFile | いいえ (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合は はい) |
Zabbix エージェント 2 と監視対象データベース間の暗号化通信において、ピア証明書の検証に使用する最上位 CA 証明書を含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.Default.TLSCertFile | いいえ (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合は はい) |
Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用する PostgreSQL 証明書または証明書チェーンを含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.Default.TLSConnect | いいえ | Zabbix エージェント 2 と監視対象データベース間の通信に使用する暗号化タイプ。名前付きセッションで値が指定されていない場合に使用されます。 サポートされる値: required - ID チェックなしで、転送モードとして TLS を使用して接続します。 verify_ca - TLS を使用して接続し、証明書を検証します。 verify_full - TLS を使用して接続し、証明書を検証し、DBHost で指定されたデータベース ID（CN）がその証明書と一致することを検証します。 暗号化タイプが未定義の場合は、暗号化されない接続を意味します。 |
||
| Plugins.PostgreSQL.Default.TLSKeyFile | いいえ (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合は はい) |
Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用する PostgreSQL 秘密鍵を含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.Default.Uri | いいえ | PostgreSQLへの接続に使用するデフォルト URI。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 埋め込み認証情報を含めないでください（含まれていても無視されます）。 URI 形式に一致している必要があります。 サポートされるスキーム: tcp, unix。例: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Default.User | いいえ | PostgreSQLへの接続に使用するデフォルトのユーザー名。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.PostgreSQL.KeepAlive | いいえ | 60-900 | 300 | 未使用のプラグイン接続が閉じられるまでの最大待機時間（秒）。 |
| Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode | いいえ | prepare | PostgreSQL接続のキャッシュモード。 <SessionName> - アイテムキーで使用するセッション名を定義します。 サポートされる値: prepare (デフォルト) - PostgreSQLサーバー上に準備済みステートメントを作成します。 describe - サーバー上にステートメントを作成せずに、匿名の準備済みステートメントを使用してステートメントを記述します。 「describe」は、PgBouncer のような接続プーラーを実行している場合など、環境で準備済みステートメントが許可されていない場合に主に有用であることに注意してください。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.Database | いいえ | セッション接続用のデータベース。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Password | いいえ | パスワード形式に一致する必要があります。 | セッション接続用のパスワード。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile | いいえ (Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect が verify_ca または verify_full に設定されている場合は はい) |
最上位 CA 証明書を含む、ピア証明書検証用ファイルのフルパス名。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile | Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile が指定されている場合は はい | PostgreSQL 証明書または証明書チェーンを含むファイルのフルパス名。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect | いいえ | PostgreSQL接続の暗号化タイプ。 <SessionName> - アイテムキーで使用するセッション名を定義します。 サポートされる値: required - ID チェックなしで、転送モードとして TLS を使用して接続します。 verify_ca - TLS を使用して接続し、証明書を検証します。 verify_full - TLS を使用して接続し、証明書を検証し、DBHost で指定されたデータベース ID（CN）がその証明書と一致することを検証します。 暗号化タイプが未定義の場合は、暗号化されない接続を意味します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile | Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile が指定されている場合は はい | PostgreSQL 秘密鍵を含むファイルのフルパス名。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Uri | いいえ | 名前付きセッションの接続文字列。 <SessionName> - アイテムキーで使用するセッション名を定義します。 埋め込み認証情報を含めないでください（含まれていても無視されます）。 URI 形式に一致している必要があります。 サポートされるスキーム: tcp, unix。例: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.User | いいえ | 名前付きセッションのユーザー名。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.PostgreSQL.System.Path | はい | PostgreSQLプラグイン実行可能ファイルへのパス。 使用例: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql |
||
| Plugins.PostgreSQL.Timeout | いいえ | 1-30 | global timeout | リクエスト実行タイムアウト（リクエストが完了するまで待機する時間（秒）で、これを超えるとリクエストは停止されます）。 |
関連項目:
- 一般的な Zabbix エージェント 2 設定パラメータの説明: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- plugins の設定手順