Vyhledání a oprava chybějících zařízení ve službě Device Update pro IoT Hub pomocí kontroly agenta

Zjistěte, jak pomocí funkce kontroly agenta vyhledat, diagnostikovat a opravit zařízení, která v instanci služby Device Update for IoT Hub chybí.

Požadavky

• Přístup ke službě IoT Hub s povolenou službou Device Update pro IoT Hub
• Zařízení IoT (nebo simulátor) zřízené pro službu Device Update a generování sestav kompatibilního ID modelu technologie Plug and Play (PnP).

Poznámka:

Funkce kontroly agenta může provádět pouze kontroly ověření na zařízeních s nainstalovaným agentem Device Update a hlásí ID modelu PnP, které odpovídá těm, které jsou kompatibilní se službou Device Update pro IoT Hub.

Azure Portal

Podporované prohlížeče:

• Microsoft Edge
• Google Chrome

Azure CLI

Prostředí Azure CLI:

• Použijte prostředí Bash v Azure Cloud Shellu.

  

• Nebo pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI.

  1. Přihlaste se k Azure CLI pomocí příkazu az login .
  2. Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
  3. Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Příkazy v tomto článku používají rozšíření azure-iot . Spusťte, az extension update --name azure-iot abyste měli jistotu, že používáte nejnovější verzi rozšíření.

Kontroly ověření podporované kontrolou agenta

Funkce kontroly agenta v současné době provádí následující kontroly ověření na všech zařízeních, která splňují výše uvedené požadavky.

Ověření	Kritéria
ID modelu PnP	ID modelu PnP je řetězec, který je hlášen agentem aktualizace zařízení dvojčeti zařízení, které popisuje, jaký model PnP by se měl použít pro komunikaci zařízení nebo cloudu. Tento řetězec musí být platným identifikátorem modelu digitálního dvojčete (DTMI), který podporuje rozhraní Device Update.
ID rozhraní	ID rozhraní je řetězec, který hlásí agent Device Update dvojčeti zařízení, který popisuje verzi rozhraní služby Device Update, která se má použít pro komunikaci zařízení nebo cloudu. Tento řetězec musí být platný DTMI, který podporuje rozhraní Device Update.
Názvy vlastností kompatibility	CompatPropertyNames je pole hlášené agentem device Update dvojčeti zařízení, které popisuje, která deviceProperties pole by se měla použít k určení kompatibility zařízení s daným nasazením. Hodnota tohoto pole musí být řetězec názvů oddělených čárkami. Řetězec musí obsahovat alespoň jeden a maximálně pět názvů. Každý název musí mít <32 znaků.
Hodnoty vlastností kompatibility	Hodnoty vlastností kompatibility jsou páry field:value určené polem compatPropertyNames a hlášené agentem Device Update dvojčeti zařízení jako deviceProperties. Každý název definovaný v názvech vlastností kompatibility musí obsahovat odpovídající dvojici polí:hodnota. Hodnota každého páru je omezená na 64 znaků.
Skupina ADU	Značka skupiny ADU je volitelná značka definovaná ve dvojčeti zařízení a určuje, do které skupiny zařízení zařízení patří. Pokud je zadán, řetězec značky je omezen na 255 znaků a může obsahovat pouze alfanumerické znaky a následující speciální znaky: ". "-" "_" "~"

Pokud některé z těchto kritérií zařízení selže, nemusí se ve službě Device Update správně zobrazit. Oprava neplatné hodnoty tak, aby splňovala zadaná kritéria, by měla způsobit správné zobrazení zařízení ve službě Device Update. Pokud se zařízení nezobrazuje ve službě Device Update ani v kontrole agenta, možná budete muset spustit synchronizaci zařízení, abyste mohli tento problém vyřešit.

Zobrazení výsledků kontroly agenta

Azure Portal

Výsledky kontroly agenta najdete na kartě Diagnostika aktualizace zařízení.

1. Na webu Azure Portal přejděte do svého centra IoT.
2. V navigační nabídce vyberte Aktualizace a pak vyberte kartu Diagnostika.
3. Rozbalte část Najít chybějící zařízení.

Azure CLI

Pomocí příkazu az iot du device health list zobrazte stav vašich zařízení.

Příkaz device health list přijímá následující argumenty:

• --account: Název účtu Device Update.
• --instance: Název instance služby Device Update.
• --filter: Filtr stavu zařízení, buď filtrující stav zařízení, nebo ID zařízení. Příklad:
  • Pokud chcete zobrazit seznam všech zařízení, která jsou v pořádku, vyfiltrujte podle state eq 'Healthy'
  • Pokud chcete zobrazit seznam všech zařízení, která nejsou v pořádku, vyfiltrujte podle state eq 'Unhealthy'
  • Zobrazení stavu cílového zařízení, filtrování podle deviceId eq '<device_name>' nebo 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>"

Zahájení operace synchronizace zařízení

Synchronizace zařízení by se měla aktivovat, pokud je zařízení zaregistrované v Centru IoT, ale nezobrazuje se ve službě Device Update ani ve výsledcích kontroly agenta.

Pro každou instanci služby Device Update může být aktivní vždy jenom jedna operace synchronizace zařízení.

Azure Portal

1. Na webu Azure Portal přejděte do svého centra IoT.
2. V navigační nabídce vyberte Aktualizace a pak vyberte kartu Diagnostika.
3. Rozbalte část Zobrazit stav zařízení.
4. Vyberte Spustit synchronizaci zařízení.

Azure CLI

Pomocí příkazu az iot du device import můžete importovat zařízení a moduly do instance služby Device Update z propojeného centra IoT.

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

Další kroky

Další informace o možnostech diagnostiky služby Device Update najdete v tématu Přehled funkcí diagnostiky aktualizací zařízení.