RabbitMQ 4.0 eliminó el mirroring de colas clásicas, por lo que cada cola clásica espejo debe convertirse en una cola de quórum antes de que un clúster pase a 4.x. Las colas de quórum se replican con Raft, confirman por mayoría y tienen por defecto un límite de entregas de 20. El orden de migración es: localizar las políticas de mirroring, eliminar las funcionalidades no admitidas, mover las colas y, después, actualizar.
Use colas de quórum para todo aquello en lo que perder un mensaje tenga consecuencias, y colas clásicas solo para cargas de trabajo transitorias, como respuestas RPC de corta duración, consumidores exclusivos y colas temporales con nombre asignado por el servidor. Si el traslado de colas forma parte de una actualización de 3.13 a 4.x, actualizaciones de RabbitMQ aborda la migración de colas y la actualización de versión como un único plan.
Esta guía explica qué es realmente una cola de quórum, las diferencias concretas, lo que las colas de quórum no admiten y una ruta de migración que hemos aplicado en clústeres de producción.
¿Qué es una cola de quórum?
Una cola de quórum es un tipo de cola moderno basado en el algoritmo de consenso Raft. En lugar de una copia principal con réplicas opcionales, mantiene un conjunto de miembros replicados (un líder y varios seguidores) repartidos entre los nodos de un clúster.
Las escrituras solo se confirman cuando las ha aceptado la mayoría de los miembros. Ese requisito de mayoría es lo que da a las colas de quórum su garantía de seguridad de los datos, y también lo que define su comportamiento ante fallos: tres miembros toleran la pérdida de un nodo; si se pierden dos, la cola deja de aceptar escrituras por diseño en lugar de arriesgarse a una divergencia.
Se coloca un miembro por nodo. En un clúster de cinco nodos, una cola de tres miembros ocupa tres nodos y deja dos sin usar: el factor de replicación es independiente del tamaño del clúster.
Los tres tipos de cola
Tipo
Replicación
Indicada para
Clásica
Una sola copia, sin replicación
Colas transitorias, exclusivas o con nombre asignado por el servidor
Quórum
Replicada con Raft, confirmación por mayoría
Mensajes de negocio duraderos cuya pérdida es inaceptable
Streams
Log replicado de solo anexado
Reproducción, distribución a muchos consumidores, retención prolongada
Las colas clásicas espejo eran una cuarta opción y ya no existen. El mirroring quedó obsoleto en la línea 3.x y se eliminó en RabbitMQ 4.0.
Principales diferencias entre colas clásicas y colas de quórum
Cola clásica
Cola de quórum
Durabilidad
Opcional
Siempre duradera
Replicación
Ninguna
Confirmada por mayoría entre los miembros
Almacenamiento
En memoria, con paginación a disco
Siempre se escribe en disco
Comportamiento ante fallos
La cola se pierde con su nodo
Sobrevive a la pérdida de una minoría de nodos
Colas exclusivas
Sí
No
Colas con nombre asignado por el servidor
Sí
No
Prefetch QoS global
Sí
Solo por consumidor
Límite de entregas
Ninguno por defecto
20 por defecto desde la 4.0
En la práctica: las colas clásicas priorizan la flexibilidad y la baja sobrecarga, y las colas de quórum priorizan la seguridad de los datos y la tolerancia a fallos. Para conseguirlo, las colas de quórum consumen más disco y más tráfico de red.
Cuándo usar colas de quórum y cuándo colas clásicas
Úselas cuando el mensaje represente trabajo real: un pedido, un pago, una tarea que no puede desaparecer. Esto abarca la gran mayoría de la mensajería empresarial, y por eso la replicación es hoy el tipo de cola por defecto más sensato para los nuevos servicios de RabbitMQ.
Use colas clásicas cuando la cola sea realmente desechable: colas de respuesta RPC ligadas a una conexión, colas exclusivas que deben desaparecer con su consumidor o colas temporales con nombre asignado por el servidor. En estos casos la replicación añade coste y las funciones no admitidas son precisamente las que necesita.
Use streams cuando varios consumidores independientes necesiten leer los mismos mensajes o necesite reproducirlos dentro de una ventana de retención.
Lo que las colas de quórum no admiten
Aquí es donde fallan las migraciones, así que compruébelo antes de planificar una. Las colas de quórum no admiten:
Colas no duraderas: siempre son duraderas
Colas exclusivas: incompatibles con el modelo de replicación
Colas con nombre asignado por el servidor: el nombre debe declararse explícitamente
Prefetch QoS global: solo funciona el prefetch por consumidor. Consulte cómo ajustar el prefetch count para conocer las implicaciones
Exclusividad de consumidor: use Single Active Consumer en su lugar
Las aplicaciones que dependen de cualquiera de estas funciones necesitan un cambio de código, no solo un cambio de tipo de cola.
El límite de entregas
A partir de RabbitMQ 4.0, el límite de entregas de las colas de quórum es de 20 por defecto. Tras veinte intentos de entrega, el mensaje se descarta o se envía a la dead-letter queue en lugar de reentregarse indefinidamente.
Antes de la 4.0 no había límite, lo que significaba que un consumidor que fallaba sistemáticamente podía reentregar un mensaje envenenado para siempre. El nuevo valor por defecto mejora la seguridad, pero cambia el comportamiento al actualizar: si su aplicación depende de reintentos ilimitados, empezará a perder mensajes que antes conservaba.
Defina x-delivery-limit para aumentarlo, o -1 para recuperar el antiguo comportamiento sin límite. No se recomienda recuperarlo: configure en su lugar una dead-letter queue para que los fallos queden capturados en vez de repetirse en bucle.
Cómo migrar de colas clásicas a colas de quórum
El tipo de una cola se fija al declararla y no se puede cambiar mediante una política. Por tanto, migrar significa crear colas nuevas, no modificar las existentes.
Audite primero. Localice todas las colas que usen exclusividad, declaración con nombre asignado por el servidor o prefetch global. Requieren cambios en la aplicación antes de hacer cualquier otra cosa.
Declare la cola nueva con el argumento x-queue-type establecido en quorum. Tres miembros es el valor práctico por defecto para la alta disponibilidad.
Vacíe la cola antigua. Haga que los consumidores lean de ambas, deje que la cola clásica se vacíe y deje de publicar en ella.
Pase los publicadores a la cola nueva en cuanto la antigua marque cero.
Elimine la cola clásica solo cuando haya transcurrido un periodo de retención completo sin incidencias.
El plugin Shovel puede trasladar mensajes entre ambas si no es posible vaciarla in situ. Ejecute primero toda la secuencia en un entorno de staging: la lista de funciones no admitidas es donde los equipos descubren los problemas, y descubrirlos en producción supone una marcha atrás de emergencia.
¿Cómo se migra de colas clásicas espejo a colas de quórum en RabbitMQ 4?
Migre antes de la actualización, porque RabbitMQ 4.0 ya no ofrece la replicación que proporcionan las políticas ha-mode. Por este orden:
Localice las políticas de mirroring en 3.13. Ejecute rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policy; devuelve un código distinto de cero si alguna política activa el mirroring. rabbitmq-diagnostics list_policies_with_classic_queue_mirroring las enumera. Las claves que debe buscar son ha-mode, ha-params, ha-sync-mode, ha-promote-on-shutdown, ha-promote-on-failure y queue-master-locator.
Enumere las colas a las que afectan esas políticas. Toda cola clásica cuya política efectiva contenga ha-mode debe cambiar de tipo. rabbitmqctl list_queues name policy effective_policy_definition type las muestra por virtual host, en RabbitMQ 3.10.13, 3.11.5 o posterior.
Elimine lo que las colas de quórum no admiten. RabbitMQ valida estrictamente los argumentos de cola, así que retire del código de la aplicación las declaraciones exclusivas y no duraderas, las colas con nombre asignado por el servidor, el prefetch global y los argumentos exclusivos del mirroring. Algunos pueden trasladarse a una política.
Elija una ruta. Migrar por virtual host en el mismo clúster; un despliegue blue-green hacia un nuevo clúster 4.x con colas de quórum; o in situ en el mismo virtual host, lo que exige detener todos los consumidores y productores de la cola mientras se traslada. Un clúster que además arrastra varias versiones de retraso suele ser más seguro con blue-green, y esa es la opción por defecto de AceMQ: el nuevo clúster 4.x se construye sobre 4.2.8 o posterior, porque evitamos la 4.1.3.
Declare las colas de quórum. Asigne quorum a x-queue-type en la declaración, con tres miembros para alta disponibilidad (HA). Vacíe la cola clásica o traslade sus mensajes con el plugin Shovel y, después, pase los publicadores a la nueva cola.
Pruebe bajo carga. El comportamiento de las colas de quórum difiere del de las colas espejo bajo carga y en casos límite, y el límite de entregas de 20 envía ahora a dead-letter mensajes que antes se reintentaban indefinidamente. Ensaye en preproducción con una cola dead-letter (DLQ) configurada.
Elimine las políticas ha-*, compruebe que el comando de verificación devuelve cero y actualice a 4.x mediante una actualización progresiva (rolling upgrade), nodo a nodo, ensayada antes fuera de producción.
Migración de colas clásicas espejo a colas de quórum en RabbitMQ 4
El mirroring de colas clásicas quedó obsoleto en 2021 y se eliminó en RabbitMQ 4.0. Si un clúster 3.13 sigue dependiendo de políticas ha-mode, la replicación que ofrecen esas políticas no existe en 4.x, de modo que el paso a colas de quórum debe planificarse en 3.13, antes de la actualización o como parte de ella, no después.
Empiece por localizar todas las políticas que activan el mirroring. RabbitMQ 3.13 incluye dos diagnósticos precisamente para esto:
# exits non-zero if any policy enables classic queue mirroring
rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policy
# lists those policies
rabbitmq-diagnostics list_policies_with_classic_queue_mirroring -s --formatter=pretty_table
La documentación de RabbitMQ describe dos rutas de migración:
Migrar por virtual host. Cree un nuevo virtual host en el mismo clúster, declare en él las colas de quórum y redirija las aplicaciones cambiando los parámetros de conexión. Es la ruta más eficiente cuando el código de la aplicación ya no depende de funcionalidades que no tienen las colas de quórum, porque el mismo código funciona con ambos tipos de cola.
Despliegue blue-green hacia un nuevo clúster 4.x. Construya un clúster 4.x con colas de quórum, traslade consumidores y publicadores y vacíe el clúster 3.13. El equipo de RabbitMQ publica herramientas de rabbitmqadmin v2 para trasladar definiciones de 3.13 con colas clásicas espejo a un clúster 4.x con colas de quórum. Así se combinan la actualización de versión y el cambio de tipo de cola en un único cutover.
En ambos casos, elimine primero las funcionalidades incompatibles. Las declaraciones exclusivas o no duraderas, las colas con nombre asignado por el servidor y el prefetch global requieren cambios en el código. Los argumentos de cola que solo tenían sentido con mirroring normalmente pueden eliminarse o trasladarse a una política. Preferimos la ruta blue-green para entornos que además llevan varias versiones menores de retraso, porque ofrece una vía de rollback que una actualización in situ no ofrece.
Si el cambio de colas forma parte de una actualización de 3.13 a 4.x, nuestro servicio de actualización de RabbitMQ planifica conjuntamente la migración de las colas y la actualización de versión, con un rollback probado.
Cómo declarar una cola de quórum con x-queue-type
Una cola de quórum la declara el cliente con el argumento x-queue-type establecido en quorum. No se puede definir mediante una política, porque una política puede cambiar tras la declaración y el tipo de cola no. Por defecto, la cola tiene hasta tres miembros, uno por nodo; x-quorum-initial-group-size modifica ese número.
La cola debe ser duradera y no exclusiva; de lo contrario, la declaración falla. Si ya existe una cola clásica con el mismo nombre, la declaración falla con un error PRECONDITION_FAILED, porque los argumentos no coinciden. Suele ser la señal de que se ha saltado un paso de la migración.
Rendimiento: throughput y latencia
Las colas de quórum no son más lentas en todos los casos, pero el compromiso es real. Cada escritura espera la confirmación (ack) de una mayoría, lo que añade latencia frente a una única copia sin replicar. A cambio, el throughput bajo carga sostenida es mucho más predecible de lo que nunca lograron las colas clásicas en espejo: el mirroring se degradaba seriamente con la longitud de la cola, y las colas de quórum no.
En cualquier caso, mantenga las colas cortas. Una cola de quórum con millones de mensajes se comportará peor que una con miles, porque cada miembro almacena todo el backlog en disco.
¿Está planificando una migración y no sabe qué colas puede mover con seguridad? AceMQ realiza estas migraciones en clústeres de producción, incluida la fase de auditoría que la mayoría de los equipos se salta. Hable con un ingeniero de AceMQ.
Operación de colas de quórum en producción
Hay tres problemas que sorprenden con frecuencia a los equipos tras la migración.
La pertenencia se gestiona de forma explícita. Añadir un nodo al clúster no lo añade a las colas existentes. Use add_member, delete_member, grow y shrink para gestionar la pertenencia de forma deliberada. Los equipos que escalan horizontalmente y dan por hecho que la replicación se extiende sola se llevan una sorpresa cuando una cola sigue teniendo miembros solo en los tres nodos originales.
El mantenimiento en Kubernetes requiere vaciar el broker. En una evaluación de clúster de 2026 atribuimos pérdidas de quórum recurrentes a tareas de mantenimiento de nodos realizadas sin vaciar antes el broker. Un drain de Kubernetes desaloja el pod, pero el nodo necesita su propio apagado ordenado para que los miembros puedan traspasar el liderazgo. Si se omite, una aplicación de parches rutinaria se convierte en una caída del servicio.
Compruebe su versión de parche antes de rediseñar. En el mismo proyecto aislamos los errores de reconocimiento de nodos en un defecto de la versión 4.2.3, corregido en compilaciones 4.2.x posteriores y en la serie 4.3. Conviene contrastar primero con las notas de la versión los errores de pertenencia que persisten tras un reinicio limpio y con la configuración correcta. Nuestra guía de resolución de problemas de RabbitMQ cubre el proceso de diagnóstico más amplio.
Para la recuperación ante desastres (DR), confirme que el clúster standby solo se activa si falla el principal. Uno que arranca junto a un principal sano provoca un split-brain, y la recuperación exige entonces recrear nodos manualmente y repetir la elección. ¿Pasa de colas clásicas a quorum queues durante una migración de 3.x a 4.x? Consulte los servicios de actualización de RabbitMQ.
AceMQ ofrece consultoría de RabbitMQ para despliegues empresariales, que incluye planificación de la migración, evaluaciones de clústeres y respuesta a incidentes 24/7.
Cómo encaja esta migración en un cambio mayor (desde otro broker o hacia una nueva versión mayor en la misma ventana) se explica en la guía de migración de RabbitMQ.
Gestión de la pertenencia en colas de quórum: grow, shrink y rebalanceo
La pertenencia no es automática salvo que la active. La CLI rabbitmq-queues se encarga de gestionarla:
# add or remove one member of one queue
rabbitmq-queues add_member [-p <vhost>] <queue-name> <node>
rabbitmq-queues delete_member [-p <vhost>] <queue-name> <node>
# add a member on <node> for all matching queues, or only those with an even member count
rabbitmq-queues grow <node> <all | even> [--vhost-pattern <pattern>] [--queue-pattern <pattern>]
# remove all members hosted on <node>
rabbitmq-queues shrink <node> [--errors-only]
# spread leaders evenly across nodes
rabbitmq-queues rebalance quorum --vhost-pattern "production.*"
La secuencia habitual tras añadir un nodo es ejecutar grow sobre el nuevo nodo y después rebalance, para que los líderes no se queden todos en los tres originales. Antes de retirar un nodo, ejecute shrink sobre él para que ninguna cola pierda un miembro con el que contaba para su mayoría.
La conciliación continua de la pertenencia (continuous membership reconciliation) automatiza el paso de grow. Con quorum_queue.continuous_membership_reconciliation.enabled = true y un target_group_size, RabbitMQ amplía las colas que están por debajo del objetivo hacia nodos que aún no las alojan. Se ejecuta cada 60 minutos por defecto y también tras eventos como la incorporación de un nodo. Está desactivada por defecto. auto_remove, que elimina miembros en nodos que han abandonado el clúster, es un ajuste independiente y también está desactivado por defecto.
Preguntas frecuentes
¿Qué tipos de colas hay en RabbitMQ?
Tres: colas clásicas (una sola copia, sin replicación), colas de quórum (replicadas con Raft y confirmación por mayoría) y streams (log replicado de solo anexado con retención). Las colas clásicas espejo eran un cuarto tipo, eliminado en la 4.0.
¿Qué es una cola de quórum (quorum queue)?
Un tipo de cola replicada de RabbitMQ que usa el algoritmo de consenso Raft. Mantiene un miembro líder y varios seguidores repartidos entre los nodos del clúster y confirma las escrituras en cuanto las acepta una mayoría, por lo que sobrevive a la caída de una minoría de nodos sin perder mensajes.
¿Cuál es el límite de entregas de las colas de quórum?
Desde RabbitMQ 4.0 es de 20 por defecto. Tras veinte intentos de entrega, el mensaje se descarta o se envía a la cola dead-letter (DLQ). Las versiones anteriores no tenían límite. Defina x-delivery-limit para cambiarlo, o -1 para desactivarlo, algo que no se recomienda.
¿Cuándo conviene usar colas clásicas en lugar de colas de quórum?
Solo para cargas de trabajo transitorias: colas exclusivas, colas temporales con nombre asignado por el servidor y colas de respuesta RPC. Todo lo que deba ser duradero debería usar colas de quórum.
¿Qué diferencia hay entre Kafka y las colas de quórum de RabbitMQ?
Las colas de quórum son una cola de mensajes replicada: los mensajes se consumen y se eliminan. Kafka es un log distribuido en el que los consumidores llevan el control de sus offsets sobre los datos retenidos y pueden reproducirlos de nuevo. Si busca una semántica de tipo log dentro del broker, los streams son el equivalente más cercano.
¿Qué limitaciones tienen las colas de quórum?
No admiten colas no duraderas, colas exclusivas, colas con nombre asignado por el servidor, prefetch QoS global ni exclusividad de consumidor. Además, siempre escriben en disco, por lo que ocupan más almacenamiento que una cola clásica equivalente.
¿Cómo se declara una cola de quórum?
Asigne el valor quorum al argumento de cola x-queue-type en el momento de la declaración. No se puede aplicar ni cambiar después mediante una política.
¿Puedo convertir una cola clásica existente en una cola de quórum?
No. El tipo de cola no se puede modificar una vez declarada. Debe crear una cola nueva, vaciar la antigua, pasar los publicadores a la nueva y eliminar la original.
Tanto si está resolviendo un incidente en producción como si planifica una migración o quiere una segunda opinión sobre su arquitectura, nuestro equipo está preparado. Sin discursos comerciales, solo respuestas.