BlogRabbitMQ

RabbitMQ Quorum Queues: Was sich in 4.x ändert und wie Sie von Classic Queues migrieren

Scott Sternloff

Von Scott Sternloff, Senior Enterprise Architect

LinkedIn · Aktualisiert am · 13 Min. Lesezeit

RabbitMQ Quorum Queues: Was sich in 4.x ändert und wie Sie von Classic Queues migrieren
Auf dieser Seite

RabbitMQ 4.0 hat das Mirroring von Classic Queues entfernt. Deshalb muss jede gespiegelte Classic Queue zur Quorum Queue werden, bevor ein Cluster auf 4.x läuft. Quorum Queues replizieren per Raft, committen per Mehrheit und haben standardmäßig ein Delivery Limit von 20. Die Reihenfolge der Migration: Mirroring-Policies ermitteln, nicht unterstützte Features bereinigen, Queues umziehen, dann upgraden.

Setzen Sie Quorum Queues überall dort ein, wo ein Nachrichtenverlust ins Gewicht fällt, und Classic Queues nur für transiente Workloads wie kurzlebige RPC-Replies, exklusive Consumer und vom Server benannte temporäre Queues. Ist die Queue-Migration Teil eines Upgrades von 3.13 auf 4.x, behandelt RabbitMQ-Upgrades Queue-Migration und Versions-Upgrade als einen gemeinsamen Plan.

Dieser Leitfaden erklärt, was eine Quorum Queue tatsächlich ist, welche konkreten Unterschiede es gibt, was Quorum Queues nicht unterstützen – und beschreibt einen Migrationspfad, den wir auf produktiven Clustern umgesetzt haben.

Was ist eine Quorum Queue?

Eine Quorum Queue ist ein moderner Queue-Typ auf Basis des Raft-Konsensalgorithmus. Statt einer primären Kopie mit optionalen Mirrors unterhält sie eine Gruppe replizierter Member – einen Leader und mehrere Follower –, verteilt über die Nodes eines Clusters.

Schreibvorgänge werden erst bestätigt, wenn eine Mehrheit der Member sie angenommen hat. Diese Mehrheitsanforderung begründet die Datensicherheitsgarantie von Quorum Queues und bestimmt zugleich ihr Ausfallverhalten: Drei Member verkraften den Ausfall eines Nodes; fallen zwei aus, nimmt die Queue konstruktionsbedingt keine Schreibvorgänge mehr an, statt ein Auseinanderlaufen der Daten zu riskieren.

Pro Node wird ein Member platziert. In einem Cluster mit fünf Nodes belegt eine Queue mit drei Membern drei Nodes und lässt zwei ungenutzt – der Replikationsfaktor ist unabhängig von der Clustergröße.

Die drei Queue-Typen

TypReplikationIdeal für
ClassicEine Kopie, keine ReplikationTransiente, exklusive oder vom Server benannte Queues
QuorumPer Raft repliziert, Commit per MehrheitDauerhafte Geschäftsnachrichten, bei denen Verlust inakzeptabel ist
StreamsReplizierter Append-only-LogReplay, Fan-out an viele Consumer, lange Aufbewahrung

Gespiegelte Classic Queues waren eine vierte Option und existieren nicht mehr. Mirroring wurde in der 3.x-Linie als veraltet markiert und in RabbitMQ 4.0 entfernt.

Die wichtigsten Unterschiede zwischen Classic und Quorum Queues

Classic QueueQuorum Queue
DauerhaftigkeitOptionalImmer dauerhaft
ReplikationKeineCommit per Mehrheit der Member
SpeicherungArbeitsspeicher mit PagingImmer auf Festplatte geschrieben
AusfallverhaltenQueue geht mit ihrem Node verlorenÜbersteht den Ausfall einer Minderheit der Nodes
Exclusive QueuesUnterstütztNicht unterstützt
Vom Server benannte QueuesUnterstütztNicht unterstützt
Globaler QoS-PrefetchUnterstütztNur pro Consumer
Delivery LimitStandardmäßig keinesAb 4.0 standardmäßig 20

