pg_stat_ch から取得されます。これは、
ステートメントごとのカウンターを
ClickHouse Cloud にストリーミングするオープンソースの Postgres 拡張機能です。テレメトリーは
データベースを出る前に Postgres 内で正規化されます。リテラルは取り除かれてプレースホルダーに置き換えられるため、
クエリした正確な値がテレメトリーストリームに含まれることはありません。
Cloud Console で ClickHouse Managed Postgres インスタンスを開き、左側のサイドバーで
クエリインサイト をクリックします。ページは、実際に使う順に
5 つの領域に分かれています。
- データベースのヘルスチェックを 1 画面で確認できる 概要。
- データベースで実行されたすべてのクエリパターンを、気になる観点で ソートして順位付けできる 低速クエリパターン テーブル。
- 個々の実行を新しい順に一覧表示する 最近のクエリ パネル。
- アクティブなセッションが待機に費やした時間を待機イベントごとに順位付けする Waits テーブル。
- 単一のパターンに関するすべてのカウンターを集約する 詳細フライアウト。
概要
概要は、9つのパネルを3×3に配置したグリッドです。最初の2行には クエリアクティビティに関するパネルが並んでいます。
この1画面で、データベースが健全かどうかを判断できます。健全なインスタンスには
典型的なパターンがあります。たとえば、バッファヒット率が 90%台後半であること、クエリ量が
アプリケーショントラフィックに応じて増減すること、エラー率が横ばいまたはゼロであること、そして
各パーセンタイルのレイテンシが互いに近い値で推移していることです。

待機チャート
3 行目には、30 秒ごとに取得されるサンプルに基づき、プライマリ上のアクティブなセッションが何を待機していたかが表示されます。
Lock wait time が上昇する一方で、Blocked sessions がゼロを上回ったままになっていないかを確認してください。これは、ロック競合が継続していることを示している可能性があります。いずれかの待機チャートをクリックすると、Waits テーブルが開きます。

低速クエリパターン
概要で問題の兆候が見つかったら、調査はパターンテーブルから始まります。正規化されたクエリパターンごとに1行が表示され、リテラル値は取り除かれているため、同じステートメントの実行は同じ行に集約されます。
- 合計実行時間 — データベースが最も多くの実時間を費やした箇所。
- CPU 時間 — コンピュート負荷の高いパターン。
- 呼び出し回数 — 高頻度のパターン。
- エラー — 繰り返し発生している失敗。
- 平均 / P50 / P95 / P99 / 最大レイテンシ — パーセンタイル別の外れ値。
- 返された行数、読み取られたブロック数、ヒットしたブロック数、WAL バイト数 — engine、cache、write-ahead log を通じて 最も多くのデータを処理したパターン。
- データベース
- ユーザー
- 操作 (
SELECT,INSERT,UPDATE,DELETE, …) - アプリケーション — 接続文字列の
application_name
sales DB で orders サービスが何をしているかだけを表示する」
といった条件は、2 つのドロップダウンで指定できます。フィルター値は、
そのインスタンスで実際に実行された内容に基づいて自動的に補完されます。
パターン テーブルの下にある 最近のクエリ パネルには、個々の実行が
新しい順に表示されます。つまり、パターンごとに1行ではなく、実行された
ステートメントごとに1行が表示されます。集計結果ではなく生のイベント
ストリームを確認したいときに使用します。たとえば、修正が反映されたことを
確認したり、エラーが発生した正確な瞬間を特定したりするのに役立ちます。

