All Products
Search
Document Center

ApsaraMQ for RabbitMQ:Vhosts

Last Updated:Jun 20, 2026

A vhost, or virtual host, provides logical isolation by managing its own set of exchanges, queues, and bindings. This allows applications to run securely on different vhosts without interfering with each other. An instance can contain multiple vhosts, and a single vhost can contain multiple exchanges and queues. Producers and consumers must specify a vhost when connecting to ApsaraMQ for RabbitMQ.

Usage notes

You can delete a vhost only after deleting all its exchanges and queues, excluding the built-in exchanges.

Create a vhost

  1. Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.

  2. In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.

  3. In the left-side navigation pane, click Vhosts.

  4. On the Vhosts page, click Create Vhost.

  5. In the Create Vhost panel, enter a name in the vhost Name text box, and then click OK.

View statistics

You can view various monitoring metrics to help you identify and resolve issues promptly.

  1. In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.

  2. In the left-side navigation pane, click Vhosts.

  3. On the Vhosts page, find the target vhost and click Details in the Actions column.

  4. On the vhost Details page, click the Monitoring and Alerting or Dashboard tab to view statistics.

    The available statistics vary by instance edition.

    • Enterprise Edition and Enterprise Platinum Edition: You can view metrics from Application Real-Time Monitoring Service (ARMS) for Prometheus and Grafana. For more information about the dashboard and its metrics, see Dashboard.

    • The Standard and Professional editions provide monitoring data through CloudMonitor. For more information about the metrics, see Monitoring Metrics.

      Note

      ApsaraMQ for RabbitMQ no longer offers new Standard Edition instances. This information applies only to existing Standard Edition instances.

View vhost connection details

After you create a vhost and establish a connection, you can view the connection details between the vhost and its clients. This includes the client IP address, connection status, status of each channel, and the number of messages sent and received per minute.

  1. In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.

  2. In the left-side navigation pane, click Vhosts.

  3. On the Vhosts page, find the target vhost, choose More > Connection Details in the Actions column, and then view the connection information on the Connection Details tab of the vhost Details page.

    Alternatively, click the name of the target vhost or click Details in the Actions column. Then, on the vhost Details page, click the Connection Details tab to view the connection information.

    Table 1. Connection parameters

    Parameter

    Description

    Connection

    The IP address of the client.

    Connection name

    The custom connection name defined by the client.

    AccessKey ID

    The AccessKey ID used for the connection.

    State

    The current status of the connection.

    SSL/TLS

    Specifies whether the connection uses SSL/TLS.

    Protocol

    The version of the AMQP protocol in use.

Delete a vhost

Warning

Deleting a vhost is an irreversible action that permanently removes all its data.

  1. In the top navigation bar of the Instances page, select the region where the instance that you want to manage resides. Then, in the instance list, click the name of the instance that you want to manage.

  2. In the left-side navigation pane, click Vhosts.

  3. On the Vhosts page, find the vhost you want to delete and in the Actions column, choose More > Delete.

  4. In the Prompt dialog box, carefully read the message and click Confirm to delete the vhost.