Kurz gesagt: Classic Queues sind auf Flexibilität und geringen Overhead optimiert, Quorum Queues auf Datensicherheit und Fehlertoleranz. Dafür kosten Quorum Queues mehr Plattenplatz und Netzwerkverkehr.

Wann Quorum Queues, wann Classic Queues?

Verwenden Sie Quorum Queues, wenn die Nachricht echte Arbeit darstellt – eine Bestellung, eine Zahlung, einen Job, der nicht verschwinden darf. Das betrifft den Großteil des Enterprise-Messagings, weshalb Replikation heute der sinnvolle Standard-Queue-Typ für neue RabbitMQ-Services ist.

Verwenden Sie Classic Queues, wenn die Queue tatsächlich verzichtbar ist: RPC-Reply-Queues, die an eine Verbindung gebunden sind, Exclusive Queues, die mit ihrem Consumer verschwinden sollen, oder vom Server benannte temporäre Queues. In diesen Fällen verursacht Replikation nur Kosten, und die nicht unterstützten Features sind genau die, die Sie brauchen.

Verwenden Sie Streams, wenn mehrere unabhängige Consumer dieselben Nachrichten lesen müssen oder Sie Replay über ein Aufbewahrungsfenster brauchen.

Was Quorum Queues nicht unterstützen

Genau hier scheitern Migrationen – prüfen Sie diese Punkte also, bevor Sie eine planen. Quorum Queues unterstützen nicht:

  • Nicht dauerhafte Queues – sie sind immer dauerhaft
  • Exclusive Queues – nicht mit dem Replikationsmodell vereinbar
  • Vom Server benannte Queues – der Name muss explizit deklariert werden
  • Globalen QoS-Prefetch – nur Prefetch pro Consumer funktioniert. Die Auswirkungen beschreibt Prefetch Count richtig einstellen
  • Consumer-Exklusivität – verwenden Sie stattdessen Single Active Consumer

Anwendungen, die auf eines dieser Features angewiesen sind, brauchen eine Codeänderung, nicht nur einen anderen Queue-Typ.

Das Delivery Limit

Seit RabbitMQ 4.0 liegt das Delivery Limit für Quorum Queues standardmäßig bei 20. Nach zwanzig Zustellversuchen wird eine Nachricht verworfen oder in eine Dead-Letter-Queue verschoben, statt endlos erneut zugestellt zu werden.

Vor 4.0 gab es kein Limit – ein dauerhaft fehlschlagender Consumer konnte eine Poison Message also endlos erneut zustellen lassen. Der neue Standard verbessert die Sicherheit, ändert aber das Verhalten beim Upgrade: Wenn Ihre Anwendung auf unbegrenzte Wiederholungen angewiesen ist, verlieren Sie plötzlich Nachrichten, die bisher erhalten blieben.

Setzen Sie x-delivery-limit, um den Wert zu erhöhen, oder -1, um das alte unbegrenzte Verhalten wiederherzustellen. Letzteres ist nicht empfehlenswert – konfigurieren Sie stattdessen eine Dead-Letter-Queue, damit Fehlschläge aufgefangen werden, statt in einer Endlosschleife zu landen.

So migrieren Sie Classic Queues zu Quorum Queues

Der Typ einer Queue wird bei der Deklaration festgelegt und lässt sich per Policy nicht ändern. Migration bedeutet daher, neue Queues anzulegen, nicht bestehende zu verändern.

  1. Zuerst auditieren. Finden Sie jede Queue, die Exklusivität, serverseitige Benennung oder globalen Prefetch nutzt. Diese brauchen Anwendungsänderungen, bevor irgendetwas anderes passiert.
  2. Neue Queue deklarieren – mit dem Argument x-queue-type auf quorum gesetzt. Drei Member sind der praxisübliche Standard für Hochverfügbarkeit.
  3. Alte Queue leeren. Lassen Sie die Consumer von beiden Queues lesen, warten Sie, bis die Classic Queue leer ist, und stoppen Sie dann das Publishing in sie.
  4. Publisher umstellen, sobald die alte Queue null Nachrichten anzeigt.
  5. Classic Queue löschen – erst, wenn eine vollständige Aufbewahrungsperiode ohne Probleme vergangen ist.

