pg_sqlog

提供访问PostgreSQL日志的SQL接口

概览

扩展包名版本分类许可证语言
pg_sqlog1.6STATBSD 3-ClauseSQL
ID扩展名BinLibLoadCreateTrustReloc模式
6500pg_sqlogsqlog
相关扩展file_fdw pg_profile pg_tracing pg_show_plans pg_stat_kcache pg_stat_monitor pg_qualstats pg_store_plans

require certain params

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY1.61817161514pg_sqlogfile_fdw
RPMPIGSTY1.61817161514pg_sqlog_$v-
DEBPIGSTY1.61817161514postgresql-$v-pg-sqlog-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
d13.x86_64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
d13.aarch64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
u22.x86_64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
u22.aarch64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
u24.x86_64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
u24.aarch64
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6
PIGSTY 1.6

构建

您可以使用 pig build 命令构建 pg_sqlog 扩展的 RPM / DEB 包:

pig build pkg pg_sqlog         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_sqlog 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pg_sqlog;          # 当前活跃 PG 版本安装
pig ext install -y pg_sqlog -v 18  # PG 18
pig ext install -y pg_sqlog -v 17  # PG 17
pig ext install -y pg_sqlog -v 16  # PG 16
pig ext install -y pg_sqlog -v 15  # PG 15
pig ext install -y pg_sqlog -v 14  # PG 14
dnf install -y pg_sqlog_18       # PG 18
dnf install -y pg_sqlog_17       # PG 17
dnf install -y pg_sqlog_16       # PG 16
dnf install -y pg_sqlog_15       # PG 15
dnf install -y pg_sqlog_14       # PG 14
apt install -y postgresql-18-pg-sqlog   # PG 18
apt install -y postgresql-17-pg-sqlog   # PG 17
apt install -y postgresql-16-pg-sqlog   # PG 16
apt install -y postgresql-15-pg-sqlog   # PG 15
apt install -y postgresql-14-pg-sqlog   # PG 14

创建扩展

CREATE EXTENSION pg_sqlog CASCADE;  -- 依赖: file_fdw

用法

pg_sqlog: 通过 SQL 访问 PostgreSQL CSV 日志

pg_sqlog 提供一个 SQL 接口,使用 file_fdw 支持的外部表来查询 PostgreSQL CSV 日志文件。

查询日志

-- 当天的日志
SELECT * FROM sqlog.log();

-- 指定日期的日志
SELECT * FROM sqlog.log('yesterday');
SELECT * FROM sqlog.log('2024-01-15');

-- 错误摘要
SELECT error_severity, COUNT(*) FROM sqlog.log() GROUP BY 1;

慢查询分析

-- 最慢的 3 种查询模式
SELECT
  AVG(sqlog.duration(message)) AS avg_duration,
  COUNT(*) AS count,
  sqlog.preparable_query(message) AS query_pattern
FROM sqlog.log()
WHERE message ~ '^duration'
GROUP BY 3
ORDER BY 1 DESC
LIMIT 3;

-- 带时间信息的查询摘要
SELECT
  log_time::time,
  sqlog.duration(message),
  sqlog.summary(message)
FROM sqlog.log('yesterday')
WHERE message ~ '^duration';

函数

函数描述
sqlog.log([timestamp])返回指定日期的日志内容
sqlog.set_date([timestamp])设置 sqlog.log 表查询的日期
sqlog.duration(text)从消息中提取查询持续时间(毫秒)
sqlog.preparable_query(text)将参数替换为 ? 以便分组
sqlog.summary(text, int, int)去除元数据,显示前/后 N 个字符
sqlog.temporary_file_size(text)从消息中提取临时文件大小
sqlog.autovacuum([timestamp])指定日期的自动清理报告
sqlog.autoanalyze([timestamp])指定日期的自动分析报告

自动清理报告

SELECT * FROM sqlog.autovacuum() LIMIT 5;
SELECT * FROM sqlog.autoanalyze() LIMIT 5;

前置条件

需要在 postgresql.conf 中设置:

log_destination = 'syslog,csvlog'
log_filename = 'postgresql.%F'
logging_collector = 'on'
log_rotation_age = '1d'
log_rotation_size = 0
log_truncate_on_rotation = 'on'
log_min_duration_statement = 1000

最后修改 2026-03-14: update extension metadata (953cbd0)