Documentation
6.0
日本語
Table of Contents
11 PostgreSQLプラグイン
概要
このセクションでは、PostgreSQL Zabbixエージェント2プラグイン設定ファイル(postgresql.conf)でサポートされているパラメータを一覧表示します。
Zabbix 6.0.10 以降、PostgreSQLプラグインはロード可能なプラグインであり、PostgreSQLプラグインリポジトリ で利用可能であり、詳細な説明が記載されています。
Windows用のコンパイル済みプラグインバイナリは Zabbix 6.0.19 以降で利用可能であり、以前の 6.0 バージョンと互換性があります。
参考情報:
- 一般的なZabbixエージェント2の設定パラメーターの説明: Zabbixエージェント2 (UNIX) / Zabbixエージェント2 (Windows)
- プラグインの設定手順
オプション
| パラメータ | 説明 |
|---|---|
| -V --version | プラグインのバージョンとライセンス情報を表示します |
| -h --help | Prヘルプ情報を表示します (省略形) |
パラメータ
Zabbix バージョン6.0.10 より前では、パラメータ名は Plugins.PostgreSQL.<Parameter> ではなく Plugins.Postgres.<Parameter> で始まります。たとえば、Plugins.Postgres.KeepAlive です。
| パラメータ | 必須 | 範囲 | デフォルト | 説明 |
|---|---|---|---|---|
| Plugins.PostgreSQL.Default.CacheMode | no | PostgreSQL接続のキャッシュモード。 サポートされる値: prepare (デフォルト) - PostgreSQLサーバ上に準備されたステートメントを作成します。 describe -サーバ上にステートメントを作成せずに、匿名の準備されたステートメントを使用してステートメントを記述します。 "describe"は、PgBouncer などの接続プーラーを実行する場合など、環境で準備されたステートメントが許可されていない場合に主に役立ちます。 バージョン6.0.25以降でサポートされています。 |
||
| Plugins.PostgreSQL.CallTimeout | no | 1-30 | global timeout | リクエストが完了するまでの最大待機時間(秒単位) |
| Plugins.PostgreSQL.CustomQueriesPath | no | disabled | カスタム クエリを含む .sql ファイルを含むディレクトリの完全なパス名 | |
| Plugins.PostgreSQL.Default.Database | no | PostgreSQLに接続するためのデフォルトのデータベース。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.Password | no | PostgreSQLに接続するためのデフォルトのパスワード。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.TLSCAFile | no (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合、必須) |
Zabbixエージェント2と監視対象データベース間の暗号化通信のピア証明書検証用の最上位 CA 証明書を含むファイルのフル パス名。名前付きセッションで値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.TLSCertFile | no (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合、必須) |
Zabbixエージェント2と監視対象データベース間の暗号化通信用の PostgreSQL 証明書または証明書チェーンを含むファイルのフル パス名。名前付きセッションで値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.TLSConnect | no | Zabbixエージェント2と監視対象データベース間の通信の暗号化タイプ。名前付きセッションで値が指定されていない場合に使用されます。 サポートされる値: required - ID チェックなしでトランスポート モードとして TLS を使用して接続します。 verify_ca - TLS を使用して接続し、証明書を検証します。 verify_full - TLS を使用して接続し、証明書を検証し、DBHost によって指定されたデータベース ID (CN) がその証明書と一致することを確認します。 暗号化タイプが定義されていない場合、接続は暗号化されません。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.TLSKeyFile | no (Plugins.PostgreSQL.Default.TLSConnect が verify_ca または verify_full に設定されている場合、必須) |
Zabbixエージェント2と監視対象データベース間の暗号化通信用の PostgreSQL 秘密キーを含むファイルのフル パス名。名前付きセッションで値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.Uri | no | PostgreSQLに接続するためのデフォルトの URI。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 埋め込み資格情報を含めないでください (無視されます)。 URI 形式と一致する必要があります。 サポートされているスキーム: tcp、unix例: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.Default.User | no | PostgreSQLに接続するためのデフォルトのユーザー名。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.PostgreSQL.KeepAlive | no | 60-900 | 300 | 未使用のプラグイン接続が閉じられるまでの最大待機時間 (秒単位) |
| Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode | no | prepare | PostgreSQL 接続のキャッシュ モード。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 サポートされる値: prepare(デフォルト) - PostgreSQLサーバ上に準備されたステートメントを作成します。 describe -サーバ上にステートメントを作成せずに、匿名の準備されたステートメントを使用してステートメントを記述します。 「describe」は、PgBouncer などの接続プーラーを実行する場合など、準備されたステートメントが許可されない環境で主に役立ちます。 バージョン6.0.25以降でサポートされています。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.Database | no | セッション接続用のデータベース。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Password | no | パスワードの形式と一致する必要があります。 | セッション接続のパスワード。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile | no (Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect が verify_ca または verify_full に設定されている場合、必須) |
最上位 CA 証明書のピア証明書検証を含むファイルの完全なパス名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile | 必須(Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile が指定されている場合) バージョン6.0.22未満では、Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect が verify_ca または verify_full に設定されている場合は常に必須です。 |
PostgreSQL 証明書または証明書チェーンを含むファイルの完全なパス名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect | no | PostgreSQL 接続の暗号化タイプ。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 サポートされる値: required - ID チェックなしでトランスポートモードとして TLS を使用して接続します。 verify_ca - TLS を使用して接続し、証明書を検証します。 verify_full - TLS を使用して接続し、証明書を検証し、DBHost によって指定されたデータベース ID (CN) がその証明書と一致することを確認します。 暗号化タイプが定義されていない場合、接続は暗号化されません。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile | 必須(Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile が指定されている場合) バージョン6.0.22未満では、Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect が verify_ca または verify_full に設定されている場合、常に必須です。 |
PostgreSQL 秘密キーを含むファイルの完全パス名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Uri | no | 名前付きセッションの接続文字列。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 埋め込まれた資格情報を含めないでください (無視されます)。 URI 形式と一致する必要があります。 サポートされているスキーム: tcp、unix例: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.User | no | 名前付きセッション ユーザー名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.PostgreSQL.System.Path | yes | 外部プラグイン実行ファイルへのパス。Zabbix 6.0.10以降でサポートされています。 | ||
| Plugins.PostgreSQL.Timeout | no | 1-30 | global timeout | リクエストの実行タイムアウト(リクエストが完了するのを待ってからシャットダウンするまでの時間) |
参考情報:
- 一般的なZabbixエージェント2の設定パラメーターの説明: Zabbixエージェント2 (UNIX) / Zabbixエージェント2 (Windows)
- プラグインの設定手順