Hromadná správa zařízení v aplikaci Azure IoT Central
Azure IoT Central můžete použít ke správě připojených zařízení ve velkém měřítku prostřednictvím úloh. Úlohy umožňují hromadně aktualizovat vlastnosti zařízení a cloudu a spouštět příkazy. V tomto článku se dozvíte, jak používat úlohy ve vlastní aplikaci a jak používat funkce importu a exportu.
Informace o správě úloh pomocí rozhraní IoT Central REST API najdete v tématu Použití rozhraní IOT Central REST API ke správě zařízení.
Tip
Když vytvoříte opakovanou úlohu, přihlaste se k aplikaci pomocí účtu Microsoft nebo účtu Microsoft Entra. Pokud se přihlásíte pomocí skupiny Microsoft Entra, je možné, že token Microsoft Entra přidružený ke skupině vyprší v určitém okamžiku v budoucnu a způsobí selhání úlohy.
Vytvoření a spuštění úlohy
Následující příklad ukazuje, jak vytvořit a spustit úlohu pro nastavení prahové hodnoty světla pro skupinu zařízení. Pomocí průvodce úloh můžete vytvářet a spouštět úlohy. Úlohu, kterou chcete spustit později, můžete uložit:
V levém podokně vyberte Úlohy.
Vyberte + Nové.
Na stránce Konfigurace úlohy zadejte název a popis, který identifikuje úlohu, kterou vytváříte.
Pokud vaše aplikace používá organizace, vyberte organizaci, ke které chcete úlohu přidružit. Úlohu můžou zobrazit nebo upravit jenom uživatelé v organizaci. Role uživatele určuje oprávnění, která má uživatel.
Vyberte cílovou skupinu zařízení, na kterou chcete úlohu použít. Pokud vaše aplikace používá organizace, vybraná organizace určí dostupné skupiny zařízení. Uvidíte, kolik zařízení se konfigurace vaší úlohy týká, pod výběrem skupiny zařízení.
Jako typ úlohy zvolte Vlastnost cloudu, Vlastnost, Příkaz, Změnit šablonu zařízení nebo Změnit manifestnasazení Edge. Konfigurace:
- Úloha vlastnosti , vyberte vlastnost a nastavte její novou hodnotu. Úloha vlastnosti může nastavit více vlastností.
- Příkazová úloha, zvolte příkaz, který chcete spustit.
- Změňte úlohu šablony zařízení, vyberte šablonu zařízení, která se přiřadí zařízením ve skupině zařízení.
- Změňte úlohu manifestu nasazení Edge, vyberte manifest nasazení IoT Edge, který se přiřadí zařízením IoT Edge ve skupině zařízení.
Výběrem možnosti Uložit a ukončit přidáte úlohu do seznamu uložených úloh na stránce Úlohy . Později se můžete k úloze vrátit ze seznamu uložených úloh.
Výběrem možnosti Další přejděte na stránku Možnosti doručení. Stránka Možnosti doručení umožňuje nastavit možnosti doručení prahové hodnoty dávky a zrušení pro tuto úlohu:
Dávky umožňují rozmísťovat úlohy pro velký počet zařízení. Úloha je rozdělena do několika dávek a každá dávka obsahuje podmnožinu zařízení. Dávky se zařadí do fronty a spustí se postupně.
Prahová hodnota zrušení umožňuje automaticky zrušit úlohu, pokud počet chyb překročí nastavený limit. Prahová hodnota se může vztahovat na všechna zařízení v úloze nebo na jednotlivé dávky.
Výběrem možnosti Další přejdete na stránku Plán . Na stránce Plán můžete povolit plán pro spuštění úlohy v budoucnu.
Zvolte možnost opakování pro plán. Můžete nastavit úlohu, která se má spustit:
- Jednorázová
- denně
- týdně
Nastavte počáteční datum a čas pro naplánovanou úlohu. Datum a čas jsou specifické pro vaše časové pásmo, a ne pro místní čas zařízení.
Pokud chcete ukončit opakovaný plán, zvolte:
- V tomto dni nastavíte koncové datum plánu.
- Po nastavení počtuspuštěních
Naplánované úlohy se vždy spouštějí na zařízeních ve skupině zařízení, i když se členství ve skupině zařízení v průběhu času změní.
Výběrem možnosti Další přejdete na stránku Revize . Na stránce Revize se zobrazují podrobnosti o konfiguraci úlohy. Výběrem možnosti Plán naplánujte úlohu:
Na stránce podrobností úlohy se zobrazují informace o naplánovaných úlohách. Když se naplánovaná úloha spustí, zobrazí se seznam instancí úloh. Naplánované spuštění úlohy je také součástí seznamu posledních 30 dnů .
Na této stránce můžete zrušit plánování úlohy nebo upravit naplánovanou úlohu. Ze seznamu naplánovaných úloh se můžete vrátit k naplánované úloze.
V průvodci úlohou se můžete rozhodnout neplánovat úlohu a spustit ji okamžitě.
Úloha prochází čekajícími, spuštěnými a dokončenými fázemi. Podrobnosti o spuštění úlohy obsahují metriky výsledků, podrobnosti doby trvání a mřížku seznamu zařízení.
Po dokončení úlohy můžete vybrat protokol výsledků a stáhnout soubor CSV s podrobnostmi o úloze, včetně zařízení a jejich hodnot stavu. Tyto informace můžou být užitečné pro řešení potíží:
Úloha se teď zobrazí v seznamu Posledních 30 dnů na stránce Úlohy . Tato stránka zobrazuje aktuálně spuštěné úlohy a historii všech dříve spuštěných nebo uložených úloh.
Poznámka:
Pro dříve spuštěné úlohy můžete zobrazit historii 30 dnů.
Správa úloh
Pokud chcete zastavit spuštěnou úlohu, otevřete ji a vyberte Zastavit. Stav úlohy se změní tak, aby odrážel, že je úloha zastavená. V části Souhrn se dozvíte, která zařízení se dokončila, selhala nebo stále čeká na vyřízení.
Pokud je úloha v zastaveném stavu, můžete pokračovat ve spuštění úlohy výběrem možnosti Pokračovat . Stav úlohy se změní tak, aby odrážel, že úloha je teď znovu spuštěná. Oddíl Souhrn pokračuje v aktualizaci s nejnovějším průběhem.
Kopírování úlohy
Pokud chcete zkopírovat existující úlohu, vyberte spuštěnou úlohu. Na stránce výsledků úlohy nebo na stránce s podrobnostmi o úlohách vyberte Kopírovat . Otevře se kopie konfigurace úlohy, kterou můžete upravit, a kopie se připojí k názvu úlohy.
Zobrazení stavu úlohy
Po vytvoření úlohy se sloupec Stav aktualizuje s nejnovější zprávou o stavu úlohy. Následující tabulka uvádí možné hodnoty stavu úlohy:
| Zpráva o stavu | Význam stavu |
|---|---|
| Dokončená | Tato úloha se spustila na všech zařízeních. |
| Nezdařilo se | Tato úloha selhala a na zařízeních se úplně nespuskla. |
| Nevyřízeno | Tato úloha ještě nezačala běžet na zařízeních. |
| Spuštěno | Tato úloha je aktuálně spuštěná na zařízeních. |
| Zastaveno | Uživatel tuto úlohu ručně zastavil. |
| Zrušeno | Tato úloha byla zrušena, protože byla překročena prahová hodnota nastavená na stránce Možnosti doručení. |
Za stavovou zprávou následuje přehled zařízení v úloze. Následující tabulka uvádí možné hodnoty stavu zařízení:
| Zpráva o stavu | Význam stavu |
|---|---|
| Úspěšně | Počet zařízení, na která se úloha úspěšně spustila. |
| Nezdařilo se | Počet zařízení, na kterých se úloha nespuskla. |
Pokud chcete zobrazit stav úlohy a všech ovlivněných zařízení, otevřete úlohu. Vedle názvu každého zařízení se zobrazí jedna z následujících stavových zpráv:
| Zpráva o stavu | Význam stavu |
|---|---|
| Dokončená | Úloha se spustila na tomto zařízení. |
| Nezdařilo se | Úloha se na tomto zařízení nespuskla. Chybová zpráva zobrazuje další informace. |
| Nevyřízeno | Úloha se na tomto zařízení ještě nespustí. |
Pokud chcete stáhnout soubor CSV, který obsahuje podrobnosti o úloze a seznam zařízení a jejich stavové hodnoty, vyberte protokol výsledků.
Filtrování seznamu zařízení
Seznam zařízení můžete filtrovat na stránce Podrobnosti úlohy výběrem ikony filtru. Můžete filtrovat podle ID zařízení nebo pole Stav:
Přizpůsobení sloupců v seznamu zařízení
Sloupce můžete do seznamu zařízení přidat tak, že vyberete ikonu možností sloupce:
Pomocí dialogového okna Možnosti sloupce vyberte sloupce seznamu zařízení. Vyberte sloupce, které chcete zobrazit, vyberte šipku doprava a pak vyberte OK. Pokud chcete vybrat všechny dostupné sloupce, zvolte Vybrat vše. Vybrané sloupce se zobrazí v seznamu zařízení.
Vybrané sloupce se uchovávají v uživatelské relaci nebo v uživatelských relacích, které mají přístup k aplikaci.
Opětovné spuštění úloh
Můžete znovu spustit úlohu, která selhala zařízení. Vyberte Znovu spustit při selhání.
Zadejte název a popis úlohy a pak vyberte Znovu spustit úlohu. Odešle se nová úloha pro opakování akce na zařízeních, která selhala.
Poznámka:
Z aplikace Azure IoT Central nemůžete současně spouštět více než pět úloh.
Po dokončení úlohy a odstranění zařízení, které je v seznamu zařízení úlohy, se položka zařízení zobrazí jako odstraněná v názvu zařízení. Odkaz podrobností není pro odstraněné zařízení dostupný.
Import zařízení
Pokud chcete do aplikace zaregistrovat velký počet zařízení, můžete zařízení hromadně importovat ze souboru CSV. Ukázkový soubor CSV najdete v úložišti Ukázek Azure. Soubor CSV by měl obsahovat následující záhlaví sloupců:
| Sloupec | Popis |
|---|---|
| IOTC_DEVICEID | ID zařízení je jedinečné identifikované, které bude toto zařízení používat pro připojení. ID zařízení může obsahovat písmena, číslice a - znak bez mezer. Maximální délka je 128 znaků. |
| IOTC_DEVICENAME | Nepovinné. Název zařízení je popisný název, který se zobrazí v celé aplikaci. Pokud není zadaný, název zařízení je stejný jako ID zařízení. Maximální délka je 148 znaků. |
Hromadná registrace zařízení v aplikaci:
V levém podokně zvolte Zařízení .
Na levém panelu zvolte šablonu zařízení, pro kterou chcete zařízení hromadně vytvořit.
Poznámka:
Pokud ještě nemáte šablonu zařízení, můžete zařízení importovat v části Všechna zařízení a zaregistrovat je bez šablony. Po importu zařízení je pak můžete migrovat do šablony.
Vyberte Importovat.
Vyberte organizaci, ke které chcete přiřadit zařízení. Všechna zařízení, která importujete, jsou přiřazená stejné organizaci. Pokud chcete přiřadit zařízení různým organizacím, vytvořte pro každou organizaci několik importovaných souborů. Případně je všechny nahrajte do kořenové organizace a pak je v uživatelském rozhraní znovu přiřaďte správným organizacím.
Vyberte soubor CSV se seznamem ID zařízení, která se mají importovat.
Import zařízení se spustí po nahrání souboru. Stav importu můžete sledovat na panelu Operace zařízení. Tento panel se zobrazí automaticky po spuštění importu nebo se k němu dostanete přes ikonu zvonku v pravém horním rohu.
Po dokončení importu se na panelu Operace zařízení zobrazí zpráva o úspěchu.
Pokud se operace importu zařízení nezdaří, zobrazí se na panelu Operace zařízení chybová zpráva. Vygeneruje se soubor protokolu zachycující všechny chyby, které si můžete stáhnout.
Pokud vaše zařízení k ověření používají tokeny SAS, exportujte soubor CSV z aplikace IoT Central. Exportovaný soubor CSV obsahuje ID zařízení a klíče SAS.
Pokud vaše zařízení k ověření používají certifikáty X.509, vygenerujte pro zařízení certifikáty typu list X.509 pomocí kořenového nebo zprostředkujícího certifikátu ve skupině registrací X.509. Použijte ID zařízení, která jste naimportovali jako CNAME hodnotu v listových certifikátech.
Export zařízení
Pokud chcete ke službě IoT Central připojit skutečné zařízení, potřebujete jeho připojovací řetězec. Podrobnosti o zařízení můžete hromadně exportovat, abyste získali informace potřebné k vytvoření připojovací řetězec zařízení. Proces exportu vytvoří soubor CSV s identitou zařízení, názvem zařízení a klíči pro všechna vybraná zařízení.
Hromadný export zařízení z aplikace:
V levém podokně zvolte Zařízení .
V levém podokně zvolte šablonu zařízení, ze které chcete zařízení exportovat.
Vyberte zařízení, která chcete exportovat, a pak vyberte akci Exportovat .
Spustí se proces exportu. Stav můžete sledovat pomocí panelu Operace zařízení.
Po dokončení exportu se zobrazí zpráva o úspěchu spolu s odkazem ke stažení vygenerovaného souboru.
Výběrem odkazu Stáhnout soubor stáhněte soubor do místní složky na disku.
Exportovaný soubor CSV obsahuje následující sloupce: ID zařízení, název zařízení, klíče zařízení a kryptografické otisky certifikátu X509:
- IOTC_DEVICEID
- IOTC_DEVICENAME
- IOTC_SASKEY_PRIMARY
- IOTC_SASKEY_SECONDARY
- IOTC_X509THUMBPRINT_PRIMARY
- IOTC_X509THUMBPRINT_SECONDARY
Další informace o připojení skutečných zařízení k aplikaci IoT Central najdete v tématu Jak se zařízení připojují.
Další kroky
Teď, když jste se naučili, jak hromadně spravovat zařízení v aplikaci Azure IoT Central, je navrhovaný další krok, jak upravit šablonu zařízení.