Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A Atualização de Dispositivo para o Hub IoT tem vários recursos que ajudam a diagnosticar e solucionar erros do lado do dispositivo. Há três recursos de diagnóstico disponíveis:
Os códigos de erro de implantação podem ser visualizados diretamente na interface do usuário da Atualização de Dispositivo.
A recolha remota de logs permite a criação de operações de log, que instruem os dispositivos de destino a carregar os logs de diagnóstico do dispositivo para uma conta vinculada de armazenamento Blob do Azure.
A Verificação de Agente executa verificações de validação em dispositivos registrados em sua instância de Atualização de Dispositivo com o objetivo de diagnosticar dispositivos que estão registrados no Hub IoT conectado, mas não estão aparecendo na Atualização de Dispositivo.
Códigos de erro de implantação na interface do usuário
Quando um dispositivo relata uma falha de implantação para o serviço de Atualização de Dispositivo, a interface do usuário de Atualização de Dispositivo exibe o relatório resultCode do dispositivo e extendedResultCode na interface do usuário. Use as seguintes etapas para exibir esses códigos:
No Portal do Azure, navegue para o seu hub IoT.
Selecione Atualizações e navegue até a guia Grupos e Implantações .
Selecione o nome de um grupo com uma implantação ativa para acessar a página Detalhes do grupo .
Selecione qualquer nome de dispositivo na lista Dispositivo para abrir o painel de detalhes do dispositivo. Aqui você pode ver o código de resultado que o dispositivo relatou.
O agente de referência de Atualização de Dispositivo segue a convenção de código de status HTTP padrão para o campo de código de resultado (por exemplo, "200" indica sucesso). Para obter mais informações sobre como analisar códigos de resultado, consulte Códigos de erro do cliente de Atualização de Dispositivo.
Observação
Se você tiver modificado seu agente de Atualização de Dispositivo para relatar códigos de resultado personalizados, os códigos numéricos ainda serão passados para a interface do usuário de Atualização de Dispositivo. Em seguida, você pode consultar qualquer documentação criada para analisar esses códigos numéricos.
Recolha remota de logs
Quando mais informações do dispositivo forem necessárias para diagnosticar e solucionar um erro, você poderá usar o recurso de coleta de logs para instruir os dispositivos de destino a carregar logs de diagnóstico no dispositivo em uma conta de armazenamento de Blob do Azure vinculada. Você pode começar a usar esse recurso seguindo as instruções em Coletar remotamente logs de diagnóstico de dispositivos.
A coleta de logs remotos da Atualização de Dispositivo é um recurso orientado a serviços e baseado em operação. Para aproveitar a coleta de logs, um dispositivo só precisa ser capaz de implementar a interface de Diagnóstico e o arquivo de configuração e ser capaz de carregar arquivos no armazenamento de Blob do Azure por meio do SDK.
A partir de um nível alto, o recurso de coleta de logs funciona da seguinte maneira:
Você cria uma nova operação de log usando a interface de utilizador ou as APIs do Device Update, direcionada a até 100 dispositivos que implementaram a interface de Diagnóstico.
O serviço de Atualização de Dispositivo envia uma mensagem de início de coleta de logs para os dispositivos de destino usando a interface de Diagnóstico. Esta mensagem inicial inclui o ID da operação de registo e um token SAS para carregar na conta de Armazenamento Azure associada.
Ao receber a mensagem de início, o agente de Atualização de Dispositivo do dispositivo de destino tenta coletar e carregar os arquivos em um ou mais caminhos de arquivo predefinidos especificados no arquivo de configuração do agente no dispositivo. O agente de referência do Device Update está configurado para carregar o log de diagnóstico do agente do Device Update (
aduc.log) e o log de diagnóstico do Agente DO ("do-agent.log") por padrão.Em seguida, o agente de Atualização de Dispositivo relata o estado da operação ( com êxito ou com falha) de volta ao serviço, incluindo a ID da operação de log, um ResultCode e um ExtendedResultCode. Se o agente de Atualização de Dispositivo falhar em uma operação de log, ele tentará automaticamente repetir três vezes, relatando apenas o estado final de volta ao serviço.
Depois de todos os dispositivos de destino terem relatado o seu estado final de volta ao serviço de Atualização de Dispositivo, o serviço de Atualização de Dispositivo marcará uma operação de registo como Concluída ou Falhada. Uma operação de log bem-sucedida indica que todos os dispositivos de destino concluíram com êxito a operação de log. Uma operação de registo falhada indica que pelo menos um equipamento de destino falhou na operação de registo.
Observação
Como a operação de log é realizada em paralelo pelos dispositivos de destino, é possível que alguns dispositivos de destino tenham carregado logs com êxito, mas a operação de log geral é marcada como falha. Você pode ver quais dispositivos foram bem-sucedidos e quais falharam exibindo os detalhes da operação de log por meio da interface do usuário ou APIs.
Verificação do agente
Quando seu dispositivo está registrado no Hub IoT, mas não aparece na instância de Atualização de Dispositivo, você pode usar o recurso Verificação de Agente para executar verificações de validação pré-feitas para ajudá-lo a diagnosticar o problema subjacente. Você pode começar a usar esse recurso seguindo estas instruções de verificação de agente.
A partir de um nível alto, o recurso de verificação do agente funciona da seguinte maneira:
- Você registra um dispositivo com o Hub IoT. Se o dispositivo relatar uma ID de Modelo que corresponda às compatíveis com o Device Update para IoT Hub, a sua instância de Device Update conectada registrará automaticamente o dispositivo com o Device Update.
- Para que um dispositivo seja gerenciado corretamente pela Atualização de Dispositivo, ele deve atender a determinados critérios que podem ser verificados usando as verificações de validação pré-feitas do Agent Check. Mais informações sobre estes critérios podem ser encontradas aqui.
- Se um dispositivo não atender a todos esses critérios, ele não poderá ser gerenciado corretamente pela Atualização de Dispositivo e não aparecerá na interface de Atualização de Dispositivo ou nas respostas da API. Pode-se usar o Agent Check para localizar este dispositivo e tentar identificar quais critérios não foram cumpridos usando o Agent Check.
- Depois de identificar quais critérios não estão sendo atendidos, você pode corrigir o problema e o dispositivo deve aparecer corretamente na interface de Atualização de Dispositivo.
Próximos passos
Saiba como usar os recursos de coleta de log remoto e verificação de agente da atualização de dispositivo: