# 1. 配置日志
$ vi /postgresql/fgdata/postgresql.conf

log_destination = ‘stderr’
logging_collector = on
log_directory = ‘logs’
log_filename = ‘postgresql-%Y-%m-%d.log’
log_truncate_on_rotation = on
log_rotation_age = 1d
log_rotation_size = 100MB
log_min_messages = warning
log_min_error_statement = error
log_statement = ‘all’
log_duration = on

# 2. 安装pgBadger
$ wget https://github.com/darold/pgbadger/archive/master.zip
$ unzip master.zip
$ cd pgbadger-master
$ cp pgbadger /usr/local/bin/

# 3. 分析日志
$ pgbadger /postgresql/logs/postgresql-2026-04-06.log -o /postgresql/reports/pgbadger-2026-04-06.html

# 4. 部署Prometheus+Grafana
– 安装PostgreSQL Exporter
– 配置Prometheus
– 配置Grafana
– 导入PostgreSQL仪表盘

# 5. 配置告警规则
$ vi /usr/local/prometheus/rules/postgres_alerts.yml

groups:
– name: postgres_alerts
rules:
– alert: PostgresError
expr: pg_exporter_last_scrape_error > 0
for: 5m
labels:
severity: critical
annotations:
summary: “PostgreSQL error”
description: “PostgreSQL instance {{ $labels.instance }} has errors”

# 1. 常见报错分析与解决

## 连接类报错
– 报错：”connection refused”
原因：PostgreSQL服务未运行、网络连接问题、防火墙设置
解决：启动PostgreSQL服务、检查网络连接、调整防火墙设置

– 报错：”password authentication failed for user”
原因：密码错误、用户不存在、认证配置错误
解决：检查密码、创建用户、调整pg_hba.conf配置

– 报错：”too many connections”
原因：连接数超过max_connections设置
解决：增加max_connections参数、使用连接池、关闭空闲连接

## 查询类报错
– 报错：”syntax error at or near”
原因：SQL语法错误
解决：检查SQL语法、修正错误

– 报错：”permission denied”
原因：用户权限不足
解决：授予相应权限、调整角色权限

– 报错：”relation does not exist”
原因：表或视图不存在
解决：创建表或视图、检查表名

## 系统类报错
– 报错：”no space left on device”
原因：磁盘空间不足
解决：清理磁盘空间、扩展磁盘容量

– 报错：”out of memory”
原因：内存不足
解决：增加内存、优化内存参数、减少内存使用

– 报错：”could not fork new process”
原因：系统进程数限制
解决：调整系统进程数限制、减少并发连接

# 2. 报错分析流程
– 收集报错信息：收集报错代码、错误消息和上下文
– 分析报错原因：根据报错信息，分析可能的原因
– 验证报错原因：通过测试和检查，验证报错原因
– 实施解决方案：采取相应的解决措施
– 验证解决效果：验证报错是否解决
– 记录解决方案：记录报错分析过程和解决方案

# 1. 安装PostgreSQL Exporter
$ wget https://github.com/prometheus-community/postgres_exporter/releases/download/v0.13.0/postgres_exporter-0.13.0.linux-amd64.tar.gz
$ tar -xzf postgres_exporter-0.13.0.linux-amd64.tar.gz
$ mv postgres_exporter-0.13.0.linux-amd64 /usr/local/postgres_exporter

# 2. 配置PostgreSQL Exporter
$ vi /etc/systemd/system/postgres_exporter.service

[Unit]
Description=PostgreSQL Exporter
After=network.target

[Service]
Type=simple
User=postgres
Environment=DATA_SOURCE_NAME=”postgresql://postgres:postgres_pass@fgedu.localhost:5432/postgres?sslmode=disable”
ExecStart=/usr/local/postgres_exporter/postgres_exporter
Restart=always

[Install]
WantedBy=multi-user.target

# 3. 启动PostgreSQL Exporter
$ systemctl daemon-reload
$ systemctl start postgres_exporter
$ systemctl enable postgres_exporter

# 4. 配置Prometheus
$ vi /usr/local/prometheus/prometheus.yml

global:
scrape_interval: 15s
evaluation_interval: 15s

scrape_configs:
– job_name: ‘postgres’
static_configs:
– targets: [‘fgedu.localhost:9187’]

# 5. 启动Prometheus
$ systemctl start prometheus
$ systemctl enable prometheus

# 6. 配置Grafana
# 访问 http://fgedu.localhost:3000
# 添加Prometheus数据源
# 导入PostgreSQL仪表盘

# 1. 连接类报错解决方案

## 连接被拒绝
– 检查PostgreSQL服务状态
$ systemctl status postgresql-18

– 检查网络连接
$ ping fgedu.localhost
$ telnet fgedu.localhost 5432

– 检查防火墙设置
$ firewall-cmd –list-ports
$ firewall-cmd –add-port=5432/tcp –permanent
$ firewall-cmd –reload

## 认证失败
– 检查用户是否存在
$ psql -U postgres -c “SELECT * FROM pg_roles WHERE rolname = ‘fgedu’;”

– 检查密码
$ psql -U fgedu -d fgedudb

– 检查pg_hba.conf配置
$ vi /postgresql/fgdata/pg_hba.conf

# 2. 查询类报错解决方案

## 语法错误
– 检查SQL语法
$ psql -U fgedu -d fgedudb -c “SELECT * FROM fgedu_users WHERE id = 1;”

– 使用EXPLAIN分析
$ psql -U fgedu -d fgedudb -c “EXPLAIN SELECT * FROM fgedu_users WHERE id = 1;”

## 权限不足
– 授予权限
$ psql -U postgres -c “GRANT SELECT ON fgedu_users TO fgedu;”

– 检查用户权限
$ psql -U fgedu -d fgedudb -c “SELECT * FROM information_schema.role_table_grants WHERE grantee = ‘fgedu’;”

# 3. 系统类报错解决方案

## 磁盘空间不足
– 检查磁盘空间
$ df -h

– 清理磁盘空间
$ find /postgresql -name “*.log” -mtime +7 -delete
$ vacuumdb -d fgedudb -v

– 扩展磁盘容量
# 添加新磁盘并挂载

## 内存不足
– 检查内存使用
$ free -h

– 优化内存参数
$ vi /postgresql/fgdata/postgresql.conf

shared_buffers = 4GB
work_mem = 32MB

– 增加内存
# 升级服务器内存