PostgreSQL コミュニティコンポーネント on PIG.CENTER

pgBadger 13.xリリースノート

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger 13.xのアップストリームの変更記録を、新しいものから順に省略せず掲載しています。

v13.2 · 2025-12-29

前回のリリース以降にユーザーから報告された問題を修正し、提供されたパッチを適用するpgBadgerのメンテナンスリリースです。

YAML 構成設定

Mon, 01 Jan 0001 00:00:00 +0000

グローバル/ユニバーサル

thread_pool_size: リーダー競合またはフェールセーフチェック中に、非同期タスクを実行し、REST API を介して他のメンバーと通信するために Patroni によって使用されるスレッドプールのサイズ。最小値は 5、デフォルト値は 5 です。
thread_stack_size: Patroni によって開始されるスレッドに使用されるスタックサイズを指定します。値は 64kB によってアライメントされる必要があります。最小値は 64kB 、デフォルト値 (Patroni によって設定) は 512kB です。
name: ホストの名前。クラスター内で一意である必要があります。値 __patroni_strict_sync_replica_placeholder__ は、Patroni による内部使用のために予約されており、ノード名として使用することはできません。
namespace: Patroni がクラスターに関する情報を保持する構成ストア内のパス。デフォルト値: 「/service」
scope: クラスター名

スターターガイド

Mon, 01 Jan 0001 00:00:00 +0000

はじめに

Mon, 01 Jan 0001 00:00:00 +0000

Patroniは、Pythonを使用した高可用性（HA）PostgreSQLソリューションのテンプレートです。PatroniはComposeのプロジェクトであるGovernor のフォークとして誕生し、多くの新機能を備えています。

機能

Mon, 01 Jan 0001 00:00:00 +0000

接続をローテートする際の幾つかのレベルの厳しさ：

セッションプーリング

最も丁寧な方法です。クライアントが接続すると、そのクライアントが接続を維持している間は、サーバー接続が常に割り当てられます。クライアントが切断すると、そのサーバー接続はプールに戻されます。このモードは、すべての PostgreSQL 機能をサポートしています。

トランザクションプーリング

クライアントにサーバー接続が割り当てられるのは、トランザクション中に限られます。PgBouncer がトランザクションの終了を検知すると、サーバーはプールに戻されます。このモードでは、PostgreSQL のセッションベースの機能の一部が動作しなくなります。アプリケーションが、破損を引き起こす機能を使用しないよう協力する場合にのみ利用できます。互換性のない機能については、以下の表を参照してください。

ステートメントプーリング

最も攻撃的な方法です。これはトランザクションプーリングの一種ですが、複数文のトランザクションを許可しない点が特徴です。これはクライアント上で「autocommit」モードを強制することを目的としており、主に PL/Proxy を対象としています。
メモリ要件が低く（デフォルトで接続あたり 2 kB）、これは PgBouncer が一度に完全なパケットを確認する必要がないためです。

動的構成設定

Mon, 01 Jan 0001 00:00:00 +0000

動的構成は DCS (分散構成ストア) に保存され、すべてのクラスターノードに適用されます。

動的構成を変更するには、patronictl_edit_config ツールまたは Patroni REST API を使用できます。

loop_wait: ループがスリープする秒数。デフォルト値: 10、可能な最小値: 1
ttl: リーダーロックを取得する TTL (秒単位)。これは、自動フェイルオーバープロセスが開始されるまでの時間と考えてください。デフォルト値: 30、可能な最小値: 20
retry_timeout: DCS および PostgreSQL 操作の再試行のタイムアウト (秒単位)。 DCS またはこれより短いネットワークの問題では、Patroni がリーダーを降格させることはありません。デフォルト値: 10、可能な最小値: 3

警告

loop_wait、retry_timeout、ttlの値を変更する際は、次の条件に従う必要があります。

pgBadger 12.xリリースノート

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger 12.xのアップストリームの変更記録を、新しいものから順に省略せず掲載しています。

v12.4 · 2023-12-25

前回のリリース以降にユーザーから報告された問題を修正するpgBadgerのメンテナンスリリースです。

インストール

Mon, 01 Jan 0001 00:00:00 +0000

Mac OSの前提条件

Macに必要なソフトウェアをインストールするには、次を実行します。

brew install postgresql etcd haproxy libyaml python

ダウンロードとインストール

Mon, 01 Jan 0001 00:00:00 +0000

配布経路を選ぶ

配布経路	用途	場所
公式リリース	ソースのtarballとリリースノート	GitHub Releases
RPMパッケージ	RPMを使用するLinuxディストリビューション	PostgreSQL Yum Repository
Debian/Ubuntuパッケージ	APTを使用するLinuxディストリビューション	PostgreSQL Apt Repository
開発用ソース	未リリースの最新コード	darold/pgbadger

このサイトのドキュメントスナップショットは、13.2のソースツリーに基づいています。ダウンロード前に必ずリリースページを確認してください。ローカルのスナップショットは意図的に固定されていますが、アップストリームのリリースは引き続き更新されます。

設定: pgbouncer.ini

Mon, 01 Jan 0001 00:00:00 +0000

説明

設定ファイルは “ini” 形式です。セクション名は [ と ] の間に記述します。; または # で始まる行はコメントとして扱われ、無視されます。行の途中に出現する ; および # は特殊文字として認識されません。

pgBadger 11.x リリースノート

Mon, 01 Jan 0001 00:00:00 +0000

これらのエントリは、pgBadger 11.x の完全なアップストリーム変更レコードを最新のものから順に保存します。

v11.8 · 2022-04-08

pgBadger のこのリリースでは、過去 3 か月以降にユーザーから報告されたいくつかの問題が修正され、特に増分モードでの新しいログエントリの検出に関する 2 つの修正が行われています。

コマンドラインリファレンス

Mon, 01 Jan 0001 00:00:00 +0000

このページには、固定されたアップストリームソースから生成されたコマンドリファレンスが保存されます。オプション名とヘルプテキストはそのまま残るため、pgbadger --help と直接比較できます。

環境構成の設定

Mon, 01 Jan 0001 00:00:00 +0000

システム環境変数を使用して、Patroni 構成ファイルで定義されている構成パラメーターの一部をオーバーライドすることができます。このドキュメントには、Patroni によって処理されるすべての環境変数がリストされています。これらの変数を介して設定された値は、Patroni 構成ファイルで設定された値よりも常に優先されます。

PgBouncer コマンドの使用法

Mon, 01 Jan 0001 00:00:00 +0000

概要

pgbouncer [-d][-R][-v][-u user] <pgbouncer.ini>
pgbouncer -V|-h

Windows では、次のオプションが利用可能です：

pgbouncer.exe [-v][-u user] <pgbouncer.ini>
pgbouncer.exe -V|-h

Windows サービスの設定に追加で使用できるオプション：

pgBadger 10.x リリースノート

Mon, 01 Jan 0001 00:00:00 +0000

これらのエントリは、pgBadger 10.x の完全なアップストリーム変更レコードを最新のものから順に保存します。

v10.3 · 2019-02-14

pgBadger のこのリリースは、ログ形式の自動検出の問題とユーザーから報告された別の pgBouncer ログ解析の問題を修正するメンテナンスリリースです。新しい機能もあります。

Patroni REST API

Mon, 01 Jan 0001 00:00:00 +0000

Patroni には豊富な REST API があり、リーダーレース中に Patroni 自体によって使用されたり、failovers/switchovers/reinitialize/restarts/reloads を実行するために patronictl ツールによって使用されたり、HTTP ヘルスチェックを実行するために HAProxy またはその他の種類のロードバランサーによって使用されたり、もちろん監視にも使用できます。以下に、Patroni REST API エンドポイントのリストを示します。

PostgreSQLのログ設定

Mon, 01 Jan 0001 00:00:00 +0000

pgBadgerでレポートできるのは、PostgreSQLがログに書き出した情報だけです。まず解析可能なプレフィックスと、目的に応じたステートメントのログ出力方針を設定し、次に分析したい運用イベントを追加してください。

PgBouncer のコンパイルとインストール

Mon, 01 Jan 0001 00:00:00 +0000

Building

PgBouncer はコンパイルするためのいくつかの要素に依存しています：

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+（TLS 機能用）
(オプション) c-ares は Libevent の evdns の代替として利用可能
(オプション) LDAP ライブラリ
(オプション) PAM ライブラリ

依存関係をインストールしたら、次のように実行します：

pgBadger 9.x リリースノート

Mon, 01 Jan 0001 00:00:00 +0000

これらのエントリは、pgBadger 9.x の完全なアップストリーム変更レコードを最新のものから順に保存します。

v9.2 · 2017-07-27

pgBadger のこのリリースは、いくつかの新機能を追加するメンテナンスリリースです。

patronictl

Mon, 01 Jan 0001 00:00:00 +0000

Patroni には patronictl という名前のコマンドラインインターフェイスがあり、これは基本的に Patroni の REST API および DCS と対話するために使用されます。これは、クラスター内での操作の実行を容易にすることを目的としており、人間またはスクリプトで簡単に使用できます。

Source Releases Download

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25

ファイル	日付	サイズ	SHA256
pgbouncer-1.25.2.tar.gz	2026-05-08	865371 バイト	sha256
pgbouncer-1.25.1.tar.gz	2025-12-03	864801 バイト	sha256
pgbouncer-1.25.0.tar.gz	2025-11-09	863322 バイト	sha256

PgBouncer 1.24

ファイル	日付	サイズ	SHA256
pgbouncer-1.24.1.tar.gz	2025-04-16	717796 バイト	sha256
pgbouncer-1.24.0.tar.gz	2025-01-10	706573 バイト	sha256

PgBouncer 1.23

ファイル	日付	サイズ	SHA256
pgbouncer-1.23.1.tar.gz	2024-08-02	700025 バイト	sha256
pgbouncer-1.23.0.tar.gz	2024-07-03	694845 バイト	sha256

PgBouncer 1.22

ファイル	日付	サイズ	SHA256
pgbouncer-1.22.1.tar.gz	2024-03-04	677351 バイト	sha256
pgbouncer-1.22.0.tar.gz	2024-01-31	670589 バイト	sha256

PgBouncer 1.21

ファイル	日付	サイズ	SHA256
pgbouncer-1.21.0.tar.gz	2023-10-16	668211 バイト	sha256

PgBouncer 1.20

ファイル	日付	サイズ	SHA256
pgbouncer-1.20.1.tar.gz	2023-08-09	638844 バイト	sha256
pgbouncer-1.20.0.tar.gz	2023-07-20	638020 バイト	sha256

PgBouncer 1.19

ファイル	日付	サイズ	SHA256
pgbouncer-1.19.1.tar.gz	2023-05-31	623569 バイト	sha256
pgbouncer-1.19.0.tar.gz	2023-05-04	616947 バイト	sha256

PgBouncer 1.18

ファイル	日付	サイズ	SHA256
pgbouncer-1.18.0.tar.gz	2022-12-12	600825 バイト	sha256

PgBouncer 1.17

