慢查询基础：数据库慢查询日志的配置与解读（MySQL/PostgreSQL为例）

慢查询日志是数据库性能诊断的“第一现场”。在微服务并发场景下，一条慢查询可能拖垮整个上游链路。本章以 MySQL 和 PostgreSQL 为例，讲解慢查询日志的开启、参数调优、日志格式解读以及常见误判场景。

2.1 慢查询日志的核心价值

慢查询日志记录执行时间超过预设阈值的 SQL 语句。其核心价值在于：

• 定位瓶颈：直接暴露响应时间最长的 SQL，避免全量审计。
• 量化趋势：通过慢查询数量变化，判断数据库负载是否恶化。
• 关联链路：结合微服务 Trace ID，将慢查询映射到具体服务实例。

2.2 MySQL 慢查询日志配置

2.2.1 参数清单

2.2.2 配置示例

-- 动态生效（无需重启）
SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 1;
SET GLOBAL log_queries_not_using_indexes = ON;
SET GLOBAL log_slow_admin_statements = ON;
SET GLOBAL slow_query_log_file = '/var/log/mysql/slow.log';

-- 持久化到 my.cnf
[mysqld]
slow_query_log = 1
long_query_time = 1
log_queries_not_using_indexes = 1
log_slow_admin_statements = 1
slow_query_log_file = /var/log/mysql/slow.log
log_output = FILE,TABLE

2.3 PostgreSQL 慢查询日志配置

2.3.1 参数清单

2.3.2 配置示例

-- postgresql.conf 修改
log_min_duration_statement = 1000        -- 1秒
log_statement = 'ddl'
log_line_prefix = '%t [%p-%l] %u@%d '   -- 时间 进程-行号 用户@库名
log_directory = '/var/log/postgresql'
log_filename = 'postgresql-slow-%Y%m%d.log'
log_rotation_age = 1440                  -- 每天轮转
log_rotation_size = 100MB                -- 或达到100MB轮转

2.4 慢查询日志解读

2.4.1 MySQL 日志格式

# Time: 2025-03-21T10:15:30.123456Z
# User@Host: app_user[app_user] @  [10.0.1.50]  Id: 12345
# Query_time: 2.345678  Lock_time: 0.001234  Rows_sent: 100  Rows_examined: 50000
SET timestamp=1742544930;
SELECT o.id, o.amount, u.name
FROM orders o
JOIN users u ON o.user_id = u.id
WHERE o.status = 'PENDING'
ORDER BY o.created_at DESC
LIMIT 100;

关键字段解读：

• Query_time：实际执行时间（2.35s），超过阈值。
• Lock_time：锁等待时间（1.2ms），占比很小，说明非锁竞争。
• Rows_examined：扫描 5 万行，仅返回 100 行，典型“扫描过多”问题。
• Rows_sent：最终返回行数。

2.4.2 PostgreSQL 日志格式

2025-03-21 10:15:30.123 UTC [12345-1] app_user@mydb LOG:  duration: 2345.678 ms  statement: SELECT o.id, o.amount, u.name
FROM orders o
JOIN users u ON o.user_id = u.id
WHERE o.status = 'PENDING'
ORDER BY o.created_at DESC
LIMIT 100;

关键字段解读：

• duration：2345.678 ms，即 2.35s。
• [12345-1]：进程 ID 和行号，便于关联 pg_stat_activity。
• app_user@mydb：用户和数据库名。

2.5 慢查询日志分析流程

下图展示了从慢查询日志到根因定位的完整分析链路：

2.6 常见误判场景

2.7 日志管理最佳实践

• 阈值动态调整：白天设置 1s，夜间维护窗口可放宽到 5s，避免误报。
• 日志轮转：使用 logrotate 或数据库内置轮转，保留最近 7~30 天。
• 集中采集：通过 Filebeat/Fluentd 将慢查询日志发送到 Elasticsearch，便于可视化分析。
• 采样率控制：高并发场景可设置 log_slow_rate_limit（MySQL 8.0+），按比例记录。
• 安全脱敏：慢查询日志可能包含用户数据，生产环境需脱敏或限制访问权限。