Connecting to RabbitMQ

Connection Types and Security

RabbitMQ comes with two HAProxy portals for your application to handle failover between the two connections. The portals are SSL/TLS enabled and backed by a Let's Encrypt certificate. Deployments also come with the RabbitMQ administrative plug-in enabled, so a connection to the Admin UI and the HTTP API is avaliable.

Language Guides

If you want to use a particular language, you can go directly to its dedicated page:

Connection Overview and Credentials

On the Overview of your RabbitMQ deployment there is a Connection Info section. The connections shown under Connection Strings are ampqs strings for connecting with a language driver. These connections are SSL/TLS-enabled, so you will need to use them with a driver that supports this.

Admin UI

The connection shown under Admin UI can be used in a browser to bring up the UI provided by the management plugin included with your Compose deployment.

HTTP API and cURL

The base URL endpoint for the API is the Admin UI address, in the Connection Info of the deployment's Overview. For example to see a list of vhosts, the request will look like this:

$ curl -i -u user:password https://portal1301-14.harmonious-rabbitmq-33.compose-34.composedb.com:15845/api/vhosts
> HTTP/1.1 200 OK
server: Cowboy
date: Tue, 23 Jan 2018 19:47:30 GMT
content-length: 804
content-type: application/json
vary: accept, accept-encoding, origin
Cache-Control: no-cache
Set-Cookie: SRVID=rabbitmq_1008194; path=/

[{"message_stats":{"deliver_get_details":
{"rate":0.0},"deliver_get":40202,"ack_details":
{"rate":0.0},"ack":0,"redeliver_details":
{"rate":0.0},"redeliver":0,"deliver_no_ack_details":
{"rate":0.0},"deliver_no_ack":0,"deliver_details":
{"rate":0.0},"deliver":0,"get_no_ack_details":
{"rate":0.0},"get_no_ack":40201,"get_details":
{"rate":0.0},"get":1,"return_unroutable_details":
{"rate":0.0},"return_unroutable":0,"confirm_details":
{"rate":0.0},"confirm":0,"publish_details":
{"rate":0.6},"publish":40206},"messages_details":
{"rate":0.0},"messages":14,"messages_unacknowledged_details":
{"rate":0.0},"messages_unacknowledged":0,"messages_ready_details":
{"rate":0.0},"messages_ready":14,"tracing":false,"name":"harmonious-rabbitmq-33"},{"tracing":false,"name":"harmony_one"},
{"tracing":false,"name":"harmony_two"}

There is an API reference found through the Admin UI, in the footer of the page. It's URL is the Admin UI URL + \api. For example, https://portal1301-14.harmonious-rabbitmq-33.compose-34.composedb.com:15845/api.

Still Need Help?

If this article didn't solve things, summon a human and get some help!