IoT Platform:Manage consumer groups

Usage notes

You can specify a consumer group ID for an AMQP client. This way, the AMQP client can connect to IoT Platform and receive messages. For more information, see Connect an AMQP client to IoT Platform.

A consumer group can contain up to 64 AMQP clients. The AMQP clients share the ID of the consumer group. After a device message is sent to IoT Platform, IoT Platform forwards the message to a random client in the consumer group.

Create a consumer group

1. Log on to the IoT Platform console.

2. On the Overview page, click All environment. On the All environment tab, find the instance that you want to manage and click the instance ID or instance name.

3. In the left-side navigation pane, choose Server-side Subscription and click the Consumer Groups tab.

4. Click Create Consumer Group.

5. In the Create Consumer Group dialog box, enter a group name and click OK.

   The name of the consumer group must be 4 to 30 characters in length, and can contain letters, digits, and underscores (_). Each Chinese character or Japanese character uses two characters.

View and monitor consumer groups

You can view the message consumption rate and the number of accumulated messages of a consumer group. To monitor the consumer group, you can configure an alert rule in the CloudMonitor console.

1. On the Consumer Groups tab, find the consumer group that you want to manage and click View in the Actions column.

2. On the Consumer Group Status tab, you can view the values of the Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages, and Last Consumed At parameters. You can also view online clients.

   If the number of accumulated messages is greater than or equal to 1, click Clear to the right of Accumulated Messages to clear the messages.

   Note

   After a consumer group is created, it may or may not accumulate messages, depending on whether it has been enabled.

   • If the consumer group has never been enabled, the consumer group is in the offline state. If you send messages to the consumer group, no messages are accumulated.

   • If the consumer group is enabled and then disabled, the consumer group is in the offline state. If you send messages to the consumer group, the messages are accumulated.

   

3. On the Consumer Group Status tab, click Alert Settings. In the Create Alert Rule panel, configure an alert rule to receive alert notifications and monitor the number of accumulated messages in the consumer group and the consumption rate.

   Set the Product parameter to IoT Platform-Server subscription. Configure other parameters based on your business requirements. For more information, see Configure alert rules.

4. On the Consumer Group Details page, click Consumption Logs. On the Consumption Logs tab, you can view the details of consumption records.

Delete a consumer group

You can delete a consumer group, but you cannot delete the default consumer group. After a consumer group is deleted, all clients in the group can no longer receive messages.

1. Disassociate a subscription. If a consumer group is associated with a subscription, you must disassociate the subscription from the consumer group. If the consumer group has no subscriptions, skip this step.

   1. On the Consumer Groups tab, find the consumer group and click View in the Actions column.

   2. On the Subscribed Products tab of the Consumer Group Details page, find the product that you want to manage and click Unsubscribe in the Actions column. In the message that appears, click OK.

      Note

      If only one consumer group is associated with a server-side subscription, the unsubscribe action is unavailable on the Consumer Group Details page. You must modify or delete the subscription on the Subscriptions tab of the Server-side Subscription page.

2. On the Consumer Groups tab of the Server-side Subscription page, find the consumer group that you want to manage and click Delete in the Actions column. In the message that appears, click OK.

References

For more information about how to specify a consumer group ID for an AMQP client and use the AMQP client to receive messages, see the following topics:

• Connect an AMQP client to IoT Platform

• Connect a client to IoT Platform by using the SDK for Java

• Connect a client to IoT Platform by using the SDK for Node.js

• Connect a client to IoT Platform by using the SDK for .NET

• Connect a client to IoT Platform by using the SDK for Python 2.7

• Connect a client to IoT Platform by using the SDK for Python 3

• Connect a client to IoT Platform by using the SDK for PHP

• Connect a client to IoT Platform by using the SDK for Go

Related API operations