Das Shovel-Plugin kann Nachrichten zwischen beiden Queues verschieben, falls ein Leeren an Ort und Stelle keine Option ist. Spielen Sie die gesamte Abfolge zuerst in Staging durch – an der Liste der nicht unterstützten Features stoßen Teams auf ihre Probleme, und sie erst in Produktion zu entdecken, heißt Notfall-Rollback.

Wenn Sie gleichzeitig zwischen Major-Versionen wechseln, stimmen Sie die Reihenfolge sorgfältig mit dem Upgrade von RabbitMQ 3.x auf 4.x ohne Downtime ab.

Wie migriert man in RabbitMQ 4 von gespiegelten Classic Queues zu Quorum Queues?

Migrieren Sie vor dem Upgrade, denn RabbitMQ 4.0 bietet die Replikation, die ha-mode-Policies bereitstellen, nicht mehr. Die Reihenfolge:

  1. Mirroring-Policies auf 3.13 ermitteln. Führen Sie rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policy aus; der Befehl endet mit einem Exit-Code ungleich null, wenn eine Policy Mirroring aktiviert. rabbitmq-diagnostics list_policies_with_classic_queue_mirroring listet diese Policies auf. Relevant sind die Keys ha-mode, ha-params, ha-sync-mode, ha-promote-on-shutdown, ha-promote-on-failure und queue-master-locator.
  2. Betroffene Queues auflisten. Jede Classic Queue, deren effektive Policy ha-mode enthält, muss den Typ wechseln. rabbitmqctl list_queues name policy effective_policy_definition type zeigt sie pro Virtual Host an, ab RabbitMQ 3.10.13 bzw. 3.11.5.
  3. Nicht unterstützte Features bereinigen. RabbitMQ validiert Queue-Argumente strikt. Entfernen Sie daher exklusive und nicht dauerhafte Deklarationen, vom Server benannte Queues, globalen Prefetch und reine Mirroring-Argumente aus dem Anwendungscode. Manches lässt sich in eine Policy verlagern.
  4. Weg wählen. Migration per Virtual Host auf demselben Cluster, Blue-Green-Deployment auf einen neuen 4.x-Cluster mit Quorum Queues oder In-place auf demselben Virtual Host – dafür müssen alle Consumer und Producer der Queue während des Umzugs gestoppt sein. Liegt ein Cluster zusätzlich mehrere Versionen zurück, ist Blue-Green-Deployment meist sicherer. Das ist auch der Standard bei AceMQ: Der neue 4.x-Cluster wird auf 4.2.8 oder neuer aufgebaut, weil wir 4.1.3 meiden.
  5. Quorum Queues deklarieren. Setzen Sie bei der Deklaration x-queue-type auf quorum, mit drei Membern für Hochverfügbarkeit (HA). Leeren Sie die Classic Queue oder verschieben Sie ihre Nachrichten mit dem Shovel-Plugin und stellen Sie dann die Publisher um.
  6. Unter Last testen. Quorum Queues verhalten sich unter Last und in Grenzfällen anders als Mirrored Queues. Zudem verschiebt das Delivery Limit von 20 nun Nachrichten in die Dead-Letter-Queue, die früher endlos erneut zugestellt wurden. Proben Sie das in Staging mit eingerichteter Dead-Letter-Queue (DLQ).
  7. Die ha-*-Policies entfernen, prüfen, dass der Check-Befehl mit null endet, und dann auf 4.x upgraden – per Rolling Upgrade, ein Knoten nach dem anderen, vorher außerhalb der Produktion geprobt.

Die Schritte folgen der RabbitMQ-Dokumentation zur Migration gespiegelter Classic Queues zu Quorum Queues, geprüft am 22. Oktober 2026.

Migration von gespiegelten Classic Queues zu Quorum Queues in RabbitMQ 4

