pgrundev/pgbot

何を解決するか

pgbot は PostgreSQL 用の時点診断ツールであり、モニタリングエージェントや時系列データベース、外部サービスのデプロイを必要とせずに、データベースの健全性に関する即時可視性を提供します。フルモニタリングプラットフォームのオーバーヘッドなしに、データベースのパフォーマンス問題の迅速な診断、未使用のインデックスの特定、クエリパフォーマンスの低下やテーブルの肥大化の検出という課題を解決します。

動作方法

pgbot は、pg_monitor 権限を持つ読み取り専用ロールを使用して PostgreSQL インスタンスに接続する単一の静的バイナリです。データベース自身の内部統計ビューを読み取り、健全性スコアや診断結果を計算します。時間の経過に伴う変化を追跡するため、ユーザーのマシン上にローカルなベースラインストアを維持しており、前回の実行からの変更点を報告できます。コアの診断結果は Go で決定論的に計算されますが、OpenAI や Gemini を通じたオプションの AI レイヤーにより、これらの結果を自然言語で説明することも可能です。

対象ユーザー

データベース管理者、開発者、AIエージェントなど、ローカルインスタンス、AWS RDS などのマネージドプロバイダ、あるいは所有していないデータベースであっても、迅速かつ読み取り専用で PostgreSQL データベースの健全性を確認したいユーザー向けに設計されています。

特徴

• ゼロデプロイ: コレクターや外部サービスを必要としない単一の静的バイナリ。
• 読み取り専用保証: 専用の pg_monitor ロールとセッションレベルの読み取り専用ピン留めにより安全を確保。
• ベースライン追跡: 前回の実行を記憶し、パフォーマンスの低下やデータベースの挙動の変化を特定可能。
• AI駆動の分析: 決定論的な診断結果を自然言語で解釈する ask および explain コマンドをオプションで提供。
• エージェント対応: バージョン付き JSON コントラクトと Model Context Protocol (MCP) サーバーを提供し、AIエージェントに診断結果を公開可能。
• 包括的な診断: インデックス、クエリ、Vacuumの健全性、テーブルストレージの分析に特化したコマンドを含む。