Debian RabbitMQ日志如何管理

Debian 上 RabbitMQ 日志管理实践

一 日志位置与查看

• 默认日志目录为：/var/log/rabbitmq/，常见文件包括：rabbit@.log（运行日志）、rabbit@-sasl.log（SASL/认证与 Erlang 日志）、rabbitmq-startup.log（启动过程日志）。Debian 的配置文件与启用插件清单通常位于 /etc/rabbitmq/。
• 快速确认当前生效的日志路径与节点名：
  • 命令：rabbitmq-diagnostics -q log_location
  • 命令：rabbitmqctl status（在输出中查看日志相关路径与节点信息）
  • Web：Management UI → Admin → Logs 可在线查看与下载节点日志。

二 日志轮转与保留策略

• 推荐方式：使用系统的 logrotate 管理 RabbitMQ 日志（Debian 默认已集成）。在 /etc/logrotate.d/ 下创建配置文件（如：/etc/logrotate.d/rabbitmq-server），示例：

  /var/log/rabbitmq/*.log {
      daily
      missingok
      rotate 20
      compress
      delaycompress
      notifempty
      dateext
      copytruncate
      sharedscripts
      postrotate
          /etc/init.d/rabbitmq-server rotate-logs >/dev/null 2>&1 || true
      endscript
  }
  

  要点说明：
  • 使用 copytruncate 适配“正在被进程写入”的日志文件，避免重启服务。
  • 通过 postrotate 调用 RabbitMQ 提供的日志轮转脚本（Debian 包通常自带）。
  • 可按需调整：daily/weekly、rotate 20（保留份数）、compress、size 500M（按大小触发）等参数。
• 验证与测试：
  • 手动触发一次：logrotate -f /etc/logrotate.d/rabbitmq-server
  • 检查是否按策略生成了带日期后缀的旧日志并压缩归档。

三 日志级别与输出路径配置

• 查看与动态调整日志级别（运行时生效）：
  • 设置连接日志为 warning：rabbitmqctl set_log_level connection warning
  • 全局默认级别（运行时生效）：rabbitmqctl set_log_level info（示例为 info）
• 持久化配置（重启生效）：
  • 方式一（新格式，key=value）：编辑 /etc/rabbitmq/rabbitmq.conf

    # 全局文件日志级别
    log.file.level = warning
    
    # 按模块设置（示例：将 connection 模块设为 warning）
    log.file.module_levels.rabbit.connection = warning
    

  • 方式二（旧格式，Erlang term）：编辑 /etc/rabbitmq/rabbitmq.config

    [
      {rabbit, [
        {log_levels, [{connection, warning}]}
      ]}
    ].
    

• 自定义日志目录（两种方式，二选一或同时设置）：
  • 通过环境变量（推荐）：在 /etc/rabbitmq/rabbitmq-env.conf 中设置

    LOG_BASE=/data/logs/rabbitmq
    RABBITMQ_LOGS=/data/logs/rabbitmq/rabbit.log
    RABBITMQ_SASL_LOGS=/data/logs/rabbitmq/rabbit-sasl.log
    

  • 直接写入 rabbitmq.conf：

    log.dir = /data/logs/rabbitmq
    

  修改后需重启节点使配置生效。

四 审计与追踪日志

• SASL 审计日志：rabbit@-sasl.log 记录认证、授权与 Erlang VM 运行信息，排查“登录失败/权限不足”等问题非常关键。
• 消息追踪（仅在排障时短时开启，避免性能影响）：
  • Firehose：
    • 开启：rabbitmqctl trace_on
    • 关闭：rabbitmqctl trace_off
  • 插件方式：rabbitmq-plugins enable rabbitmq_tracing，在管理界面配置追踪。
    注意：开启 trace 会产生大量日志，可能影响性能，用后应关闭。

五 运维要点与排错建议

• 优先通过 Management UI 的 Admin → Logs 页面快速定位问题；必要时结合命令行 rabbitmqctl status、rabbitmq-diagnostics environment 检查节点与配置。
• 轮转失败或日志不切时，检查：
  • /var/log/rabbitmq 目录与日志文件属主是否为 rabbitmq:rabbitmq；
  • logrotate 配置中的 postrotate 脚本路径与权限是否正确；
  • 是否误用了仅适用于旧版本的配置方式（如仅修改 rabbitmq.config 而未设置 log.file.level）。
• 若需变更数据或日志目录，务必同时调整 LOG_BASE/MNESIA_BASE 等环境变量，并保证新目录存在且权限正确，变更后重启节点。