ファイル	日付	サイズ	SHA256
pgbouncer-1.17.0.tar.gz	2022-03-23	598294 バイト	sha256

PgBouncer 1.16

ファイル	日付	サイズ	SHA256
pgbouncer-1.16.1.tar.gz	2021-11-11	591450 バイト	sha256
pgbouncer-1.16.0.tar.gz	2021-08-09	592136 バイト	sha256

PgBouncer 1.15

ファイル	日付	サイズ	SHA256
pgbouncer-1.15.0.tar.gz	2020-11-19	588042 バイト	sha256

PgBouncer 1.14

ファイル	日付	サイズ	SHA256
pgbouncer-1.14.0.tar.gz	2020-06-11	578955 バイト	sha256

PgBouncer 1.13

ファイル	日付	サイズ	SHA256
pgbouncer-1.13.0.tar.gz	2020-04-27	574955 バイト	sha256

PgBouncer 1.12

ファイル	日付	サイズ	SHA256
pgbouncer-1.12.0.tar.gz	2019-10-17	567465 バイト	sha256

PgBouncer 1.11

ファイル	日付	サイズ	SHA256
pgbouncer-1.11.0.tar.gz	2019-08-27	571414 バイト	sha256

PgBouncer 1.10

ファイル	日付	サイズ	SHA256
pgbouncer-1.10.0.tar.gz	2019-07-01	480571 バイト	sha256

PgBouncer 1.9

ファイル	日付	サイズ	SHA256
pgbouncer-1.9.0.tar.gz	2018-08-13	469300 バイト	sha256

PgBouncer 1.8

ファイル	日付	サイズ	SHA256
pgbouncer-1.8.1.tar.gz	2017-12-20	465930 バイト	sha256
pgbouncer-1.8.tar.gz	2017-12-19	465612 バイト	sha256

PgBouncer 1.7

ファイル	日付	サイズ	SHA256
pgbouncer-1.7.2.tar.gz	2016-02-26	462374 バイト	sha256
pgbouncer-1.7.1.tar.gz	2016-02-18	461903 バイト	sha256
pgbouncer-1.7.tar.gz	2015-12-18	459080 バイト	sha256

PgBouncer 1.6

ファイル	日付	サイズ	SHA256
pgbouncer-1.6.1.tar.gz	2015-09-03	431076 バイト	sha256
pgbouncer-1.6.tar.gz	2015-08-01	412700 バイト	sha256

PgBouncer 1.5

ファイル	日付	サイズ	SHA256
pgbouncer-1.5.5.tar.gz	2015-04-09	336145 バイト	sha256
pgbouncer-1.5.4.tar.gz	2012-11-28	339610 バイト	sha256
pgbouncer-1.5.3.tar.gz	2012-09-12	339013 バイト	sha256
pgbouncer-1.5.2.tar.gz	2012-05-29	335338 バイト	sha256
pgbouncer-1.5.1.tar.gz	2012-04-17	334413 バイト	sha256
pgbouncer-1.5.tar.gz	2012-01-05	411488 バイト	sha256

PgBouncer 1.4

ファイル	日付	サイズ	SHA256
pgbouncer-1.4.2.tgz	2011-06-16	283204 バイト	sha256
pgbouncer-1.4.1.tgz	2011-04-01	282728 バイト	sha256
pgbouncer-1.4.tgz	2011-01-11	231691 バイト	sha256

PgBouncer 1.3

ファイル	日付	サイズ	SHA256
pgbouncer-1.3.4.tgz	2010-09-09	167957 バイト	sha256
pgbouncer-1.3.3.tgz	2010-05-10	167476 バイト	sha256
pgbouncer-1.3.2.tgz	2010-03-15	166756 バイト	sha256
pgbouncer-1.3.1.tgz	2009-07-06	161518 バイト	sha256
pgbouncer-1.3.tgz	2009-02-18	160154 バイト	sha256

PgBouncer 1.2

ファイル	日付	サイズ	SHA256
pgbouncer-1.2.3.tgz	2008-08-08	145372 バイト	sha256
pgbouncer-1.2.2.tgz	2008-08-06	145017 バイト	sha256
pgbouncer-1.2.1.tgz	2008-08-04	144903 バイト	sha256
pgbouncer-1.2.tgz	2008-07-29	143915 バイト	sha256

PgBouncer 1.1

ファイル	日付	サイズ	SHA256
pgbouncer-1.1.2.tgz	2007-12-10	122054 バイト	sha256
pgbouncer-1.1.1.tgz	2007-10-26	121042 バイト	sha256
pgbouncer-1.1.tgz	2007-10-09	120462 バイト	sha256

PgBouncer 1.0

ファイル	日付	サイズ	SHA256
pgbouncer-1.0.8.tgz	2007-06-18	93636 バイト	sha256
pgbouncer-1.0.7.tgz	2007-04-19	93086 バイト	sha256
pgbouncer-1.0.6.tgz	2007-04-12	92244 バイト	sha256
pgbouncer-1.0.5.tgz	2007-04-11	91934 バイト	sha256
pgbouncer-1.0.4.tgz	2007-04-11	91889 バイト	sha256
pgbouncer-1.0.3.tgz	2007-04-11	91489 バイト	sha256
pgbouncer-1.0.2.tgz	2007-03-28	90555 バイト	sha256
pgbouncer-1.0.1.tgz	2007-03-15	89609 バイト	sha256
pgbouncer-1.0.tgz	2007-03-13	88587 バイト	sha256

バイナリパッケージ

さまざまな OS ディストリビューションには、PgBouncer のネイティブなパッケージまたはポートが用意されています。そのため、まずあなたの OS で既に利用可能かどうかを確認することをお勧めします。

