Redis在Debian上的日志管理

Redis 在 Debian 上的日志管理

一 定位与查看日志

• 查看当前日志输出方式：使用命令查看配置项 logfile，若返回空字符串，表示日志输出到标准输出/系统日志；否则为指定的日志文件路径。示例：redis-cli config get logfile。Debian 常见路径为 /var/log/redis/redis-server.log。
• 直接查看日志文件：例如 sudo tail -f /var/log/redis/redis-server.log。
• 若日志输出到系统日志（journald），可用：sudo journalctl -u redis-server -f 实时查看。

二 配置日志输出与级别

• 编辑配置文件：Debian 上通常为 /etc/redis/redis.conf。
• 指定日志文件路径：设置 logfile /var/log/redis/redis-server.log（取消注释并填写路径）。
• 设置日志级别：可选值为 debug、verbose、notice、warning，生产常用 notice。示例：loglevel notice。
• 动态查看与调整（无需重启）：
  • 查看：redis-cli CONFIG GET loglevel
  • 调整：redis-cli CONFIG SET loglevel verbose
• 使配置持久化：修改 redis.conf 后执行 sudo systemctl restart redis-server。

三 日志轮转与保留策略

• 推荐方式：使用 logrotate 管理 Redis 日志，创建文件 /etc/logrotate.d/redis，内容示例：

/var/log/redis/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
    delaycompress
    copytruncate
    create 640 redis redis
    postrotate
        systemctl reload redis-server >/dev/null 2>&1 || true
    endscript
}

• 说明：
  • 采用 copytruncate 可避免重启 Redis；若使用 systemd 且希望零中断，可改为 postrotate systemctl reload redis-server ...。
  • 权限与属主设置为 redis:redis（640），与 Debian 常见包安装保持一致。
• 验证与测试：
  • 手动触发一次轮转：sudo logrotate -f /etc/logrotate.d/redis
  • 检查是否生成压缩归档与权限是否正确。

四 目录权限与系统服务要点

• 确保日志目录存在且权限正确：
  • sudo mkdir -p /var/log/redis
  • sudo chown redis:redis /var/log/redis && sudo chmod 750 /var/log/redis
• 使用 systemd 管理的 Redis 服务单元通常为 redis-server.service；修改日志配置后可用 sudo systemctl reload redis-server 让服务重新读取配置（配合 copytruncate 的 logrotate 场景尤为合适）。

五 常见问题与快速排查

• 日志不写入文件：检查 logfile 是否为空（为空则输出到标准输出/journald），以及 /var/log/redis 目录是否存在且属主为 redis:redis。
• 权限被拒绝：确认日志文件与目录权限为 640/750 且属主为 redis。
• 修改未生效：确认修改的是正确的 redis.conf，并执行 sudo systemctl restart redis-server；或用 CONFIG GET 验证运行时值。
• 轮转后无新日志：若未使用 copytruncate，需重启或 reload；若使用 copytruncate，确认 logrotate 已成功执行且新文件权限正确。
• 动态调级风险：将级别设为 debug 会产生大量日志，可能影响性能，仅在排障时临时使用。