pg_stat_insights - PostgreSQL 效能監控擴充套件¶

進階 PostgreSQL 查詢效能監控、SQL 最佳化和資料庫分析擴充套件

監控慢查詢 • 追蹤快取效率 • 分析 WAL 產生 • 最佳化資料庫效能 • 即時指標 • Grafana 儀表板

語言支援 / Language Support / 多言語対応¶

繁體中文 (目前) | 简体中文 | 日本語 | English

概述¶

簡化 PostgreSQL 查詢效能監控

pg_stat_insights 是一個進階的 PostgreSQL 擴充套件，用於**資料庫效能監控**、查詢最佳化**和 **SQL 分析。追蹤和分析 52 個綜合指標，透過 **11 個預建檢視**識別慢查詢、最佳化快取效能並即時監控資料庫健康狀況。

適用於： - 監控 PostgreSQL 效能的資料庫管理員 - 追蹤查詢效能和資源使用的 DevOps 團隊 - 最佳化 SQL 查詢和資料庫操作的開發人員 - 實施資料庫監控和警報的 SRE

主要特性： - 52 個指標欄 - 執行時間、快取命中、WAL 產生、JIT 統計、緩衝區 I/O - 11 個預建檢視 - 立即存取最慢查詢、快取未命中、I/O 密集型操作 - 11 個參數 - 微調追蹤、直方圖和統計收集 - 直接替換 pg_stat_statements，具有增強的指標 - PostgreSQL 16-18 - 與最新 PostgreSQL 版本完全相容 - 回應時間追蹤 - 按執行時間對查詢進行分類（<1ms 到 >10s） - 快取分析 - 識別緩衝區快取低效率和最佳化機會 - WAL 監控 - 追蹤每個查詢的預寫日誌產生 - 時間序列資料 - 歷史效能趨勢和桶分析 - Prometheus/Grafana 就緒 - 包含預建的儀表板和警報規則

快速開始 - 3 步安裝¶

在 5 分鐘內監控 PostgreSQL 查詢效能：

-- 步驟 1：在 PostgreSQL 設定中啟用擴充套件
ALTER SYSTEM SET shared_preload_libraries = 'pg_stat_insights';
-- 需要重新啟動 PostgreSQL 伺服器

-- 步驟 2：在您的資料庫中建立擴充套件
CREATE EXTENSION pg_stat_insights;

-- 步驟 3：立即檢視最慢的查詢
SELECT 
    query,
    calls,
    total_exec_time,
    mean_exec_time,
    rows
FROM pg_stat_insights_top_by_time 
LIMIT 10;

**結果：**立即了解查詢效能、執行時間、快取效率以及 PostgreSQL 資料庫中的資源使用情況。

文件¶

完整文件可在以下位置取得：

pgelephant.github.io/pg_stat_insights¶

快速連結：

• 入門指南 - 安裝和設定
• 設定 - 所有 11 個參數
• 檢視參考 - 所有 11 個檢視
• 指標指南 - 所有 52 欄
• 使用範例 - 50+ SQL 查詢
• Prometheus & Grafana - 監控整合
• 故障排除 - 常見問題

安裝¶

# 建構和安裝
cd pg_stat_insights
make
sudo make install

# 設定
echo "shared_preload_libraries = 'pg_stat_insights'" | \
  sudo tee -a /etc/postgresql/*/main/postgresql.conf

# 重新啟動 PostgreSQL
sudo systemctl restart postgresql

# 建立擴充套件
psql -d your_database -c "CREATE EXTENSION pg_stat_insights;"

詳細說明： 安裝指南

檢視¶

所有 11 個預建檢視：

完整參考： 檢視文件

為什麼選擇 pg_stat_insights？¶

解決常見的 PostgreSQL 效能問題：

• 尋找慢查詢 - 識別消耗過多執行時間和資源的查詢
• 最佳化快取使用 - 偵測緩衝區快取未命中並提高 shared_buffers 效率
• 減少 WAL 負擔 - 監控每種查詢類型的預寫日誌產生
• 追蹤查詢模式 - 分析執行頻率、回應時間和資源消耗
• 即時監控 - 與 Grafana 整合，實現即時儀表板和警報
• PostgreSQL 最佳實務 - 遵循 PostgreSQL 編碼標準和慣例建構

與其他擴充套件的比較¶

檢視詳細比較： 功能比較

PostgreSQL 效能測試¶

全面的 TAP 測試套件，確保品質： - 16 個測試檔案**涵蓋所有擴充套件功能 - **150 個測試案例，100% 程式碼覆蓋率 - 測試所有 52 個指標欄、11 個檢視、11 個參數 - 自訂 StatsInsightManager.pm 框架 - 無需外部 Perl 相依性 - 與 PostgreSQL 18 測試基礎設施相容

執行 PostgreSQL 擴充套件測試：

./run_all_tests.sh

持續整合： GitHub Actions 工作流程，在每次提交時自動進行 PostgreSQL 測試

了解更多： 測試指南

使用 Prometheus & Grafana 進行資料庫監控¶

即時 PostgreSQL 指標視覺化：

將 pg_stat_insights 資料轉換為可操作的儀表板和警報，用於 PostgreSQL 資料庫監控：

• Prometheus 整合 - 5 個為 postgres_exporter 預設定的查詢
• Grafana 儀表板 - 8 個用於查詢效能視覺化的即用型面板
• 警報規則 - 11 個用於資料庫健康監控的生產就緒警報
• 查詢速率追蹤 - 監控每秒查詢數（QPS）和輸送量
• 快取效能 - 即時緩衝區快取命中率監控
• 回應時間 SLA - 追蹤 P95/P99 查詢延遲，實現服務層級目標
• WAL 產生警報 - 監控預寫日誌增長和磁碟使用情況

完整的 Prometheus/Grafana 指南： 監控整合

授權¶

MIT 授權 - 版權所有 © 2024-2025, pgElephant, Inc.

詳見 LICENSE。

連結¶

• 完整文件
• 互動式演示 - 線上體驗 pg_stat_insights
• 部落格文章 - 完整指南和最佳實務
• GitHub 儲存庫
• 回報問題
• 討論