IoT Platform:Gerenciar grupos de consumidores

Recursos

Use um dos métodos a seguir para escutar grupos de consumidores e obter mensagens encaminhadas:

• Configure AMQP server-side subscription: use uma assinatura do lado do servidor via Advanced Message Queuing Protocol (AMQP) para assinar um tipo específico de mensagem enviada por todos os dispositivos de um product e encaminhar essas mensagens para um grupo de consumidores definido.

  Para mais informações sobre as diferenças entre assinaturas do lado do servidor e encaminhamento de dados, consulte Comparison of data forwarding solutions.

• Configure a data forwarding rule: use o recurso de encaminhamento de dados para enviar mensagens de um tópico específico para um grupo de consumidores AMQP.

Observações de uso

Defina um ID de grupo de consumidores para um cliente AMQP. Dessa forma, o cliente AMQP se conecta ao IoT Platform e recebe mensagens. Para mais detalhes, consulte Connect an AMQP client.

Um grupo de consumidores pode conter até 64 clientes AMQP, que compartilham o ID do grupo. Quando um dispositivo envia uma mensagem ao IoT Platform, a plataforma a encaminha para um cliente aleatório do grupo.

Criar um grupo de consumidores

1. Faça login no console do IoT Platform.

2. Na página Overview, localize a instância que deseja gerenciar e clique em no ID ou no nome da instância.

3. No painel de navegação à esquerda, escolha Server-side Subscription e clique em na aba Consumer Groups.

4. Clique em Create Consumer Group.

5. Na caixa de diálogo Create Consumer Group, insira um nome para o grupo e clique em OK.

   O nome do grupo de consumidores deve ter entre 4 e 30 caracteres e pode conter letras, dígitos e sublinhados (_). Cada caractere chinês ou japonês conta como dois caracteres.

Visualizar e monitorar grupos de consumidores

Verifique a taxa de consumo de mensagens e a quantidade de mensagens acumuladas em um grupo de consumidores. Para monitorar o grupo, configure uma regra de alerta no console do CloudMonitor.

1. Na aba Consumer Groups, encontre o grupo de consumidores desejado e clique em View na coluna Actions.

2. Na aba Consumer Group Status, visualize os valores dos parâmetros Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages e Last Consumed At. Também é possível ver os clientes online.

   Se o número de mensagens acumuladas for maior ou igual a 1, clique em Clear à direita de Accumulated Messages para limpar as mensagens.

   Nota

   Após a criação de um grupo de consumidores, ele pode ou não acumular mensagens, dependendo da ativação.

   • Se o grupo nunca foi ativado, ele permanece no estado offline. Mensagens enviadas para esse grupo não são acumuladas.

   • Se o grupo foi ativado e depois desativado, ele fica no estado offline. Mensagens enviadas para esse grupo são acumuladas.

   A aba Consumer Group Status exibe as métricas Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages e Last Consumed At na área de informações básicas. Abaixo dessas métricas, a lista Online Clients contém as colunas Client ID, Client IP/Port, Last Up Time, Per-Connection Real-time Consumption Rate e Per-Connection Accumulated Consumption Rate.

3. Na aba Consumer Group Status, clique em Alert Settings. No painel Create Alert Rule, configure uma regra de alerta para receber notificações e monitorar a quantidade de mensagens acumuladas no grupo de consumidores e a taxa de consumo.

   Defina o parâmetro Product como IoT Platform-Server subscription. Configure os demais parâmetros conforme suas necessidades de negócio. Para mais informações, consulte Configure alert rules.

4. Na página Consumer Group Details, clique em Consumption Logs. Na aba Consumption Logs, visualize os detalhes dos registros de consumo.

Excluir um grupo de consumidores

É possível excluir um grupo de consumidores, exceto o grupo padrão. Após a exclusão, todos os clientes do grupo deixam de receber mensagens.

1. Desassocie uma assinatura. Se o grupo de consumidores estiver associado a uma assinatura, desassocie-a antes de prosseguir. Caso não haja assinaturas vinculadas ao grupo, pule esta etapa.

   1. Na aba Consumer Groups, localize o grupo de consumidores e clique em View na coluna Actions.

   2. Na aba Subscribed Products da página Consumer Group Details, encontre o product desejado e clique em Unsubscribe na coluna Actions. Na mensagem exibida, clique em OK.

      Nota

      Se apenas um grupo de consumidores estiver associado a uma assinatura do lado do servidor, a ação de cancelar assinatura não estará disponível na página Consumer Group Details. Modifique ou exclua a assinatura na aba Subscriptions da página Server-side Subscription.

2. Na aba Consumer Groups da página Server-side Subscription, localize o grupo de consumidores que deseja gerenciar e clique em Delete na coluna Actions. Na mensagem exibida, clique em OK.

Referências

Para saber mais sobre como definir um ID de grupo de consumidores para um cliente AMQP e usá-lo no recebimento de mensagens, consulte os tópicos a seguir:

• Connect an AMQP client

• Java SDK connection example

• Node.js SDK connection example

• 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

• Example: Python 3 SDK connection

• PHP SDK connection example

• Go SDK connection example

Operações de api relacionadas