Inglês
Chinês
Espanhol
Russo
Francês
Alemão
Indonésio
Tailandês
Vietnamita
Árabe
Italiano
Turco
Polonês
Japonês
As falhas de conexão do gateway MQTT devem ser investigadas na primeira etapa que falha: resolução do destino, conexão de rede, TLS quando exigido, aceitação pelo broker ou permissão de mensagem. Mudar um tópico não corrige falha de negociação TLS. Preserve o erro do cliente e o registro correspondente do broker para testar a etapa correta.
Confirme o que o gateway instalado está executando
O gateway METRAVON TG451 lista MQTT entre suas funções de software, mas o modo exigido do firmware e o projeto das mensagens da plataforma ainda precisam de confirmação. Registre versão de firmware, versão MQTT, transporte, nome de servidor do broker, porta de serviço e identidade atribuída à instalação.
Confira a especificação real do serviço para TCP sem TLS, TLS ou outro transporte suportado. Não deduza a porta correta de um padrão lembrado. Confirme que o destino configurado é o ponto de conexão do broker, não o endereço do console web ou uma rota do balanceador destinada a outro serviço.
Localize as falhas de conexão MQTT nos registros
| Resultado | Etapa provável | Evidência útil |
|---|---|---|
| Nome falha | A resolução do destino não produziu endereço utilizável. | Registre nome do servidor, resultado da resolução e caminho ativo da rede sem mudar credenciais. |
| Porta falha | A conexão ao serviço solicitado não foi estabelecida. | Compare a tentativa com registros do serviço em escuta e do firewall. |
| TLS falha | A sessão segura não foi estabelecida. | Guarde o erro da negociação e verifique horário, nome de servidor e certificados exigidos. |
| Broker rejeita | O servidor retornou um resultado de conexão MQTT. | Interprete o resultado conforme a versão negociada do protocolo e o registro do broker. |
| Sem dados úteis | A aceitação da conexão não gerou o resultado esperado na aplicação. | Inspecione permissões do tópico, tratamento do conteúdo e registro de dados aceitos da plataforma. |
Corrija confiança e identidade sem contorná-las
Para TLS, confirme relógio do gateway, validade do certificado e nome de servidor. Uma autoridade certificadora privada exige a configuração apropriada de confiança. Quando TLS mútuo for exigido, estabeleça que certificado e chave privada do cliente correspondem e pertencem ao dispositivo pretendido.
Não envie chaves privadas em chamados de suporte nem desative a verificação de certificados para fazer o erro desaparecer. Peça ao responsável pelo serviço a cadeia de confiança esperada e os ajustes suportados e aplique-os pelo processo autorizado de configuração.
Identidade do cliente MQTT e permissões de publicação são questões separadas. O broker pode aceitar uma conexão e rejeitar uma operação não autorizada. Confira tópico exato, maiúsculas e minúsculas e política da conta. No MQTT 3.1.1, quando o broker aceita nova conexão com identificador de cliente já conectado, desconecta o cliente existente. Assim, dois gateways com esse identificador podem expulsar um ao outro repetidamente ao reconectar. Compare identificadores e horários de conexão do broker antes de mudar antenas ou ajustes de manutenção de sessão.
Separe publicação bem-sucedida de medição correta
O broker transporta um conteúdo; não valida inerentemente o significado de engenharia do valor do sensor. Compare uma mensagem capturada com o esquema acordado e uma leitura de origem conferida. Verifique unidades, escala, identidade da fonte e horário de aquisição antes de diagnosticar ausência de tendência como problema de conectividade.
Um PUBACK de QoS 1 confirma que o receptor MQTT aceitou responsabilidade pela mensagem, não que o banco final armazenou a medição. QoS 1 pode entregar duplicatas; QoS 2 impede entrega duplicada dentro de sua troca de protocolo, mas não certifica o processamento posterior no banco. Confira o QoS suportado pelo firmware e serviço receptor instalados e defina como a aplicação identifica e reconcilia registros repetidos. Uma mensagem retida não é um arquivo de séries temporais, e uma sessão existente não prova a disponibilidade de todas as medições anteriores.
Para sessões instáveis, compare configuração de manutenção de sessão, interrupções de rede e motivos de fechamento no servidor. Defina tentativas e manutenção de sessão pelos requisitos do serviço e condições observadas. Ciclos agressivos de tentativas podem esconder o erro original e sobrecarregar o destino.
Use comparação com cliente isolado apenas para responder a uma pergunta específica
Um cliente de teste aprovado na mesma rede ajuda a distinguir acessibilidade do serviço de problema de configuração do gateway. Dê-lhe identidade própria e tópico de teste permitido. Não duplique a identidade de um dispositivo ativo nem publique valores de teste nas medições de produção.
Registre ponto de conexão, transporte e classe de credenciais testados. Uma conexão bem-sucedida de notebook por outra rede é evidência útil, mas não verifica rota, relógio nem repositório de confiança do gateway.
Perguntas de integração MQTT
P1. Devem-se mudar tópicos quando o broker nunca aceita a sessão?
Resolva primeiro a etapa de conexão que falhou. O mapeamento normal dos tópicos de telemetria é pertinente após a aceitação, embora recursos associados à conexão possam ter requisitos próprios de política. Use o resultado real de rejeição do broker em vez de alterar campos sem relação.
P2. Autenticação bem-sucedida prova permissão para publicar?
Não. Confirme as operações autorizadas e os caminhos exatos de tópicos da conta. Depois confira o conteúdo aceito pela aplicação posterior; permissão de transporte e validação da aplicação são distintas.
P3. O que incluir em uma solicitação de suporte MQTT?
Envie modelo e firmware, versão do protocolo, transporte, ponto de conexão, horário do erro e resultados do cliente/broker sem dados sensíveis. Inclua exemplo de tópico e conteúdo com dados sensíveis removidos quando a sessão funcionar, mas os dados falharem. Exclua senhas, tokens e chaves privadas.
Resumo
Diagnostique a etapa de conexão que falhou e verifique separadamente permissões das mensagens e dados de engenharia. Solicite uma análise de configuração MQTT à METRAVON com o erro registrado e a especificação do serviço, não apenas uma captura de tela desconectada.
