pgrundev/pgbot

解决的问题

pgbot 为 PostgreSQL 数据库提供即时的、只读的诊断健康报告，无需外部代理、监控服务或写入权限。它通过分析数据库的内部统计信息，帮助开发人员和 DBA 快速识别性能瓶颈、未使用的索引和配置问题。

工作原理

它是一个单一的静态二进制文件，使用具有 pg_monitor 权限的只读角色连接到您的数据库。它通过采样 PostgreSQL 的内部统计视图来生成确定性的健康报告。它还可以选择使用 AI 模型（通过 API keys）对已计算出的结果提供通俗易懂的解释。它支持本地基准测试以跟踪随时间变化的性能回归，并提供机器可读的 JSON 输出，以便集成到 CI/CD 流水线或 AI 代理工作流中。

适用人群

需要快速分类数据库性能问题、执行临时健康检查或在不增加完整监控平台开销的情况下将数据库可观测性集成到自动化 CI/CD 流水线中的开发人员和数据库管理员。

亮点

• 零占用： 无需代理、无需外部服务，也无需写入权限。
• 确定性结果： 所有诊断均在本地使用 Go 计算；AI 仅用于总结结果，而非生成结果。
• 支持 CI/CD： 支持 JSON 输出、SARIF 报告和用于自动化门控的退出代码。
• AI 代理友好： 包含一个 MCP (Model Context Protocol) 服务器，允许 AI 代理直接查询数据库健康状况。
• 回归跟踪： 将当前状态与历史基准进行比较，以突出显示查询性能或表使用情况的具体变化。