リファレンス

物理マシン GCEのn1-highcpu-2マシンタイプ /var/lib/etcdにマウントした専用ローカルSSD：1台 OS用の専用低速ディスク：1台 メモリー：1.8 GB CPU：2基 etcdバージョン：2.1.0 alpha etcdクラスター etcdメンバー3つを、それぞれ別のマシンで実行します。 テスト 別のマシンを起動し、hey HTTPベンチマークツール を使って各etcdメンバーにリクエストを送信します。詳しい手順はベンチマーク開発ガイド を参照してください。 性能 単一 …

物理マシン GCEのn1-highcpu-2マシンタイプ etcdのデータディレクトリとしてマウントした専用ローカルSSD：1台 OS用の専用低速ディスク：1台 メモリー：1.8 GB CPU：2基 etcdクラスター etcd 2.2.0メンバー3つを、それぞれ別のマシンで実行します。 バージョンの詳細： etcd Version: 2.2.0 Git SHA: e4561dd Go Version: go1.5 Go OS/Arch: linux/amd64 テスト etcdクラスターの外部 …

物理マシン GCEのn1-highcpu-2マシンタイプ /var/lib/etcdにマウントした専用ローカルSSD：1台 OS用の専用低速ディスク：1台 メモリー：1.8 GB CPU：2基 etcdクラスター etcd 2.2.0-rcメンバー3つを、それぞれ別のマシンで実行します。 バージョンの詳細： etcd Version: 2.2.0-alpha.1+git Git SHA: 59a5a7e Go Version: go1.4.2 Go OS/Arch: linux/amd64 比較 …

物理マシン 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クラスターを起動します。 キー名の長さは常に64バイトとし …

物理マシン 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 v3ベンチマークツール を使用します。 性能 単一キーの読み取り キーサイズ（バイト） クライアント数 読み取りQPS 90パーセンタイルのレイテンシー（ms） 256 1 2716 …

注記 監視機能は活発に開発されているため、開発が進むにつれてメモリー使用量が変わる可能性があります。ただし、以下の数値を大幅に超えて増えることは想定していません。 etcdの主な目標の1つは、非常に多くのウォッチャーが膨大な数の監視を行えるようにすることです。etcdは、O(10k)のクライアント、O(100K)の監視ストリーム（クライアントあたりO(10)ストリーム）、合計O(10M)の監視（ストリームあたりO(100)の監視）への対応を目指しています。個々の監視が消費するメモリーは …

etcdのストレージでは、2つの構成要素が物理メモリーを消費します。etcdプロセスは、キーの検索を高速化するためにインメモリーインデックスを割り当てます。また、オペレーティングシステムが管理するプロセスのページキャッシュには、最近ディスクから読み込んだデータが保存され、すばやく再利用できます。 インメモリーインデックスは、ディスク上のデータ（値）へのポインターとともに、すべてのキーをB木 のデータ構造で保持します。B木の各キーには、値の異なるバージョンを指す複数のポインターが含まれる場合があ …

ベンチマーク etcdのベンチマークは定期的に公開され、以下の各リリースについて追跡されます。 etcd v2.1.0-alpha etcd v2.2.0-rc etcd v3デモ メモリー使用量のベンチマーク さまざまなシナリオで想定されるメモリー使用量を記録します。 etcd v2.2.0-rc

サポート階層 etcdはさまざまなプラットフォームで動作しますが、保証の内容はプラットフォームのサポート階層によって異なります。 階層1：etcdメンテナー が完全にサポートします。機能テストと堅牢性テストを含むすべてのテストに合格することを保証します。 階層2：統合テストとエンドツーエンドテストへの合格を保証しますが、機能テストや堅牢性テストに合格するとは限りません。 階層3：ビルドできることを保証します。簡単なテストしか行っていない、またはテストしていない可能性があるため、不安定なものとして …

開発やテストでは、etcdは通常、限られたリソースでも問題なく動作します。ノートPCや安価なクラウドマシンでetcdを使って開発することも一般的です。ただし、etcdクラスターを本番運用する場合は、適切に管理するうえでハードウェアの指針が役立ちます。ここでの提案は厳格な規則ではなく、堅牢な本番環境を構築する出発点です。どの環境でも、本番運用前に想定ワークロードを再現してテストすることを推奨します。 CPU 大きなCPU処理能力を必要とするetcd環境は多くありません。一般的なクラスターは、2〜4 …

etcdは、次の方法で設定できます。 コマンドラインフラグ 環境変数：各フラグには、同じ名前を大文字のスネークケース に変換し、ETCD_を付けた環境変数が対応します。たとえば、--some-flagはETCD_SOME_FLAGになります。 設定ファイル 警告 注意：設定方法を組み合わせた場合は、次の規則が適用されます。 コマンドラインフラグは環境変数より優先されます。 設定ファイルを指定すると、すべてのコマンドラインフラグと環境変数は無視されます。 コマンドラインフラグ 以下では、フラグを …

