pgrundev/pgbot

它解决了什么问题

pgbot 是一个针对 PostgreSQL 的时间点诊断工具，能够在无需部署监控代理、时序数据库或外部服务的情况下，立即提供数据库健康状况的可见性。它解决了快速排查数据库性能问题、识别未使用的索引以及检测查询性能退化或表膨胀问题的难题，而无需承担完整监控平台的开销。

它如何工作

pgbot 是一个单一的静态二进制文件，通过具有 pg_monitor 权限的只读角色连接到 PostgreSQL 实例。它读取数据库自身的内部统计视图来计算健康评分和发现结果。为了跟踪随时间的变化，它在用户机器上维护一个本地基线存储，从而能够报告自上次运行以来的变化情况。虽然核心发现是确定性的，并在 Go 中计算，但它还提供了一个可选的 AI 层（通过 OpenAI 或 Gemini），可以以通俗语言解释这些发现。

适用人群

专为需要快速、只读方式检查 PostgreSQL 数据库健康状况的数据库管理员、开发者以及 AI 代理设计，无论数据库是本地实例、AWS RDS 等托管服务，还是他们不拥有的数据库。

主要特性

• 零部署： 单一静态二进制文件，无需收集器或外部服务。
• 只读保证： 使用专用的 pg_monitor 角色和会话级只读锁定以确保安全。
• 基线追踪： 记住之前的运行记录，以识别性能退化和数据库行为的变化。
• AI 驱动分析： 可选的 ask 和 explain 命令，可提供对确定性发现的通俗语言解释。
• 适配代理： 提供版本化的 JSON 协议和 Model Context Protocol (MCP) 服务器，将发现结果暴露给 AI 代理。
• 全面诊断： 包含专门用于分析索引、查询、VACUUM 健康状况和表存储的命令。