dvcrn 功能说明
pg-health 提供全面的数据库健康检查，帮助识别潜在的性能问题和优化机会。
执行流程
1. 前置检查
确认 postgres-mcp MCP 工具可用（参考根 SKILL.md 的前置检查）。
2. 执行健康检查
调用 get_database_health 工具获取数据库健康报告。
3. 分析结果
健康检查通常包含以下维度：
索引健康
- 未使用的索引 — 占用空间但从未被查询使用的索引
- 重复索引 — 功能重复的索引，可以合并
- 缺失索引 — 频繁全表扫描的表可能需要添加索引
- 索引膨胀 — 索引大小超过实际需要，需要 REINDEX
连接状态
- 活跃连接数 — 当前正在执行查询的连接
- 空闲连接数 — 空闲但未释放的连接
- 连接池利用率 — 连接数占 max_connections 的比例
- 长时间运行的查询 — 可能阻塞其他操作的慢查询
缓冲区缓存
- 缓存命中率 — shared_buffers 的命中率（应 > 95%）
- 缓存大小 — 当前缓存配置是否合理
- 脏页比例 — 需要写入磁盘的脏页数量
Vacuum 状态
- 自动 vacuum 状态 — 是否正常运行
- 死元组数量 — 需要清理的过期数据
- 表膨胀 — 表大小超过实际需要
- 事务 ID 回卷风险 — 接近 wraparound 的表
复制状态（如果配置了复制）
- 复制延迟 — 主从之间的延迟时间
- 复制槽状态 — 复制槽是否正常
- WAL 堆积 — WAL 日志是否堆积
序列状态
- 序列使用率 — 接近上限的序列（可能导致插入失败）
4. 生成报告
将健康检查结果整理成易读的报告，包括：
- 总体评分 — 数据库健康状况的总体评估
- 关键问题 — 需要立即处理的问题（红色警告）
- 优化建议 — 可以改进的地方（黄色提示）
- 正常指标 — 运行良好的部分（绿色）
5. 提供建议
根据发现的问题，提供具体的优化建议：
- 索引问题 → 建议删除未使用的索引、合并重复索引、添加缺失索引
- 连接问题 → 建议调整连接池配置、关闭空闲连接、优化慢查询
- 缓存问题 → 建议调整 shared_buffers 大小
- Vacuum 问题 → 建议手动 VACUUM、调整 autovacuum 参数
- 复制问题 → 建议检查网络、优化复制配置
- 序列问题 → 建议将序列类型从 integer 改为 bigint
使用示例
基础健康检查：
用户：检查一下数据库健康状况
助手：[调用 get_database_health]
[分析结果并生成报告]
针对性检查：
用户：为什么数据库连接数这么高？
助手：[调用 get_database_health]
[重点分析连接状态部分]
定期监控：
用户：每天早上 9 点检查数据库健康
助手：[设置定时任务，每天执行健康检查]
报告格式示例
📊 数据库健康报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 总体状态：良好 (85/100)
🔴 关键问题：
• 表 users 有 3 个未使用的索引，浪费 2.5GB 空间
• 连接数接近上限 (95/100)，可能导致新连接失败
🟡 优化建议：
• 缓存命中率 92%，建议增加 shared_buffers
• 表 orders 需要 VACUUM，死元组占比 15%
✅ 运行正常：
• 复制延迟 < 1s
• 无长时间运行的查询
• 序列使用率正常
注意事项
- 权限要求 — 健康检查需要访问系统视图（pg_stat_*），确保数据库用户有足够权限
- 性能影响 — 健康检查本身会执行一些查询，在高负载时段谨慎使用
- 定期检查 — 建议定期（每天或每周）执行健康检查，及时发现问题
- 结合监控 — 健康检查是快照，建议配合持续监控工具（如 Prometheus + Grafana）