Localizar e corrigir dispositivos ausentes da Atualização de Dispositivo para o Hub IoT usando a verificação do agente

Saiba como usar o recurso de verificação de agente para localizar, diagnosticar e corrigir dispositivos ausentes na instância do Hub IoT da Atualização de Dispositivo.

Pré-requisitos

• Acesso a um Hub IoT com a Atualização de Dispositivo para o Hub IoT habilitada.
• Um dispositivo IoT (ou simulador) provisionado para Atualização de Dispositivo e relatório de um ID de modelo Plug and Play (PnP) compatível.

Nota

O recurso de verificação de agente só pode executar verificações de validação em dispositivos que tenham o agente de Atualização de Dispositivo instalado e estejam relatando um ID de modelo PnP que corresponda aos compatíveis com a Atualização de Dispositivo para Hub IoT.

Portal do Azure

Browsers suportados:

• Microsoft Edge
• Google Chrome

CLI do Azure

Um ambiente da CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell.

  

• Ou, se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure

  1. Entre na CLI do Azure usando o comando az login .
  2. Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
  3. Quando solicitado, instale as extensões da CLI do Azure na primeira utilização. Os comandos neste artigo usam a extensão azure-iot . Execute az extension update --name azure-iot para se certificar de que está a utilizar a versão mais recente da extensão.

Verificações de validação suportadas pela verificação do agente

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

Verificação de validação	Critérios
ID do modelo PnP	O ID do modelo PnP é uma cadeia de caracteres que é relatada pelo agente de Atualização de Dispositivo para o gêmeo do dispositivo que descreve qual modelo PnP deve ser usado para comunicação dispositivo/nuvem. Essa cadeia de caracteres deve ser um identificador de modelo de gêmeo digital (DTMI) válido que suporte a interface de Atualização de Dispositivo.
Interface ID	O ID da interface é uma cadeia de caracteres que é relatada pelo agente de Atualização de Dispositivo para o gêmeo de dispositivo que descreve qual versão da interface de Atualização de Dispositivo deve ser usada para comunicação dispositivo/nuvem. Essa cadeia de caracteres deve ser uma DTMI válida que suporte a interface de Atualização de Dispositivo.
Nomes de propriedades de compatibilidade	CompatPropertyNames é um campo relatado pelo agente de Atualização de Dispositivo para o gêmeo de dispositivo que descreve quais deviceProperties campos devem ser usados para determinar a compatibilidade do dispositivo com uma determinada implantação. O valor deste campo deve ser uma cadeia de nomes delimitados por vírgula. A cadeia de caracteres deve conter pelo menos um e não mais de cinco nomes. Cada nome deve ter <32 caracteres.
Valores de propriedade de compatibilidade	Os valores de propriedade de compatibilidade são os pares campo:valor especificados pelo compatPropertyNames campo e relatados pelo agente de Atualização de Dispositivo para o gêmeo do dispositivo como deviceProperties. Cada nome definido em nomes de propriedade de compatibilidade deve ter um par field:value correspondente relatado. O valor para cada par é limitado a 64 caracteres.
Grupo ADU	A tag Grupo ADU é uma tag opcional que é definida no gêmeo de dispositivo do dispositivo e determina a qual grupo de dispositivos o dispositivo pertence. Se especificado, a cadeia de caracteres da tag é limitada a 255 caracteres e pode conter apenas caracteres alfanuméricos e os seguintes caracteres especiais: "." "-" "_" "~"

Se um dispositivo falhar em qualquer um desses critérios, ele pode não aparecer corretamente na Atualização de dispositivo. Corrigir o valor inválido para atender aos critérios especificados deve fazer com que o dispositivo apareça corretamente na Atualização de dispositivo. Se o dispositivo não aparecer na Atualização de Dispositivo nem na verificação do agente, talvez seja necessário executar a sincronização do dispositivo para resolver o problema.

Ver resultados da verificação do agente

Portal do Azure

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

1. No Portal do Azure, navegue para o seu hub IoT.
2. Selecione Atualizações no menu de navegação e, em seguida, selecione a guia Diagnóstico .
3. Expanda a seção Localizar dispositivos ausentes .

CLI do Azure

Use a lista de integridade do dispositivo az iot du para visualizar a integridade dos seus dispositivos.

O device health list comando usa os seguintes argumentos:

• --account: O nome da conta de Atualização de Dispositivo.
• --instance: O nome da instância de Atualização de Dispositivo.
• --filter: Um filtro de integridade do dispositivo, filtrando no estado do dispositivo ou na ID do dispositivo. Por exemplo:
  • Para listar todos os dispositivos íntegros, filtre por state eq 'Healthy'
  • Para listar todos os dispositivos não íntegros, filtre por state eq 'Unhealthy'
  • Para mostrar o estado de integridade de um dispositivo de destino, filtre por deviceId eq '<device_name>' ou deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

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

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

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

Portal do Azure

1. No Portal do Azure, navegue para o seu hub IoT.
2. Selecione Atualizações no menu de navegação e, em seguida, selecione a guia Diagnóstico .
3. Expanda a seção Exibir integridade do dispositivo.
4. Selecione Iniciar uma sincronização de dispositivo.

CLI do Azure

Use az iot du device import para importar dispositivos e módulos para a instância de Atualização de Dispositivo de um hub IoT vinculado.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Próximos passos

Para saber mais sobre os recursos de diagnóstico da Atualização de Dispositivo, consulte Visão geral do recurso de diagnóstico de Atualização de dispositivo