並列処理

Mon, 01 Jan 0001 00:00:00 +0000

pgBadgerには相互に補完する2つのマルチプロセスモードがあります。単にCPU数だけでなく、入力の構成に応じて選択してください。

オプション	並列処理の単位	適する入力	主な制約
`-j N` / `--jobs N`	単一ログファイルの分割片	大きなシーク可能なログ1つ	分割境界で少数のクエリーが重複または欠落する場合があります
`-J N` / `--Jobs N`	ログファイル全体	多数の独立したログ	ワーカーを稼働させ続けるだけのファイル数がある場合にのみ効果があります

`-j`で大きなファイルを分割する

$ pgbadger -j 8 /var/log/postgresql/postgresql.log

アップストリームのアルゴリズムは、各ファイルをN個のバイト範囲に分割し、範囲ごとにパーサーをフォークして一時的なバイナリ統計を書き出した後、その統計を最終レポートに統合します。

レプリカのイメージングとブートストラップ

Mon, 01 Jan 0001 00:00:00 +0000

Patroni を使用すると、新しいレプリカの作成をカスタマイズできます。また、新しい空のクラスターがブートストラップされるときに何が起こるかの定義もサポートします。 2 つの区別は明確に定義されています。Patroni は、initialize キーがクラスターの DCS に存在する場合にのみレプリカを作成します。 initialize キーがない場合、Patroni は初期化キーロックを取得する最初のノードで排他的にブートストラップを呼び出します。

増分レポート

Mon, 01 Jan 0001 00:00:00 +0000

増分モードでは、解析した統計をバイナリ形式で保存し、1日ごとのHTMLレポート、1週間ごとの累積レポート、およびそれらを結ぶカレンダー形式の目次を生成します。同じログエントリーを重複して数えずに、ローテーションされたログを繰り返し処理するための機能です。

よくある質問

Mon, 01 Jan 0001 00:00:00 +0000

はじめに

よくある質問では、ユーザーガイド、構成リファレンス、コマンドリファレンスで説明されている場合も、されていない場合もある個別の疑問について、詳しく説明します。ここで問題に関する情報が見つからない場合は、pgBackRestのGitHubのIssue一覧も有用な情報源です。

ヘルプコマンド (help)

Mon, 01 Jan 0001 00:00:00 +0000

3 つのレベルのヘルプが用意されています。コマンドが指定されない場合は、一般のヘルプが表示されます。コマンドが指定された場合（例：pgbackrest help backup）、そのコマンドの詳細な説明と有効なオプションの一覧が表示されます。コマンドに加えてオプションが指定された場合（例：pgbackrest help backup type）、そのオプションがコマンドに適用される際の詳細な説明が表示されます。

サイジングと性能

Mon, 01 Jan 0001 00:00:00 +0000

一般的な CPU 使用率を見ると、TCP モードまたは HTTP close モードでは、処理時間の 15% を HAProxy が、85% をカーネルが使用します。HTTP keep-alive モードでは、HAProxy が約 30%、カーネルが約 70% を使用します。つまり、オペレーティングシステムとそのチューニングは、全体の性能に大きく影響します。

レプリケーションモード

Mon, 01 Jan 0001 00:00:00 +0000

PatroniはPostgreSQLのストリーミングレプリケーションを使用します。ストリーミングレプリケーションの詳細はPostgresのドキュメントを参照してください。デフォルトでは、PatroniはPostgreSQLに非同期レプリケーションを設定します。レプリケーション方式の選択は業務上の要件によって異なります。非同期と同期の両方式、および他の高可用性ソリューションを検討し、最適なものを判断してください。

出力形式

Mon, 01 Jan 0001 00:00:00 +0000

pgBadgerは、ファイル名の拡張子または-x / --extensionから出力形式を選びます。-o / --outfileを複数回指定すると、1回の解析から複数形式を生成できます。

変更履歴

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25.x

2026-05-08 - PgBouncer 1.25.2 - 「不確実性に満ちたタイトル争いに、新鮮な一撃が加わる」

セキュリティ

コミュニティ

Mon, 01 Jan 0001 00:00:00 +0000

チュートリアル

Postgres Plus Standard Server 用に PgBouncer を設定する方法

PgBouncer の概念についての良い概要。

バウンシングの意味とは何か。

プーリングモードの違いについて説明します。

サンプルレポート

Mon, 01 Jan 0001 00:00:00 +0000

サンプルの内容は2022年5月にpgBadger 11.8で生成されました。元のサンプルをこのサイトとともに保存しているため、アップストリームサーバーに接続せずにレポートのナビゲーション、グラフ、スタイル、スクリプトを利用できます。

スタンバイクラスター

Mon, 01 Jan 0001 00:00:00 +0000

Patroniは、「スタンバイクラスター」と呼ばれる機能を使用して、リモートのデータセンター（リージョン）へのカスケードレプリケーションも実行できます。この種類のクラスターには、次の要素があります。

プロジェクトの指標

Mon, 01 Jan 0001 00:00:00 +0000

コードカバレッジ

pgBackRest は、/src のコア C コードを完全に function/branch/line カバーすることを目指しています。

関数/行は例外なく完全にカバーされています。

よくある質問

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer への接続方法

PgBouncer は Postgres サーバーとして動作するため、クライアントを PgBouncer のポートに接続するだけでよい。

ウォッチドッグのサポート

Mon, 01 Jan 0001 00:00:00 +0000

