Automatická správa zařízení a modulů IoT pomocí webu Azure Portal

Automatická správa zařízení v Azure IoT Hub automatizuje mnoho opakujících se a složitých úloh při správě rozsáhlých loďstva zařízení. Díky automatické správě zařízení můžete cílit na sadu zařízení na základě jejich vlastností, definovat požadovanou konfiguraci a potom nechat zařízení IoT Hub aktualizovat, když vstoupí do rozsahu. Tato aktualizace se provádí pomocí automatické konfigurace zařízení nebo automatické konfigurace modulu, která umožňuje shrnout dokončování a dodržování předpisů, zpracovávat sloučení a konflikty a nastavovat konfigurace v rámci postupného přístupu.

Automatická správa zařízení funguje tak, že aktualizuje sadu dvojitých vláken zařízení nebo nevláken modulu s požadovanými vlastnostmi a ohlásí souhrn, který vychází z nefunkčních hlášených vlastností. Zavádí nový dokument třídy a JSON s názvem Konfigurace , která má tři části:

• Podmínka cíle definuje rozsah vláken zařízení nebo nepodmíněných vláken modulu, které se mají aktualizovat. Cílová podmínka je určena jako dotaz na zdvojených značkách nebo hlášených vlastnostech.

• Cílový obsah definuje požadované vlastnosti, které se mají přidat nebo aktualizovat v cílovém zařízení vlákna nebo vlákna v modulu. Obsah zahrnuje cestu k oddílu požadovaných vlastností, které mají být změněny.

• Metriky definují Souhrnné počty různých stavů konfigurace, například úspěch, probíhá a Chyba. Vlastní metriky jsou zadány jako dotazy na nedokončené hlášené vlastnosti. Systémové metriky jsou výchozí metriky, které měří stav s dvojitou aktualizací, jako je třeba počet nezpracovaných vláken a počet úspěšně aktualizovaných vláken.

Automatické konfigurace se spouští poprvé po vytvoření konfigurace a pak v intervalu pěti minut. Dotazy na metriky se spouštějí při každém spuštění automatické konfigurace.

Implementovat vlákna

Automatická konfigurace zařízení vyžaduje, aby se při synchronizaci stavu mezi cloudem a zařízeními použily vlákna zařízení. Další informace najdete v tématu Principy a použití dvojčat zařízení ve službě IoT Hub.

Automatická konfigurace modulů vyžaduje použití vláken modulu k synchronizaci stavu mezi cloudem a moduly. Další informace najdete v tématu pochopení a použití vláken v modulu v IoT Hub.

Použití značek k cílení na vlákna

Před vytvořením konfigurace musíte určit, která zařízení nebo moduly mají mít vliv. Azure IoT Hub identifikuje zařízení a používá značky v zařízení, které jsou v práci, a identifikuje moduly pomocí značek v modulu s dvojitou signalizací. Každé zařízení nebo moduly může mít více značek a můžete je definovat jakýmkoli způsobem, který dává smysl pro vaše řešení. Pokud například spravujete zařízení v různých umístěních, přidejte do vlákna zařízení následující značky:

"tags": {
    "location": {
        "state": "Washington",
        "city": "Tacoma"
    }
},

Vytvořit konfiguraci

1. V Azure Portalpřejdete do služby IoT Hub.

2. V levém navigačním podokně vyberte Konfigurace .

3. Vyberte Přidat konfiguraci zařízení nebo Přidat konfiguraci modulu.

   

Existuje pět kroků pro vytvoření konfigurace. V následujících částech si projdete každé z nich.

Název a popisek

1. Poskytněte konfiguraci jedinečný název, který bude obsahovat až 128 malých písmen. Vyhněte se mezerám a následujícími neplatnými znaky: & ^ [ ] { } \ | " < > / .

2. Přidejte popisky, které vám pomůžou sledovat vaše konfigurace. Popisky jsou názvy, páry hodnot , které popisují vaši konfiguraci. Příkladem je HostPlatform, Linux nebo Version, 3.0.1.

3. Kliknutím na tlačítko Další přejděte k dalšímu kroku.

zadejte Nastavení

Tato část definuje obsah, který se má nastavit v nezpracovaných vlákenách zařízení nebo modulu. Pro každou sadu nastavení existují dva vstupy. První je dvojitá cesta, což je cesta k oddílu JSON v rámci vláken požadovaných vlastností, které budou nastaveny. Druhá je obsah JSON, který se má vložit do této části.

Můžete například nastavit dvojitou cestu k properties.desired.chiller-water a pak zadat následující obsah JSON:

{
  "temperature": 66,
  "pressure": 28
}

Jednotlivá nastavení můžete nastavit také zadáním celé cesty a zadáním hodnoty bez závorek. Například s nazdvojenou cestou properties.desired.chiller-water.temperature nastavte obsah na 66 . Pak vytvořte nové nastavení s dvojím nastavením pro vlastnost tlak.

Pokud dvě nebo více konfigurací cílí na stejnou cestu, bude platit obsah z konfigurace s nejvyšší prioritou (Priorita je definována v kroku 4).

Chcete-li odebrat existující vlastnost, zadejte hodnotu vlastnosti null .

Další nastavení můžete přidat tak, že vyberete možnost Přidat zdvojené zařízení nebo Přidat nastavení s dvojitým modulem.

Zadat metriky (volitelné)

Metriky poskytují souhrnné počty různých stavů, které může zařízení nebo modul nahlásit zpět po použití konfiguračního obsahu. Můžete například vytvořit metriku pro změny nastavení čekání, metriky pro chyby a metriky pro úspěšné změny nastavení.

Každá konfigurace může mít až pět vlastních metrik.

1. Zadejte název metriky.

2. Zadejte dotaz na kritéria metriky. Dotaz vychází z nezaznamenaných vlastností zařízení. Metrika představuje počet řádků vrácených dotazem.

Například:

SELECT deviceId FROM devices 
  WHERE properties.reported.chillerWaterSettings.status='pending'

Můžete zahrnout klauzuli, kterou konfigurace použila, například:

/* Include the double brackets. */
SELECT deviceId FROM devices 
  WHERE configurations.[[yourconfigname]].status='Applied'

Pokud vytváříte metriku pro vytváření sestav v konfigurovaných modulech, vyberte moduleId z devices.modules . Například:

SELECT deviceId, moduleId FROM devices.modules
  WHERE properties.reported.lastDesiredStatus.code = 200

Cílová zařízení

Pomocí vlastnosti značky z vašich vláken můžete cílit na konkrétní zařízení nebo moduly, které by měly tuto konfiguraci přijmout. Můžete také cílit na nedokončené hlášené vlastnosti.

Automatické konfigurace zařízení můžou směrovat jenom nepřesné značky zařízení a konfigurace automatických modulů můžou být jenom cílové moduly s dvojitými značkami.

Vzhledem k tomu, že více konfigurací může cílit na stejné zařízení nebo modul, každá konfigurace potřebuje číslo priority. Pokud dojde ke konfliktu, konfigurace s nejvyšší prioritou je služba WINS.

1. Jako prioritu konfigurace zadejte kladné celé číslo. Nejvyšší číselná hodnota je považována za nejvyšší prioritu. Pokud mají dvě konfigurace stejné číslo priority, ten, který byl vytvořen naposledy službou WINS.

2. Zadejte cílovou podmínku pro určení, která zařízení nebo moduly budou cílem této konfigurace. Podmínka je založena na nepodmíněných značkách nebo ve dvojitě hlášených vlastnostech a měla by odpovídat formátu výrazu.

   Pro automatickou konfiguraci zařízení můžete určit, že chcete cílit jenom na značku, nebo na vlastnost hlášeno. Příkladem je tags.environment='test' nebo properties.reported.chillerProperties.model='4000x'. Můžete nastavit * cílení na všechna zařízení.

   Pro automatickou konfiguraci modulu použijte dotaz k zadání značek nebo hlášených vlastností z modulů registrovaných ve službě IoT Hub. Příkladem je from devices.modules where tags.environment='test' nebo from devices.modules where properties.reported.chillerProperties.model='4000x'. Zástupný znak nelze použít pro cílení na všechny moduly.

3. Kliknutím na tlačítko Další přejdete k poslednímu kroku.

Kontrola konfigurace

Zkontrolujte informace o konfiguraci a pak vyberte Odeslat.

Monitorování konfigurace

Pokud chcete zobrazit podrobnosti o konfiguraci a monitorovat zařízení, která ho používají, použijte následující postup:

1. V Azure Portalpřejdete do služby IoT Hub.

2. Vyberte Konfigurace zařízení IoT.

