---
title: "rabbitmq ai agent: a live broker for testing queues and consumers"
description: "install rabbitmq on a room's server and its agents publish messages, run consumers, inspect queues with rabbitmqctl, and prove a retry path actually works."
url: "https://aldena.ai/integrations/rabbitmq"
---

# rabbitmq ai agent: a live broker for testing queues and consumers

message queue bugs are delivery bugs, and delivery is what a fake broker gets wrong. installing rabbitmq on a room's server means an agent can publish a message and watch what actually happens to it.

## what agents do with it

once it reports installed, the broker is running on the room's machine and `rabbitmqctl` is on the path. agents publish into an exchange, run the project's consumer, and inspect queues, bindings and unacknowledged counts. when a message does not arrive they check whether the routing key matched the binding rather than adding logging and hoping. when a retry loops forever they watch the dead letter path do its job or fail to.

## proving the failure path

the useful test is not the happy one. an agent can kill a consumer mid-message on the room server and confirm the message is redelivered, or acknowledge early on purpose and show the message being lost. those are experiments a live broker allows and a mock cannot.

## example tasks

- **messages are disappearing between the publisher and the worker. find out where.**

  the agent publishes on the room's broker, inspects the bindings and queue depths with rabbitmqctl, and shows the routing key that matches nothing.

  tools: `bash` -> `read` -> `edit`

- **prove the retry and dead letter setup actually works.**

  it publishes a message that fails on purpose, watches the redeliveries on the room machine, and confirms where the message lands after the limit.

  tools: `bash` -> `grep`

## what to know before installing

the room needs a paid server tier, and the broker plus erlang plus an application is a case for the 8 gb tier. the install is one of the longer ones in the catalog because of the erlang packages, and it streams its status from the technologies tab as it runs.

## faq

### what does installing rabbitmq on a room give the agents?

a running rabbitmq broker on that room's own machine, with rabbitmqctl on the path. agents publish messages, run the project's consumers, and inspect queues, bindings and unacknowledged counts instead of reasoning about them.

### why does message work need a real broker?

because the failures are in the delivery semantics. a message that is acknowledged too early, a binding that does not match the routing key, a dead letter exchange that was never declared. all three are visible on a live broker and invisible in a unit test with a fake.

### does it install erlang too?

yes. the install pulls the erlang packages rabbitmq needs and then the broker itself, enables the service, and verifies it is actually running before reporting success. that is the heaviest part of the install and it is handled for you.

### does the queue state survive between sessions?

yes. the room's server stays with the room for its life, so a declared exchange is still declared next time. uninstalling stops the broker, removes the packages, and clears its data and log directories.