5.8. ヘルスチェック

Pgpool-IIはサーバやネットワークの障害を検知するために、設定されたバックエンドに定期的に接続を試みます。 この障害チェックの手続きを「ヘルスチェック」と言います。

SSLが有効なら、ヘルスチェックプロセスはSSL接続を使うかもしれません。

障害が検知されると、Pgpool-IIは設定に基づいてフェイルオーバや縮退運転を試みます。

注意

ヘルスチェックは各バックエンドノードへの余分の接続を1つ必要としますので、postgresql.confmax_connectionsもそれに応じて調整する必要があります。

以下のパラメータは、名前の最後に数字の接尾辞を持つことができます。その 接尾辞は、backend_hostnameのようなバックエンド情報で定義されるバックエンドのIDに対応します。 たとえばhealth_check_timeout0は、バックエンド0のhealth_check_timeoutに適用されます。

接尾辞付きのパラメータがない場合は、そのバックエンドの設定値は接尾辞なしのパラメータの値が使用されます。 つまり、接尾辞なしのパラメータは、「広域変数」のように扱われます。

health_check_timeout (integer)

TCP接続が時間内に成功せずにバックエンドのPostgreSQLへの接続を諦めるまでのタイムアウト値を秒単位で指定します。

このパラメータは、ネットワークケーブルが抜けた際などにヘルスチェックが長時間待たされるのを防止します。 デフォルトは20秒です。0を指定するとタイムアウト処理をしません (TCP/IP のタイムアウトまで待ちます)。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_period (integer)

ヘルスチェックの間隔を秒単位で指定します。 デフォルトは0で、これはヘルスチェックが無効であることを意味します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_user (string)

ヘルスチェックを行うPostgreSQLユーザ名を指定します。 同じユーザ名が全てのPostgreSQLバックエンドに存在していなければなりません。 さもないと、ヘルスチェックがエラーとなります。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_password (string)

health_check_userで設定したヘルスチェックを行うPostgreSQLユーザ名のパスワードを指定します。 ユーザとパスワードは全てのPostgreSQLバックエンドで同じである必要があります。 さもないと、ヘルスチェックがエラーとなります。

health_check_passwordが空白のままの場合、 Pgpool-IIは空のパスワードを使用する前にまずpool_passwdファイルからhealth_check_userのパスワードを取得できるか試みます。

health_check_passwordにAES256-CBCで暗号化されたパスワードも指定することができます。 AESで暗号化されたパスワードを指定するためには、パスワード文字列は暗号化(aes-256-cbcアルゴリズムを使用)およびbase64でエンコードした後、AESを接頭辞として付けなければいけません。

暗号化されていないクリアテキストパスワードを指定するためには、TEXTをパスワード文字列の前に付けます。 例えば、パスワードとしてmypassを設定したい場合、パスワードフィールドにTEXTmypassと指定すべきです。 有効な接頭辞がない場合、Pgpool-IIは平文のパスワードとして文字列を見なします。

正しくフォーマットされたAES暗号化パスワード文字をpg_encコマンドを使用して作成することもできます。

注意: Pgpool-IIは暗号化されたパスワードを使うために起動時に有効な復号鍵を要求します。 Pgpool-IIに復号鍵を提供する方法の詳細は項6.4.2を参照してください。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_database (string)

ヘルスチェックを行う対象のPostgreSQLデータベース名を指定します。 デフォルトは''で、この場合は最初にpostgresデータベースが試され、その後でtemplate1データベースが試されます。 これはPgpool-II V3.4以前の挙動と同じです。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_max_retries (integer)

ヘルスチェックに失敗したときに、諦めてフェイルオーバを始める前にリトライする最大回数を指定します。

ティップ: この設定は動作にむらのあるネットワーク環境において、マスターノードが正常であるにも関わらず、たまにヘルスチェックが失敗することが予想される場合に有用です。

ティップ: health_check_max_retreisを有効にする場合は、failover_on_backend_errorを無効にするのが望ましいです。

デフォルト値は0で、この場合はリトライをしません。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

health_check_retry_delay (integer)

ヘルスチェックのリトライ間の時間間隔を秒単位で指定します(health_check_max_retries > 0でなければ有効になりません)。 0を指定すると、待ち時間はなくリトライは直ちに行われます。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

connect_timeout (integer)

connect()システムコールを使ったバックエンドへの接続を諦めるまでの時間をミリ秒単位で指定します。 デフォルトは10000ミリ秒(10秒)です。 不安定なネットワークを使う場合、この値を大きくすると良いでしょう。 0を指定すると、タイムアウトしません。

注意: connect_timeoutの値はヘルスチェックだけではなく通常の接続プールを生成するときにも使われます。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。