consumer_timeout ist der Timeout von RabbitMQ für die Bestätigung von Zustellungen. Hält ein Consumer eine Zustellung länger als diesen Timeout, ohne sie zu bestätigen, schließt RabbitMQ den Channel dieses Consumers mit einer Channel-Exception PRECONDITION_FAILED, und die unbestätigten Nachrichten kehren zur erneuten Zustellung in die Queue zurück. Der Standardwert beträgt 30 Minuten. Ab RabbitMQ 4.3 gilt er nur noch für Quorum Queues.
Er betrifft ausschließlich Consumer im manuellen Acknowledgement-Modus – die übliche Einstellung in AMQP-0-9-1-Clients, wenn keine Nachricht verloren gehen darf: Der Broker übergibt eine Zustellung und wartet darauf, dass der Consumer die fertig verarbeiteten Nachrichten bestätigt. Der Timeout soll Consumer erwischen, die eine Nachricht angenommen haben und dann hängen geblieben sind, damit die Arbeit wieder in die Queue gestellt statt ewig festgehalten wird. Er trifft aber auch gesunde Consumer, deren Jobs schlicht länger als 30 Minuten dauern – und genau dort beginnt meist die Verwirrung: Die Anwendung läuft, die Verbindung ist offen, und die Consumer-Zahl in der Management UI ist stillschweigend auf null gefallen.
So sieht der Consumer-Timeout-Fehler aus
Der Broker protokolliert das Schließen des Channels mit Consumer Tag, Channel, Queue und Delivery Tag. In der RabbitMQ-Dokumentation sieht die Meldung so aus:
Consumer 'consumer-tag-998754663370' on channel 1 and queue 'qq.1' in vhost '/' has timed out
waiting for a consumer acknowledgement of a delivery with delivery tag = 10. Timeout used: 180000 ms.
Auf Client-Seite kommt sie als Channel-Exception mit PRECONDITION_FAILED an. Weil sie den Channel und nicht die Verbindung schließt, bleibt die Client-Bibliothek oft verbunden und protokolliert nichts Auffälliges, sofern das Herunterfahren des Channels nicht behandelt wird. Die Queue zeigt ihre Nachrichten nun wieder als bereit an, sie werden mit gesetztem Redelivered-Flag erneut zugestellt, und der langsame Job läuft womöglich zweimal.
Drei Gründe, warum ein RabbitMQ-Consumer aufhört zu konsumieren
Der Timeout ist einer von drei Wegen, auf denen ein Consumer aufhört zu konsumieren, ohne dass die Anwendung das veranlasst hat. In der Management UI sehen alle drei gleich aus, sie erfordern aber unterschiedliche Lösungen:
Der Acknowledgement-Timeout hat den Channel geschlossen. Die oben gezeigte Logzeile erscheint, die Verbindung bleibt bestehen, und der Consumer ist weg. Die Verarbeitung hat zu lange gedauert, oder der Consumer hing.
Der Broker hat den Consumer abgebrochen. Wird eine Queue gelöscht oder fällt der Knoten aus, auf dem sie liegt, sendet RabbitMQ dem Client ein asynchrones basic.cancel. Clients melden dafür die Capability consumer_cancel_notify an – die offiziellen RabbitMQ-Clients tun das standardmäßig –, und die Client-Bibliothek reicht das Ereignis über einen Callback weiter, etwa handleCancel im Java-Client. Ignoriert die Anwendung diesen Callback, bleibt ein Channel ohne Consumer übrig.
Die Verbindung ist abgerissen. Ein Load Balancer, eine Firewall oder ein NAT-Gateway hat eine inaktive TCP-Verbindung getrennt, oder der Client-Prozess ist eingefroren. Heartbeats erkennen das: Der empfohlene Standardwert liegt bei 60 Sekunden, und nach zwei ausgebliebenen Heartbeats gilt die Gegenstelle als nicht erreichbar. Alternativ können TCP-Keepalives dieselbe Aufgabe auf Betriebssystemebene übernehmen.
Prüfen Sie in dieser Reihenfolge: zuerst das Broker-Log, dann die Channel- und Cancel-Callbacks des Clients, dann das Netzwerk. Das Broker-Log verrät Ihnen innerhalb weniger Sekunden, welcher der drei Fälle vorliegt.
consumer_timeout konfigurieren: global, pro Queue oder deaktiviert
Global setzen Sie den Timeout in der RabbitMQ-Konfigurationsdatei rabbitmq.conf, in Millisekunden:
# one hour
consumer_timeout = 3600000
Pro Queue geht das ab RabbitMQ 3.12 mit einer Policy oder einem Queue-Argument. Die Policy ist das bessere Werkzeug, weil sie sich ändern lässt, ohne die Anwendung neu auszurollen:
Das Queue-Argument heißt x-consumer-timeout, wird bei der Deklaration gesetzt und ebenfalls in Millisekunden angegeben.
RabbitMQ wertet den Timeout einmal pro Minute aus. Werte unter einer Minute werden daher nicht unterstützt, Werte unter fünf Minuten nicht empfohlen. Deaktivieren lässt er sich in advanced.config, indem Sie consumer_timeout auf undefined setzen. Die Dokumentation empfiehlt jedoch statt des Abschaltens einen hohen Wert von einigen Stunden.
Die Änderung in RabbitMQ 4.3: nur noch Quorum Queues
Ab RabbitMQ 4.3 werden Timeouts für die Bestätigung von Zustellungen nur noch von Quorum Queues unterstützt. Daraus folgen zwei Konsequenzen:
Consumer von Classic Queues verlieren den Schutz. Ein Consumer, der eine Nachricht aus einer Classic Queue annimmt und hängen bleibt, hält sie fest, bis Channel oder Verbindung geschlossen werden. Wenn Sie sich darauf verlassen haben, dass der Timeout hängende Consumer von Classic Queues befreit, brauchen Sie stattdessen clientseitige Timeouts oder Monitoring.
Der Wechsel zu Quorum Queues kann ihn einschalten. Ein Workload, der mit stundenlangen Jobs problemlos auf Classic Queues lief, sieht nach der Migration auf Quorum Queues womöglich plötzlich Channel-Schließungen mit PRECONDITION_FAILED. Setzen Sie für diese Queues einen consumer-timeout pro Queue als Teil der Migration – nicht erst nach dem ersten Incident.
Hängende Consumer erkennen, bevor der Timeout greift
Ein Consumer kurz vor dem Timeout wirkt von außen gesund: verbunden, subscribed, mit Nachrichten in Verarbeitung. Drei Prüfungen zeigen das Problem frühzeitig.
Unbestätigte Nachrichten, die sich nicht mehr bewegen. Vergleichen Sie pro Queue die bereiten und die unbestätigten Nachrichten sowie die Zahl der Consumer:
rabbitmqctl list_queues -p / name messages_ready messages_unacknowledged consumers consumer_utilisation
Bleibt messages_unacknowledged einer Queue konstant, während messages_ready wächst, halten Consumer Zustellungen fest, die sie nicht abschließen. Eine consumer_utilisation deutlich unter 1,0 bei einer Queue mit Rückstau sagt dasselbe aus anderer Richtung: Die Queue hat Nachrichten, kann sie aber nicht zustellen, weil die Consumer an ihrem Prefetch-Limit stehen.
Welche Consumer sie festhalten.rabbitmqctl list_consumers listet jede Subscription mit Channel, Consumer Tag, der Angabe, ob Acknowledgements erwartet werden, und ihrem Prefetch-Limit auf. Ein Consumer mit hohem Prefetch auf einer langsamen Queue ist der erste Verdächtige.
Die Zahl der Consumer im Zeitverlauf. Alarmieren Sie in Prometheus – mit aktivierten Metriken pro Objekt, damit die Werte pro Queue statt aggregiert gemeldet werden –, wenn rabbitmq_queue_consumers bei Queues, die immer konsumiert werden sollten, auf null fällt, und wenn rabbitmq_queue_messages_unacked steigt, ohne dass die Raten für zugestellte und bestätigte Nachrichten entsprechend mitsteigen. Diese beiden Alarme erfassen den Timeout, einen vom Broker ausgelösten Cancel und eine abgerissene Verbindung – je nachdem, was zuerst eintritt.
So verhindern Sie Consumer-Timeouts
Den Timeout zu erhöhen ist nur dann die richtige Lösung, wenn die Arbeit tatsächlich so lange dauert. Der Rest ist Client-Verhalten:
Timeout pro Queue dimensionieren. Setzen Sie consumer-timeout auf den Queues, die lange Jobs transportieren, mit etwas Spielraum über der längsten legitimen Verarbeitungszeit, und lassen Sie den globalen Standardwert unverändert.
Prefetch bei langsamer Verarbeitung niedrig halten. Jede vorab abgerufene Nachricht ist bereits eine Zustellung, für die der Timeout läuft. Bei einem Prefetch von 50 und Jobs von je einer Minute wird die 31. Zustellung schon über 30 Minuten festgehalten, bevor der Consumer überhaupt damit beginnt – und beim Standard-Timeout wird der Channel geschlossen. Siehe RabbitMQ prefetch count.
Auf dem Channel bestätigen, über den die Zustellung kam, und zwar in jedem Codepfad, auch im Fehlerpfad. Ein fehlendes Ack in einem Fehlerzweig ist die häufigste Ursache für einen Consumer, der Zustellungen festhält, bis der Timeout greift.
Channel-Shutdown und Cancel-Benachrichtigungen behandeln. Öffnen Sie bei einer Channel-Schließung oder einem basic.cancel einen neuen Channel und subscriben Sie erneut. Die automatische Connection Recovery der Client-Bibliotheken stellt abgerissene Verbindungen wieder her, deckt aber nicht immer einen einzelnen geschlossenen Channel oder einen vom Broker ausgelösten Cancel ab.
Verarbeitung idempotent gestalten. Eine Zustellung mit Timeout wird wieder in die Queue gestellt und erneut zugestellt – ein Job, der zu 90 Prozent fertig war, läuft also noch einmal. Nachrichten, die nie rechtzeitig fertig werden können, gehören in eine Dead Letter Queue statt in eine Schleife erneuter Zustellungen; siehe RabbitMQ Dead Letter Queues.
Auf unbestätigte Nachrichten und die Consumer-Zahl pro Queue alarmieren, nicht nur auf die Queue-Tiefe. Eine Consumer-Zahl von null bei einer Queue, die immer Consumer haben sollte, ist das früheste Signal für alle drei Fehlerbilder.
Diese Muster begegnen uns regelmäßig in den RabbitMQ-Support-Tickets, die wir bearbeiten: Consumer werden als fehlend gemeldet, während die Anwendung gesund ist – nach einer Migration auf Quorum Queues oder einer Änderung der Speicherlimits. Wenn Sie einen zweiten Blick auf einen Cluster mit diesem Verhalten brauchen, deckt der RabbitMQ-Support von AceMQ das ab, und der Leitfaden zum RabbitMQ-Troubleshooting beschreibt den weiteren Diagnoseweg.
Der Timeout für die Bestätigung von Zustellungen (Delivery Acknowledgement Timeout). Hält ein Consumer eine Zustellung länger als diesen Timeout, ohne sie zu bestätigen, schließt RabbitMQ den Channel dieses Consumers mit einer Channel-Exception PRECONDITION_FAILED, und die unbestätigten Nachrichten gehen zurück in die Queue. Der Standardwert beträgt 30 Minuten.
Wie hoch ist der Standard-Consumer-Timeout in RabbitMQ?
30 Minuten (1.800.000 ms). RabbitMQ prüft einmal pro Minute, ob der Timeout greift. Werte unter einer Minute werden daher nicht unterstützt, Werte unter fünf Minuten nicht empfohlen.
Wie ändere ich den Consumer-Timeout für eine einzelne Queue?
Ab RabbitMQ 3.12 setzen Sie den Schlüssel consumer-timeout in einer Policy oder das Argument x-consumer-timeout bei der Deklaration der Queue. Beide erwarten Millisekunden. Ein Wert pro Queue ist sicherer, als den globalen consumer_timeout für alle Queues im Cluster anzuheben.
Gilt consumer_timeout in RabbitMQ 4.3 für Classic Queues?
Nein. Ab RabbitMQ 4.3 werden Timeouts für die Bestätigung von Zustellungen nur noch von Quorum Queues unterstützt. Ein Consumer einer Classic Queue, der eine Zustellung unbegrenzt festhält, wird unter 4.3 nicht mehr vom Broker geschlossen.
Kann ich den Consumer-Timeout von RabbitMQ deaktivieren?
Ja, indem Sie consumer_timeout in advanced.config auf undefined setzen – die RabbitMQ-Dokumentation rät jedoch davon ab. Ein hoher Wert, zum Beispiel einige Stunden, behält den Schutz bei, ohne lange Jobs abzubrechen.
Warum fällt die Zahl meiner RabbitMQ-Consumer auf null, obwohl die Anwendung läuft?
Meist aus einem von drei Gründen: Der Timeout für die Zustellbestätigung hat den Channel des Consumers geschlossen, der Broker hat den Consumer abgebrochen, weil seine Queue gelöscht wurde oder nicht mehr verfügbar war, oder die TCP-Verbindung ist abgerissen und wurde nach ausbleibenden Heartbeats getrennt. Clients, die den Channel nicht neu öffnen und sich nicht erneut subscriben, bleiben verbunden, konsumieren aber nichts.
Senior Enterprise Architect bei AceMQ. Verantwortet hier die technischen Beiträge: Architektur, Clustering und Migrationen von RabbitMQ, Kafka und Redis.
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.