Das Mirroring von Classic Queues wurde 2021 abgekündigt und in RabbitMQ 4.0 entfernt. Setzt ein 3.13-Cluster noch auf ha-mode-Policies, gibt es die Replikation dieser Policies auf 4.x nicht mehr. Der Wechsel zu Quorum Queues muss daher auf 3.13 geplant werden – vor oder im Rahmen des Upgrades, nicht danach.

Ermitteln Sie zuerst jede Policy, die Mirroring aktiviert. RabbitMQ 3.13 bringt genau dafür zwei Diagnosebefehle mit:

# 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

Die RabbitMQ-Dokumentation beschreibt zwei Migrationswege:

  1. Migration per Virtual Host. Legen Sie auf demselben Cluster einen neuen Virtual Host an, deklarieren Sie dort Quorum Queues und leiten Sie die Anwendungen über geänderte Verbindungsparameter dorthin um. Das ist der effizienteste Weg, wenn der Anwendungscode nicht mehr von Features abhängt, die Quorum Queues fehlen – denn derselbe Code funktioniert dann mit beiden Queue-Typen.
  2. Blue-Green-Deployment auf einen neuen 4.x-Cluster. Bauen Sie einen 4.x-Cluster mit Quorum Queues auf, ziehen Sie Consumer und Publisher um und leeren Sie den 3.13-Cluster. Das RabbitMQ-Team stellt mit rabbitmqadmin v2 Tooling bereit, um 3.13-Definitionen mit gespiegelten Classic Queues auf einen 4.x-Cluster mit Quorum Queues zu übertragen. So verbinden Sie Versions-Upgrade und Wechsel des Queue-Typs in einer einzigen Umstellung.

In beiden Fällen gilt: Bereinigen Sie zuerst die inkompatiblen Features. Exklusive oder nicht dauerhafte Deklarationen, vom Server benannte Queues und globaler Prefetch erfordern Codeänderungen. Queue-Argumente, die nur für Mirroring sinnvoll waren, lassen sich meist entfernen oder in eine Policy verlagern. Für IT-Landschaften, die zusätzlich mehrere Minor-Versionen zurückliegen, bevorzugen wir das Blue-Green-Deployment, weil es einen Rollback-Pfad bietet, den ein In-place-Upgrade nicht hat.

Wenn der Wechsel der Queues Teil eines Upgrades von 3.13 auf 4.x ist, plant unser RabbitMQ-Upgrade-Service die Migration der Queues und das Versions-Upgrade gemeinsam – inklusive getestetem Rollback.

Quorum Queue mit x-queue-type deklarieren

Eine Quorum Queue wird vom Client mit dem Argument x-queue-type = quorum deklariert. Per Policy lässt sich das nicht setzen, denn eine Policy kann sich nach der Deklaration ändern, ein Queue-Typ nicht. Standardmäßig erhält die Queue bis zu drei Member, einen pro Knoten; mit x-quorum-initial-group-size ändern Sie diese Zahl.

Python mit pika:

channel.queue_declare(
    queue="orders",
    durable=True,
    arguments={"x-queue-type": "quorum"},
)

Java-Client:

Map<String, Object> args = Map.of("x-queue-type", "quorum");
channel.queueDeclare("orders", true, false, false, args);

Die Queue muss dauerhaft (durable) und darf nicht exklusiv sein, sonst schlägt die Deklaration fehl. Existiert bereits eine Classic Queue mit demselben Namen, scheitert die Deklaration mit einem PRECONDITION_FAILED-Fehler, weil die Argumente nicht übereinstimmen. Das ist das typische Zeichen dafür, dass ein Migrationsschritt übersprungen wurde.

Performance: Durchsatz und Latenz

Quorum Queues sind nicht grundsätzlich langsamer, der Trade-off ist aber real. Jeder Schreibvorgang wartet auf das Acknowledgement (Ack) einer Mehrheit, was im Vergleich zu einer einzelnen, nicht replizierten Kopie Latenz hinzufügt. Im Gegenzug ist der Durchsatz unter Dauerlast weit berechenbarer, als es Classic Mirrored Queues je waren – Mirroring brach mit wachsender Queue-Länge stark ein, Quorum Queues nicht.

Halten Sie Queues trotzdem kurz. Eine Quorum Queue mit Millionen Nachrichten verhält sich schlechter als eine mit Tausenden, weil jeder Member den gesamten Rückstau auf der Festplatte speichert.

Sie planen eine Migration und wissen nicht, welche Queues sich gefahrlos umziehen lassen? AceMQ führt solche Migrationen auf produktiven Clustern durch – einschließlich des Audit-Schritts, den die meisten Teams überspringen. Sprechen Sie mit einem AceMQ-Engineer.

Quorum Queues im Produktivbetrieb

Drei Punkte machen Teams nach der Migration regelmäßig zu schaffen.

Die Membership wird explizit verwaltet. Wird dem Cluster ein Knoten hinzugefügt, wird er nicht automatisch bestehenden Queues hinzugefügt. Verwalten Sie die Membership gezielt mit add_member, delete_member, grow und shrink. Teams, die horizontal skalieren und annehmen, die Replikation ziehe mit, sind überrascht, wenn eine Queue weiterhin nur Member auf den ursprünglichen drei Knoten hat.

Kubernetes-Wartung erfordert einen Broker-Drain. Bei einem Cluster-Assessment im Jahr 2026 haben wir wiederkehrenden Quorum-Verlust auf Knoten-Wartungen zurückgeführt, bei denen der Broker nicht vorher per Drain in den Wartungsmodus versetzt wurde. Ein Kubernetes-Drain entfernt den Pod, der Knoten braucht aber einen eigenen Graceful Shutdown, damit die Member die Leadership übergeben können. Wer das auslässt, macht aus routinemäßigem Patching einen Ausfall.

Prüfen Sie die Patch-Version, bevor Sie umbauen. Im selben Projekt haben wir Fehler bei der Knotenerkennung auf einen Defekt im Release 4.2.3 eingegrenzt, der in späteren 4.2.x-Builds und der 4.3-Serie behoben ist. Membership-Fehler, die einen sauberen Neustart und eine korrekte Konfiguration überstehen, sollten Sie zuerst mit den Release Notes abgleichen. Unser RabbitMQ-Troubleshooting-Leitfaden beschreibt den weiteren Diagnoseweg.

Stellen Sie für Disaster Recovery (DR) sicher, dass der Standby-Cluster nur bei Ausfall des Primärclusters aktiv wird. Startet er parallel zu einem intakten Primärcluster, entsteht ein Split-Brain – die Wiederherstellung erfordert dann das manuelle Neuanlegen von Knoten und eine erneute Leader Election. Stellen Sie bei einem Wechsel von 3.x auf 4.x von Classic- auf Quorum-Queues um? Siehe RabbitMQ-Upgrade-Services.

AceMQ bietet RabbitMQ-Beratung für Enterprise-Deployments, einschließlich Migrationsplanung, Cluster-Assessments und 24/7 Incident Response.

Wie sich diese Migration in einen größeren Umzug einfügt – von einem anderen Broker oder auf eine neue Major-Version im selben Zeitfenster –, erläutert der Leitfaden zur RabbitMQ-Migration.

Quorum-Queue-Membership verwalten: grow, shrink und Rebalance

Die Membership wird nur automatisch verwaltet, wenn Sie das aktivieren. Zuständig ist das CLI rabbitmq-queues:

# 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.*"

Nach dem Hinzufügen eines Knotens folgt üblicherweise grow auf den neuen Knoten und danach rebalance, damit nicht alle Leader auf den ursprünglichen drei bleiben. Bevor Sie einen Knoten außer Betrieb nehmen, führen Sie shrink für ihn aus, damit keine Queue einen Member verliert, den sie für ihre Mehrheit braucht.

