こんにちは！データベースのパフォーマンスチューニングや日々の運用管理、本当にお疲れ様です。
現場でPostgreSQLを触っていると、「pgAdminの標準ダッシュボード、見やすくて便利だけど、うちのサービス特有のメトリクスもここに集約できたらなぁ…」と感じたことはありませんか？CPU使用率やコネクション数だけでなく、「特定のエラーログの発生頻度」や「重要なマスタテーブルの更新差分」などをリアルタイムで監視できたら、障害対応のスピードは圧倒的に変わりますよね。
今回は、pgAdmin 4の標準機能では物足りないと感じているあなたへ向けて、PostgreSQLの内部カタログを駆使して独自の監視クエリを登録し、pgAdmin上でカスタムメトリクスとして可視化する極限のテクニックを、優しく丁寧にお伝えします。
これをマスターすれば、日々のDB監視やトラブルシューティングが劇的に楽になりますよ。さあ、一緒にデータベースの深淵を覗いてみましょう！
—
1. なぜ「pgAdminの拡張」が必要なのか？
pgAdmin 4は、PostgreSQL公式の強力な管理GUIツールです。ブラウザベースでありながら多機能で、標準の「Dashboard」タブでは、セッション数、トランザクション数、I/Oの状況などがグラフィカルに表示されます。
しかし、実際の現場では「一般的なメトリクス」だけでは不十分です。
- 「特定の重いバッチ処理が、今どの程度の進捗率で走っているか」
- 「キャッシュヒット率は十分か（インデックスがちゃんと効いているか）」
- 「特定のECテーブルにおける未出荷データの滞留数」
これらをわざわざ別の監視ツール（PrometheusやGrafanaなど）を立てて構築するのも一つの手ですが、「日常的に開いているpgAdmin上で、DBの健康状態を一元管理できたら一番スムーズ」ですよね。
pgAdmin 4のダッシュボードは、実は内部で定期的にSQLクエリを発行し、その結果を描画しています。つまり、「PostgreSQLのシステムカタログ（システムビュー）を叩く独自のクエリ」を定義し、それを組み込むことができれば、無限の可能性が広がります。
—
2. 基礎知識：PostgreSQLの心臓部「システムカタログ」を覗く
カスタムメトリクスを作るためには、PostgreSQLが内部で保持している統計情報にアクセスする必要があります。まずは、その基本となる「システムカタログ」の概念を軽く押さえましょう。
PostgreSQLは、データベースのメタデータや統計情報を `pg_catalog` というスキーマ内に隠し持っています。例えば、以下のビューは現場でよく使う鉄板のものです。
- `pg_stat_activity`: 現在実行中のプロセス（セッション）の状態
- `pg_stat_database`: データベースごとの統計情報（コミット数、ロールバック数、キャッシュヒット率など）
- `pg_stat_user_tables`: ユーザーテーブルごとのアクセス統計（シーケンシャルスキャンの回数など）
まずは、pgAdminの「Query Tool」を開いて、次のような独自の監視クエリが正しく動くかテストしてみましょう。これが「Hello World」ならぬ、カスタムメトリクスの第一歩です。
動作確認用クエリ：キャッシュヒット率の算出
データベースがメモリ上で効率よく処理を行えているか（ディスクからの読み込みを減らせているか）を示す、極めて重要な指標です。
— データベース全体のキャッシュヒット率を計算するクエリ
SELECT
datname AS database_name,
blks_hit::float / (blks_hit + blks_read + 1) 100 AS cache_hit_ratio
FROM
pg_stat_database
WHERE
datname = current_database();
Query Toolでこれを実行し、パーセンテージ（通常99%以上が望ましい）が返ってくることを確認してください。この「1行のJSONや数値、あるいはテーブル形式で結果を返すSQL」こそが、カスタムメトリクスの源泉となります。
—
3. ステップ・バイ・ステップ：カスタムメトリクスの登録と可視化
ここからが本番です。pgAdmin 4のダッシュボードを拡張し、先ほど作成したような独自のカスタムメトリクスを組み込む手順を解説します。
pgAdmin 4では、ダッシュボードの表示項目や統計情報のポーリング間隔、取得するSQLなどは設定ファイル（Python製バックエンドの仕組み）によって管理されています。
ステップ1: 設定ファイルの場所を特定する
pgAdmin 4のデスクトップ版やサーバーモードによって異なりますが、設定をカスタマイズするためのファイル群はインストールディレクトリ内に存在します。
Docker環境やソースコードから動かしている場合は、環境内の `config_local.py` または `pgadmin/utils/driver/psycopg2/…` あたりの統計情報取得ロジックを拡張するのが上級者のアプローチですが、今回は最も安全かつスマートに「カスタムダッシュボード・パネル」を追加する手順を見ていきましょう。
ステップ2: カスタムSQLを「Statistics（統計情報）」タブに統合する
pgAdminのオブジェクトツリーで任意のデータベースを選択し、「Statistics」タブを開くと、標準の統計情報が表形式で表示されます。
ここに独自のカスタム統計を追加するには、PostgreSQL側でカスタムビュー（View）を作成し、それをpgAdminから参照させるのが一番エレガントで安全な方法です。pgAdmin本体のソースコードを書き換える必要がないため、バージョンアップ時にも壊れません。
① PostgreSQL側でカスタムビューを作成する
DB管理者権限で、監視用のスキーマとビューを作成します。
— 監視専用のスキーマを作成（すでになければ）
CREATE SCHEMA IF NOT EXISTS monitoring;
— キャッシュヒット率や死活監視をまとめたカスタムビューを作成
CREATE OR REPLACE VIEW monitoring.vw_custom_dashboard_metrics AS
SELECT
current_timestamp AS checked_at,
datname AS database_name,
numbackends AS active_connections,
xact_commit AS total_commits,
xact_rollback AS total_rollbacks,
— キャッシュヒット率を算出
ROUND(
COALESCE(blks_hit::numeric / NULLIF(blks_hit + blks_read, 0) 100, 0),
2
) AS cache_hit_ratio_percent
FROM
pg_stat_database
WHERE
datname = current_database();
— 一般的な監視用ロールにも権限を付与しておく
GRANT SELECT ON monitoring.vw_custom_dashboard_metrics TO PUBLIC;
② pgAdminの「Dashboard」や「Query Tool」からお気に入りに登録する
作成したビューは、pgAdminのオブジェクトツリーの「Views」配下に綺麗に現れます。
1. pgAdminの左側ツリーから `Databases` -> `あなたのDB` -> `Schemas` -> `monitoring` -> `Views` -> `vw_custom_dashboard_metrics` を選択。
2. 右ペインの「View/Edit Data」（データの表示）をクリック。
3. これにより、リアルタイムのカスタムメトリクスが美しい表形式でブラウザ上に描画されます。
「これだけ？」と思われるかもしれませんが、現場のエンジニアにとって、複雑なクエリを打たなくても、クリック数回で独自のビジネスロジックやインフラ指標にアクセスできるビューを用意しておくことこそが、最大の効率化（ダッシュボードの拡張）なのです。
—
4. さらに踏み込む：アラートを兼ねた「異常値検知クエリ」の常駐化
単に数値を眺めるだけでなく、さらに実用的なテクニックとして、「問題がある時だけ行を返す（＝アラート用の）」カスタムクエリをpgAdminのDashboardやスクラッチパッドに常駐させる方法を紹介します。
例えば、「長く残りすぎているアイドルセッション（Idle in transaction）」は、ロック競合やメモリ枯渇の原因になります。これを常時監視するカスタムクエリを組んでみましょう。
— 【危険なアイドルセッションの検出クエリ】
— 5分以上「idle in transaction」状態になっているプロセスをあぶり出す
SELECT
pid,
usename,
datname,
state,
now() – state_change AS idle_duration,
query
FROM
pg_stat_activity
WHERE
state = ‘idle in transaction’
AND (now() – state_change) > interval ‘5 minutes’;
このクエリをpgAdminの「Query Tool」のタブに常時スタンバイさせておき、必要に応じて自動更新（Query Toolのタイマー機能など）を組み合わせることで、簡易的なリアルタイム・モニタリング環境がpgAdminの中に完成します。
—
5. おわりに：データベースとの対話を深めよう
今回は、pgAdmin 4の標準機能を補う形で、PostgreSQLのシステムカタログとカスタムビューを駆使したメトリクス可視化の極意を解説しました。
- 標準機能に頼らず、システムカタログ（`pg_stat_`）を活用して独自の視点を持つ
- データベース内に `monitoring` などの専用ビューを用意し、pgAdminから即座にアクセスできるようにする
- 見たい情報をすぐ取り出せる環境を整え、日々の運用コストを劇的に下げる
このアプローチをマスターすれば、あなたは単に「GUIをポチポチ触る人」から、「データベースの内部構造を熟知し、自在にコントロールするアーキテクト」へとステップアップできます。
毎日のデータベース管理・開発作業が、少しでも快適でエキサイティングなものになりますように。それでは、また次回の技術でお会いしましょう！