# postgres_skill **Repository Path**: imiyu/postgres_skill ## Basic Information - **Project Name**: postgres_skill - **Description**: No description available - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-21 - **Last Updated**: 2026-09-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # postgres_skill PostgreSQL SKILLs for AI Agent. 1. postgres-daily-check, PostgreSQL 实例日常巡检 SKILL 2. polardb-daily-check, PolarDB 实例日常巡检 SKILL 3. postgresql-bi-agent, PostgreSQL 实例业务数据经营分析 SKILL [Powered by AI](https://github.com/digoal/blog/blob/master/202602/20260204_01.md) ----- 用法: 将对应 skill 目录拷贝到 AI Agent 指定的存放 SKILL 的目录中. 发起巡检请求, 例如使用 postgres-daily-check 技能: `全面巡检 postgresql 数据库, 连接: host 127.0.0.1 port 1922 user digoal dbname postgres password 123456` postgres-daily-check 技能的 PostgreSQL 巡检结果展示: 🔍 PostgreSQL 全面巡检报告 巡检时间: 2026-02-05 14:00:00 数据库连接: 127.0.0.1:1922/postgres 整体状态: 🟠 WARNING --- 一、核心健康与可用性 ✅ 无效索引检查 - 状态: 正常 - 结果: 未发现无效索引 ✅ XID 回卷风险 - 状态: 正常 - 详情: - postgres: 0.60% (12,919,115 事务) - test: 0.60% - template1: 0.60% - gemini_test: 0.60% - contrib_regression: 0.60% - 风险: 所有数据库远低于回卷阈值(85%) ✅ MultiXactId 回卷风险 - 状态: 正常 - 详情: 所有数据库的 datminmxid 已冻结或无效，无回卷风险 ✅ 阻塞锁检查 - 状态: 正常 - 结果: 未发现阻塞锁 ✅ 死锁检测 - 状态: 正常 - 结果: 当前数据库无死锁记录 ✅ 关键配置检查 - fsync: on ✅ (数据同步正常) - synchronous_commit: on ✅ (同步提交正常) - log_min_duration_statement: -1 (未启用慢查询日志) - log_lock_waits: off (未启用锁等待日志) - track_io_timing: off (未启用IO计时) --- 二、会话与连接监控 ✅ 连接使用情况 - 当前连接: 1/100 - 使用率: 1.0% (正常) ✅ 长时间运行查询 - 状态: 正常 - 结果: 未发现超过5分钟的活跃查询 ✅ 空闲事务会话 - 状态: 正常 - 结果: 未发现超过1分钟的空闲事务 ✅ 锁等待检查 - 状态: 正常 - 结果: 无锁等待 ✅ 等待事件 - 状态: 正常 - 结果: 当前无活跃等待事件 🟠 连接安全性 - SSL 加密: 0 个连接 - GSSAPI 加密: 0 个连接 - 本地连接: 0 个连接 - ⚠️ 未加密连接: 1 个 (192.168.65.1) - 建议: 生产环境建议启用 SSL 加密连接 --- 三、性能与活动监控 ❌ 缓存命中率 (严重问题) - 状态: 异常 - 命中率: 56.44% - 问题: 缓存命中率远低于推荐值(>95%) - 原因: 可能存在大量全表扫描或 shared_buffers 配置不足 - 建议: 1. 检查 shared_buffers 配置(当前可能过小) 2. 优化查询，减少全表扫描 3. 考虑增加内存 ✅ 事务回滚率 - 状态: 正常 - postgres: 0.00% - gemini_test: 0.72% - 其他: 0% - 建议: 所有数据库回滚率均在正常范围(<5%) 🟡 热点表分析 | Schema | 表名 | DML操作 | 扫描次数 | 死元组 | |--------|------|---------|----------|--------| | public | pgbench_accounts | 22,902,438 | 25,804,866 | 1,490,265 ⚠️ | | public | pgbench_tellers | 12,903,420 | 12,902,424 | 0 | | public | pgbench_branches | 12,902,516 | 12,902,426 | 0 | | public | pgbench_history | 12,902,402 | - | 0 | 🟠 IO 统计 - 临时文件: 7 个 - 临时文件大小: 956 MB - 块读取: 37,739,568,299 - 块命中: 48,897,269,759 - 总块数: 86,636,838,058 - 读写时间: 0ms (未启用 track_io_timing) 🟠 Background Writer 统计 - buffers_clean: 4,544,613 - maxwritten_clean: 13,996 ⚠️ - buffers_alloc: 37,409,810,311 - 问题: maxwritten_clean 值较高，表明 bgwriter 可能需要调优 - 建议: 考虑调整 bgwriter_lru_maxpages 和 bgwriter_lru_multiplier 🟡 WAL 统计 - WAL 记录: 107,729,154 - WAL FPI: 21,586,306 - WAL 字节: 144 GB - WAL buffers full: 434,597 - 状态: WAL 生成量正常 🟠 Checkpointer 统计 - 定时检查点: 2,215 次 - 请求检查点: 193 次 - 完成检查点: 374 次 - 写入时间: 8,703,830 ms - 同步时间: 100,240 ms - 缓冲区写入: 220,732 - 平均每次检查点写入时间: 23,272.27 ms ⚠️ (偏高) - 平均每次检查点同步时间: 268.02 ms - 状态: WARNING - 检查点写入时间较长，建议检查存储性能或调整 checkpoint 参数 ✅ SLRU 统计 - Transaction: 命中率 97.94% (正常) - Multixact Offset: 低活动量 - Commit Timestamp: 无活动 - 状态: 正常 --- 四、复制与归档 ✅ 复制状态 - 状态: 单机模式 - 结果: 无活跃备库(正常运行) ✅ 复制槽 - 状态: 正常 - 结果: 无复制槽配置 🟡 WAL 归档状态 - 状态: 未启用 - 归档数量: 0 - 失败数量: 0 - WAL 目录大小: 1,024 MB - 建议: 如需备份恢复能力，建议启用 archive_mode 和 archive_command --- 五、维护与存储 🟡 数据库大小 | 数据库 | 大小 | |--------|------| | postgres | 3,611 MB | | gemini_test | 8,094 kB | | contrib_regression | 7,902 kB | | test | 7,569 kB | 🟡 最大对象 表: - pgbench_accounts: 2,346 MB - pgbench_history: 640 MB - pgbench_tellers: 78 MB - pgbench_branches: 64 MB 索引: - pgbench_accounts_pkey: 428 MB - pgbench_tellers_pkey: 32 MB - pgbench_branches_pkey: 6,576 kB ❌ 表膨胀 (严重问题) | Schema | 表名 | 大小 | 膨胀率 | 浪费空间 | |--------|------|------|--------|----------| | public | pgbench_accounts | 2,345.86 MB | 80.36% | 1,977 MB ⚠️ | | public | pgbench_history | 642.05 MB | 46.34% | 311 MB | | public | pgbench_tellers | 78.45 MB | 99.97% | 82 MB ⚠️ | | public | pgbench_branches | 64.19 MB | 100.00% | 67 MB ⚠️ | 总浪费空间: 约 2.4 GB ❌ 索引膨胀 (严重问题) | Schema | 索引名 | 大小 | 膨胀率 | 浪费空间 | |--------|--------|------|--------|----------| | public | pgbench_accounts_pkey | 428.44 MB | 55.43% | 249 MB | | public | pgbench_tellers_pkey | 31.79 MB | 99.94% | 33 MB | | public | pgbench_branches_pkey | 6.42 MB | 99.97% | 6.5 MB | ✅ Autovacuum 状态 - 状态: 正常 - 结果: 当前无活跃的 autovacuum 进程 ✅ 大未使用索引 - 状态: 正常 - 结果: 未发现大未使用索引 ✅ 过时统计信息 - 状态: 正常 - 结果: 无过时统计信息 ✅ 序列耗尽风险 - 状态: 正常 - 结果: 无序列接近耗尽 ✅ 冻结预测 - 状态: 正常 - 结果: 无表接近 XID/MXID 冻结限制 --- 六、问题汇总与建议 🔴 严重问题 (需立即处理) 1. 表和索引严重膨胀 - pgbench_tellers 膨胀率 99.97% - pgbench_branches 膨胀率 100% - pgbench_accounts 膨胀率 80.36%，浪费 1.9 GB 空间 - 建议: 立即执行 VACUUM FULL 或 REINDEX VACUUM FULL pgbench_accounts; VACUUM FULL pgbench_tellers; VACUUM FULL pgbench_branches; VACUUM FULL pgbench_history; REINDEX TABLE pgbench_accounts; REINDEX TABLE pgbench_tellers; REINDEX TABLE pgbench_branches; 2. 缓存命中率过低 - 当前 56.44%，远低于推荐值 95%+ - 建议: - 增加 shared_buffers (建议设置为物理内存的 25%) - 检查并优化执行大量全表扫描的查询 - 考虑增加服务器内存 🟠 中等问题 (建议处理) 3. Background Writer 调优 - maxwritten_clean 值较高(13,996) - 建议: 调整 bgwriter 参数 ALTER SYSTEM SET bgwriter_lru_maxpages = 1000; ALTER SYSTEM SET bgwriter_lru_multiplier = 10.0; 4. Checkpointer 写入时间过长 - 平均每次检查点写入时间 23,272 ms - 建议: - 检查存储性能 - 调整 checkpoint_completion_target - 考虑增加 max_wal_size 5. 未加密连接 - 发现 1 个未加密 TCP 连接 - 建议: 生产环境启用 SSL ssl = on ssl_cert_file = 'server.crt' ssl_key_file = 'server.key' 🟡 低优先级建议 6. WAL 归档未启用 - 建议: 如需 PITR 恢复能力，启用归档 archive_mode = on archive_command = 'cp %p /path/to/archive/%f' 7. 监控配置优化 - log_min_duration_statement: 建议设置慢查询阈值(如 1s) - track_io_timing: 建议启用以监控 I/O 性能 --- 七、巡检结论 本次巡检发现 2个严重问题 和 3个中等问题: 1. 表/索引膨胀是最紧急的问题，pgbench_tellers 和 pgbench_branches 表几乎完全膨胀，pgbench_accounts 表浪费近 2GB 空间 2. 缓存命中率过低表明内存配置或查询优化存在问题 3. 其他配置和性能参数有待优化 建议优先级: 1. 🔴 立即执行 VACUUM FULL 和 REINDEX 回收空间 2. 🔴 调整 shared_buffers 提升缓存命中率 3. 🟠 优化 bgwriter 和 checkpointer 参数 4. 🟡 启用 SSL 加密和 WAL 归档 总体评价: 数据库存在较严重的存储膨胀和内存配置问题，需要立即进行维护优化。