Continuous Membership Reconciliation automatisiert den grow-Schritt. Mit quorum_queue.continuous_membership_reconciliation.enabled = true und einer target_group_size erweitert RabbitMQ Queues unterhalb der Zielgröße auf Knoten, die sie noch nicht hosten. Der Abgleich läuft standardmäßig alle 60 Minuten sowie nach Ereignissen wie dem Beitritt eines Knotens. Standardmäßig ist er deaktiviert. auto_remove, das Member auf Knoten entfernt, die den Cluster verlassen haben, ist eine separate Einstellung und ebenfalls standardmäßig deaktiviert.

FAQ

Welche Queue-Typen gibt es in RabbitMQ?

Drei: Classic Queues (eine Kopie, keine Replikation), Quorum Queues (per Raft repliziert, Commit per Mehrheit) und Streams (replizierter Append-only-Log mit Retention). Gespiegelte Classic Queues (Classic Mirrored Queues) waren ein vierter Typ und wurden in 4.0 entfernt.

Was ist eine Quorum Queue?

Ein replizierter Queue-Typ von RabbitMQ auf Basis des Raft-Konsensalgorithmus. Er hält einen Leader und mehrere Follower über die Cluster-Knoten verteilt und committet Schreibvorgänge, sobald eine Mehrheit sie angenommen hat. So übersteht er den Node-Ausfall einer Minderheit ohne Nachrichtenverlust.

Was ist das Delivery Limit bei Quorum Queues?

Ab RabbitMQ 4.0 liegt es standardmäßig bei 20. Nach zwanzig Zustellversuchen wird die Nachricht verworfen oder in eine Dead-Letter-Queue verschoben. Frühere Versionen hatten kein Limit. Mit x-delivery-limit ändern Sie den Wert, mit -1 deaktivieren Sie das Limit – nicht empfehlenswert.

Wann sollte man Classic Queues statt Quorum Queues verwenden?

Nur für transiente Workloads: Exclusive Queues, vom Server benannte temporäre Queues und RPC-Reply-Queues. Alles Dauerhafte gehört in Quorum Queues.

Was ist der Unterschied zwischen Kafka und RabbitMQ Quorum Queues?

Quorum Queues sind eine replizierte Message Queue – Nachrichten werden konsumiert und anschließend entfernt. Kafka ist ein verteiltes Log, in dem Consumer ihre Offsets in den vorgehaltenen Daten verfolgen und Nachrichten per Replay erneut abspielen können. Für Log-Semantik innerhalb des Brokers sind Streams das nähere Pendant.

Welche Einschränkungen haben Quorum Queues?

Keine nicht dauerhaften (non-durable) Queues, keine Exclusive Queues, keine vom Server benannten Queues, kein globaler QoS-Prefetch und keine Consumer-Exklusivität. Außerdem schreiben sie immer auf die Festplatte und belegen daher mehr Speicherplatz als eine vergleichbare Classic Queue.

Wie deklariere ich eine Quorum Queue?

Setzen Sie bei der Deklaration das Queue-Argument x-queue-type auf quorum. Per Policy lässt sich der Typ nachträglich weder setzen noch ändern.

Kann ich eine bestehende Classic Queue in eine Quorum Queue umwandeln?

Nein. Der Queue-Typ ist nach der Deklaration unveränderlich. Sie müssen eine neue Queue anlegen, die alte leeren, dann die Publisher umstellen und die ursprüngliche Queue löschen.

Scott Sternloff

Autor

Scott SternloffSenior Enterprise Architect

Senior Enterprise Architect bei AceMQ. Verantwortet hier die technischen Beiträge: Architektur, Clustering und Migrationen von RabbitMQ, Kafka und Redis.

Leitfäden, Vergleiche und Studien

Mehr zum Thema RabbitMQ

Kostenlose Beratung

Lassen Sie Experten auf Ihre RabbitMQ-Cluster-Umgebung schauen

Ob Sie einen Produktionsvorfall beheben, eine Migration planen oder eine zweite Meinung zu Ihrer Architektur wünschen – unser Team steht bereit. Kein Verkaufsgespräch, nur Antworten.

E-Mail schreiben