3. 慢查询日志机制详解：slowlog-log-slower-than 与 slowlog-max-len 配置原理

慢查询日志是 Redis 性能诊断的第一道防线。它不记录执行失败的命令，只记录那些执行耗时超过阈值的命令。理解其核心配置项 slowlog-log-slower-than 和 slowlog-max-len 的原理，是精准定位慢查询的前提。

3.1 核心配置项对比

3.2 slowlog-log-slower-than：阈值设定原理

Redis 在执行每个命令前会记录开始时间，命令执行完毕后计算耗时。如果耗时 > slowlog-log-slower-than，则将该命令的 ID、时间戳、耗时、命令及参数、客户端地址等信息追加到慢查询日志链表头部。

• 单位是微秒：1ms = 1000μs。默认 10000μs = 10ms。
• 负值表示关闭：设为 -1 将禁用慢查询日志。
• 零值表示记录所有命令：设为 0 会记录每个执行的命令（生产环境慎用，会大量消耗内存）。
• 动态生效：可通过 CONFIG SET 在线修改，无需重启。

3.3 slowlog-max-len：队列长度与淘汰机制

慢查询日志存储在内存中的一个固定长度链表中。当新记录加入时，如果链表长度超过 slowlog-max-len，最旧的记录会被自动淘汰。

• 内存占用：每条记录约占用几百字节，128 条记录占用约 50KB 内存。
• 淘汰策略：先进先出（FIFO），新记录插入头部，旧记录从尾部移除。
• 动态调整：同样支持 CONFIG SET 在线修改。

3.4 配置原理流程图

下图展示了 Redis 处理命令时慢查询日志的完整判定与记录流程：

3.5 配置操作与查看命令

3.6 配置示例与效果分析

以下是一个典型的生产环境配置示例：

# 设置慢查询阈值为 2ms
CONFIG SET slowlog-log-slower-than 2000

# 设置日志队列长度为 1024 条
CONFIG SET slowlog-max-len 1024

# 查看当前配置是否生效
CONFIG GET slowlog-log-slower-than
# 返回: 1) "slowlog-log-slower-than"
#       2) "2000"

CONFIG GET slowlog-max-len
# 返回: 1) "slowlog-max-len"
#       2) "1024"

3.7 常见配置误区

• 误区一：阈值设得越小越好——设得过小（如 10μs）会导致大量正常命令被记录，日志队列迅速填满，真正需要关注的慢查询反而被过早淘汰。
• 误区二：队列长度越大越好——设得过大（如 100000）会占用大量内存，且 SLOWLOG GET 返回数据量过大，增加网络传输开销。
• 误区三：只配置阈值不关注队列长度——如果队列长度过小，慢查询记录会被快速淘汰，导致问题排查时找不到历史记录。
• 误区四：修改配置后不持久化——CONFIG SET 仅修改运行期配置，重启后失效。需同时修改 redis.conf 文件或使用 CONFIG REWRITE 持久化。