Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A Atualização de Dispositivo para Hub IoT tem vários recursos que ajudam você a diagnosticar e solucionar problemas de erros do lado do dispositivo. Há três recursos de diagnóstico disponíveis:
Os códigos de erro de implantação podem ser exibidos diretamente na interface do usuário da Atualização do Dispositivo.
A Coleção de logs remotos permite a criação de operações de log, que instruem os dispositivos de destino a carregar logs de diagnóstico no dispositivo para uma conta de armazenamento de Blob do Azure vinculada.
Agent Check executa verificações de validação em dispositivos registrados na sua instância do Device Update, com o objetivo de diagnosticar dispositivos que estão registrados no IoT Hub conectado, mas não estão aparecendo no Device Update.
Códigos de erro de implantação na UI
Quando um dispositivo relata uma falha de implantação para o serviço de Atualização de Dispositivo, a interface do usuário da Atualização de Dispositivo exibe resultCode e extendedResultCode relatados do dispositivo na interface do usuário. Use as seguintes etapas para exibir estes códigos:
No portal do Azure, navegue para o 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 de 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 êxito). Para mais informações sobre como analisar códigos de resultado de processamento, consulte códigos de erro do cliente de Atualização de Dispositivo.
Observação
Se você modificou o agente de Atualização de Dispositivo para relatar códigos de resultado personalizados, os códigos numéricos continuam a ser transferidos para a interface do usuário da Atualização de Dispositivo. Em seguida, você pode consultar qualquer documentação criada para analisar esses códigos numéricos.
Coleção de logs remotos
Quando mais informações do dispositivo forem necessárias para diagnosticar e solucionar problemas de 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 para uma conta de armazenamento de Blobs 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 coleção de logs remotos da Atualização de Dispositivos é um recurso controlado por serviço 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 Blobs do Azure por meio do SDK.
Em um alto nível, o recurso de coleção de logs funciona da seguinte maneira:
Você cria uma nova operação de log usando a interface do usuário ou as APIs da Atualização de Dispositivo, tendo como destino até 100 dispositivos que tenham implementado a interface de Diagnóstico.
O serviço de atualização de dispositivo envia uma mensagem de início da coleta de logs para os dispositivos alvo usando a interface de diagnóstico. Essa mensagem inicial inclui a ID da operação de log e um token SAS para carregar para a conta de Armazenamento do Azure associada.
Ao receber a mensagem inicial, 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 da Atualização de Dispositivo está configurado para carregar o log de diagnóstico do Agente da Atualização de Dispositivo (
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 ( bem-sucedido 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á repetir automaticamente três vezes, relatando apenas o estado final de volta ao serviço.
Depois que todos os dispositivos de destino relatarem o estado do terminal de volta ao serviço da Atualização de Dispositivo, o serviço da Atualização de Dispositivo marcará a operação de log como Bem-sucedida ou Com falha. 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 registro com falha indica que pelo menos um dispositivo de destino falhou na execução do registro.
Observação
Como a operação de log é realizada em paralelo pelos dispositivos alvo, é possível que alguns dispositivos alvo carreguem logs com êxito, mas a operação de log geral esteja 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 das APIs.
Verificação do agente
Quando seu dispositivo está registrado no Hub IoT, mas não está aparecendo em sua instância de Atualização de Dispositivo, você pode usar o recurso Verificação do Agente para executar verificações de validação predefinidas para ajudá-lo a diagnosticar a causa subjacente do problema. Você pode começar a usar esse recurso seguindo estas instruções de Verificação do Agente.
De um alto nível, o recurso de verificação do agente funciona da seguinte forma:
- Registre um dispositivo no Hub IoT. Se o dispositivo relatar uma ID de Modelo que corresponda às compatíveis com a Atualização de Dispositivo para Hub IoT, a instância da Atualização de Dispositivo conectada do usuário registrará automaticamente o dispositivo com a Atualização de Dispositivo.
- 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 pelo Agent Check. Mais informações sobre esses 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 do Dispositivo ou respostas à API. Você pode usar a Verificação de Agente para localizar este dispositivo e tentar identificar quais critérios não são atendidos usando a Verificação do Agente.
- Depois de identificar quais critérios não estão sendo atendidos, você poderá corrigir o problema e o dispositivo deverá aparecer corretamente na interface de Atualização do Dispositivo.
Próximas etapas
Saiba como usar a coleção de logs remotos do Device Update e os recursos de Verificação do Agente: