FAQ: How to close all connections in RabbitMQ?

RabbitMQ Management Interface

A connection can be closed via the RabbitMQ Management Interface. Enter the connection tab and press on the connection. Go to the bottom of the page and press Close this connection, followed by pressing Force Close.

rabbitmqadmin

The management plugin ships with a command line tool rabbitmqadmin which can perform the same actions as the web-based UI (the RabbitMQ management interface).

Rabbitmqadmin config example, ensure all text is contained in quote marks as shown:

[default]
hostname = "CLUSTER_URL"
port = 443
username = "USERNAME"
password = "PASSWORD"
vhost = "VHOST"

Close one connection:

$ rabbitmqadmin -q close connection name=CONNECTION_NAME

The example below shows how the command is used for a CloudAMQP instance.

$ rabbitmqadmin --use-tls --tls-ca-cert-file=$CERTIFICATE_LOCATION --config=$CONFIG_LOCATION -q close connection name=$CONNECTION_NAME

Close connections by user

You are able to affect connections on a user-by-user basis, using the list_of_user and close_of_user commands. You can use list_of_user to confirm which connections may be deleted and then close_of_user to delete all connections from that user

$ rabbitmqadmin -q connections list_of_user -u $CLOSE_USERNAME

$ rabbitmqadmin -q connections close_of_user -u $CLOSE_USERNAME

The example below shows how the command is used for a CloudAMQP instance.

$ rabbitmqadmin --use-tls --tls-ca-cert-file=$CERTIFICATE_LOCATION --config=$CONFIG_LOCATION -q connections list_of_user --username=$CLOSE_USERNAME

$ rabbitmqadmin --use-tls --tls-ca-cert-file=$CERTIFICATE_LOCATION --config=$CONFIG_LOCATION -q connections close_of_user --username=$CLOSE_USERNAME

Close all connections

You are able to close many/all connections at once by using a script to collect and obtain the names of all connections within an instance and then iterating through to close them one at a time.

The script below will:

1. Put the output from listing all connections into a file
2. Obtain the names of the connections and put them in their own file, "names.txt". In this step you can open the file and remove the names of any connections you wish to keep.
3. Loop the list of connections and close each one.

If there are connections within the list that you would like to keep, you can simply remove them from the "names.txt" file to keep them.

$ rabbitmqadmin --non-interactive list connections > connections.txt

$ while read name; do
 echo "$name" | awk 'BEGIN {FS="  "}; {print $1}' >>name.txt
done < connections.txt

$ while read name; do
 rabbitmqadmin close connection --name "${name}"
done < name.txt

The example below shows how the script is used for a CloudAMQP instance.

$ rabbitmqadmin --use-tls --non-interactive --tls-ca-cert-file=$CERTIFICATE_LOCATION --config=$CONFIG_LOCATION list connections > connections.txt

$ while read name; do
 echo "$name" | awk 'BEGIN {FS="  "}; {print $1}' >>name.txt
done < connections.txt

$ while read name; do
 rabbitmqadmin --use-tls --tls-ca-cert-file=$CERTIFICATE_LOCATION  --config=$CONFIG_LOCATION close connection --name "${name}"
done < name.txt

HTTP API, curl

The RabbitMQ Management plugin provides an HTTP-based API for management and monitoring of your RabbitMQ server. In CloudAMQP the management plugin is assigned port 443 and SSL has to be used.

rabbitmqctl

The RabbitMQ CLI provides a way (since version 3.7.0) to close all connections for a vhost, or even the whole server. See all arguments in the rabbitmqctl documentation

Please email us at contact@cloudamqp.com if you have any suggestions, questions or feedback.