Quando clientes MQTT se conectam ou desconectam, as aplicações de backend geralmente precisam de visibilidade em tempo real desses eventos para gerenciar sessões, registrar auditorias ou tratar failovers. As regras de notificação de status do cliente encaminham esses eventos de conexão e desconexão do ApsaraMQ for MQTT para um tópico do ApsaraMQ for RocketMQ, onde os serviços de backend podem consumi-los.
Somente instâncias do ApsaraMQ for RocketMQ 4.0 são compatíveis como destino de notificação. A instância MQTT e a instância RocketMQ devem estar na mesma região.

Como funciona
Um cliente ApsaraMQ for MQTT conecta-se ao broker ou desconecta-se dele.
O broker gera um evento de notificação de status com base na regra configurada.
O sistema encaminha o evento para o tópico especificado do ApsaraMQ for RocketMQ.
Serviços de backend implantados em instâncias do Elastic Compute Service (ECS) assinam o tópico RocketMQ e processam as notificações.
Para obter detalhes sobre a estrutura das mensagens dos eventos encaminhados, consulte Mapeamentos de estrutura de mensagens entre Message Queue for MQTT e Message Queue for Apache RocketMQ.
Cotas e limites
Crie uma regra de notificação de status do cliente
Antes de começar, verifique se você tem:
Uma instância do ApsaraMQ for MQTT com versão de kernel V3.x.x
Uma instância do ApsaraMQ for RocketMQ 4.0 na mesma região da instância MQTT
Um tópico RocketMQ para receber os eventos de notificação
Um group ID configurado para os dispositivos MQTT que você deseja monitorar
Para criar uma regra, siga estas etapas:
Faça login no console do ApsaraMQ for MQTT. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione a região onde a instância está localizada. Clique no nome da instância para acessar a página Instance Details.
No painel de navegação à esquerda, clique em Rules. No canto superior esquerdo da página, clique em Create Rule.
-
Na etapa Configure Basic Information, defina os parâmetros a seguir e clique em Next.
Parâmetro
Exemplo
Descrição
Rule ID
111111
Identificador globalmente exclusivo da regra. Pode conter letras, dígitos, hifens (-) e sublinhados (_). Deve incluir pelo menos uma letra ou dígito e ter entre 3 e 64 caracteres. O sistema trunca automaticamente valores que excederem 64 caracteres. Não é possível alterar esse valor após a criação.
Description
migrate from rocketmq
Descrição da regra.
Status
Enable
Defina se a regra será ativada imediatamente. Valores válidos: Enable e Disable.
Rule Type
Client Status Notification
Escolha Client Status Notification para encaminhar eventos de conexão e desconexão do cliente. Outros valores válidos: Data Outbound (consulte Exportar dados do ApsaraMQ for MQTT para outros serviços Alibaba Cloud) e Data Inbound (consulte Importar dados de outros serviços de nuvem para o ApsaraMQ for MQTT).
-
Na etapa Configure Rule Source, defina a origem dos dados e clique em Next.
Parâmetro
Exemplo
Descrição
Group ID
GID_Client_Status
Group ID dos dispositivos cujos eventos de status serão encaminhados. Para mais informações sobre group IDs, consulte Termos.
-
Na etapa Configure Rule Destination, defina o destino dos eventos encaminhados e clique em Create.
Parâmetro
Exemplo
Descrição
Destination Service Type
Message Queue for Apache RocketMQ
Serviço de nuvem que recebe os eventos de status. Somente o ApsaraMQ for RocketMQ é compatível.
Message Queue for Apache RocketMQ Instance
MQ_INST_13801563067\\\\\*_BbyOD2jQ
Instância do ApsaraMQ for RocketMQ que recebe os eventos. Deve estar na mesma região da instância MQTT.
Topic
TopicB
Tópico RocketMQ que recebe os eventos de notificação.
Após a criação, a regra aparece na página Rules.
Edite uma regra
Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Edit.
Na página Edit Rule, modifique qualquer parâmetro, exceto Rule ID.
Clique em Save na etapa Configure Rule Destination.
Ative ou desative uma regra
Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Enable ou Disable.
Na caixa de diálogo de confirmação, clique em OK.
Exclua uma regra
Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Delete.
Na caixa de diálogo de confirmação, clique em OK.