3. Zkontrolujte seznam konfigurací. Pro každou konfiguraci můžete zobrazit následující podrobnosti:

   • ID – název konfigurace.

   • Podmínka cíle – dotaz, který slouží k definování cílových zařízení nebo modulů.

   • Priorita – číslo priority přiřazené ke konfiguraci.

   • Čas vytvoření – časové razítko z doby, kdy byla konfigurace vytvořena. Toto časové razítko se používá k přerušení vztahů, pokud mají dvě konfigurace stejnou prioritu.

   • Systémové metriky – metriky, které jsou vypočítány IoT Hub a nemohou být upravovány vývojáři. Cíl Určuje počet vláken zařízení, která odpovídají cílové podmínce. Použije zadaný počet nevláken zařízení, která byla upravena konfigurací, což může zahrnovat částečné změny v případě, že se změnila samostatná konfigurace s vyšší prioritou.

   • Vlastní metriky – metriky, které vývojář zadal jako dotazy na hlášené vlastnosti dvojčete. Pro každou konfiguraci je možné definovat až pět vlastních metrik.

4. Vyberte konfiguraci, kterou chcete monitorovat.

5. Zkontrolujte podrobnosti o konfiguraci. Pomocí karet můžete zobrazit konkrétní podrobnosti o zařízeních, která konfiguraci přijali.

   • Cílová podmínka – zařízení nebo moduly, které odpovídají cílové pod podmínkě.

   • Metriky – seznam systémových metrik a vlastních metrik. Seznam zařízení nebo modulů, které se počítají pro jednotlivé metriky, můžete zobrazit tak, že vyberete metriku v rozevíracím seznamu a pak vyberete Zobrazit zařízení nebo Zobrazit moduly.

   • Device Twin Nastavení nebo Module Twin Nastavení – nastavení dvojčete nastavená konfigurací.

   • Popisky konfigurace – páry klíč-hodnota používané k popisu konfigurace. Popisky nemají žádný vliv na funkčnost.

Úprava konfigurace

Když upravíte konfiguraci, změny se okamžitě replikují do všech cílových zařízení nebo modulů.

Pokud aktualizujete cílovou podmínku, dojde k následujícím aktualizacím:

• Pokud dvojče nesplňuje starou cílovou podmínku, ale splňuje novou cílovou podmínku a tato konfigurace má pro toto dvojče nejvyšší prioritu, použije se tato konfigurace.

• Pokud dvojče, které právě tuto konfiguraci používá, nesplňuje cílovou podmínku, nastavení z konfigurace se odebere a dvojče se upravuje podle další konfigurace s nejvyšší prioritou.

• Pokud dvojče, které právě tuto konfiguraci používá, nesplňuje cílovou podmínku a nesplňuje cílovou podmínku žádné jiné konfigurace, nastavení z konfigurace se odebere a u dvojčete nebudou provedeny žádné další změny.

Pokud chcete upravit konfiguraci, postupujte následovně:

1. V Azure Portalpřejděte do svého centra IoT.

2. Vyberte Konfigurace zařízení IoT.

3. Vyberte konfiguraci, kterou chcete upravit.

4. Proveďte aktualizace následujících polí:

   • Cílová podmínka
   • Popisky
   • Priorita
   • Metriky

5. Vyberte Uložit.

6. Postupujte podle kroků v části Monitorování konfigurace a sledujte, jak se změny zakují.

Odstranění konfigurace

Když odstraníte konfiguraci, budou mít jakákoli dvojčata zařízení další konfiguraci s nejvyšší prioritou. Pokud dvojčata zařízení nesplňuje cílovou podmínku žádné jiné konfigurace, pak se žádná další nastavení neudá.

1. V Azure Portalpřejděte do svého centra IoT.

2. Vyberte Konfigurace zařízení IoT.

3. Pomocí zaškrtávacího políčka vyberte konfiguraci, kterou chcete odstranit.

4. Vyberte Odstranit.

5. Zobrazí se výzva k potvrzení.

Další kroky

V tomto článku jste zjistili, jak nakonfigurovat a monitorovat zařízení IoT ve velkém měřítku. Další informace o správě těchto Azure IoT Hub:

• Hromadná správa identit zařízení služby IoT Hub
• Monitorování IoT Hubu

Další informace o možnostech této IoT Hub najdete v těchto tématu:

• IoT Hub příručka pro vývojáře
• Nasazení AI do hraničních zařízení s použitím Azure IoT Edge

Pokud chcete prozkoumat IoT Hub Device Provisioning Service a umožnit tak bez problémů zřizování za běhu, projděte si následující:

• Služba Azure IoT Hub Device Provisioning