标签: Erlang

  • 深入 RabbitMQ 跨机房雪崩排查:Shovel 环形路由风暴引发的内存高水位封控与 Paging IO 抖动实战

    某次接手处理一个跨机房双活架构的突发故障,业务端疯狂报错 java.util.concurrent.TimeoutException,所有往 RabbitMQ 集群投递消息的生产者全部卡死。登录管控台一看,双机房的 RabbitMQ 节点内存全部顶到告警线,连接状态齐刷刷显示为 blocked。 最终排查发现,这是一个极其低级的架构配置失误:业务侧通过 HTTP API 动态下发了双向 Shovel 任务进行跨机房消息同步,但既没有规划隔离的 Routing Key,也没有利用 Header 进行防环判断。一条消息在两个机房之间构成了无限死循环(Infinite Routing Loop),引发指数级的消息放大。RabbitMQ 在触发 vm_memory_high_watermark 保护机制后,无差别封杀所有生产者 TCP 连接,随后触发海量内存数据 Paging 刷盘,直接把底层存储 IOPS 打满,导致整个消息总线瘫痪。

    跨机房同步不用自带防环机制的 Federation,反而去手捏底层的 Shovel,捏完还不做防环逻辑。这种把插线板插在自己身上企图获得无限能源的操作,是对分布式系统基本功的严重亵渎。

    案发现场:诡异的 Blocked 连接与暴涨的内存

    监控大屏上的指标非常刺眼:

    1. Message Rate 异常:入队速率(Publish)从平时的 3k/s 瞬间飙升到 80k/s,而出队速率(Deliver/Get)几乎跌零。

    2. 连接状态死锁:执行 rabbitmqctl list_connections pid client_properties state,发现数万个生产者连接的 state 全部处于 blockingblocked 状态。

    3. 节点内存报警:系统内存 32G,RabbitMQ 进程占用飙破 12.8G(默认 40% 阈值)。

    4. 日志报警:核心日志里疯狂刷出 alarm_handler 触发的告警: log [warning] <0.324.0> memory resource limit alarm set on node 'rabbit@node1'. [info] <0.326.0> connection <0.1122.0> (10.x.x.x:54321 -> 10.x.x.y:5672): connection is blocked

    深度剖析:环形风暴与 Erlang VM 内存防御机制

    为什么一条循环消息能让整个 RabbitMQ 集群雪崩?这涉及 AMQP 协议的路由盲区以及 Erlang VM 激进的防御机制。

    1. Shovel 双向死环的形成

    在跨机房同步场景中,RabbitMQ 官方推荐的 Federation 插件会在消息 Header 中隐式追加 x-received-from 标记。当节点发现消息的流转链路中已经包含自己的集群名时,会主动丢弃,从而天然防环。 但排查过程中发现,业务侧为了“灵活控制路由”,选择使用了更底层的 Shovel 插件。Shovel 的本质是一个伪装成客户端的 Erlang 进程,它在一端 Consume,在另一端 Publish。 配置示例还原:

    • 机房 A Shovel:源端 Exchange=order.topic,目标端 机房 B Exchange=order.topic

    • 机房 B Shovel:源端 Exchange=order.topic,目标端 机房 A Exchange=order.topic

    由于两者监听的 Routing Key 均为 # 且目标 Exchange 相同,机房 A 产生的一条真实订单消息,被 Shovel 搬运到机房 B 后,立刻被机房 B 的 Shovel 捕获,再次搬回机房 A。消息在两条千兆专线间以网卡极限速度疯狂打乒乓球。

    2. vm_memory_high_watermark 的“休克疗法”

    RabbitMQ 不是以丢消息为代价来保命的系统。当节点内存达到 vm_memory_high_watermark(默认总内存的 0.4 倍)时,RabbitMQ 会触发一种近乎物理断电的保护机制: 底层 Erlang 会调用 erlang:setopts(Socket, [{active, false}]),直接停止读取所有发布消息的 TCP Socket。 这导致操作系统的 TCP 接收缓冲区迅速填满,TCP 窗口滑动为 0(Zero Window),反压(Backpressure)传导至客户端,最终导致所有的 Spring AMQP / Celery 生产者线程因等不到 ACK 甚至无法建立 Socket 发送而全部 Block 阻塞,业务雪崩。

    3. Paging 刷盘引发的 IO 惨案

    内存触顶后,噩梦才刚刚开始。为了腾出内存,RabbitMQ 会根据 vm_memory_high_watermark_paging_ratio(默认 0.5,即达到内存水位线的 50% 时触发)策略,将内存中的瞬态消息(Transient Messages)和队列索引强行 Page Out 到磁盘的 msg_store_transient 目录。

    # 查看内存破拆情况
    rabbitmq-diagnostics memory_breakdown
    # 输出显示 msg_index 和 queue_procs 占据了绝大部分内存
    

    几十万条循环堆积的消息瞬间引发极高频率的随机写 IO,导致磁盘 %%util 打满 100%,iowait 飙升。此时哪怕你想通过命令行去删除队列,都会因为底层 Mnesia 数据库及 Erlang 进程的 IO 阻塞而超时失败。

    破局与防御性修复

    在 IO 打满、连接全卡死的状态下,常规操作已经失效,必须通过底层干预进行“放水排雷”。

    1. 紧急提水位,恢复管控权 必须先骗过 Erlang VM,让它以为内存还够,从而恢复 TCP 处理和管控台响应:

    # 临时将内存告警阈值从 0.4 提至 0.6,争取操作窗口
    rabbitmqctl set_vm_memory_high_watermark 0.6
    

    2. 斩断死环,清理积压 在争取到的几分钟窗口期内,立刻删掉引发风暴的 Shovel 配置,并暴力清空积压队列:

    # 删除恶意 Shovel (注意:需在目标 VHost 下执行)
    rabbitmqctl clear_parameter -p /my_vhost shovel my_evil_shovel_a2b
    
    # 清洗队列(比从 UI 点 Purge 更稳)
    rabbitmqctl purge_queue -p /my_vhost loop_queue_name
    

    3. 架构级防御加固 恢复后,必须进行彻底的架构重构,杜绝此类问题二次发生:

    • 弃用双向 Shovel,改用 Federation:如果非要用双向同步,强制使用 Federation 插件,利用其内置的 x-received-from Header 实现拓扑防环。

    • 如果是 Shovel 刚需,必须做 Header 路由过滤:在 Shovel 配置中注入特定的 Header(例如 add_forward_headers),并在接收端的 Exchange 之前挂载一个 Headers Exchange 进行逻辑判断,拒收带有该机房标记的消息。

    • 死信与 TTL 兜底:任何跨系统调用的队列,绝对不允许无限期堆积。强制设置 x-message-ttlx-max-length。消息堆满立刻进 DLX(死信交换机),并配合报警,将故障控制在局部。

    总结排查清单

    为了避免后续运维和开发再踩坑,总结同类问题速查清单如下:

    1. 连接 Blocked 速查:遇到大量连接呈 blocking/blocked,第一时间看管控台右上角 Node 状态,如果是红色 Memory,说明已触发内存高水位封控,直接查 vm_memory_high_watermark

    2. 路由死环预警:排查有无异常的高 Message Publish 速率。如果有,且入队等于出队,极大概率是 Dead Letter Exchange (DLX) 配置成了死环,或者是 Shovel/Federation 跨机房配置了镜像拓扑。

    3. Paging 引起的性能雪崩:如果 CPU Load Average 极高,且执行 rabbitmqctl 命令频繁超时,检查磁盘 IO 是否被 RabbitMQ 的 msg_store_transientmsg_store_persistent 目录写满。必要时临时调高内存阈值进行急救。

    4. 生产者防阻塞策略:业务代码严禁对 MQ 同步阻塞等待。必须配置 ConnectionFactory 的超时时间,并在框架层捕获 AmqpException 进行降级,防止 MQ 抖动直接把业务 Tomcat/Netty 线程池拖死。

  • 深度剖析:跨机房 Federation 链路高延迟引发的 RabbitMQ 内存雪崩与路由风暴

    结论先行:跨机房部署 RabbitMQ Federation 时,高延迟 WAN 链路配合过大的 prefetch-count 会触发 Erlang VM 内存雪崩。解决方案:将 Upstream 的 prefetch-count 下调至 100-500,调优底层 TCP 发送窗口,并强制配置 max-hops=1 彻底阻断 AMQP 路由环路。以下是故障现场复盘。

    凌晨两点半,告警群被 P99 投递延迟报警刷屏。生产环境一组基于 RabbitMQ 3.11.15 (Erlang 25.3) 构建的双活集群由于跨机房专线拥塞,引发了连锁反应:上游集群触发 vm_memory_high_watermark 导致全量生产者被 Connection.Blocked 阻塞,核心交易链路短时瘫痪。

    为什么高延迟WAN链路会击穿 Federation 的内存防线?

    排障的第一步永远是看现场指标。通过 rabbitmq-diagnostics memory_breakdown,我发现上游集群的内存消耗并非由于 Queue 中积压了大量 Ready 消息,而是 connection_readersconnection_writers 占用了接近 6GB 内存。

    本质上,RabbitMQ Federation 插件是一个运行在下游(Downstream)集群内部的 AMQP 客户端。它会在上游(Upstream)声明一个内部队列(通常命名为 federation: exchange_name -> target),然后通过 AMQP 协议的 basic.consume 不断拉取消息。

    当 WAN 链路出现 50ms 以上的延迟波动时,灾难的种子就埋下了:

    1. 默认无限制的信道窗口:如果不显式指定,Federation 链路会使用默认较大的 prefetch_count(或者受限于网络吞吐)。

    2. Erlang 的异步发送机制:上游的 Channel 进程在收到 ACK 之前,会将 In-flight(飞行中)的消息保存在 Erlang 进程字典和底层 TCP Socket 缓冲区中。

    3. 内存急剧膨胀:延迟飙升导致下游 ACK 返回极慢。上游积压了大量 Unacked 消息,Erlang VM 为了维持吞吐,不断分配 Binary Heap。当总内存触及 vm_memory_high_watermark.relative = 0.4 的警戒线时,RabbitMQ 启动自保,触发全局内存告警,挂起所有发送消息的 TCP 连接。

    抓取底层网络包也能印证这一点:

    # 查看堆积在 TCP Send Buffer 里的数据量
    ss -tnpi | grep -A 1 5672
    

    你会看到 wmem_alloccwnd 极大,数据卡在内核态发不出去,上层 Erlang 进程不断重试分配内存。

    隐藏在 Binding 下的无限反射:路由风暴溯源

    在控制住了内存水位(临时调大 watermark 阈值放行流量)后,我发现上游的 TPS 曲线呈现出不自然的周期性锯齿。查阅日志,发现了大量重复的 x-received-from Headers。

    这就是跨机房双活的第二个大坑:AMQP 路由风暴

    在双向同步(Active-Active)架构中,A 机房的 Exchange 同步给 B 机房,B 机房的 Exchange 又配置了 Federation 同步给 A 机房。如果路由控制不当,一条消息会在 A 和 B 之间像乒乓球一样无限反射。

    Federation 防止环路的核心机制是附加 AMQP Header:

    • 消息离开 A 机房时,被打上 x-received-from: A-node-name

    • 消息到达 B 机房,B 尝试转发回 A 时,检查 Header 发现 A 已经存在,则丢弃。

    但坑在于:如果你使用的是 HAProxy 等四层负载均衡连接 Upstream,或者节点重启导致 Node Name 发生变化,Header 的防环检测就会失效。此时 max-hops 参数就成了最后一道防线。如果没配,消息默认会跳跃多次,导致内部网络带宽被无效的 AMQP Framing 完全榨干。

    核心调优与防御性配置落地

    废话不多说,直接上修复方案和最终配置。我们要从应用层协议栈到底层内核参数进行全面限制。

    1. 收紧 Federation 链路的 QoS

    重置 Upstream 参数,严格控制 prefetch-countmax-hops

    # RabbitMQ 控制台执行,动态更新 Federation Upstream
    rabbitmqctl set_parameter federation-upstream my-cross-dc-upstream \
    '{"uri":"amqp://sync_user:password@remote-haproxy:5672", 
      "prefetch-count": 200, 
      "max-hops": 1,
      "reconnect-delay": 5,
      "ack-mode": "on-confirm"}'
    

    注:prefetch-count: 200 是经过网络带宽延迟乘积(BDP)计算的折中值,既保证了基本吞吐,又避免了延迟突发时的内存爆仓。ack-mode: on-confirm 确保消息在落盘后再回执,防止脑裂丢数据。

    2. 底层 TCP 缓冲区调优

    rabbitmq.conf 中调整与 WAN 链路适配的 TCP 缓存参数,防止底层协议栈吃光内存后反压至 Erlang 层。

    # /etc/rabbitmq/rabbitmq.conf
    ## 针对高延迟网络调优 TCP Write/Read Buffer
    tcp_listen_options.sndbuf  = 131072
    tcp_listen_options.recbuf  = 131072
    tcp_listen_options.backlog = 1024
    tcp_listen_options.nodelay = true
    
    ## 开启信用流控告警
    vm_memory_high_watermark_paging_ratio = 0.75
    

    3. 清理残留的无效 Binding

    路由风暴往往伴随着错误的内部绑定。使用以下命令排查并清理:

    # 过滤查看内部的 federation 绑定关系
    rabbitmqctl list_bindings -p / | grep 'federation:'
    

    如果发现某些已废弃机房的临时 Queue 还在,坚决通过 rabbitmqadmin delete queue name='...' 干掉,防止死信不断积压。

    常见问题

    Q1:跨机房同步,Shovel 和 Federation 到底该怎么选? Federation 是基于 Exchange 拓扑的声明式同步,适合大面积的“状态复制”(如配置广播、多活全量同步),但其隐藏了内部队列,出故障时排查成本高。Shovel 是明确的点对点队列搬运工,属于典型的“硬连接”,结构简单且极度可控。如果是核心交易数据的跨机房灾备,我强烈建议使用 Shovel;如果是常规业务的多活路由,再考虑 Federation。

    Q2:Federation 链路状态显示 running,但消息就是不同步怎么排查? 大概率是网络半连接(Half-Open)或者 AMQP 协议层的死锁。直接看下游节点的内部 Queue 堆积情况。使用 rabbitmqctl list_queues name messages_unacknowledged 过滤 federation: 开头的队列。如果 unacknowledged 居高不下,说明网络回包被丢弃。结合 tcpkill 或重启 Federation link 插件即可快速恢复。

    Q3:如何精准监控 Federation 的积压情况? 不要只盯上游业务队列。必须监控下游针对上游自动生成的内部队列积压。建议在 Prometheus Exporter 中增加正则匹配: rabbitmq_queue_messages_ready{queue=~"federation:.*"}。只要这个指标突破 1000,立刻触发 P2 级告警检查专线质量,否则等待你的就是全线上游节点的熔断。