RabbitMQ 在 Debian 上的日志管理策略
一 日志路径与查看方式
- 默认日志目录为：/var/log/rabbitmq，常见日志文件名为：rabbit@.log。可直接查看或实时跟踪：
- 查看全部：sudo cat /var/log/rabbitmq/rabbit@.log
- 分页浏览：sudo less /var/log/rabbitmq/rabbit@.log
- 实时跟踪：sudo tail -f /var/log/rabbitmq/rabbit@.log
- 启用管理插件后，可在 Web 管理界面的 Admin → Logs 区域在线查看相关日志。以上路径与方式适用于 Debian 上的 RabbitMQ 包安装场景。
二 输出目标与级别配置
- 输出目标
- 文件：默认输出到文件；也可改为标准输出或 syslog，支持同时输出到多个目标（例如文件+控制台）。
- 控制台：设置 log.console = true 启用；适合容器化或 systemd 日志收集场景。
- Syslog：可对接系统 syslog（示例键：log.syslog）。
- 日志级别
- 全局默认级别：log.default.level = info（常用级别：debug < info < warning < error < critical）。
- 按类别细粒度控制：例如将连接日志设为 warning 以降低噪音
- 经典配置格式（rabbitmq.config）：
[{rabbit, [{log_levels, [{connection, warning}]}]}].
- 新格式（rabbitmq.conf，若使用 Lager 兼容键）：
log.file.level = info
log.console.level = info
- 环境变量优先级
- RABBITMQ_LOGS 可指定日志文件路径或设为 - 输出到标准输出；其优先级高于配置文件中的路径设置。
三 日志轮转与保留
- 内置基于文件大小的轮转（推荐）
- 关键参数：log.file.rotation.size（达到阈值触发轮转）、log.file.rotation.count（保留历史个数）。
- 示例（10 MB 触发，保留 5 个归档）：
log.file.rotation.size = 10485760
log.file.rotation.count = 5
- 内置基于时间的轮转（可选）
- 关键参数：log.file.rotation.date，语法与 newsyslog 类似。
- 示例（每日 00:00 轮转，保留 5 个归档）：
log.file.rotation.date = $D0
log.file.rotation.count = 5
- 系统级 Logrotate（Debian 包默认提供）
- RabbitMQ Debian 包会在 /etc/logrotate.d/rabbitmq-server 中配置每周轮转与压缩，作为内置轮转的补充或替代。
- 建议：二选一或协同使用，避免重复轮转导致空文件或命名冲突。
四 日志格式与集中化采集
- 结构化日志
- 将日志格式化为 JSON 便于检索与可视化：
- 文件：log.file.formatter = json
- 控制台：log.console.formatter = json
- Syslog：log.syslog.formatter = json
- 集中化采集与可视化
- 使用 Filebeat → Logstash → Elasticsearch/Kibana 采集与展示 RabbitMQ 日志，适合生产环境统一观测与告警。
五 运维要点与故障排查
- 动态查看与变更
- 运行时查看节点状态与诊断信息：rabbitmqctl status；服务管理：sudo systemctl start|stop|restart rabbitmq-server。
- 路径与生效
- 配置文件位置：/etc/rabbitmq/rabbitmq.conf（新格式）或 /etc/rabbitmq/rabbitmq.config（经典 Erlang 配置）。
- 修改后需重启节点生效；若设置了 RABBITMQ_LOGS，请确保与配置文件一致，避免路径混乱。
- 诊断优先
- 出现异常时，优先检查 /var/log/rabbitmq 下的日志文件与管理界面 Admin → Logs，可快速定位连接、权限、集群与资源告警等问题。