Debian 上 RabbitMQ 的日志管理策略
一 核心机制与默认行为
- 日志默认写入目录 /var/log/rabbitmq，常见文件包括：rabbit@.log（节点运行日志）、rabbitmq.log（通用日志）、rabbitmq-startup.log（启动过程日志）。可通过命令 rabbitmq-diagnostics -q log_location 或管理界面 Admin → Logs 查看实际生效路径与文件。RabbitMQ 自 3.7.0 起使用 Lager 日志库，支持多目标输出（文件、控制台、syslog），且不同目标的日志级别可分别设置；环境变量 RABBITMQ_LOGS 可指定日志文件路径，若设为 - 则输出到标准输出。Debian 包默认提供 logrotate 策略，对日志进行定期轮转与压缩。
二 日志轮转与保留
- 内置轮转（Lager）：通过参数控制基于时间或大小的滚动与保留数量，例如：
- 基于时间：log.file.rotation.date = $D0（每日午夜）、$D23（每日 23:00）、$H00（每小时整点）、$W0D0H0（每周日 00:00）等；配合 log.file.rotation.count 保留历史份数。
- 基于大小：log.file.rotation.size = 10485760（10 MB），同样结合 count 控制保留数量。
- 系统级轮转（logrotate）：Debian 包在 /etc/logrotate.d/rabbitmq-server 中预置策略，默认按周轮转并压缩旧日志，可按需调整频率、保留份数与压缩方式。
三 输出目标与级别配置
- 输出目标与开关
- 文件：启用/禁用与路径由 log.file 控制；可同时输出到多个目标（如文件+控制台）。
- 控制台：log.console = true 启用；log.console.level 设置控制台日志级别（如 debug、info）。
- Syslog：可启用并配置 log.syslog 相关参数，将日志发送至系统 syslog。
- 日志级别
- 支持级别：none、error、warning、info、debug；可按“类别-级别”细粒度设置，例如将连接日志设为 warning：log_levels = [{connection, warning}]。
- 格式
- 支持将日志格式化为 JSON：log.file.formatter = json（亦可分别设置 console、syslog 的格式）。
四 路径与环境的自定义
- 环境变量优先：RABBITMQ_LOGS 指定日志文件路径；RABBITMQ_SASL_LOGS 指定 SASL 日志路径；设置 RABBITMQ_LOGS=- 输出到标准输出（便于容器与 systemd 归集）。
- 配置文件与 env 文件
- 新版配置：/etc/rabbitmq/rabbitmq.conf（key = value）；旧版 Erlang 配置：/etc/rabbitmq/rabbitmq.config。
- 环境文件：/etc/rabbitmq/rabbitmq-env.conf，可设置 LOG_BASE、CONFIG_FILE、MNESIA_BASE 等，变更后需重启节点生效。
五 运维实践与快速命令
- 快速定位与查看
- 查看日志目录与文件：rabbitmq-diagnostics -q log_location
- 实时跟踪：tail -f /var/log/rabbitmq/rabbit@.log
- 管理界面：Admin → Logs 在线查看与下载
- 变更生效与风险控制
- 修改 rabbitmq.conf 后需重启节点；不建议长期开启 debug 级别，避免日志量激增。
- 启用 rabbitmq_tracing 或 trace_on 会产生大量输出并影响性能，仅在排障时短时开启并及时关闭。