All Products
Search
Document Center

ApsaraMQ for RabbitMQ:Manage instances

Last Updated:Mar 15, 2024

In ApsaraMQ for RabbitMQ, an instance is an independent entity that includes basic resources such as virtual hosts (vhosts), exchanges, and queues. An instance can be considered as an isolated server or service environment in which messages are received, stored, and forwarded. This topic describes how to create an instance, view instance details, upgrade and downgrade instance configurations, and renew an instance in the ApsaraMQ for RabbitMQ console.

Instance status

The status of an ApsaraMQ for RabbitMQ instance varies based on the billing method and edition of the instance.

Table 1. Status

Status

Description

Deploying

  • An instance in this state is unavailable.

  • This state is supported only by Enterprise Platinum Edition instances. Enterprise Platinum Edition instances must be deployed by technical support after the instances are purchased.

Running

  • An instance in this state is available.

  • After you purchase a Professional Edition or Enterprise Edition instance, the instance enters the Running state.

Stopped

  • An instance in this state is unavailable.

  • The resources and data of an instance that is in this state are retained and can be restored.

Released

  • An instance in this state is unavailable.

  • The resources of an instance in this state are released and the data of the instance is deleted. The resources and data cannot be restored.

Supported operations

Operation

Description

Create an instance

ApsaraMQ for RabbitMQ provides Professional Edition, Enterprise Edition, Enterprise Platinum Edition, and Serverless Edition instances. For information about the differences among the instance editions, see Instance editions.

Note

ApsaraMQ for RabbitMQ Serverless Edition instances are available only in the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Shenzhen), China (Guangzhou), China (Chengdu), China (Hong Kong), India (Mumbai), Singapore, Philippines (Manila), Indonesia (Jakarta), and Thailand (Bangkok). If you want to purchase ApsaraMQ for RabbitMQ Serverless Edition instances in a region other than the preceding regions, submit a ticket to contact ApsaraMQ for RabbitMQ technical support.

View instance details

You can view the basic information, endpoints, and usage limits of an instance in the ApsaraMQ for RabbitMQ console. You can also query messages and the peak transactions per second (TPS) of an instance in the ApsaraMQ for RabbitMQ console.

Note

You can view the peak TPS of an instance only if the message trace feature is enabled for the instance.

Upgrade or downgrade instance configurations

  • When workloads on your business increase, you can increase the peak TPS and queue quota for your instance. This helps prevent business interruption that is caused by insufficient resources.

  • When workloads on your business decrease, you can decrease the peak TPS and queue quota for your instance. This helps improve resource utilization and reduce costs.

You can upgrade or downgrade the following configuration items of ApsaraMQ for RabbitMQ Professional Edition, Enterprise Edition, and Enterprise Platinum Edition instances:

  • Instance Edition

  • EIP

  • Internet TPS

  • Peak TPS

  • Queues

    Important

    The threshold values of Professional Edition or Enterprise Edition instances in a cluster vary based on the value of the Queues parameter. If you change the value of the Queues parameter for an instance, the threshold values of the instance change. For more information, see Limits on clusters.

  • Message Trace

  • Max. Connections: You can change the value of this parameter only if the instance is of the Enterprise Edition or Enterprise Platinum Edition.

  • Message Storage Space: You can change the value of this parameter only if the instance is of the Enterprise Platinum Edition.

You can upgrade or downgrade the following configuration items of ApsaraMQ for RabbitMQ Serverless Edition instances:

  • EIP

  • Message Trace

Renew an instance

If an instance is released due to overdue payments, the service becomes unavailable and your business is interrupted. To prevent the issue, renew the instance at the earliest opportunity.

Note
  • You can renew only subscription instances that are in the Expired or Running state.

  • ApsaraMQ for RabbitMQ allows you to renew only subscription instances. The renewal operation does not apply to pay-as-you-go instances. For existing pay-as-you-go instances, you need only to keep your account balance sufficient.

  • For information about instance expiration, see Billing overview.

Enable the elastic TPS feature for an instance

Note

