AI for RabbitMQ
Design and debug RabbitMQ with AI — exchanges and routing, queue backpressure, dead-lettering, clustering and quorum queues, and consumer reliability.
46 copy-paste prompts · 108 in-depth guides Jump to prompts Jump to guides
Prompts
- Advanced
RabbitMQ Blue-Green Cluster Migration Plan Prompt
Plan a blue-green migration to a brand-new RabbitMQ cluster using Shovel to drain in-flight messages, cut clients over vhost-by-vhost, and keep a clean rollback path.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Classic Queue v2 (CQv2) Storage Migration Design Prompt
Plan a safe migration of classic queues to the CQv2 message store to cut memory use and improve consistency, validating version support, feature flags, and per-queue conversion.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Client Connection & Channel Pooling Design Prompt
Design correct client-side connection and channel pooling for RabbitMQ so an app reuses long-lived connections, isolates publishing from consuming, and never leaks channels under load.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Delayed Message Exchange Scheduling Design Prompt
Design scheduled/delayed delivery in RabbitMQ using the delayed-message-exchange plugin, comparing it to TTL+DLX, and sizing it so pending delays don't overwhelm the broker.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ KEDA Consumer Autoscaling Design Prompt
Design a KEDA-driven autoscaler that scales RabbitMQ consumer deployments on queue depth without thrashing, starving prefetch, or breaking message ordering.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Log Triage & Root-Cause Analysis Prompt
Turn raw RabbitMQ broker logs into a ranked incident timeline, correlating connection drops, alarms, partitions, and crashes into a single root cause with next actions.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Message Deduplication Design Prompt
Design end-to-end message deduplication for a RabbitMQ pipeline, deciding between broker-side dedup, publisher confirms, and idempotent consumers to achieve effective exactly-once processing.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ OAuth 2.0 / JWT Authentication Design Prompt
Design token-based authentication and authorization for RabbitMQ using the OAuth 2.0 plugin, mapping JWT scopes to vhost/resource permissions across AMQP and the management UI.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Plugin Inventory & Security Audit Prompt
Audit enabled RabbitMQ plugins for attack surface, unused listeners, and version risk, then produce a hardening plan that disables what isn't needed and locks down what remains.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Firehose Tracing Debug Plan Prompt
Use the firehose tracer and rabbitmq_tracing plugin to capture exactly what a broker did with a message — where it was published, how it routed, and why it was dropped or dead-lettered — without guessing from application logs.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ perf-test Benchmark & Capacity Plan Prompt
Design a rigorous rabbitmq-perf-test benchmark that measures publish/consume throughput, end-to-end latency, and confirm/ack overhead for a specific workload — so capacity numbers come from data, not guesses.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Web-STOMP WebSocket Messaging Design Prompt
Design a browser-to-broker messaging layer over RabbitMQ Web-STOMP so web clients get real-time updates safely — with per-user authorization, destination scoping, and back-pressure that a hostile browser can't abuse.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Feature Flags Upgrade Enablement Plan Prompt
Plan the safe enablement of RabbitMQ feature flags before and after a version upgrade, so all cluster nodes agree on the schema, required flags are on before you upgrade past their version, and no node is left on an incompatible state.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ on Kubernetes Cluster Operator Deployment Design Prompt
Design a production RabbitMQ deployment on Kubernetes using the RabbitMQ Cluster Operator, covering StatefulSet sizing, quorum queues, persistence, anti-affinity, and safe rolling upgrades.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Queue Max-Length & Overflow Behavior Design Prompt
Design bounded RabbitMQ queues with max-length / max-length-bytes limits and the right overflow behavior (drop-head, reject-publish, or reject-publish-dlx) so a slow consumer never exhausts broker memory or disk.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Alternate Exchange & Unroutable Message Design Prompt
Design handling for unroutable and rejected messages using alternate exchanges, mandatory-flag returns, and a catch-all topology so messages that match no binding are captured instead of silently dropped.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Backup & Disaster Recovery Design Prompt
Design a RabbitMQ backup and DR strategy covering definitions export, message durability assumptions, cross-region replication options, and a tested recovery runbook with realistic RPO/RTO.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Cluster Capacity & Sizing Review Prompt
Right-size a RabbitMQ cluster's node count, memory/disk headroom, file descriptors, and Erlang scheduler settings against measured publish/consume rates and queue depth before scaling or a traffic event.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Heartbeat & Connection Churn Triage Prompt
Diagnose missed-heartbeat disconnects, connection/channel churn, and 'connection_closed_abruptly' noise by correlating client timeouts, proxy idle limits, and broker heartbeat settings.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Poison Message & Redelivery Loop Triage Prompt
Diagnose endless requeue/redelivery loops caused by poison messages, nack-without-DLX, and missing delivery-limit handling so a single bad message stops poisoning a consumer group.
- Claude
- ChatGPT
Open prompt - Intermediate
RabbitMQ Prometheus Monitoring & Alerting Design Prompt
Design a RabbitMQ observability stack with the right Prometheus metrics, dashboards, and alert thresholds for queue depth, memory/disk alarms, flow control, and node health before incidents happen.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Queue Type Selection Decision Matrix Prompt
Choose between classic mirrored queues, quorum queues, and streams for a specific workload by weighing durability, ordering, throughput, memory model, and operational trade-offs.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Rolling Cluster Upgrade Plan Prompt
Plan a safe rolling upgrade of a RabbitMQ cluster across minor/major versions, sequencing node drains, feature-flag enablement, and queue-type compatibility while keeping clients connected.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ TLS, AuthN & AuthZ Hardening Prompt
Review and harden RabbitMQ transport TLS, listener exposure, user/vhost permissions, and authentication backends against a security baseline without breaking existing clients.
- Claude
- ChatGPT
Open prompt - Intermediate
RabbitMQ Vhost & Multi-Tenancy Permission Design Prompt
Design vhost isolation, per-tenant users, and least-privilege configure/write/read permissions plus resource limits so multiple teams or tenants share one cluster safely.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Consistent Hash Exchange Sharding Prompt
Use the consistent hash exchange to spread load across many queues while keeping all messages for a given key on the same queue, and weight bindings without reshuffling everything.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Definitions Export & Import GitOps Prompt
Treat RabbitMQ topology as code — export definitions, scrub secrets, version them, and import safely on boot so brokers are reproducible instead of hand-configured.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Lazy Queue Memory Strategy Prompt
Decide whether lazy queue behavior (disk-first message storage) fits a deep-backlog workload, and configure it without tanking throughput on hot paths.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Management API Automation Prompt
Build safe automation against the RabbitMQ HTTP management API — health checks, queue audits, and bulk operations — without hammering the broker or hard-coding fragile assumptions.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ MQTT Plugin IoT Broker Prompt
Configure the RabbitMQ MQTT plugin as an IoT-facing broker — topic-to-routing-key mapping, QoS handling, per-device auth, and connection limits — without breaking AMQP consumers.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Operator Policy Design Prompt
Design RabbitMQ policies and operator policies that enforce queue limits, TTLs, and queue types fleet-wide without colliding on priority or fighting application-declared arguments.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Priority Queue Design Prompt
Design a RabbitMQ priority queue that actually prioritizes — choosing the right number of priority levels, avoiding starvation, and understanding why prefetch can defeat the whole scheme.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Single Active Consumer Ordering Prompt
Use single active consumer (SAC) to preserve strict message ordering with hot-standby failover, and understand exactly what ordering guarantee you get versus what you don't.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Streams Design & Tuning Prompt
Decide when a RabbitMQ Stream (not a queue) is the right model, then size retention, segment, and consumer-offset settings for a high-throughput, replayable log.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Connection & Channel Leak Debugging Prompt
Track down why RabbitMQ connection or channel counts keep climbing until the broker hits limits, and find the client code that opens but never closes them.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Consumer Prefetch & QoS Tuning Prompt
Tune consumer prefetch (basic.qos) so work is spread evenly across consumers, throughput is high, and no single consumer hoards or starves while others sit idle.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Dead-Letter Exchange & Retry Design Prompt
Design a dead-letter exchange and retry topology so failed messages are retried with backoff and parked safely instead of being lost or stuck in a poison-message loop.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Exchange & Routing-Key Topology Design Prompt
Design a clean exchange, binding, and routing-key topology for a new or messy RabbitMQ messaging layer so producers and consumers stay decoupled and routing is predictable.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Memory & Disk Alarm Resource-Limit Triage Prompt
Triage a RabbitMQ memory or disk-free alarm that has blocked publishers cluster-wide, find what is consuming the resource, and recover safely without dropping messages.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
RabbitMQ Message TTL & Expiration Strategy Prompt
Decide where and how to apply message TTL, queue TTL, and max-length so stale messages expire safely instead of piling up or silently disappearing.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Publisher Confirms & Idempotent Consumers Prompt
Design an end-to-end no-message-loss path with publisher confirms, durable/persistent messages, and idempotent consumers so neither a broker restart nor a redelivery breaks correctness.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Queue Backpressure & Flow-Control Triage Prompt
Diagnose why a RabbitMQ queue is backing up and producers are being throttled, and decide whether the bottleneck is slow consumers, flow control, or a resource alarm.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Shovel & Federation Cross-Site Setup Prompt
Decide between shovel and federation and design a reliable cross-site or cross-cluster message-replication setup that survives WAN flakiness without duplicating or losing messages.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
RabbitMQ Mirrored-to-Quorum Queue Migration Design Prompt
Plan a migration of OpenStack's RabbitMQ from deprecated classic mirrored queues to quorum queues, keeping oslo.messaging RPC and notifications healthy throughout.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Cluster Partition Recovery Prompt
Recover an OpenStack RabbitMQ cluster after a network partition or node failure — heal split-brain, restore quorum, and resync OpenStack services whose RPC stalled while the broker was unhealthy.
- Claude
- ChatGPT
Open prompt - Advanced
RabbitMQ Queue Investigation Prompt
Investigate backed-up queues, dead-letter spillover, and consumer issues in RabbitMQ clusters.
- Claude
- ChatGPT
Open prompt
Guides
- · 9 min read
RabbitMQ Error Guide: 'RESOURCE_LOCKED - cannot obtain exclusive access' Locked Queue
Fix RabbitMQ RESOURCE_LOCKED errors: exclusive queue owned by another connection, reconnect races, and 'cannot obtain exclusive access to locked queue' fixes.
Read guide - · 9 min read
RabbitMQ Error Guide: 'operation queue.declare caused a channel exception' Declare Failures
Fix RabbitMQ queue.declare and queue.delete channel exceptions: x-queue-type mismatch, invalid arguments, passive declare on a missing queue, and delete-if-unused.
Read guide - · 9 min read
RabbitMQ Error Guide: 'unable to join cluster' Cookie and Version Mismatch
Fix RabbitMQ 'unable to join cluster' errors: Erlang cookie mismatch, cluster_name mismatch, RabbitMQ/Erlang version skew, and 'already a member' on join_cluster.
Read guide - · 9 min read
RabbitMQ Error: AMQP 1.0 connection failed / plugin not enabled
Fix RabbitMQ AMQP 1.0 connection failures: enable rabbitmq_amqp1_0, check the native AMQP 1.0 support, SASL auth, vhost mapping, and container/link attach errors.
Read guide - · 9 min read
RabbitMQ Error: Classic Mirrored Queue Synchronisation Stuck / Unsynchronised Mirrors
Fix a RabbitMQ classic mirrored queue stuck with unsynchronised mirrors: trigger and monitor sync, understand ha-sync-mode, and migrate to quorum queues to end the synchronisation problem for good.
Read guide - · 8 min read
RabbitMQ Error: 'classic_queue_mirroring is deprecated' HA Policy Rejected
Fix RabbitMQ's deprecated classic mirrored queue (ha-mode) policy warning and removal in 4.x: diagnose classic_queue_mirroring usage and migrate to quorum queues.
Read guide - · 9 min read
RabbitMQ Error: 'connection.blocked' — Publishers Blocked by a Resource Alarm
Fix RabbitMQ connection.blocked: publishers stall when a memory or disk resource alarm fires. Diagnose the alarm, free memory/disk, tune watermarks, and unblock producers.
Read guide - · 8 min read
RabbitMQ Error: Dead-Letter Exchange Not Found, Messages Not Dead-Lettering
Fix RabbitMQ messages not routing to a dead-letter exchange: diagnose a missing x-dead-letter-exchange, unrouted DLX messages, and no-route drops with rabbitmqctl.
Read guide - · 9 min read
RabbitMQ Error: 'failed to import definitions' From definitions.json on Boot
Fix RabbitMQ 'failed to import definitions' at startup: bad definitions.json path, invalid JSON, schema/validation errors, and missing vhosts or users blocking a clean boot.
Read guide - · 8 min read
RabbitMQ Error: Delayed Message Exchange Plugin Not Delaying Messages
Fix rabbitmq_delayed_message_exchange not delaying: enable the plugin, declare x-delayed-message with x-delayed-type, set the x-delay header, and avoid the disk-persistence gotchas.
Read guide - · 9 min read
RabbitMQ Error: Federation Link Down / Upstream Not Running
Fix a RabbitMQ federation link stuck 'down': diagnose missing upstreams, unmatched policies, bad upstream URIs and blocked ports so exchange and queue federation links reach the running state again.
Read guide - · 9 min read
RabbitMQ Error: 'khepri_db' Metadata Store Enable and Replication Failure
Fix RabbitMQ Khepri metadata store errors: timed-out leader election, feature flag stuck state_changing, and Ra replication failures when enabling khepri_db across a cluster.
Read guide - · 8 min read
RabbitMQ Error: Lazy Queue Mode Deprecated, High Disk I/O After Conversion
Fix RabbitMQ lazy queue mode issues: diagnose deprecated x-queue-mode lazy, classic queue v2 behaviour, and high disk I/O after conversion with rabbitmqctl and diagnostics.
Read guide - · 8 min read
RabbitMQ Error: x-max-length Reached, Messages Dropped or Dead-Lettered
Fix RabbitMQ dropping messages when x-max-length is reached: diagnose max-length overflow, drop-head vs reject-publish, and reason 'maxlen' dead-lettering with rabbitmqctl.
Read guide - · 8 min read
RabbitMQ Error: Messages Disappearing Due to Message TTL Expiry
Fix RabbitMQ messages vanishing from a queue: diagnose per-message and per-queue x-message-ttl expiry, expired messages dropped or dead-lettered, with rabbitmqctl.
Read guide - · 9 min read
RabbitMQ Error: MQTT plugin connection refused / not enabled
Fix RabbitMQ MQTT connection refused: enable rabbitmq_mqtt, open port 1883/8883, fix CONNACK auth (bad username or password), vhost mapping and anonymous logins.
Read guide - · 8 min read
RabbitMQ Error: Policy Not Applied to a Queue Because a Higher-Priority Policy Matches
Fix RabbitMQ policies that never apply to a queue: diagnose priority precedence, apply-to scope, and pattern overlap so the right effective_policy_definition lands via rabbitmqctl.
Read guide - · 9 min read
RabbitMQ Error: rabbitmq_prometheus /metrics Scrape Timeout Under Load
Fix RabbitMQ Prometheus scrape timeouts: the /metrics endpoint stalls under load with many queues. Use per-object vs aggregated metrics, raise scrape_timeout, and shard collection.
Read guide - · 8 min read
RabbitMQ Error: Quorum/Stream Queue Leaders Not Balancing Across Nodes
Fix RabbitMQ leaders piling on one node: set queue-leader-locator to balanced, rebalance quorum/stream leaders with rabbitmq-queues, and stop client-local leader placement.
Read guide - · 9 min read
RabbitMQ Error: 'reject-publish' queue overflow returning basic.nack to publishers
Fix RabbitMQ x-overflow reject-publish nacks: diagnose max-length/max-length-bytes limits, confirm publisher nacks, tune queue overflow, and stop dropped messages.
Read guide - · 9 min read
RabbitMQ Error: Shovel 'connection_refused' Cannot Reach Source or Destination
Fix a RabbitMQ shovel stuck with 'connection_refused': diagnose bad URIs, blocked ports, wrong credentials and TLS so a dynamic or static shovel reconnects to its source or destination broker.
Read guide - · 8 min read
RabbitMQ Error: Single Active Consumer Not Failing Over to the Next Consumer
Fix RabbitMQ single active consumer not switching: enable x-single-active-consumer at declare time, cancel/ack correctly, and confirm failover with rabbitmqctl list_consumers.
Read guide - · 9 min read
RabbitMQ Error: STOMP plugin CONNECT error / authentication failed
Fix RabbitMQ STOMP CONNECT errors: enable rabbitmq_stomp, open port 61613, resolve ERROR frames for bad login, vhost access, heartbeats and destination prefixes.
Read guide - · 9 min read
RabbitMQ Error: Stream Consumer 'offset out of range' / Invalid Offset Spec
Fix a RabbitMQ stream consumer failing with 'offset out of range' or an invalid offset spec: understand retention-trimmed offsets, first/last/next/timestamp specs and how to attach safely.
Read guide - · 9 min read
RabbitMQ Error: Stream Publisher Confirms Timing Out
Fix RabbitMQ stream publisher confirms that never arrive: diagnose resource alarms, slow disk on the osiris log, under-replicated stream members and client timeouts so confirms flow again.
Read guide - · 9 min read
RabbitMQ Error: Unacked Messages Stuck and Not Redelivered
Fix RabbitMQ messages stuck in unacked state and never redelivered: a consumer holding them without acking. Diagnose prefetch, missing acks, and force redelivery safely.
Read guide - · 9 min read
RabbitMQ Error: vm_memory_high_watermark alarm set, connections blocked
Fix RabbitMQ memory alarm blocking publishers: diagnose vm_memory_high_watermark, connection.blocked, memory_high_watermark_set, tune the watermark and drain queues.
Read guide - · 8 min read
RabbitMQ Error: 'WebSocket connection failed' with the Web-STOMP Plugin
Fix RabbitMQ Web-STOMP 'WebSocket connection to ws://.../ws failed' errors: diagnose the disabled plugin, wrong port, reverse-proxy Upgrade headers, TLS, and STOMP login failures.
Read guide - · 8 min read
RabbitMQ Error Guide: 'access to vhost refused for user' — Fix vhost Permissions
Fix 'access to vhost refused for user' in RabbitMQ: grant vhost access, set configure/write/read permissions, and fix the connection vhost.
Read guide - · 8 min read
RabbitMQ Error Guide: 'No compatible authentication mechanism' — Fix SASL Mechanism Mismatch
Fix 'no compatible authentication mechanism' in RabbitMQ: align client and server SASL mechanisms, enable PLAIN or EXTERNAL, and fix TLS client-cert auth.
Read guide - · 9 min read
RabbitMQ Error Guide: 'BOOT FAILED' — Fix a Broker That Won't Start
Fix 'BOOT FAILED' in RabbitMQ: read the failed boot step, recover a corrupt schema or config, fix permissions, and get the broker to start cleanly.
Read guide - · 8 min read
RabbitMQ Error Guide: 'Error preparing configuration' — Fix rabbitmq.conf Syntax
Fix 'error preparing configuration' in RabbitMQ: correct rabbitmq.conf syntax, resolve Cuttlefish schema errors, and fix advanced.config Erlang terms.
Read guide - · 8 min read
RabbitMQ Error Guide: 'feature flag is disabled' — Fix Blocked Declarations & Upgrades
Fix 'feature flag is disabled' in RabbitMQ: enable required feature flags, finish a cluster-wide upgrade first, and unblock quorum and stream declarations.
Read guide - · 8 min read
RabbitMQ Error Guide: 'message size exceeds max_message_size' — Fix Oversized Messages
Fix 'message size larger than configured max' in RabbitMQ: raise max_message_size safely, shrink payloads, and use a claim-check for large blobs.
Read guide - · 8 min read
RabbitMQ Error Guide: 'plugins_not_found' — Fix Plugin Enable Failures
Fix 'plugins_not_found' in RabbitMQ: correct the plugin name, match its version to the broker, fix the plugins directory, and re-enable cleanly.
Read guide - · 9 min read
RabbitMQ Error Guide: 'STREAM_NOT_AVAILABLE' — Fix Stream Leader Unavailability
Fix 'STREAM_NOT_AVAILABLE' in RabbitMQ Streams: restore a stream leader, recover replica quorum, enable the stream plugin and port, and reconnect clients.
Read guide - · 8 min read
RabbitMQ Error Guide: 'UNEXPECTED_FRAME' — Fix AMQP Protocol Violations
Fix 'UNEXPECTED_FRAME' in RabbitMQ: stop sharing a channel across threads, keep frames in order, and upgrade buggy clients that violate AMQP framing.
Read guide - · 9 min read
RabbitMQ Error Guide: 'CONNECTION_FORCED' — Why the Broker Closed Your Connection
Fix RabbitMQ CONNECTION_FORCED errors: tell node shutdown from a manually closed connection or an idle-connection reaper, and rebuild client auto-recovery so it reconnects.
Read guide - · 9 min read
RabbitMQ Error Guide: 'frame_too_large' — Raise frame_max or Shrink the Message
Fix RabbitMQ frame_too_large errors: diagnose oversized messages and headers against the negotiated frame_max, align client and broker frame limits, and split big payloads.
Read guide - · 9 min read
RabbitMQ Error Guide: 'handshake_timeout' — Fix Slow or Non-AMQP Connections
Fix RabbitMQ handshake_timeout errors: diagnose TCP health-check probes, wrong-protocol clients, slow TLS negotiation, and load-balancer prunes that never finish the AMQP handshake.
Read guide - · 8 min read
RabbitMQ Error Guide: 'closing AMQP connection ... {bad_header,...}' — Fix Protocol Mismatch
Fix RabbitMQ 'bad_header' handshake errors: stop clients speaking HTTP, TLS, or the wrong AMQP version to port 5672, point them at the right listener and TLS port, and clear the noise.
Read guide - · 8 min read
RabbitMQ Error Guide: 'Failed to start Ranch listener ... eaddrinuse' — Fix Port Already in Use
Fix RabbitMQ 'eaddrinuse' at startup: find what already holds port 5672, 15672, 25672, or 4369, resolve stale beam.smp/epmd processes and port conflicts, and start the broker cleanly.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Authentication failed (rejected by the remote node), please check the Erlang cookie' — Fix Cookie Mismatch
Fix the RabbitMQ Erlang cookie mismatch that blocks rabbitmqctl and cluster joins: locate the .erlang.cookie file, align its value and permissions across nodes, and restart cleanly.
Read guide - · 9 min read
RabbitMQ Error Guide: 'NOT_FOUND - no exchange' basic.publish Failures
Fix RabbitMQ publish failures: 404 NOT_FOUND on basic.publish, returned messages, channel closed on publish, and missing publisher confirms explained.
Read guide - · 9 min read
RabbitMQ Error Guide: '{socket_error, epipe}' Broken Pipe on Write
Fix RabbitMQ epipe / broken pipe errors: trace writes to a closed socket from slow consumers, vanished clients, and network drops, and stop one-sided connection loss.
Read guide - · 9 min read
RabbitMQ Error Guide: 'CHANNEL_ERROR - expected channel.open' Closed Channel Exception
Fix RabbitMQ CHANNEL_ERROR and 'channel closed' exceptions: using a closed channel, unexpected frames, protocol violations, and frame-ordering bugs.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Node rabbit@host is down' Cluster Member Unreachable
Fix RabbitMQ 'Node rabbit@host is down' and 'not responding' errors: a crashed beam, stopped service, or blocked distribution ports. Diagnose and recover safely.
Read guide - · 9 min read
RabbitMQ Error Guide: '{socket_error, econnreset}' Connection Reset by Peer
Fix RabbitMQ econnreset / connection reset by peer: trace LB and proxy idle timeouts, client crashes, and firewall resets that drop AMQP connections mid-stream.
Read guide - · 9 min read
RabbitMQ Error Guide: 'consumer cancelled' basic.cancel Notification
Fix RabbitMQ consumer cancel notifications: diagnose why basic.cancel is pushed to clients when a queue is deleted, its node fails, or it is recovered.
Read guide - · 9 min read
RabbitMQ Error Guide: 'consumer_timeout' Delivery Acknowledgement Timed Out
Fix RabbitMQ consumer_timeout: diagnose 'delivery acknowledgement timed out' channel closures from long processing or unacked messages and tune the limit.
Read guide - · 9 min read
RabbitMQ Error Guide: 'CRASH REPORT ... gen_server terminated' Reading Erlang Crashes
Read RabbitMQ Erlang crash reports: decode gen_server terminated and supervisor reports with noproc, badmatch, function_clause, case_clause, and badarg reasons.
Read guide - · 9 min read
RabbitMQ Error Guide: 'PRECONDITION_FAILED - inequivalent arg for exchange' Declaration Conflict
Fix RabbitMQ PRECONDITION_FAILED inequivalent arg errors on exchange declare or delete: mismatched type, durable, auto-delete, and internal flags.
Read guide - · 9 min read
RabbitMQ Error Guide: 'federation link ... unavailable' Upstream Connection Failure
Fix RabbitMQ federation upstream unavailable errors: broken upstream connections, bad credentials or URIs, network blocks, and misconfigured upstream-sets and policies.
Read guide - · 9 min read
RabbitMQ Error Guide: 'flow' Connection State Internal Flow Control
Fix RabbitMQ publishers stuck in 'flow' state: diagnose internal credit-based flow control from slow queues, disk, or CPU, distinct from resource alarms.
Read guide - · 9 min read
RabbitMQ Error Guide: 'inconsistent_cluster' Node Disagrees on Membership
Fix RabbitMQ inconsistent_cluster errors where a node thinks it's clustered with a peer that disagrees. Caused by stale state after a reset or forget. Recover safely.
Read guide - · 9 min read
RabbitMQ Error Guide: 'HTTP access denied' Management UI and API 401/403
Fix RabbitMQ HTTP access denied errors in the management UI and API: missing management tags, wrong credentials, and missing vhost permissions causing 401/403.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Failed to start Ranch listener' Management Plugin on 15672
Fix RabbitMQ management listener startup failures on port 15672: eaddrinuse port conflicts, the plugin not enabled, and bad listener config blocking the UI.
Read guide - · 9 min read
RabbitMQ Error Guide: 'statistics database could not be contacted' Metrics Failure
Fix RabbitMQ statistics database unavailable and metrics timeout errors: overloaded stats collector, rates mode, and large topologies stalling the management UI.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Error on AMQP connection' Reading the Connection Lifecycle Logs
Decode RabbitMQ accepting/closing/Error on AMQP connection logs: find the real close reason behind handshake_error, missed heartbeats, and abrupt client disconnects.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Error: operation ... timed out' rabbitmqctl RPC Timeout
Fix RabbitMQ operation timed out errors from rabbitmqctl and cluster ops: overloaded nodes, slow internal RPC, long-running queries, and the --timeout flag.
Read guide - · 9 min read
RabbitMQ Error Guide: 'basic.nack' Publisher Confirm Negative Acknowledgement
Fix RabbitMQ publisher nacks: diagnose basic.nack received under publisher confirms from failed persistence, leader failover, or resource alarms.
Read guide - · 9 min read
RabbitMQ Error Guide: 'home node ... is down' Classic Queue Unavailable
Fix RabbitMQ 'home node is down' errors: classic queue unavailable because its home/leader node is offline, queue shown as down in management, and HA fixes.
Read guide - · 9 min read
RabbitMQ Error Guide: '{error, queue_process_is_stopped}' Queue Process Down
Fix RabbitMQ queue_process_is_stopped errors: classic, mirrored, or quorum queue process down on a failed node, failed delete_queue, and stuck operations.
Read guide - · 9 min read
RabbitMQ Error Guide: 'cannot reach majority' Quorum Queue Lost Quorum
Fix RabbitMQ quorum queues that lost majority: diagnose 'cannot reach majority', under-replicated members, and recover queues after losing over half the nodes.
Read guide - · 9 min read
RabbitMQ Error Guide: 'ra: command timeout' Quorum Queue Raft Timeout
Fix RabbitMQ quorum queue Raft timeouts: diagnose 'ra command timeout' and 'failed to start Raft' from slow disk, overloaded nodes, and network latency.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Shovel ... terminated' Worker Failure and Lost Upstream
Fix RabbitMQ shovel worker terminated and failed-to-start errors: bad source/destination URIs, wrong credentials, missing queues, and dynamic vs static shovel config.
Read guide - · 9 min read
RabbitMQ Error Guide: 'certificate verify failed' TLS Trust and mTLS Verification Errors
Fix RabbitMQ certificate verify failed errors: resolve unknown CA, expired certs, hostname mismatches, and fail_if_no_peer_cert mTLS failures by fixing the trust chain.
Read guide - · 9 min read
RabbitMQ Error Guide: 'TLS handshake failed' Protocol and Cipher Negotiation Errors
Fix RabbitMQ TLS handshake failures: resolve protocol-version mismatches, cipher and SNI negotiation errors, and plaintext clients hitting the AMQPS 5671 listener.
Read guide - · 9 min read
RabbitMQ Error Guide: 'PRECONDITION_FAILED - unknown delivery tag' Ack Failure
Fix RabbitMQ 'unknown delivery tag' errors: acking on the wrong channel, double-ack, acking after auto-ack, and stale delivery tags after reconnect.
Read guide - · 9 min read
RabbitMQ Error Guide: 'unknown exchange type x-delayed-message' Missing Plugin
Fix RabbitMQ unknown exchange type errors for x-delayed-message and x-consistent-hash: the exchange-type plugin is missing or disabled. Enable and verify it.
Read guide - · 9 min read
RabbitMQ Error Guide: 'ACCESS_REFUSED - access to queue refused for user' Authorization Failure
Fix RabbitMQ ACCESS_REFUSED authorization errors: set correct configure/write/read permission regexes per vhost so users can declare, publish to, and consume resources.
Read guide - · 9 min read
RabbitMQ Error Guide: 'ACCESS_REFUSED - vhost not found' No Access to Virtual Host
Fix RabbitMQ vhost not found / no access to vhost errors: create the missing virtual host, grant per-vhost permissions, and correct URL-encoded vhost paths in clients.
Read guide - · 9 min read
RabbitMQ Error Guide: 'connection_closed_abruptly' Unexpected Client Disconnect
Fix RabbitMQ connection_closed_abruptly: crashed clients, OOM kills, missing graceful shutdown, network resets, and container restarts diagnosed and resolved.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Discarding message in an old incarnation' Stale Node Reference
Fix 'Discarding message in an old incarnation' in RabbitMQ: node restarts, partition recovery, stale process references, and mirrored queue leftovers.
Read guide - · 9 min read
RabbitMQ Error Guide: 'epmd error for host ... nxdomain' Node Resolution Failure
Fix the epmd error for host nxdomain/address: DNS and /etc/hosts, epmd on port 4369, short vs long node names, and firewall rules.
Read guide - · 9 min read
RabbitMQ Error Guide: 'file descriptor limit alarm set' FD Exhaustion
Fix the file descriptor limit alarm: raise ulimit and systemd LimitNOFILE, find connection and socket leaks, and clear the high watermark block.
Read guide - · 9 min read
RabbitMQ Error Guide: '{inet_error,etimedout}' Stale Half-Open Connection
Fix RabbitMQ inet_error etimedout half-open connections: vanished clients, disabled heartbeats, TCP keepalive tuning, and NAT idle-timeout drops.
Read guide - · 9 min read
RabbitMQ Error Guide: 'Mnesia is overloaded' Metadata Churn Warning
Fix RabbitMQ 'Mnesia is overloaded' dump_log write_threshold warnings caused by queue churn, exclusive/auto-delete storms, binding churn and slow disk.
Read guide - · 9 min read
RabbitMQ Error Guide: 'PLAIN login refused: user does not exist' Authentication Failure
Fix RabbitMQ 'PLAIN login refused: user does not exist': missing users, vhost confusion, guest restrictions, auth backends, and rotated secrets.
Read guide - · 9 min read
RabbitMQ Error Guide: 'quorum queue ... no leader elected' Raft Quorum Loss
Fix RabbitMQ quorum queues with no leader: down replicas, lost majority, partitioned Ra members, and stalled Raft leader elections.
Read guide - · 9 min read
RabbitMQ Error Guide: 'timeout_waiting_for_tables' Cluster Startup Failure
Fix RabbitMQ timeout_waiting_for_tables on startup: node boot order, last-disc-node down, Mnesia table sync, and forget_cluster_node recovery.
Read guide - · 10 min read
Automating RabbitMQ With the Management API and AI
The RabbitMQ HTTP management API is the easiest way to automate ops and the easiest way to overload your broker. Here's how to use AI to script it without self-inflicting load.
Read guide - · 11 min read
Blue-Green RabbitMQ Upgrades With AI
In-place RabbitMQ major upgrades are risky and hard to roll back. Here's how to use AI to plan a blue-green upgrade that moves traffic with a real escape hatch.
Read guide - · 10 min read
Sharding RabbitMQ With the Consistent Hash Exchange and AI
The consistent hash exchange spreads load while keeping per-key affinity, but its binding keys are weights, not patterns. Here's how to use AI to shard cleanly.
Read guide - · 9 min read
RabbitMQ Error Guide: 'ACCESS_REFUSED' Login Was Refused (403)
Fix RabbitMQ ACCESS_REFUSED login refused errors: diagnose bad credentials, missing vhost permissions, loopback-only guest, and disabled or tagless users.
Read guide - · 9 min read
RabbitMQ Error Guide: 'CHANNEL_ERROR' Too Many Channels and Flow Control
Fix RabbitMQ CHANNEL_ERROR and channel-max errors: diagnose channel leaks, expected channel.open, the channel_max limit, and connection.blocked flow control.
Read guide - · 9 min read
RabbitMQ Error Guide: 'ECONNREFUSED' Connection Refused on 5672
Fix RabbitMQ ECONNREFUSED on port 5672: diagnose a stopped broker, wrong host/port, TLS-only listeners, firewall blocks, and bound interface mismatches.
Read guide - · 9 min read
RabbitMQ Error Guide: 'missed heartbeats' Heartbeat Timeout from Client
Fix RabbitMQ missed heartbeats and heartbeat timeout errors: diagnose blocked event loops, firewall idle timeouts, low heartbeat values, and overloaded consumers.
Read guide - · 10 min read
RabbitMQ Error Guide: 'Mnesia network partition' Cluster Split Brain
Fix RabbitMQ Mnesia network partitions (split brain): detect partitioned nodes, choose a partition handling strategy, and safely recover a clustered broker.
Read guide - · 8 min read
RabbitMQ Error Guide: 'NO_ROUTE' Mandatory Message Returned Unroutable
Fix RabbitMQ NO_ROUTE returned messages: diagnose missing bindings, wrong routing keys, default vs named exchange confusion, and exchange type mismatches.
Read guide - · 8 min read
RabbitMQ Error Guide: 'NOT_FOUND' No Queue or Exchange (404)
Fix RabbitMQ NOT_FOUND channel errors: diagnose missing queues and exchanges, wrong vhost, auto-deleted queues, typos, and declaration order race conditions.
Read guide - · 9 min read
RabbitMQ Error Guide: 'PRECONDITION_FAILED' Inequivalent Arg for Queue
Fix RabbitMQ PRECONDITION_FAILED inequivalent arg errors: reconcile durable, auto-delete, x-message-ttl, x-queue-type, and DLX mismatches on redeclared queues.
Read guide - · 10 min read
RabbitMQ Error Guide: 'resource alarm' Memory/Disk Free Limit Reached
Fix RabbitMQ resource alarms blocking publishers: diagnose memory high-watermark and disk free limit, find the queue consuming RAM, and clear the alarm safely.
Read guide - · 10 min read
Governing RabbitMQ With Policies and Operator Policies Using AI
RabbitMQ policies don't merge — only one applies per queue. Here's how to use AI to design policy and operator-policy guardrails without silently disabling each other.
Read guide - · 9 min read
RabbitMQ Priority Queues That Actually Prioritize With AI
A RabbitMQ priority queue is easy to declare and easy to render useless. Here's how to use AI to design one that works, including the prefetch trap that silently breaks it.
Read guide - · 10 min read
RabbitMQ Single Active Consumer for Ordered Processing With AI
Single active consumer gives ordered delivery with failover, but not the guarantee most people think. Here's how to use AI to apply SAC and understand its real limits.
Read guide - · 11 min read
RabbitMQ Streams as a Replayable Log With AI
RabbitMQ Streams look like queues but behave like an append-only log. Here's how to use AI to decide when to reach for them and size retention without filling disk.
Read guide - · 11 min read
Securing RabbitMQ With TLS and x509 Authentication Using AI
TLS on RabbitMQ is easy to half-configure and hard to verify. Here's how to use AI to set up x509 client-cert auth, then prove the broker actually rejects bad clients.
Read guide - · 10 min read
Debugging RabbitMQ Message Flow With Tracing and Firehose Using AI
When messages vanish between publish and consume, RabbitMQ's tracing and firehose show you where. Here's how to use AI to read the trace without overloading the broker.
Read guide - · 10 min read
Debugging RabbitMQ Connection and Channel Leaks With AI
A connection or channel leak creeps up slowly until the broker hits its limit. Here's how to use AI to find the leaking service fast and confirm the fix.
Read guide - · 11 min read
Designing RabbitMQ Exchanges and Routing Keys With AI
Topology is the part of RabbitMQ that bites you in production. Here's how to use AI to design exchanges and routing keys, then validate the plan on a staging broker.
Read guide - · 11 min read
Fixing RabbitMQ Queue Backpressure and Flow Control With AI
When RabbitMQ throttles publishers, the symptoms are confusing and the docs are dense. Here's how to use AI to diagnose backpressure and flow control fast.
Read guide - · 11 min read
RabbitMQ Cross-Site Federation and Shovel With AI
Federation and shovel solve different cross-site problems and people pick wrong. Here's how to use AI to choose and configure them, then verify links on staging.
Read guide - · 12 min read
RabbitMQ Dead-Letter Queues and Retry Patterns Done Right With AI
Dead-letter queues are easy to declare and easy to get subtly wrong. Here's how to use AI to design DLX and retry topology, then validate it on staging.
Read guide - · 10 min read
RabbitMQ Message TTL and Expiration Strategy With AI
Message TTL looks simple and behaves in surprising ways. Here's how to use AI to design an expiration strategy that won't silently drop the messages you need.
Read guide - · 12 min read
RabbitMQ Publisher Confirms and Idempotent Consumers for Zero Message Loss With AI
Zero message loss takes publisher confirms on one end and idempotent consumers on the other. Here's how to use AI to design both and prove them on staging.
Read guide - · 11 min read
Quorum Queues vs Classic Mirrored Queues With AI
Mirrored queues are deprecated and quorum queues are the path forward — but migrating isn't free. Here's how to use AI to reason through the trade-offs safely.
Read guide - · 10 min read
Tuning RabbitMQ Consumer Prefetch and QoS With AI
Prefetch is the single highest-leverage RabbitMQ knob and the easiest to set wrong. Here's how to use AI to reason about QoS, then verify the number on staging.
Read guide