Descrição geral do diagnóstico da Atualização de Dispositivos para Hub IoT
A Atualização de Dispositivos para Hub IoT tem várias funcionalidades que o ajudam a diagnosticar e resolver erros do lado do dispositivo. Com o lançamento do agente v0.9.0, existem três funcionalidades de diagnóstico disponíveis:
Os códigos de erro de implementação podem ser visualizados diretamente na interface de utilizador da Atualização de Dispositivos
A recolha de registos remotos permite a criação de operações de registo, que instruim os dispositivos visados a carregar registos de diagnósticos no dispositivo para uma conta de armazenamento de Blobs do Azure associada
A Verificação de Agente executa verificações de validação em dispositivos registados na instância da Atualização de Dispositivos com o objetivo de diagnosticar dispositivos registados no Hub IoT ligado, mas não aparecem na Atualização de Dispositivos
Códigos de erro de implementação na IU
Quando um dispositivo comunica uma falha de implementação no serviço de Atualização de Dispositivos, a interface de utilizador da Atualização de Dispositivos apresenta o dispositivo comunicado resultCode e extendedResultCode na interface de utilizador. Utilize os seguintes passos para ver estes códigos:
Na portal do Azure, navegue para o seu hub IoT.
Selecione Atualizações e, em seguida, navegue para o separador Grupos e Implementações.
Selecione o nome de um grupo com uma implementação ativa para aceder à página Detalhes do grupo .
Selecione qualquer nome de dispositivo na lista Dispositivo para abrir o painel de detalhes do dispositivo. Aqui, pode ver o código de resultado que o dispositivo comunicou.
O agente de referência da Atualização de Dispositivos segue a convenção de código de estado HTTP padrão para o campo de código de resultado (por exemplo, "200" indica êxito). Para obter mais informações sobre como analisar códigos de resultado, veja Códigos de erro do cliente da Atualização de Dispositivos.
Nota
Se tiver modificado o agente de Atualização de Dispositivos para comunicar códigos de resultados personalizados, os códigos numéricos continuarão a ser transmitidos para a interface de utilizador da Atualização de Dispositivos. Em seguida, pode consultar qualquer documentação que tenha criado para analisar estes códigos numéricos.
Recolha de registos remotos
Quando forem necessárias mais informações do dispositivo para diagnosticar e resolver um erro, pode utilizar a funcionalidade de recolha de registos para instruir os dispositivos visados a carregar registos de diagnósticos no dispositivo para uma conta de armazenamento de Blobs do Azure ligada. Pode começar a utilizar esta funcionalidade ao seguir as instruções em Recolher remotamente registos de diagnóstico de dispositivos.
A coleção de registos remotos da Atualização de Dispositivos é uma funcionalidade baseada em operações condicionada por serviço. Para tirar partido da recolha de registos , um dispositivo só precisa de ser capaz de implementar a interface de diagnóstico e o ficheiro de configuração e de poder carregar ficheiros para o armazenamento de Blobs do Azure através do SDK.
A partir de um nível elevado, a funcionalidade de recolha de registos funciona da seguinte forma:
O utilizador cria uma nova operação de registo com a interface de utilizador ou APIs de Atualização de Dispositivos, direcionadas para até 100 dispositivos que implementaram a interface de Diagnóstico.
O serviço Atualização de Dispositivos envia uma mensagem de início de recolha de registos para os dispositivos visados através da interface de Diagnóstico. Esta mensagem de início inclui o ID da operação de registo e um token de SAS para carregamento para a conta de Armazenamento do Azure associada.
Após receber a mensagem de início, o agente de Atualização de Dispositivos do dispositivo de destino tenta recolher e carregar os ficheiros nos caminhos de ficheiros predefinidos especificados no ficheiro de configuração do agente no dispositivo. O agente de referência da Atualização de Dispositivos está configurado para carregar o registo de diagnóstico do agente de Atualização de Dispositivos (
aduc.log) e o registo de diagnóstico do Agente DO ("do-agent.log") por predefinição.Em seguida, o agente de Atualização de Dispositivos comunica o estado da operação ( com Êxito ou Com Falha) de volta ao serviço, incluindo o ID da operação de registo, um ResultCode e um ExtendedResultCode. Se o agente de Atualização de Dispositivos falhar uma operação de registo, tentará automaticamente repetir três vezes, reportando apenas o estado final ao serviço.
Depois de todos os dispositivos visados comunicarem o respetivo estado de terminal ao serviço Atualização de Dispositivos, o serviço Atualização de Dispositivos marca a operação de registo como Bem-sucedida ou Falhada. Uma operação de registo bem-sucedida indica que todos os dispositivos visados concluíram com êxito a operação de registo. Uma operação de registo falhada indica que pelo menos um dispositivo visado falhou na operação de registo.
Nota
Uma vez que a operação de registo é realizada em paralelo pelos dispositivos visados, é possível que alguns dispositivos visados carreguem registos com êxito, mas a operação de registo geral é marcada como falhada. Pode ver que dispositivos foram bem-sucedidos e que falharam ao ver os detalhes da operação de registo através da interface de utilizador ou das APIs.
Verificação do Agente
Quando o dispositivo está registado no Hub IoT mas não aparece na instância de Atualização de Dispositivos, pode utilizar a funcionalidade Verificação de Agente para executar verificações de validação pré-criadas para o ajudar a diagnosticar o problema subjacente. Pode começar a utilizar esta funcionalidade ao seguir estas instruções de Verificação do Agente.
A partir de um nível elevado, a funcionalidade de verificação do agente funciona da seguinte forma:
O utilizador regista um dispositivo com Hub IoT. Se o dispositivo indicar um ID de Modelo que corresponda aos compatíveis com a Atualização de Dispositivos para Hub IoT, a instância de Atualização de Dispositivos ligada do utilizador registará automaticamente o dispositivo com a Atualização de Dispositivos.
Para que um dispositivo seja gerido corretamente pela Atualização de Dispositivos, tem de cumprir determinados critérios que podem ser verificados através das verificações de validação pré-efetuadas da Verificação de Agente. Pode encontrar mais informações sobre estes critérios aqui.
Se um dispositivo não cumprir todos estes critérios, não pode ser gerido corretamente pela Atualização de Dispositivos e não será apresentado na interface de Atualização de Dispositivos ou nas respostas da API. Os utilizadores podem utilizar a Verificação de Agente para localizar este dispositivo e tentar identificar que critérios não estão a ser cumpridos através da Verificação de Agente.
Depois de o utilizador identificar quais os critérios que não estão a ser cumpridos, o utilizador pode corrigir o problema e o dispositivo deverá aparecer corretamente na interface de Atualização de Dispositivos.
Passos seguintes
Saiba como utilizar a coleção de registos remotos da Atualização de Dispositivos e as funcionalidades de Verificação de Agente: