Se ocorrer uma exceção em um dispositivo do ApsaraMQ for MQTT ou se as mensagens não forem enviadas ou recebidas conforme o esperado, use a consulta de status do dispositivo para verificar se ele está online, revisar suas assinaturas e rastrear seu histórico de conexões e mensagens. Isso ajuda a identificar rapidamente a causa do problema.
Pré-requisitos
Antes de começar, certifique-se de ter:
Uma instância do ApsaraMQ for MQTT
O Group ID e o Device ID do dispositivo a ser inspecionado
Consultar o status do dispositivo
Faça login no ApsaraMQ for MQTT console. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione a região onde sua instância está localizada. Na página Instances, clique no nome da instância para acessar a página Instance Details.
Na página Instances, localize sua instância e escolha na coluna Actions.
Na página Device Status Query, insira o Group ID e o Device ID e clique em Search.
Os resultados da consulta são organizados em três abas: Device status, Device Trace e Message Trace.
Compreender os resultados da consulta
Aba Device status
A aba Device status exibe o status de conexão atual e a configuração de sessão do dispositivo.
|
Campo |
Descrição |
|
Client ID |
O ID exclusivo do cliente MQTT. |
|
Status |
O status de conexão: Online ou Offline. |
|
Client Address |
O endereço IP do cliente. |
|
cleanSession |
Indica se o broker limpa as assinaturas anteriores e as mensagens offline na fila quando o cliente reconecta. Quando o valor é |
|
Last Updated At |
O carimbo de data e hora da alteração de status mais recente. |
Seção de assinaturas
A seção Subscription, exibida abaixo dos campos de status do dispositivo, lista todos os tópicos nos quais o dispositivo está inscrito atualmente.
|
Campo |
Descrição |
|
Parent Topic |
O tópico de nível 1 no ApsaraMQ for MQTT no qual o cliente se inscreve. |
|
Subtopic |
O tópico de nível 2 ou 3 sob o tópico pai. |
|
QoS |
O nível de qualidade de service (QoS) para entrega de mensagens entre o cliente e o broker. O QoS determina a garantia de entrega: |
Solucionar conflitos de Client ID
Se um dispositivo ficar offline inesperadamente ou se desconectar repetidamente, um conflito de Client ID pode ser a causa. O conflito ocorre quando o mesmo Client ID inicia múltiplas conexões simultâneas (conexões duplicadas). O ApsaraMQ for MQTT retém apenas a conexão mais recente e desconecta forçosamente (encerra) as anteriores.
Como solucionar
Nos resultados da consulta, clique na aba Device Trace e visualize o histórico de conexões do dispositivo.
Se múltiplos registros de conexão aparecerem de diferentes pontos de acesso ou endereços IP com carimbos de data e hora sobrepostos em uma curta janela de tempo, isso confirma um conflito de Client ID.
Revise as informações de source em cada registro de conexão — incluindo o endereço IP e o endpoint de acesso — para identificar qual cliente iniciou a conexão duplicada.
Resolução
Certifique-se de que cada dispositivo físico use um Client ID globalmente exclusivo. Não compartilhe nem reutilize o mesmo Client ID em vários dispositivos ou permita conexões simultâneas com o mesmo Client ID, pois isso causa desconexões mútuas.
Aba Device Trace
A aba Device Trace exibe o histórico de conexões do dispositivo, incluindo eventos de conexão e desconexão com carimbos de data e hora. Use esta aba para identificar problemas de conectividade intermitente ou desconexões inesperadas.
Para descrições dos campos, consulte Query the connection history of a device.
Aba Message Trace
A aba Message Trace exibe a lista de mensagens do dispositivo, incluindo mensagens publicadas e recebidas. Use esta aba para verificar se as mensagens foram entregues ou para identificar mensagens ausentes.
Para descrições dos campos, consulte Query message traces.
Perguntas frequentes
Como confirmo se uma relação de assinatura MQTT expirou ou está ativa atualmente?
O console do ApsaraMQ for MQTT não fornece uma entrada direta para consultar eventos históricos de expiração de assinatura. Confirme o status de assinatura atual de um dispositivo:
Faça login no ApsaraMQ for MQTT console e acesse a página Device Status Query da sua instância.
Insira o Group ID e o Device ID do dispositivo e clique em Search.
Nos resultados da consulta, verifique a seção Subscription para ver se o dispositivo está inscrito atualmente nos tópicos esperados.
Para solucionar falhas históricas de assinatura, verifique o log do dispositivo para confirmar se um pacote SUBSCRIBE foi enviado após a reconexão. Nota: mesmo que você defina cleanSession como false, o dispositivo deve se inscrever ativamente após a reconexão para receber novas mensagens. Combine o histórico de conexões da aba Device Trace com o log do dispositivo para inferir quando uma assinatura se tornou inativa.
Como visualizo o horário exato em que um dispositivo ficou offline ou determino se o status offline exibido no monitoramento é preciso?
Para visualizar o horário exato em que um dispositivo ficou offline:
Acesse a página Device Status Query, insira o Group ID e o Device ID e clique em Search.
Nos resultados da consulta, clique na aba Device Trace.
A aba Device Trace lista todos os eventos de conexão e desconexão com carimbos de data e hora precisos. Use esses registros como a fonte autoritativa para o horário exato da desconexão.
Observe o seguinte ao interpretar os resultados:
Se a aba Device Trace não exibir dados, ou exibir o dispositivo como online enquanto o monitoramento o mostra como offline, a discrepância pode ser causada por atrasos na coleta de dados de monitoramento. Atualize a página para recuperar o status de conexão mais recente.
O campo Last Updated At na aba Device status exibe o horário da alteração de status do cliente mais recente, o que pode não refletir o momento exato da desconexão. Para o horário preciso da desconexão, consulte os registros de Device Trace.
Como visualizo as conexões online simultâneas e seus detalhes para uma instância MQTT?
Você pode verificar a contagem de conexões online simultâneas e os detalhes de conexão em diferentes níveis de granularidade:
Visão geral no nível da instância (contagem de conexões online simultâneas): No ApsaraMQ for MQTT console, acesse a página de detalhes da instância. O painel de visão geral exibe a contagem atual de conexões de clientes, que mostra o número total de conexões online simultâneas para a instância.
Detalhes por dispositivo (valores específicos para conexões individuais): Para visualizar o status online e os detalhes de conexão de dispositivos individuais, use o recurso Device Status Query descrito neste tópico. Insira o Group ID e o Device ID para consultar informações de conexão de dispositivos específicos.
Tendências históricas e estatísticas de faturamento: Para visualizar tendências históricas de contagem de conexões ou estatísticas de conexão relacionadas ao faturamento, consulte a documentação de faturamento relevante ou os gráficos de monitoramento disponíveis no console.
Por que o número de dispositivos online mostra 0 na página de detalhes do tópico?
Na página de detalhes do tópico, a aba Online Devices exibe uma contagem de conexões agregada para o tópico. Um valor 0 geralmente significa que nenhum dispositivo inscrito no tópico possui uma conexão TCP ativa. No entanto, isso também pode resultar de um dos seguintes fatores:
A contagem inclui apenas dispositivos que se inscrevem diretamente no tópico pai. Dispositivos que se inscrevem apenas em um subtópico não são incluídos na contagem do tópico pai. Insira o subtópico específico no campo de consulta para verificar o número de dispositivos online para esse subtópico.
A contagem não é atualizada em tempo real, portanto, pode não refletir imediatamente o estado de conexão mais recente.
Para confirmar o status online real de um dispositivo e descartar essas possibilidades, use o recurso Device Status Query descrito neste tópico:
Acesse a página Device Status Query, insira o Group ID e o Device ID do dispositivo e clique em Search.
Verifique o campo Status para confirmar se o dispositivo está realmente online e revise a seção Subscription para confirmar a relação de assinatura entre o dispositivo e o tópico.
Como obtenho uma lista de Client IDs para todos os dispositivos que estão online atualmente em uma instância MQTT?
O console do ApsaraMQ for MQTT não fornece uma entrada para exportar ou visualizar em massa a lista de Client IDs de todos os dispositivos que estão online atualmente em uma instância. O recurso Batch Close Connections permite que você faça upload de um arquivo CSV com Client IDs que você já conhece para fechar suas conexões em massa, mas não lista nem retorna os Client IDs dos dispositivos online.
Para obter o Client ID, o status online e o endereço IP do cliente de um dispositivo específico, consulte os dispositivos um por um usando o recurso Device Status Query descrito neste tópico:
Acesse a página Device Status Query, insira o Group ID e o Device ID do dispositivo e clique em Search.
Na aba Device status dos resultados da consulta, verifique o Client ID do dispositivo, o campo Status para o estado de conexão e o Client Address.
Se você precisar dessas informações para um grande número de dispositivos, repita a consulta para cada dispositivo individualmente. Consultas em massa com uma lista completa de Group IDs e Device IDs não são suportadas.