複数のPostgreSQLサーバーがプライマリーとして動作すると、タイムラインが分岐してトランザクションが失われる可能性があります。この状況はスプリットブレイン問題とも呼ばれます。スプリットブレインを避けるには、DCS内のリーダーキーが期限切れになった後にPostgreSQLがトランザクションのコミットを受け付けないよう、Patroniが保証する必要があります。通常、Patroniは何らかの理由でリーダーロックの更新に失敗すると、PostgreSQLを停止することでこれを実現しようとします。しかし、次のようなさまざまな理由で実行できない場合があります。

補完製品と代替製品

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy は、以下に挙げる製品の一部と非常にうまく連携します。そのため、HAProxy に直接関連しないものもここで紹介します。

4.1. Apache HTTP server

Apache は、事実上の標準となっている HTTP サーバーです。非常に充実したモジュール構成のプロジェクトで、ファイル配信と動的コンテンツの両方をサポートします。一部のアプリケーションサーバーのフロントエンドとしても使用でき、リクエストのプロキシやレスポンスのキャッシュも行えます。いずれの用途でも、通常は前段にロードバランサーが必要です。Apache にはさまざまな動作モードがあり、モードによって負荷が異なります。一部のモジュールでは、依然として負荷の大きい prefork モデルが必要なため、接続数が増えるとうまくスケールできません。この場合、HAProxy でサーバーごとの同時接続数を安全な値に制限すると、大きな効果があります。サーバーを大幅に高速化し、そのリソースを確保してアプリケーションで有効に利用できます。

クラスターの一時停止/再開モード

Mon, 01 Jan 0001 00:00:00 +0000

目的

ある条件下では、Patroni はクラスターの管理を一時的に停止する必要があり、DCS にクラスター状態を保持したままにする必要があります。このような状況の例として、メジャーバージョンのアップグレードや破損からの復旧など、稀なクラスター操作が挙げられます。これらの操作中は、Patroni が認識しない理由でノードの起動・停止が頻発し、一部のノードが一時的にプライマリーに昇格する場合もあり、その結果、同時に1つのプライマリーしか実行されていないという前提が破られることがあります。したがって、Patroni は「クラスターから分離」する機能を備えており、Pacemaker のメンテナンスモードに相当する動作を実現できる必要があります。

サポートと貢献

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger はオープンプロジェクトとして維持されています。バグ報告、機能要望、ドキュメントの修正、パッチは、上流の GitHub リポジトリ経由で処理されます。

バグおよび機能要望

最新リリース版にアップグレードし、動作が依然として発生するか確認してください。
既存の回答を検索するには、オープンな問題およびクローズされた問題を確認してください。
問題を再現する最小限の安全なログサンプルおよびコマンドラインに簡略化してください。
認証情報、機密SQL、バインド値、ホスト名、アドレス、および業務データを削除します。
pgBadger のバージョン、オペレーティングシステム、入力形式、正確なオプション、観測結果、期待結果を含む新しいIssue を開いてください。

クラッシュやパーサーの誤りの場合、境界を再現するために必要な最小限のサニタイズ済みログ行のみを含めてください。完全な本番ログや生成されたレポートは、公開Issueへの添付にはほとんどの場合適していません。

ドキュメントとコミュニティ

Mon, 01 Jan 0001 00:00:00 +0000

1. 利用可能なドキュメント

完全な HAProxy ドキュメントは、次のドキュメントに含まれています。時間を節約し、ニーズに最も正確に応えるために、必ず関連ドキュメントを参照してください。また、これらの文書に回答が記載されているメーリングリストに質問を送信することはご遠慮ください。

DCSフェイルセーフモード

Mon, 01 Jan 0001 00:00:00 +0000

問題

Patroniは、リーダー選出とネットワーク分断の検出を行うため、分散構成ストア（DCS）に大きく依存しています。つまり、DCS内のリーダーロックを更新できる場合に限り、ノードはPostgresをプライマリーとして実行できます。リーダーロックの更新に失敗すると、Postgresはただちに降格し、読み取り専用として起動します。この「問題」が発生する可能性は、使用するDCSによって異なります。たとえば、Patroni専用のetcdでは発生する可能性はほぼゼロですが、etcdを基盤に持つK8s APIでは、より頻繁に観測される可能性があります。

ライセンスとクレジット

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger は、PostgreSQL ライセンスに基づいて配布される無料のオープンソースソフトウェアです。著作権およびライセンス通知を保持することを条件として、無償で使用、コピー、変更、配布することができます。

設定マニュアル

Mon, 01 Jan 0001 00:00:00 +0000

KubernetesでのPatroniの使用

Mon, 01 Jan 0001 00:00:00 +0000

PatroniはKubernetesオブジェクトを使用してクラスターの状態を保存し、リーダーキーを管理できます。そのため、整合性ストアを用意せずにKubernetes環境でPostgresを運用できます。つまり、追加のetcdデプロイメントを実行する必要がありません。Patroniがリーダーキーと構成キーの保存に使用できるKubernetesオブジェクトには二種類あり、kubernetes.use_endpointsまたは環境変数PATRONI_KUBERNETES_USE_ENDPOINTSで構成します。

Citusサポート

Mon, 01 Jan 0001 00:00:00 +0000

Patroniを使用すると、マルチノードCitus クラスターを非常に簡単に構築できます。

要点

必要なのは、次の簡単なルールに従うことだけです。

単独インスタンスをPatroniクラスターに移行する

Mon, 01 Jan 0001 00:00:00 +0000

このセクションでは、単独のPostgreSQLインスタンスをPatroniクラスターに移行する手順を説明します。

既存のPostgreSQLインスタンスを使用せずにPatroniクラスターを構築する場合は、実行と設定を参照してください。

他のツールとの統合

Mon, 01 Jan 0001 00:00:00 +0000

Patroni は、スタック内の他のツールと統合できます。このセクションでは、Patroni が他のツールと統合する方法についてのアイデアを提供する例を示します。ただし、すべての例を網羅しているわけではありません。

セキュリティに関する考慮事項

Mon, 01 Jan 0001 00:00:00 +0000

Patroni クラスターには、不正アクセスから保護すべき2つのインターフェースがあります。1つは分散型構成ストレージ（DCS）、もう1つは Patroni REST API です。

DCS の保護

Patroni と patronictl は、DCS に対してデータの格納および取得を行います。

6. キャッシュ

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy は、favicon や css などの小さなオブジェクトを対象とするキャッシュを提供します。RAM 上で動作する、最小限の保守で済む簡素なキャッシュです。

複数のデータセンターにまたがるHA

Mon, 01 Jan 0001 00:00:00 +0000

複数のデータセンターにデプロイしたPostgreSQLクラスターの高可用性は、レプリケーションに基づきます。レプリケーションには同期と非同期があります（レプリケーションモードを参照）。

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

このセクションでは、Patroni に関して最もよくある質問に対する回答を示します。各サブセクションでは、さまざまな種類の質問に焦点を当てます。

リリースノート

Mon, 01 Jan 0001 00:00:00 +0000

バージョン 4.1.5

2026-08-12 をリリース

互換性の向上

PostgreSQL との互換性 14.24、15.19、16.15、17.11、18.6 (Alexander Kukushkin)

新しい output_plugin_libraries GUC を追加します。これは、論理デコード出力プラグインを制限します。

etcdからの読み取り

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdctlをインストールします。

手順

getサブコマンドを使用して、etcdから読み取ります。

バージョンコマンド (version)

Mon, 01 Jan 0001 00:00:00 +0000

pgBackRest のインストール済みバージョンを表示します。

コマンドオプション

出力オプション (`--output`)

出力形式。

貢献ガイドライン

Mon, 01 Jan 0001 00:00:00 +0000

チャット

質問がある場合、対話形式のトラブルシューティング支援が必要な場合、他のPatroniユーザーと話したい場合は、PostgreSQL Slack の#patroni チャンネルに参加してください。

マネージメントガイド

Mon, 01 Jan 0001 00:00:00 +0000

1. 前提条件

Mon, 01 Jan 0001 00:00:00 +0000

このドキュメントでは、HAProxy の起動、停止、管理、トラブルシューティングの方法について説明します。また、既知の制限や回避すべき落とし穴についても述べています。設定方法については記載していません（詳細は configuration.txt を参照してください）。

etcdへの書き込み

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdctlをインストールします。

手順

putサブコマンドを使用して、キー・バリューペアを書き込みます。

2. HAProxy のアーキテクチャ

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy は、マルチスレッドで動作するイベント駆動型のノンブロッキングデーモンです。複数の処理の切り替えをシステムのスケジューリングに任せず、イベントの多重化によってすべての処理をスケジュールします。通常は単一プロセスとして動作するため、システム上で “ps aux” を実行すると “haproxy” プロセスは一つだけ表示されます。ただし、ソフトリロード中に、新しいプロセスと並行して古いプロセスが残りの処理を終えている場合は例外です。このため、strace ユーティリティで動作を簡単に追跡できます。利用可能なプロセッサー数に応じて性能を拡張するため、haproxy はデフォルトで、実行を許可されたプロセッサーごとにワーカースレッドを一つ起動します。明示的に別の設定をしない限り、受信トラフィックはこれらすべてのスレッドに分散され、各スレッドは同じイベントループを実行します。ほぼ線形のスケーラビリティを実現するため、スレッド間の依存関係を必要最小限に抑えるよう細心の注意を払っています。その影響の一つとして、各接続は単一のスレッドで処理されます。したがって、利用可能な処理能力をすべて使うには、少なくともスレッド数と同じだけの接続が必要です。この条件は、ほぼ常に満たされます。

6. メモリ管理

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy は、シンプルかつ高速なプールベースのメモリ管理を使用します。少数の異なるオブジェクトタイプに依存するため、異なるサイズごとに malloc() を呼び出すよりも、適切なサイズのオブジェクトが既に含まれているプールから新しいオブジェクトを選択する方がはるかに効率的です。プールはスタックまたは LIFO として編成されるため、新しく割り当てられたオブジェクトは、CPU キャッシュ内でまだホットな最近リリースされたオブジェクトから取得されます。メモリの断片化を制限するために、同様のサイズのプールがマージされます。

プレフィックスでキーを取得する方法

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdctlをインストールします。
ローカルクラスターをセットアップします。

プレフィックスでキーを取得する

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

グローバルオプション

--endpoints=[127.0.0.1:2379], gRPC endpoints

オプション

--prefix, get a range of keys with matching prefix

例

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

8. ロギング

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy はファイルシステムアクセスを実行しないため、ロギングに関しては常に syslog サーバーに依存します。標準的な使用方法は、UDP 経由でログサーバー (デフォルトではポート 514) にログを送信することです。通常、これはローカル syslog デーモンが実行されている 127.0.0.1 に設定されますが、中央サーバーにログを記録するためにネットワーク経由でも使用されます。中央サーバーは、特にログを到着順にマージしておくことが望ましいアクティブ/アクティブシナリオで追加の利点を提供します。 HAProxy は、UNIX ソケットを使用してログをローカル syslog デーモンに送信することもできますが、HAProxy の実行中に syslog サーバーが再起動されるとソケットが置き換えられ、新しいログが失われるため、これはまったく推奨されません。 HAProxy は chroot ジェイル内に隔離されるため、新しいソケットに再接続する機能はありません。また、UNIX ソケットで使用されているログバッファが非常に小さいため、負荷が非常に軽い場合でもメッセージが失われる可能性があることが現場で観察されています。ただし、これはテストには問題ありません。

10. より簡単な構成管理

Mon, 01 Jan 0001 00:00:00 +0000

クラスターを構成する 2 つの HAProxy ノードが、少数のアドレスを除いてまったく同じ設定を共有することはよくあります。ノードごとに設定の複製を管理すると、その内容は必然的に食い違っていきます。設定に環境変数を組み込めば、システム全体の環境変数をいくつか変えるだけで、複数の設定でまったく同じファイルを共有できます。この機能はバージョン 1.5 で導入され、当初はアドレスにのみ環境変数を含めることができました。1.6 では対応範囲が広がり、どこでも環境変数を使用できます。構文は UNIX シェルと同じで、変数はドル記号 (’$’)、開き波括弧 (’{’)、変数名、閉じ波括弧 (’}’) の順に記述します。アドレスを除き、環境変数は二重引用符で囲まれた引数の中でのみ解釈されます。これは、ドル記号を含む正規表現を使用する既存の設定を壊さないために必要な制限です。

11. 回避すべき既知の落とし穴

Mon, 01 Jan 0001 00:00:00 +0000

システムの再起動後に haproxy サービスが起動せず、手動で起動すると動く、という報告をときどき受けます。多くの場合、keepalived などのクラスター IP アドレス管理機構を使い、マスターノードだけにサービスの IP アドレスを割り当てています。haproxy を 0.0.0.0 にバインドしていたときは動作していたものが、仮想 IP アドレスにバインドするように変更すると動かなくなります。これは、サービスの起動時点ではローカルノードが仮想 IP アドレスをまだ所有しておらず、HAProxy がそのアドレスにバインドしようとすると、ローカルの IP アドレスではないためシステムが拒否することが原因です。解決策は haproxy サービスの起動を遅らせることではありません。それでは再起動に対応できません。ローカルに存在しないアドレスへのバインドを許可するよう、システムを正しく設定します。Linux では、net.ipv4.ip_nonlocal_bind sysctl を 1 に設定するだけです。この設定は、特定の宛先アドレスに向けて HAProxy を通過する IP トラフィックを透過的に捕捉する場合にも必要です。

13. セキュリティに関する考慮事項

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy は、非常に限られた権限で動作するよう設計されています。標準的な使用方法は、chroot jail に隔離したうえで、jail 内で何の権限も持たない非 root ユーザーに権限を落とすことです。これにより、将来脆弱性が発見されても、侵害がシステムの他の部分に影響しないようにします。

キーの削除方法

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdとetcdctl をインストールします。

キーの追加と削除

指定したキーまたはキー範囲を削除するdel：

キーの監視方法

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdとetcdctl をインストールします。

キーの監視

今後の変更の通知を受け取るwatch：

リースの作成方法

Mon, 01 Jan 0001 00:00:00 +0000

TTLを指定した書き込みに使用するlease：

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa granted with TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# or after 300 seconds
etcdctl --endpoints=$ENDPOINTS get sample

ロックの作成方法

Mon, 01 Jan 0001 00:00:00 +0000

LOCKは、指定された名前の分散ミューテックスを取得します。取得したロックは、etcdctlが終了するまで保持されます。

前提条件

etcdとetcdctl をインストールします。

ロックの作成

分散ロックに使用するlock：

etcdクラスターでリーダー選出を行う方法

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcd とetcdctl がインストールされていることを確認します。
稼働中のetcdクラスターを確認します。

リーダー選出を行う

etcdctlコマンドは、etcdクラスターでリーダー選出を行うために使用します。一度にリーダーになれるクライアントが1つだけであることを保証します。

クイックスタート

Mon, 01 Jan 0001 00:00:00 +0000

次の手順に従って、単一メンバーのetcdクラスターをローカルにインストールし、実行してテストします。

ビルド済みのバイナリーまたはソースからetcdをインストールします。詳細はインストールを参照してください。

データベースの保存方法

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

etcdctlとetcdutlをインストールします。
ローカルクラスターをセットアップします。

データベースのスナップショットを取得する

etcdデータベースのある時点のスナップショットを保存するsnapshot：

デモ

Mon, 01 Jan 0001 00:00:00 +0000

この一連の例では、etcdクラスターを操作するための基本的な手順を示します。

認証

認証に使用するauth、user、role：

バグの報告

Mon, 01 Jan 0001 00:00:00 +0000

etcdプロジェクトのいずれかの部分にバグやドキュメントの誤りを見つけた場合は、Issueを作成してお知らせください。私たちはバグや誤りを真剣に受け止めており、小さすぎて報告する必要のない問題はないと考えています。バグを報告する前に、同じ問題を報告するIssueがすでに存在していないか確認してください。

ログの規約

Mon, 01 Jan 0001 00:00:00 +0000

etcdはzap ライブラリーを使用し、アプリケーションの出力をレベル別に分類してログに記録します。ログメッセージのレベルは、次の規約に従って決まります。

Goアプリケーションへのetcdの組み込み

Mon, 01 Jan 0001 00:00:00 +0000

etcdのGoパッケージembedを使用すると、etcdサーバーをアプリケーションに直接、簡単に組み込めます。

詳細はembedパッケージのドキュメントを参照してください。

システムの制限

Mon, 01 Jan 0001 00:00:00 +0000

リクエストサイズの上限

etcdは、メタデータで一般的な小さなキー・バリューペアを処理するように設計されています。大きなリクエストも処理できますが、他のリクエストのレイテンシーが増加する可能性があります。デフォルトでは、各リクエストの最大サイズは1.5 MiBです。この上限は、etcdサーバーの--max-request-bytesフラグで設定できます。

認証

Mon, 01 Jan 0001 00:00:00 +0000

認証に使用するauth、user、role：

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

注意：

これは、認証に関する情報を追加して更新する必要がある未完成のページです。上記のテキストはコード例にすぎません。

バージョン管理

Mon, 01 Jan 0001 00:00:00 +0000

このドキュメントでは、etcdプロジェクトでサポートされるバージョンについて説明します。

サービスのバージョン管理とサポート対象バージョン

etcdのバージョンは、セマンティックバージョニングの用語に従い、x.y.zと表記します。xはメジャーバージョン、yはマイナーバージョン、zはパッチバージョンです。新しいマイナーバージョンでは、APIに機能が追加される場合があります。

etcd v3のベンチマーク

Mon, 01 Jan 0001 00:00:00 +0000

物理マシン

GCE n1-highcpu-2マシンタイプ

/var/lib/etcdにマウントした専用ローカルSSD × 1
OS用の専用低速ディスク × 1
メモリー1.8 GB
CPU × 2
etcdバージョン2.2.0

etcd クラスター

v3デモモードで稼働するetcdメンバー1つ

etcd v2.2.0-rc-memoryのベンチマーク

Mon, 01 Jan 0001 00:00:00 +0000

物理マシン

GCE n1-standard-2マシンタイプ

/var/lib/etcdにマウントした専用ローカルSSD × 1
OS用の専用低速ディスク × 1
メモリー7.5 GB
CPU × 2

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

テスト

各メンバーが2コアを使用する3メンバーのetcdクラスターを起動します。

etcdクラスターとアプリケーションのアップグレード

Mon, 01 Jan 0001 00:00:00 +0000

このセクションには、etcdクラスターとアプリケーションのアップグレードに関するドキュメントをまとめています。

アップグレード方針

アップグレードを始める前に、etcdでサポートされるアップグレードは次の2つの場合だけであることに注意してください。

etcdクラスターとアプリケーションのダウングレード

Mon, 01 Jan 0001 00:00:00 +0000

このセクションには、etcdクラスターとアプリケーションのダウングレードに関するドキュメントをまとめています。

etcd v3.xクラスターのダウングレード

PRの管理

Mon, 01 Jan 0001 00:00:00 +0000

目的

PRの管理を迅速にすること。

etcdのPRはhttps://github.com/etcd-io/etcd/pullsに一覧表示されています。 PRにはさまざまなラベル、マイルストーン、レビュアーなどを設定できます。ラベルの詳細な一覧は、次のページを参照してください。 https://github.com/kubernetes/kubernetes/labels

帰属とライセンス

Mon, 01 Jan 0001 00:00:00 +0000

pig.centerは、6つのアップストリームプロジェクトが作成したドキュメントを再公開しています。各ドキュメントページの末尾には、原著作物、著作権者、ライセンス、およびこのページの該当セクションへのリンクを記載した1行の帰属表示があります。

検索

Mon, 01 Jan 0001 00:00:00 +0000

PostgreSQL コミュニティコンポーネント on PIG.CENTER

pgBadger 13.xリリースノート

v13.2 · 2025-12-29

YAML 構成設定

グローバル/ユニバーサル

スターターガイド

はじめに

機能

動的構成設定

pgBadger 12.xリリースノート

v12.4 · 2023-12-25

インストール

Mac OSの前提条件

ダウンロードとインストール

配布経路を選ぶ

設定: pgbouncer.ini

説明

pgBadger 11.x リリース ノート

v11.8 · 2022-04-08

コマンドラインリファレンス

環境構成の設定

PgBouncer コマンドの使用法

概要

pgBadger 10.x リリース ノート

v10.3 · 2019-02-14

Patroni REST API

PostgreSQLのログ設定

PgBouncer のコンパイルとインストール

Building

pgBadger 9.x リリース ノート

v9.2 · 2017-07-27

patronictl

Source Releases Download

PgBouncer 1.25

PgBouncer 1.24

PgBouncer 1.23

PgBouncer 1.22

PgBouncer 1.21

PgBouncer 1.20

PgBouncer 1.19

PgBouncer 1.18

PgBouncer 1.17

PgBouncer 1.16

PgBouncer 1.15

PgBouncer 1.14

PgBouncer 1.13

PgBouncer 1.12

PgBouncer 1.11

PgBouncer 1.10

PgBouncer 1.9

PgBouncer 1.8

PgBouncer 1.7

PgBouncer 1.6

PgBouncer 1.5

PgBouncer 1.4

PgBouncer 1.3

PgBouncer 1.2

PgBouncer 1.1

PgBouncer 1.0

バイナリパッケージ

並列処理

-jで大きなファイルを分割する

レプリカのイメージングとブートストラップ

増分レポート

よくある質問

はじめに

ヘルプ コマンド (help)

サイジングと性能

レプリケーションモード

出力形式

変更履歴

PgBouncer 1.25.x

コミュニティ

チュートリアル

サンプルレポート

スタンバイクラスター

プロジェクトの指標

コードカバレッジ

よくある質問

PgBouncer への接続方法

pgBadger 11.x リリースノート

pgBadger 10.x リリースノート

pgBadger 9.x リリースノート

`-j`で大きなファイルを分割する

ヘルプコマンド (help)

バージョンコマンド (version)

出力オプション (`--output`)