RabbitMQ 在 Debian 上的日志分析与排查指南
一 日志位置与快速查看
- 默认日志目录为：/var/log/rabbitmq，常见日志文件名为：rabbit@.log。也可通过环境变量 RABBITMQ_LOGS 指定日志文件路径；将其设为 - 可将日志输出到标准输出（便于容器或 systemd 捕获）。Debian 包通常已配置好目录与轮转。示例：
- 实时查看：sudo tail -f /var/log/rabbitmq/rabbit@$(hostname).log
- 分页查看：sudo less /var/log/rabbitmq/rabbit@$(hostname).log
- 查看服务日志（systemd）：sudo journalctl -u rabbitmq-server -f
- 启用管理插件后，可在 http://:15672 的 Admin → Logs 页面在线查看日志片段。
二 常用命令行分析
- 按时间筛选当天的日志：
- grep “$(date ‘+%d/%b/%Y’)” /var/log/rabbitmq/rabbit@$(hostname).log
- 统计当天各源 IP 的连接次数（假设日志中出现形如 “accepted TCP connection from ” 的行，按实际日志格式调整字段）：
- grep “$(date ‘+%d/%b/%Y’)” /var/log/rabbitmq/rabbit@$(hostname).log | awk ‘{print $NF}’ | sort | uniq -c | sort -nr | head
- 统计错误级别日志数量：
- grep -i “error” /var/log/rabbitmq/rabbit@$(hostname).log | wc -l
- 查看节点启动/关闭、集群成员上下线等“里程碑”事件（关键词示例）：
- grep -E “INFO REPORT.(Starting RabbitMQ|Stopping RabbitMQ|node . up|node .* down)” /var/log/rabbitmq/rabbit@$(hostname).log
- 如需确认日志文件路径与节点名，可使用：sudo rabbitmqctl status（输出中包含日志相关路径信息）。
三 日志级别与输出目标配置
- 运行时调整日志级别（按类别，示例将连接日志调为 warning）：
- sudo rabbitmqctl set_log_level debug
- 或仅调整某类别：sudo rabbitmqctl -n rabbit@ set_log_level debug
- 配置文件方式（rabbitmq.conf，经典/新风格二选一，注意格式与逗号）：
- 新风格（rabbitmq.conf）：
- log.file.level = debug
- log.connection.level = warning
- log.channel.level = info
- 经典风格（advanced.config，Erlang 元组格式）：
- [ {rabbit, [ {log_levels, [ {connection, warning}, {channel, info} ]} ]} ].
- 输出目标与格式：
- 启用文件日志：log.file = true（或设置 log.file = /data/logs/rabbitmq/rabbit.log）
- 输出到控制台：log.console = true；可分别设置 console/file/syslog 的 formatter
- JSON 便于集中式分析：log.file.formatter = json（或 log.console.formatter = json、log.syslog.formatter = json）
- 日志轮转（内置）：
- 按大小：log.file.rotation.size = 10485760（10 MB）
- 保留个数：log.file.rotation.count = 5
- 也可使用 Debian 的 logrotate 进行周期性轮转与清理。
四 集中化采集与可视化
- 将日志统一采集到 ELK/EFK 或 OpenSearch 等平台：
- 方案 A（推荐）：Filebeat → Logstash → Elasticsearch/Kibana
- Filebeat 读取 /var/log/rabbitmq/ 下日志，解析时间戳与关键字段
- Logstash 做 grok 解析与结构化，输出到 ES；Kibana 构建仪表盘（连接数、错误趋势、节点上下线等）
- 方案 B：直接写入 syslog，再由 Logstash/其他采集器处理
- 为便于机器解析，建议在 RabbitMQ 启用 JSON 日志格式（log.file.formatter = json），或在采集端完成结构化。
五 进阶 消息轨迹与问题定位
- 开启消息级别的 Firehose/Tracing（仅用于排障，生产慎用，会带来性能开销）：
- 启用插件：sudo rabbitmq-plugins enable rabbitmq_tracing
- 开启跟踪：sudo rabbitmqctl trace_on
- 关闭跟踪：sudo rabbitmqctl trace_off
- 开启后会出现 amq.rabbitmq.trace 与 amq.rabbitmq.log 两个 exchange，订阅即可获取连接与消息收发的详细事件
- 典型排查路径：
- 连接异常：查看 “accepted TCP connection from … / connection_closed_abruptly” 等
- 节点与集群：关注 “node up/down”、集群重连与分区恢复日志
- 资源告警：内存/磁盘水位与阻塞发布相关日志（如 “Memory limit set to …”）。