Waits
Waits を展開するか、待機チャートをクリックすると、選択した期間の平均アクティブセッション数の多い順に並んだ待機イベントを確認できます。
個々のイベントの説明については、Postgres 待機イベントリファレンスを参照してください。
patterns または 最近のクエリ テーブル内の任意の行をクリックすると、右側に クエリ詳細
フライアウトが開きます。このフライアウトでは、選択した時間範囲におけるそのパターンの
すべての実行を対象に、遅くなっている理由を示すカウンターを集計して表示します。
このフライアウトは、スクロール可能な単一レイアウトで、5 つのセクションがあります。
- クエリパターン — リテラルを
$1、$2、… に置き換えた正規化 SQL と、クリップボードにコピーするボタン。 - 集計リソース使用量 — 合計 呼び出し回数、平均/P95/P99/最大レイテンシー、合計ランタイム、返された行数、cache ヒット率、読み取られたブロック数、ヒットしたブロック数、CPU 時間、WAL バイト数、エラーを含む 13 個の統計カードのグリッド。
- クエリコンテキスト — このパターンの 発生元であるデータベース、ユーザー、操作、アプリケーション。
- 注目すべき実行 — エラー、異常に遅い実行、 および結果セットが大きい実行を、最近の実行の完全な一覧より前に表示します。
- 最近の実行 — 同じパターンの個々の実行で、 実行ごとのカウンターを表示します。


- 共有ブロック — read と hit は常に表示され、written と dirtied は ゼロ以外の場合に表示されます。
- ローカルおよび一時ブロック操作 — 一時ブロック操作がゼロ以外の場合は、ソートまたは ハッシュがディスクにスピルしたことを意味します。
- 読み取り / 書き込み時間 — CPU 時間とは別に表示される I/O 時間です。
- CPU 時間 — user と system がそれぞれ別に表示されます。
- 並列ワーカー — 計画数と実際に起動された数です。
- JIT — JIT コンパイルの合計時間と関数数です。
- WAL — バイト数とレコード数です。
クエリインサイト API
ステートメント単位のテレメトリーは、 ClickHouse Cloud OpenAPI を通じて 利用することもできます。 低速クエリパターン テーブルは list slow query patterns エンドポイントに対応し、詳細フライアウト は get slow query pattern エンドポイントに対応しています。このエンドポイントは、1 つのパターンの集計メトリクスと その最近の実行を返します。pg_stat_ch は parse-analyze フェーズにフックし、各リテラルを
プレースホルダー ($1、$2、…) に置き換え、その結果のパターンを
queryid をキーにしたバックエンドごとの LRU にキャッシュします。ステートメントの
実行が完了すると、そのキャッシュされたパターンがイベントに付与されます。値を含む
元のステートメントがデータベースの外に出ることはありません。
プロデューサーによるオーバーヘッドは、ステートメントごとにおよそ 3% です。enqueue パス
では、共有メモリのリングバッファに対して非ブロッキングの try-lock を使用します。負荷が高い
場合は、Postgres にバックプレッシャーをかける代わりに、拡張機能がカウンターを増やしてイベントを破棄します。
Waitsはサンプリングで取得される
待機チャートとWaitsテーブルは、プライマリで30秒ごとに収集されるサンプルに基づいています。短時間の待機はサンプル間で完結してしまうと表示されないことがあるため、これらのビューは継続的な待機やロック競合の特定に最も適しています。pg_stat_ch は、実行された各ステートメント (トップレベルとネストの両方) ごとに、サンプリングの対象となる 1 件の生のイベントを出力します。クエリのパーセンタイル、ランキング、内訳は、このイベントストリームをもとに ClickHouse 上で算出されます。
Insights のバックエンドは ClickHouse Cloud です。
高負荷な Postgres インスタンスからのクエリごとのテレメトリーは、1 日あたり数百万行に達します。
列指向圧縮により、実行単位の詳細データを数か月分でも低コストで保持でき、
数十億行に対してもサブ秒で集計できるため、
1 週間や 1 か月の単位で絞り込んでも UI を軽快に操作できます。
pg_stat_ch は Apache 2.0 ライセンスです。任意の Postgres に対して実行でき、任意の
ClickHouse に送信できます。ソースコードと issue は
github.com/clickhouse/pg_stat_ch にあります。
関連ページ
- 監視ダッシュボード — 組み込みのリソースおよびアクティビティのチャート
- Prometheus エンドポイント — ホストレベルのメトリクスを独自のオブザーバビリティスタックに取り込めます
- ClickHouse Managed Postgres OpenAPI — 低速クエリパターンや最近の実行履歴をプログラムから取得できます
- 拡張機能 — ClickHouse Managed Postgres インスタンスで利用可能な拡張機能
- GitHub 上の
pg_stat_ch— クエリインサイトを支えるオープンソースの拡張機能