Todos os produtos
Search
Central de documentação

ApsaraMQ for MQTT:Gerencie regras para notificações de status do cliente

Última atualização: Jun 28, 2026

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.

Nota

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.

Fluxo de eventos de notificação de status do cliente

Como funciona

  1. Um cliente ApsaraMQ for MQTT conecta-se ao broker ou desconecta-se dele.

  2. O broker gera um evento de notificação de status com base na regra configurada.

  3. O sistema encaminha o evento para o tópico especificado do ApsaraMQ for RocketMQ.

  4. Serviços de backend implantados em instâncias do Elastic Compute Service (ECS) assinam o tópico RocketMQ e processam as notificações.

Nota

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

Item

Limite

Descrição

Regras por instância

100

Para solicitar uma cota maior, entre no grupo DingTalk 35228338 e contate o suporte técnico do ApsaraMQ for MQTT.

Deduplicação de regras

Uma regra do mesmo tipo por recurso interno

Cada group ID aceita apenas uma regra de notificação de status do cliente. Cada tópico do ApsaraMQ for MQTT aceita uma regra de entrada de dados e uma regra de saída de dados.

Restrição entre regiões

Origem e destino dos dados devem estar na mesma região

Por exemplo, se a origem dos dados for uma instância do ApsaraMQ for MQTT na região China (Hangzhou), o destino também deverá estar na região China (Hangzhou).

Versão da instância ApsaraMQ for MQTT

Kernel V3.x.x obrigatório

Verifique a versão do kernel na lista de instâncias ou na página Instance Details no console do ApsaraMQ for MQTT.

Versão da instância ApsaraMQ for RocketMQ

Apenas 4.0

Regras de troca de dados entre ApsaraMQ for MQTT e ApsaraMQ for RocketMQ exigem instâncias do ApsaraMQ for RocketMQ 4.0.

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:

  1. Faça login no console do ApsaraMQ for MQTT. No painel de navegação à esquerda, clique em Instances.

  2. 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.

  3. No painel de navegação à esquerda, clique em Rules. No canto superior esquerdo da página, clique em Create Rule.

  4. 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).

  5. 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.

  6. 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

  1. Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Edit.

  2. Na página Edit Rule, modifique qualquer parâmetro, exceto Rule ID.

  3. Clique em Save na etapa Configure Rule Destination.

Ative ou desative uma regra

  1. Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Enable ou Disable.

  2. Na caixa de diálogo de confirmação, clique em OK.

Exclua uma regra

  1. Na página Rules, localize a regra desejada. Na coluna Actions, escolha More > Delete.

  2. Na caixa de diálogo de confirmação, clique em OK.

Tópicos relacionados