Encontre e conserte dispositivos ausentes no Device Update for Hub IoT usando a verificação de agentes

Aprenda a usar o recurso de verificação de agentes para encontrar, diagnosticar e corrigir dispositivos ausentes na sua instância de Atualização de Dispositivos para Hub IoT.

Pré-requisitos

Observação

O recurso de verificação do agente só pode realizar verificações de validação em dispositivos que possuem o agente Device Update instalado e estejam reportando um ID de modelo PnP que corresponde aos compatíveis com o Device Update for Hub IoT.

Navegadores com suporte:

Verificações de validação suportadas pelo Agent Check

O recurso de verificação do agente atualmente realiza as seguintes verificações de validação em todos os dispositivos que atendem aos pré-requisitos acima.

Verificação de validação Criteria
ID do modelo PnP O ID do modelo PnP é uma string que é reportada pelo agente de Atualização de Dispositivo ao dispositivo gêmeo que descreve qual modelo PnP deve ser usado para comunicação entre dispositivo e nuvem. Essa cadeia de caracteres deve ser um identificador válido de modelo de gêmeo digital (DTMI) que ofereça suporte à interface Device Update.
Interface ID O ID de interface é uma cadeia de caracteres informada pelo agente do Device Update ao dispositivo gêmeo, que descreve qual versão da interface do Device Update deve ser usada na comunicação entre o dispositivo e a nuvem. Essa string deve ser um DTMI válido que suporte a interface de Atualização de Dispositivo.
Nomes das propriedades de compatibilidade CompatPropertyNames é um campo que o agente de Atualização de Dispositivo reporta ao dispositivo gêmeo. Ele descreve quais deviceProperties campos usar para determinar a compatibilidade do dispositivo com uma determinada implantação. O valor desse campo deve ser uma sequência de nomes delimitados por vírgulas. A sequência deve conter pelo menos um e não mais que cinco nomes. Cada nome deve ter menos de 32 caracteres.
Valores de propriedades de compatibilidade Os valores da propriedade de compatibilidade são os pares campo:valor especificados pelo campo compatPropertyNames e informados pelo agente do Device Update ao gêmeo do dispositivo na forma de deviceProperties. Todo nome definido em nomes de propriedades de compatibilidade deve ter um par campo:valor correspondente reportado. O valor de cada par é limitado a 64 caracteres.
Grupo ADU ADU Group é uma tag opcional que você define no gêmeo digital do dispositivo. Ele determina a qual grupo de dispositivos o dispositivo pertence. Se especificado, a string de tag é limitada a 255 caracteres e só pode conter caracteres alfanuméricos e os seguintes caracteres especiais: "." "-" "_" "~"

Se um dispositivo não cumprir algum desses critérios, pode não aparecer corretamente na Atualização do Dispositivo. Corrigir o valor inválido para atender aos critérios especificados deve fazer com que o dispositivo apareça corretamente em Atualização do Dispositivo. Se o dispositivo não aparecer na Atualização do Dispositivo nem na verificação do agente, talvez você precise executar a sincronização do dispositivo para resolver o problema.

Ver resultados da verificação do agente

Os resultados da verificação do agente podem ser encontrados na aba de diagnóstico de Atualização do Dispositivo.

  1. No Azure portal, navegue até o hub IoT.
  2. Selecione Atualizações no menu de navegação, depois selecione a aba Diagnósticos .
  3. Expanda a seção Encontrar dispositivos faltando .

Iniciar uma operação de sincronização de dispositivo

A sincronização de dispositivos deve ser acionada se um dispositivo foi registrado no hub IoT, mas não aparece na Atualização do Dispositivo nem nos resultados da verificação do agente.

Apenas uma operação de sincronização de dispositivo pode estar ativa por vez para cada instância de Atualização de Dispositivo.

  1. No Azure portal, navegue até o hub IoT.
  2. Selecione Atualizações no menu de navegação, depois selecione a aba Diagnósticos .
  3. Expanda a seção Ver estado do dispositivo.
  4. Selecione Iniciar sincronização de dispositivo.

Próximas Etapas 

Para saber mais sobre as capacidades de diagnóstico do Device Update, veja a visão geral do recurso de diagnóstico de atualização de dispositivos

  • Última atualização em