このAPIリファレンスは、各見出しに記載した.protoファイルから自動生成されています。 サービス Lock (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto) ロックサービスは、クライアント側のロック機能をgRPCインターフェースとして公開します。 メソッド リクエスト型 レスポンス型 説明 Lock LockRequest LockResponse Lockは、指定した名前付きロックの分散共有ロックを取得します。成功すると、呼び出し元が …

このAPIリファレンスは、各見出しに記載した.protoファイルから自動生成されています。 サービス Auth (api/etcdserverpb/rpc.proto) メソッド リクエスト型 レスポンス型 説明 AuthEnable AuthEnableRequest AuthEnableResponse AuthEnableは認証を有効にします。 AuthDisable AuthDisableRequest AuthDisableResponse AuthDisableは認証を無効にします。 …

このドキュメントでは、etcdの機能と、それに関連する非推奨化の手続きを理解できるよう、機能の概要を説明します。etcdで機能を開発する方法については、開発ガイドライン を参照してください。 etcdの機能には、「実験的」「安定」「安全でない」の3つの段階があります。etcd --helpを実行すると、機能の一覧を確認できます。 実験的 早期にフィードバックを得るため、新機能は通常、実験的機能として追加されます。実験的機能はフラグ名で識別でき、その名前には--experimentalという接頭辞 …

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

このドキュメントでは、etcdのドキュメント、コマンドライン、ソースコードで使う各種用語を定義します。 アラーム クラスターの信頼性を維持するために運用担当者の介入が必要になると、etcdサーバーはアラームを発報します。 認証 認証は、etcdリソースに対するユーザーのアクセス権限を管理します。 クライアント クライアントはetcdクラスターに接続し、キー・バリューペアの取得、データの書き込み、更新の監視などのサービスリクエストを発行します。 クラスター クラスターは複数のメンバーで構成されます …

etcdプロジェクトはバージョン3.5以降、単一のリポジトリ に置かれた複数のGoモジュール で構成されています。 次のモジュールがあります。 go.etcd.io/etcd/api/v3 - etcdクライアントとサーバー間の通信プロトコルを定義する API定義（protoやprotoから生成されたライブラリーなど）を含みます。 go.etcd.io/etcd/pkg/v3 - etcdで使用する、etcd固有ではないユーティリティーパッケージ群です。 将来独立したリポジトリに移せる可能性のあ …

etcdはzap ライブラリーを使用し、アプリケーションの出力をレベル別に分類してログに記録します。ログメッセージのレベルは、次の規約に従って決まります。 DebugLevelのログは通常、大量に出力されるため、本番環境では一般に無効にします。 例： リモートピアへの通常のメッセージの送信 ディスクへのログエントリーの書き込み InfoLevelは、デフォルトのログ優先度です。 例： 起動時の構成 スナップショット作成の開始 クラスターへの新しいノードの追加 認証サブシステムへの新しいユーザーの …

注記 このページでは、etcd 3.7で削除された旧v2ディスカバリープロトコルを説明しています。新しいv3.7環境のデプロイには、v3ディスカバリープロトコル を使用してください。 検出サービスのプロトコルは、共有の検出URLを使い、クラスターの初期構築時に新しいetcdメンバーが他のすべてのメンバーを検出するためのものです。 検出サービスのプロトコルは、クラスターの初期構築時にのみ使用します。実行時の再構成やクラスターの監視には使用できません。 このプロトコルは、新しい検出トークンを使って …

ディスカバリーサービスのプロトコルは、共有のディスカバリートークンとエンドポイントリストを使用して、クラスターのブートストラップ時に新しいetcdメンバーが他のすべてのメンバーを検出できるようにします。 ディスカバリーサービスのプロトコルは、クラスターのブートストラップ時にのみ使用します。実行時の再構成やクラスターの監視には使用できません。 このプロトコルでは、新しいディスカバリートークンを使って一意のetcdクラスターをブートストラップします。1つのディスカバリートークンが表せるetcdクラス …

etcdはメトリクスの報告にPrometheus を使用します。メトリクスはリアルタイムの監視やデバッグに利用できます。etcdはメトリクスを永続化しないため、メンバーを再起動するとメトリクスはリセットされます。 利用可能なメトリクスを確認する最も簡単な方法は、メトリクスのエンドポイント/metricsにcURLでアクセスすることです。形式はPrometheusのドキュメント に記載されています。 Prometheusの入門ドキュメント に従ってPrometheusサーバーを起動し、etcdのメ …

以下に挙げるサードパーティーのライブラリーやツール（https://github.com/etcd-io 以外で公開されているもの）は、etcdチームによるテストや保守の対象外です。利用する前に、それぞれのドキュメントを読み、調査することを推奨します。 ツール etcdctl - etcd用コマンドラインクライアント。 etcd-dump - etcdのダンプとリストアを行うコマンドラインユーティリティー。 etcd-fs - etcd用のFUSEファイルシステム。 etcddir - etcd …

etcdの概要 etcdとは何ですか？ etcdは、整合性のある分散キー・バリューストアです。主に分散システム内で、独立した協調サービスとして使用されます。全体をメモリーに収められる少量のデータを保持するように設計されています。 etcdはどう発音しますか？ etcdの発音は**/ˈɛtsiːdiː/**で、「分散したetcディレクトリ」を意味します。 クライアントはetcdのリーダーにリクエストを送る必要がありますか？ Raft はリーダーを基盤とする仕組みで、クラスターのコンセンサスが必要な …

このページでは、管理者がetcdに指定できる各種フィーチャーゲートの概要を説明します。 機能の各段階については、機能の段階 を参照してください。 概要 フィーチャーゲートは、etcdの機能を表すkey=valueペアの集合です。 etcdのコマンドラインフラグ--feature-gatesで、各機能を有効または無効にできます。 etcdでは、一連のフィーチャーゲートを有効または無効にできます。 すべてのフィーチャーゲートを確認するには、-hフラグを使用します。 フィーチャーゲートを設定するには …

以下のセクションは使用頻度が低く、通常は少数のパラメーターだけをサポートします。セクション同士に暗黙の関係はありません。いずれも単一のキーワードで開始します。“global"セクションより前に置くことはできません。SSL関連など、一部のサポートはビルドオプションによる場合があります。 12.1. トレース デバッグのために、HAProxyのサブシステムでトレースを有効にできます。特定のサブシステムのデバッグメッセージを出力する、問題の診断に非常に有効なツールです。トレースはCLIで動的に設定で …

HAProxyのスティックテーブルは、特定の型のキーにさまざまな情報やメトリクスを関連付け、最後の更新から一定期間保持する仕組みです。キーの値を行番号とし、各列が異なる項目を表す、複数列のテーブルの一行と考えることができます。 スティックテーブルは当初、クライアントとサーバーの間でセッションを持続させるため、その対応付けの情報を保存する目的で設計されました。クライアントが接続またはリクエストを送信すると、識別子（送信元アドレス、Cookie、URLパラメーター）でそのクライアントを識別し、選択 …

HAProxyは、Responder型のFastCGIアプリケーションへHTTPリクエストを送れます。この機能はHAProxy 2.1で追加されました。使うには、サーバーでFastCGIプロトコルを使うよう設定し（server行の"proto fcgi"キーワード）、そのサーバーを管理するバックエンドでFastCGIアプリケーションを設定して使用しなければなりません（proxyセクションの"use-fcgi-app"キーワード）。複数のFastCGIアプリケーションを定義できますが、一つのバッ …

pgBackRestのインストール済みバージョンを表示します。 コマンドオプション 出力オプション (--output) 出力形式です。 次の出力形式をサポートします。 text - インストールされたpgBackRestのバージョンをテキスト形式で表示します。 num - pgBackRestのインストール済みバージョンを整数で表示します。 default: text example: --output=num

ここでは、公式にサポートするフィルターと、それぞれが受け付けるパラメーターを示します。コンパイルオプションによっては、利用できないフィルターもあります。利用可能なフィルターの一覧はhaproxy -vvに表示されます。 関連項目：“filter” 9.1. トレース filter trace [name <name>] [random-forwarding] [max-fwd <max>] [hexdump] 引数： <name> メッセージに表示する任意の名前です。 名前を指定しない場合は …

バージョン 4.1.5 2026-08-12 リリース 互換性の向上 PostgreSQL 14.24、15.19、16.15、17.11、18.6 との互換性 (Alexander Kukushkin) 新しい output_plugin_libraries GUC を追加します。これは、論理デコード出力プラグインを制限します。 改善点 REST API 接続リセットのログを WARNING ではなく DEBUG で記録 (Kyle McLaren) 本物の (接続以外の) エラーの処理に影 …

verifyは、リポジトリ内のバックアップとアーカイブが有効かどうかを判定します。 コマンドオプション 出力オプション（--output） 出力の種類です。 次の出力形式をサポートします。 none - 検証結果を出力しません。 text - 検証情報をstdoutに出力します。 default: none example: --output=text バックアップセットオプション（--set） 検証するバックアップセットです。 指定したバックアップセットに関連するすべてのデータベースファイルと …

新しいpgBackRestプロセスの実行を許可しません。デフォルトでは、実行中のプロセスは正常に完了するまで継続できます。実行中のプロセスを終了するには、--forceオプションを使用します。 stopコマンドの完了後にpgBackRestプロセスを実行すると、エラーが返されます。詳細と例は、開始と停止 を参照してください。 コマンドオプション 強制オプション（--force） すべてのpgBackRestプロセスを強制的に停止します。 このオプションは、実行中のすべてのpgBackRestプロ …

このセクションでは、Patroni に関して最もよくある質問に対する回答を示します。各サブセクションでは、さまざまな種類の質問に焦点を当てます。 これがあなたの疑問のほとんどを解決するのに役立つことを願っています。さらに懸念がある場合、または予期しない問題に直面している場合は、チャット および バグの報告 を参照して、ヘルプを取得したり問題を報告したりする方法を確認してください。 他の HA ソリューションとの比較 repmgr などの他のソリューションでは必要ないのに、Patroni では …

HAProxyは、リクエストやレスポンスのストリーム、クライアントやサーバーの情報、テーブル、環境情報などからデータを抽出できます。このデータ抽出をサンプル取得と呼びます。取得したサンプルはスティックテーブルのキーなど、さまざまな用途に使用できますが、最も一般的な用途は、パターンと呼ばれる定義済みの定数データとの照合です。 7.1. ACLの基本 アクセス制御リスト（ACL）は、任意の情報を定義済みパターンのリストと比較するための、名前付きの方法を宣言するものです。宣言しておくと後から必要に応 …

以前にstopコマンドでpgBackRestプロセスを停止した場合、startコマンドで再び開始可能にできます。このコマンドはpgBackRestプロセスを直ちに起動するのではなく、実行を許可します。詳細と例は、開始と停止 を参照してください。 一般オプション rootでの実行許可オプション（--allow-root） rootユーザーによるコマンドの実行を許可します。 デフォルトでは、ファイルの所有権を慎重に管理するように設計されたrestoreコマンドのみをrootユーザーで実行できます。ほ …

HAProxyは、faviconやcssなどの小さなオブジェクトを対象とするキャッシュを提供します。RAM上で動作する、最小限の保守で済む簡素なキャッシュです。 キャッシュには全スレッドで共有するメモリ領域を使用し、1kBのブロックに分割します。 オブジェクトが使われなくなると、有効期限にかかわらず、新しいオブジェクトを保存するために削除できます。新しいオブジェクトを割り当てる際は、最も古いオブジェクトから削除します。 キャッシュのキーには、hostヘッダーとURIのハッシュを使用します。 …

PostgreSQLを新しいメジャーバージョンにアップグレードした直後に、すべてのpgBackRest設定のpg-pathを新しいデータベースの場所に設定し、stanza-upgradeコマンドを実行する必要があります。ホストに複数のリポジトリが設定されている場合は、それぞれのstanzaをアップグレードします。データベースがオフラインの場合は、--no-onlineオプションを使用してください。 コマンドオプション オンラインオプション（--online） オンラインのクラスターを更新します。 …

“bind”、“server”、“default-server"キーワードは、ビルドオプションやHAProxyをビルドしたシステムに応じた各種設定をサポートします。各設定は通常、単語一つと、その後に続く場合がある値で構成され、“bind"行または"server"行と同じ行に記述します。このセクションでは、これらのオプションをすべて説明します。 5.1. bindオプション “bind"キーワードは、いくつかの設定をサポートし、すべて同じ行の引数として指定します。バインドするアドレスより後ろに記 …

stanza-deleteコマンドは、stanzaに関連するリポジトリ内のデータを削除します。 警告： このコマンドは慎重に使用してください。指定したstanzaのすべてのバックアップとアーカイブを、pgBackRestリポジトリから恒久的に削除します。 stanzaを削除する手順は次のとおりです。 stanzaに関連するPostgreSQLクラスターを停止します（または–forceでこの条件を無視します）。 stanza-deleteコマンドを実行するホストでstopコマンドを実行します。 …

プロキシの設定は、次のセクションに記述できます。 defaults [<name>] [ from <defaults_name> ] frontend <name> [ from <defaults_name> ] backend <name> [ from <defaults_name> ] listen <name> [ from <defaults_name> ] “frontend"セクションは、クライアント接続を受け付けるリッスンソケットの集合を記述します。 “backend"セク …

pgbackrest.confにstanzaを設定した後、stanza-createコマンドを実行する必要があります。複数のリポジトリが設定されている場合は、それぞれにstanzaを作成します。作成済みのstanzaはスキップするため、新しいリポジトリを設定した場合でも、stanza-createは常に安全に実行できます。 詳細と例は、stanzaの作成 を参照してください。 コマンドオプション オンラインオプション（--online） オンラインのクラスターで作成します。 –no-online …

“global” セクションのパラメーターはプロセス全体に適用され、多くはOSに依存します。通常は最初にまとめて設定し、正しく設定できれば変更する必要はありません。一部には対応するコマンドラインオプションがあります。 “global” セクションでは、次のキーワードを使用できます。 プロセス管理とセキュリティ 51degrees-allow-unmatched 51degrees-cache-size 51degrees-data-file 51degrees-difference …

pgBackRest TLSサーバーにpingを送信し、接続を受け付けていることを確認します。認証は試みないため、生存確認のみを行います。 コマンドラインにホストを指定しない場合は、tls-server-hostオプションを使用します。 コマンドオプション TLSサーバーアドレスオプション（--tls-server-address） TLSサーバーのアドレスです。 サーバーがクライアントのリクエストを待ち受けるIPアドレスです。 default: localhost example: …

2.1. 設定ファイルの形式 HAProxyの設定では、主に3つのパラメーター源を使います。 コマンドライン引数。常に優先されます。 設定ファイル。その形式をここで説明します。 実行中のプロセスの環境。環境変数を明示的に参照した場合に使います。 設定ファイルは、いくつかの基本規則に従う、比較的単純な階層形式です。 1. 設定ファイルは、順序を持つ文の並びです。 2. 文は、保護されていない"#"（ハッシュ）より前にある、空でない一行です。 3. 行は、保護されていない空白またはタブで区切った、 …

pgBackRestサーバーは、SSHプロトコルを使用せずにリモートホストにアクセスできるようにします。 コマンドオプション TLSサーバーアドレスオプション（--tls-server-address） TLSサーバーのアドレスです。 サーバーがクライアントのリクエストを待ち受けるIPアドレスです。 default: localhost example: --tls-server-address=* TLSサーバー認可クライアントオプション（--tls-server-auth） TLSサーバーで …

pgBadgerは、PostgreSQLライセンスに基づいて配布される無料のオープンソースソフトウェアです。著作権およびライセンス通知を保持することを条件として、無償で使用、コピー、変更、配布することができます。 PostgreSQLライセンス Copyright (c) 2012-2026, Gilles Darold Permission to use, copy, modify, and distribute this software and its documentation for …

restoreコマンドは、デフォルトではバックアップが存在する最初のリポジトリから最新のバックアップを自動選択します（クイックスタート - バックアップのリストア を参照）。リポジトリの確認順序はpgbackrest.confによって決まります（例：repo2より先にrepo1を確認します）。特定のリポジトリから選択するには、--repoオプション（例：--repo=1）を指定できます。最新以外のバックアップが必要な場合は、--setオプションを指定できます。 PITR に …

1. 利用可能なドキュメント HAProxyのドキュメント一式は、次の文書に収録されています。時間を節約し、必要な情報を正確に得るために、該当するドキュメントを必ず参照してください。これらの文書に回答がある質問は、メーリングリストに送らないでください。 intro.txt （このドキュメント）：負荷分散の基本、製品としてのHAProxy、できることとできないこと、回避すべき既知の落とし穴、OS固有の制限、入手方法、開発の進め方、既知の修正をすべて含む版を稼働させる方法、更新方法、補完製品と代替 …

unixのlsコマンドに似ていますが、サポートされているすべてのリポジトリ種類で動作します。このコマンドは、絶対パス、または--repo-pathオプションで定義したリポジトリパスからの相対パスを受け取ります。主に管理、調査、テストに使用し、通常のpgBackRest構成で必須のものではありません。 デフォルトのテキスト出力は、1行に1つのファイル名を表示します。--output=jsonを指定すると、JSON形式で出力できます。 複数のリポジトリが設定されている場合、--repoオプションを指 …

pgBadger 9.xから13.xまでのリリース履歴を、メジャーシリーズ別に新しいリリースから順にまとめています。 これらのエントリーは、各リリース時点の動作を説明しています。過去のデフォルト値、設定名、アップグレード手順は13.2と異なる場合があります。運用設定には、現在のコマンドラインリファレンスとPostgreSQLのログ設定ガイドを参照してください。 シリーズ 含まれるバージョン 最初–最後のリリース ページ 13.x 13.0–13.2 2024-12-08 – 2025-12-29 …

unixのcatコマンドに似ていますが、サポートされているすべてのリポジトリ種類で動作します。このコマンドには完全修飾ファイル名が必要で、主に管理、調査、テストに使用します。通常のpgBackRest構成で必須のものではありません。 リポジトリが暗号化されている場合、repo-getはファイルを自動的に復号します。ファイルは自動的には展開しませんが、出力をgzip -dなどの適切な展開コマンドにパイプで渡せます。 複数のリポジトリが設定されている場合、--repoオプションを指定しない限り、コマ …

PgBouncer への接続方法 PgBouncer は Postgres サーバーとして動作するため、クライアントを PgBouncer のポートに向けるだけで接続できます。 複数のサーバー間でクエリを負荷分散するには？ PgBouncer は、データベース接続文字列でのコンマ区切りのホストリストをサポートしています。load_balance_hosts=round-robin を指定すると、新しいサーバー接続はそのリストを巡回して作成されます。例： [databases] app = …

サンプルの内容は2022年5月にpgBadger 11.8で生成されました。レポートのナビゲーション、グラフ、スタイル、スクリプトはオフラインで利用できます。 サンプル 紹介する内容 ローカルコピー 完全版レポート PostgreSQLの動作とPgBouncerの統計 完全版レポートを開く 増分レポート カレンダー形式の目次、週次集計、日次ページ 増分レポートの目次を開く エラーとイベント エラーと運用イベントに限定したレポート エラーレポートを開く 完全版レポート 完全版レポートは自己完結型の …

infoコマンドは、単一のstanzaまたはすべてのstanzaを対象に動作します。デフォルトはテキスト出力で、要求したstanzaのバックアップについて、人が読みやすい要約を提供します。この形式は、どのリリースでも変更される可能性があります。 機械可読の出力には--output=jsonを使用します。JSON出力はテキスト出力よりはるかに多くの情報を含み、バグが見つからない限り形式は維持されます。 実行を高速化するには、--detail-level=progressを指定して出力を進行状況の情 …

PgBouncer 1.26.x 2026-09-23 - PgBouncer 1.26.0 - 「これまでのすべての search_path を無視」 セキュリティ CVE-2026-19888 の修正：1.26.0 より前の PgBouncer は、SCRAM client-final-message に nonce が含まれていることをチェックしていませんでした。認証されていないリモート攻撃者は、nonce を含まない client-final-message を送信することで …

pgBadgerは、ファイル名の拡張子または-x / --extensionから出力形式を選びます。-o / --outfileを複数回指定すると、1回の解析から複数形式を生成できます。 形式 一般的な拡張子 主な用途 HTML .html グラフ付きで、人が読みやすく操作可能なレポート テキスト .txt ターミナルでの確認とプレーンテキストによる保存 バイナリ .bin 統合可能な中間統計とレポートの再生成 JSON .json 他のソフトウェアとの連携。JSON::XSが必要 生のCSV …

一般的なCPU使用率を見ると、TCPモードまたはHTTP closeモードでは、処理時間の15% をHAProxyが、85% をカーネルが使用します。HTTP keep-aliveモードでは、HAProxyが約30%、カーネルが約70% を使用します。つまり、オペレーティングシステムとそのチューニングは、全体の性能に大きく影響します。 利用形態はユーザーによって大きく異なります。帯域幅を重視する場合もあれば、リクエストレート、同時接続数、SSL性能を重視する場合もあります。このセクションでは、 …

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

はじめに よくある質問では、ユーザーガイド、構成リファレンス、コマンドリファレンスで説明されている場合も、されていない場合もある個別の疑問について、詳しく説明します。ここで問題に関する情報が見つからない場合は、pgBackRestのGitHubのIssue一覧 も有用な情報源です。 「could not find WAL segment」エラーが発生した場合はどうすればよいですか。 このエラーはさまざまな問題によって発生する可能性があります。たとえば、次のような原因が考えられます。 …

はじめに pgBackRestのリリース番号は、メジャーとマイナーの2つの部分で構成されます。メジャーリリースでは、以前のメジャーリリースとの互換性が失われる可能性があります。ただし、v2リリースはv1リポジトリと完全に互換性があり、すべてのv1オプションを受け付けます。マイナーリリースには不具合修正や新機能が含まれることがありますが、リポジトリ形式は変更せず、オプションや名称の変更も極力避けます。v1リリースのドキュメントはこちら を参照してください。リリースノートには「補足事項」が含まれる …

pgBackRestは、保持数または保持期間という保持種別に基づいてフルバックアップをローテーションします。保持数を指定した場合、期限切れ処理ではバックアップの作成時期ではなく、保持すべき数を基準にします。差分バックアップは数に基づきますが、依存するフルバックアップが期限切れになると必ず期限切れになります。増分バックアップが保持設定によって単独で期限切れになることはなく、関連するフルバックアップまたは差分バックアップとともに期限切れになります。詳細と例は、フルバックアップの保持 と差分バックアッ …

はじめに pgBackRestはコマンドラインパラメーターだけでも使用できますが、構成が複雑な場合や多数のオプションを設定する場合は、設定ファイルの方が実用的です。設定ファイルのデフォルトの場所は/etc/pgbackrest/pgbackrest.confです。この場所にファイルがない場合は、旧デフォルトの/etc/pgbackrest.confを確認します。 次のオプション型を使用します。 文字列：通常は識別子やパスワードなどを表すテキスト文字列です。 コマンドラインの例 …

PgBouncer 1.26 ファイル 日付 サイズ チェックサム pgbouncer-1.26.0.tar.gz 2026-09-23 897943 バイト sha256 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 …

Patroni には patronictl という名前のコマンドライン インターフェイスがあり、これは基本的に Patroni の REST API および DCS と対話するために使用されます。これは、クラスター内での操作の実行を容易にすることを目的としており、人間またはスクリプトで簡単に使用できます。 構成 patronictl は、構成の 3 セクションを使用します。 ctl: Patroni REST API に対して認証する方法、およびサーバー ID を検証する方法。詳細については …

HAProxyは、高可用性、TCPとHTTPの負荷分散、アプリケーショントラフィックの管理を実現する、無料で高速かつ信頼性の高いリバースプロキシです。このコンポーネントでは、HAProxy 3.4の主要な3つのマニュアルの日本語訳全文を、OINK用に階層のない一連のMarkdownページへ再構成しています。 この版は、公式英語マニュアルのメンテナンスブランチのスナップショット3.4.6-66に対応しています。最新の安定版リリースは3.4.6（v3.4.6）です。このスナップショットには、そのリ …

checkコマンドは、指定したstanzaのアーカイブとバックアップに対し、pgBackRestとarchive_command設定が正しく構成されていることを検証します。コマンドを実行するホストに設定されたすべてのリポジトリとデータベースの確認を試みます。必要なWALセグメントがアーカイブに到達せず、バックアップが不完全になるような設定ミス、特にアーカイブの設定ミスを検出します。このコマンドは、PostgreSQLホストまたはリポジトリホストで実行できます。スタンバイホストでも実行できますが、 …

v9.2 · 2017-07-27 pgBadgerのこのリリースは、いくつかの新機能を追加するメンテナンスリリースです。 チェックポイントの距離と推定値のレポートを追加しました。 AWS RedshiftキーワードのサポートをSQLコード整形ツールに追加しました。 リモートモードでのログ形式の自動検出を追加して、pgbouncerログファイルとPostgreSQLログファイルをリモートで解析できるようにします。 いくつかのバグ修正と機能強化もあります。 最後の範囲より上のデータが表示されなかっ …

はじめに コマンドは、pgBackRestのさまざまな機能を実行するために使用します。ここでは、各コマンドのオプションを網羅しています。複数のコマンドに適用されるオプションも、該当する各コマンドのページに記載しています。pgbackrest.confで設定できるオプションもすべて含まれます。 pgbackrest.confに設定した非ブール型のオプションは、コマンドラインでreset-接頭辞を使用するとデフォルト値に戻せます。この機能を使うと、リポジトリホスト上で直接バックアップをリストアできま …

Patroni には豊富な REST API があり、リーダー競合中に Patroni 自身によって使用されたり、フェイルオーバー/スイッチオーバー/再初期化/再起動/リロードを実行するために patronictl ツールによって使用されたり、HTTP ヘルスチェックを実行するために HAProxy またはその他の種類のロードバランサーによって使用されたり、もちろん監視にも使用できます。以下に、Patroni REST API エンドポイントのリストを示します。 ヘルスチェックエンドポイント …

複数のリポジトリが設定されている場合、--repoオプションを指定しない限り、pgBackRestは最も優先度の高いリポジトリ（例：repo1）にバックアップします。 pgBackRestにはスケジューラーが組み込まれていないため、cronなどのスケジュール機構から実行することを推奨します。 詳細と例は、バックアップの実行 を参照してください。 コマンドオプション バックアップ注釈オプション（--annotation） ユーザー定義のキー/値ペアでバックアップに注釈を付けます。 バックアップに情 …

v10.3 · 2019-02-14 pgBadgerのこのリリースは、ログ形式の自動検出の問題とユーザーから報告された別のpgBouncerログ解析の問題を修正するメンテナンスリリースです。新しい機能もあります。 -o | --outfile オプションを複数回指定し、一つのコマンドで複数の形式を出力できるようになりました。例： pgbadger -o out.html -o out.json /log/pgsql-11.log HTMLとJSONの二つのレポートが生成され、対応する二つのファ …

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

使い方とオプション 使用法: pgbadger [options] logfile […] 詳細なレポートとグラフを生成するPostgreSQLログアナライザー。 引数: logfileには、単一のログファイル、複数のファイル、またはファイル一覧を返す シェルコマンドを指定できます。標準入力からログを渡す場合はファイル名に-を 指定します。csvlog形式は標準入力からの読み取りに対応していません。 オプション: -a | --average minutes : クエリーと接続の平均グラフを作成 …

Patroni 構成には 3 タイプがあります。 グローバル 動的構成 。 これらのオプションは DCS (分散構成ストア) に保存され、すべてのクラスター ノードに適用されます。動的構成は、patronictl_edit_config ツールまたは Patroni REST API を使用していつでも設定できます。変更されたオプションがスタートアップ コンフィギュレーションの一部ではない場合、オプションはすべてのノードに非同期的に (次のウェイクアップ サイクル時に) 適用され、その後リロー …

PostgreSQLからWALセグメントを受け取り、インデックス付きのrepo-pathオプションで定義された各リポジトリにアーカイブします（リポジトリの設定については、リポジトリ セクションを参照）。WALセグメントは、archive-asyncの値に応じて、直ちにアーカイブに送信されるか、ローカルに保存されます。複数のリポジトリが設定されている場合、archive-pushはできる限り多くのリポジトリへの送信を試みます。 archive-pushは、PostgreSQLに設定して呼び出すこと …

v11.8 · 2022-04-08 pgBadgerのこのリリースでは、過去3か月間にユーザーから報告されたいくつかの問題が修正され、特に増分モードでの新しいログエントリーの検出に関する2つの修正が行われています。 log_line_prefixでミリ秒(%m)またはエポック(%n)が使用された場合のタイムスタンプ付きの新しいログエントリーの検出を修正しました。 マルチプロセスが使用されていない場合のローカルファイル内の新しいログエントリーの検出を修正しました。 変更と謝辞の完全な一覧は次のと …

説明 設定ファイルは “ini” 形式です。セクション名は [ と ] の間に記述します。; または # で始まる行はコメントとして扱われ、無視されます。行の途中に出現する ; および # は特殊文字として認識されません。 汎用設定 logfile ログファイルを指定します。デーモン化する場合 (-d)、この設定または syslog のいずれかを設定する必要があります。 ログファイルは開いたまま保持されるため、ローテーション後は kill -HUP または管理コンソールで RELOAD; を実 …

グローバル/ユニバーサル thread_pool_size: リーダー競合またはフェールセーフ チェック中に、非同期タスクを実行し、REST API を介して他のメンバーと通信するために Patroni によって使用されるスレッド プールのサイズ。最小値は 5、デフォルト値は 5 です。 thread_stack_size: Patroni によって開始されるスレッドに使用されるスタック サイズを指定します。値は 64kB によってアライメントされる必要があります。最小値は 64kB 、デフォ …

このコマンドは、PostgreSQLがバックアップのリストアやPITRを実行する際、またはレプリカを最新の状態に保つためにストリーミングの代わりとして使用します。WALセグメントは、PostgreSQLのリカバリーやレプリカの維持に必要です。 複数のリポジトリが設定されている場合、WALは優先度順（例：repo1、repo2など）にリポジトリから取得します。一般に、より高速または低コストのストレージを高い優先度にする方が適切です。--repoオプションでリポジトリを指定した場合は、そのリポジトリ …

v12.4 · 2023-12-25 前回のリリース以降にユーザーから報告された問題を修正するpgBadgerのメンテナンスリリースです。 pgbouncerバージョン1.21のレポートを修正しました。パッチを提供してくださったAles Zelenyに感謝します。 ファイル単位の並列度がファイル数を超えないようにしました。報告してくださったmaliangzhuに感謝します。 v12.3以降で壊れていた回帰テストを修正しました。報告してくださったieshinに感謝します。 LOGエントリーが …

動的構成は DCS (分散構成ストア) に保存され、すべてのクラスター ノードに適用されます。 動的構成を変更するには、patronictl_edit_config ツールまたは Patroni REST API を使用できます。 loop_wait: ループがスリープする秒数。デフォルト値: 10、可能な最小値: 1 ttl: リーダー ロックを取得する TTL (秒単位)。これは、自動フェイルオーバー プロセスが開始されるまでの時間と考えてください。デフォルト値: 30、可能な最小値: …

脆弱な暗号化サブキーとソルト 2026年10月4日 2.59.3より前のpgBackRestは、暗号化用のランダムデータを生成する際にエラーを確認していませんでした。OpenSSLがオペレーティングシステムからランダムデータを取得できない場合、メモリ内に既に存在するデータから暗号化サブキーとソルトが生成され、エラーは報告されませんでした。暗号化されていないリポジトリは影響を受けません。 このエラーが発生することはまれと考えられます。原因として、getrandom()システムコールをブロックする …

backupコマンドで付けた注釈は、後からannotateコマンドで追加、変更、削除できます。 コマンドオプション バックアップ注釈オプション（--annotation） ユーザー定義のキー/値ペアでバックアップに注釈を付けます。 バックアップに情報を示すキー/値ペアを付加できます。このオプションを複数回指定して、複数の注釈を付けられます。 注釈は、--setでバックアップを指定した場合にinfoコマンドのテキスト出力に表示されます。JSON出力には常に表示されます。 example: …

v13.2 · 2025-12-29 前回のリリース以降にユーザーから報告された問題を修正し、提供されたパッチを適用するpgBadgerのメンテナンスリリースです。 対応する一重引用符で囲まれ、内部にエスケープされた引用符を含む文字列を正しく処理できなかった正規化を修正しました。報告してくださったBertrand Bourgierに感謝します。 ドキュメントのプレースホルダーの要件を修正しました。 エラーのサンプルログエントリーがレポートされない場合があった問題を修正しました。報告してくださった …