The elastic TPS feature is supported only by ApsaraMQ for RabbitMQ Professional Edition, Enterprise Platinum Edition, and Enterprise Edition instances.

Elastic TPS is the TPS that exceeds the specification limit of an instance. If your actual TPS usage may exceed the specification limit of your instance due to bursty traffic, you can enable the elastic TPS feature to increase the peak TPS of your instance within a specific range. This prevents business interruption that is caused by instance throttling.

You are charged for elastic TPS. For information about the upper limits and billing rules of elastic TPS, see Billing of elastic TPS.

Create an instance

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

  2. In the top navigation bar, select a region. On the Instances page, click Create Instance.

  3. On the buy page, follow the on-screen instructions to complete the configurations, read and select the terms of service, and then click Buy Now.

  4. Follow the on-screen instructions to complete the payment.

    In the top navigation bar of the Instances page, select the region where the instance was created. On the page that appears, view the instance that you created.

    Note
    • After you purchase a Professional Edition or Enterprise Edition instance, the instance immediately enters the Running state.

    • After you purchase an Enterprise Platinum Edition instance, the instance enters the Deploying state. After the instance is deployed, the instance enters the Running state.

View instance details

  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. On the Instance Details page, view the details of the instance.

Upgrade or downgrade instance configurations

Usage notes

  • You can upgrade or downgrade only the configurations of instances that are in the Running state.

  • In ApsaraMQ for RabbitMQ, Professional Edition and Enterprise Edition instances are of the shared cluster type and Enterprise Platinum Edition instances are of the dedicated cluster type. When you upgrade a Professional or Enterprise Edition instance to an Enterprise Platinum Edition instance, the instance is migrated between clusters. The migration requires 30 to 60 minutes to complete. The migration duration varies based on the number of queues and the migrated data volume.

  • When you upgrade a Professional or Enterprise Edition instance to an Enterprise Platinum Edition instance, the endpoint of the instance is not changed and client connections are not forcibly closed. However, the metadata of the instance is migrated. To shorten the upgrade time in the backend, we recommend that you upgrade instance configurations during off-peak hours.

  • If an instance upgrade or downgrade is not completed after a long period of time and a message that indicates data is being migrated is displayed for specific operations, the data in a specific queue may not be fully consumed. In this case, you can reduce the number of produced messages in the queue or increase the number of consumers.

  • If you downgrade an Enterprise Platinum Edition instance to a Professional or Enterprise Edition instance, instance data is not migrated and your business is not affected.

Procedure

  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. On the Instance Details page, click Upgrade or Downgrade in the upper-right corner of the Overview section.

  4. In the panel that appears, follow the on-screen instructions to configure the parameters, read and select the terms of service, and then click Buy Now.

  5. Follow the on-screen instructions to complete the payment.

Renew an instance

Important
  • Only Enterprise Edition, Professional Edition, and Enterprise Platinum Edition instances require renewal.

  • The resources and data of an expired instance are retained and can be restored after you renew the instance.

  • The resources and data of a released or deleted instance are not retained and cannot be restored.

  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. On the Instance Details page, click Renew in the upper-right corner of the Overview section.

  4. In the Renew panel that appears, specify the subscription duration, read and select the terms of service, and then click Buy Now.

  5. Follow the on-screen instructions to complete the payment.

    Note

    If you do not renew an instance at your earliest opportunity, the payment for the instance becomes overdue and the instance expires and becomes unavailable. We recommend that you enable auto-renewal when you create an instance.

    In the Basic Information section of the Instance Details page, you can view the Expired At parameter to check the expiration time of the instance after renewal.

Enable the elastic TPS feature for an instance

Note
  • If your Alibaba Cloud account has overdue payments, you cannot enable the elastic TPS feature for an instance.

  • The elastic TPS feature is supported only by ApsaraMQ for RabbitMQ Professional Edition, Enterprise Platinum Edition, and Enterprise Edition instances.

  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 Overview section of the Instance Details page, turn on the Enable Elasticity Quota switch in the Maximum TPS card.

  4. In the message that appears, click OK.