pgrundev/pgbot

解決する課題

pgbotは、外部エージェントや監視サービス、書き込み権限を必要とせず、PostgreSQLデータベースの即時かつ読み取り専用の診断ヘルスレポートを提供します。データベースの内部統計を分析することで、開発者やDBAがパフォーマンスのボトルネック、未使用のインデックス、設定の問題を迅速に特定できるよう支援します。

仕組み

単一の静的バイナリであり、pg_monitor権限を持つ読み取り専用ロールを使用してデータベースに接続します。PostgreSQLの内部統計ビューをサンプリングして、決定論的なヘルスレポートを生成します。オプションでAIモデル（APIキー経由）を使用し、計算済みの結果に対して平易な言葉で解説を提供することも可能です。ローカルベースラインをサポートして経時的なパフォーマンス回帰を追跡できるほか、CI/CDパイプラインやAIエージェントのワークフローに統合するための機械可読なJSON出力も提供します。

対象ユーザー

データベースのパフォーマンス問題を迅速にトリアージする必要がある開発者やデータベース管理者、あるいは本格的な監視プラットフォームのオーバーヘッドなしに、データベースの可観測性を自動化されたCI/CDパイプラインに統合したい方に最適です。

特徴

• ゼロフットプリント： エージェントや外部サービスは不要で、書き込みアクセス権も必要ありません。
• 決定論的な診断： すべての診断はGoでローカルに計算されます。AIは結果の生成ではなく、要約のみに使用されます。
• CI/CD対応： JSON出力、SARIFレポート、自動ゲート制御用の終了コードをサポートしています。
• AIエージェント対応： MCP (Model Context Protocol) サーバーを内蔵しており、AIエージェントがデータベースの健全性を直接クエリできます。
• 回帰追跡： 現在の状態を過去のベースラインと比較し、クエリパフォーマンスやテーブル使用状況の具体的な変化を強調表示します。