Hromadná správa zařízení ve vaší Azure IoT Central aplikaci
Pomocí nástroje Azure IoT Central spravovat připojená 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. Soubory CSV můžete použít také k hromadném importu a exportu zařízení. Tento článek popisuje, jak začít používat úlohy ve vlastní aplikaci a jak používat funkce importu a exportu.
Vytvoření a spuštění úlohy
Následující příklad ukazuje, jak vytvořit a spustit úlohu pro nastavení světlé prahové hodnoty pro skupinu zařízení logistické brány. Pomocí průvodce úlohou můžete vytvářet a spouštět úlohy. Úlohu můžete uložit pro pozdější spuštění.
V levém podokně vyberte Úlohy.
Vyberte + Nová úloha.
Na stránce Configure your job (Konfigurace úlohy) zadejte název a popis, abyste mohli identifikovat úlohu, kterou vytváříte.
Pokud vaše aplikace používá organizace, vyberte organizaci, ke které chcete úlohu přidružit. Úlohu mohou 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í, pro kterou chcete svou úlohu použít. Pokud vaše aplikace používá organizace, vybraná organizace určí dostupné skupiny zařízení. Počet zařízení, na která se vaše konfigurace úlohy vztahuje, můžete vidět pod výběrem skupiny zařízení.
Jako typ úlohy zvolte Vlastnost cloudu, Vlastnost nebo Příkaz:
Pokud chcete nakonfigurovat úlohu vlastností, vyberte vlastnost a nastavte její novou hodnotu. Pokud chcete nakonfigurovat úlohu příkazu, zvolte příkaz, který chcete spustit. Úloha vlastností může nastavit více vlastností.
Vyberte Uložit a ukončit a přidejte úlohu do seznamu uložených úloh na stránce Úlohy. Později se můžete k úlohě vrátit ze seznamu uložených úloh.
Výběrem možnosti Další přejděte na stránku Možnosti doručení. Na stránce Možnosti doručení můžete nastavit možnosti doručení pro tuto úlohu: Dávky a Prahová hodnota zrušení.
Dávky umožňují prosaovat úlohy pro velký počet zařízení. Úloha je rozdělená do několika dávek a každá dávka obsahuje podmnožinu zařízení. Dávky se zařadit do fronty a spouštět 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řejděte 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. Úlohu můžete nastavit tak, aby se spouštěla:
- Jednorázová
- denně
- týdně
Nastavte počáteční datum a čas naplánované úlohy. 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 tento den nastavíte koncové datum plánu.
- Po nastavení počtu spuštění úlohy.
Naplánované úlohy se vždycky spouštěnou na zařízeních ve skupině zařízení, i když se členství ve skupině zařízení v průběhu času mění.
Výběrem možnosti Další přejděte na stránku Kontrola. Na stránce Kontrola se zobrazí podrobnosti o konfiguraci úlohy. Vyberte Naplánovat a naplánujte úlohu:
Na stránce s podrobnostmi úlohy se zobrazí informace o plánovaných úlohách. Po spuštění naplánované úlohy se zobrazí seznam instancí úlohy. Naplánované spuštění úlohy je také součástí seznamu posledních 30denních úloh.
Na této stránce můžete úlohu neplánovat nebo upravit naplánovanou úlohu. K naplánované úlohě se můžete vrátit ze seznamu naplánovaných úloh.
V průvodci úlohou se můžete rozhodnout úlohu nenaplánovat a okamžitě ji spustit. Následující snímek obrazovky ukazuje úlohu bez plánu, která je připravená k okamžité spuštění. Vyberte Spustit a spusťte úlohu:
Úloha prochází fázemi čekající na vyřízení, spuštění a dokončení. 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 vaší úlohě, včetně zařízení a jejich hodnot stavu. Tyto informace mohou být užitečné při ř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
Můžete zobrazit 30denní historii dříve spuštěných úloh.
Správa úloh
Pokud chcete spuštěnou úlohu zastavit, otevřete ji a vyberte Zastavit. Stav úlohy se změní tak, aby odrážel, že se úloha zastavila. V části Souhrn se zobrazí, která zařízení se dokončila, selhala nebo která stále čekají na vyřízení.
Pokud je úloha v zastaveném stavu, můžete výběrem možnosti Pokračovat pokračovat a pokračovat v běhu úlohy. Stav úlohy se změní tak, aby odrážel, že úloha je teď znovu spuštěná. Oddíl Souhrn se bude dál aktualizovat 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 k názvu úlohy se připojí kopie.
Zobrazení stavu úlohy
Po vytvoření úlohy se ve sloupci Stav aktualizuje nejnovější stavová zpráva úlohy. Následující tabulka uvádí možné hodnoty stavu úlohy:
| Zpráva o stavu | Význam stavu |
|---|---|
| Dokončeno | Tato úloha se spustili na všech zařízeních. |
| Neúspěšný | Tato úloha selhala a na zařízeních se úplně nespouštěla. |
| Čekající | Tato úloha ještě na zařízeních nezačala běžet. |
| 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 se zrušila, 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 této úlohu. V následující tabulce jsou uvedené 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ě spustili. |
| Neúspěšný | Počet zařízení, na které se úlohu nepodařilo spustit. |
Pokud chcete zobrazit stav úlohy a všechna ovlivněná zařízení, otevřete ji. Vedle každého názvu zařízení se zobrazí jedna z následujících stavových zpráv:
| Zpráva o stavu | Význam stavu |
|---|---|
| Dokončeno | Úloha se spustili na tomto zařízení. |
| Neúspěšný | Na tomto zařízení se nepodařilo spustit úlohu. Chybová zpráva zobrazí další informace. |
| Čekající | Úloha se na tomto zařízení ještě nespouštěla. |
Pokud si chcete stáhnout soubor CSV, který obsahuje podrobnosti o úlohách, 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 pole ID zařízení nebo Stav:
Přizpůsobení sloupců v seznamu zařízení
Sloupce můžete přidat do seznamu zařízení výběrem ikony možností sloupce:
Pomocí dialogového okna Možnosti sloupce zvolte 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á v uživatelské relaci nebo napříč uživatelskými relacemi, které mají přístup k aplikaci.
Opětovné spuštění úloh
Můžete znovu spustit úlohu, která obsahuje zařízení, která selhala. Vyberte Znovu spustit při selhání:
Zadejte název a popis úlohy a pak vyberte Spustit úlohu znovu. Na zařízeních, která selhala, se odeslala nová úloha, která akci zopakovat.
Poznámka
V jedné aplikaci nemůžete spustit více než pět úloh najednou Azure IoT Central aplikace.
Po dokončení úlohy a odstranění zařízení, které je v seznamu zařízení úlohy, se položka zařízení v názvu zařízení zobrazí jako odstraněná. Odkaz na podrobnosti není pro odstraněné zařízení k dispozici.
Import zařízení
Pokud chcete k aplikaci připojit velký počet zařízení, můžete zařízení hromadně importovat ze souboru CSV. Příklad souboru 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é, že se toto zařízení bude používat k 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ý parametr. Název zařízení je popisný název, který se zobrazí v celé aplikaci. Pokud není zadané, 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 importovat zařízení 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 zařízení přiřadit. 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 několik souborů importu , jeden pro každou organizaci. Případně je můžete všechny nahrát do kořenové organizace a pak je v uživatelském rozhraní znovu přiřadit ke 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 po spuštění importu zobrazí automaticky nebo k tomuto panelu můžete získat přístup prostřednictvím ikony zvonku v pravém horním rohu.
Po dokončení importu se na panelu Operace zařízení zobrazí zpráva o úspěšném provedení.
Pokud operace importu zařízení selže, na panelu Operace zařízení se zobrazí chybová zpráva. Vygeneruje se soubor protokolu zachycující všechny chyby, které si můžete stáhnout.
Export zařízení
K připojení skutečného zařízení k IoT Central potřebujete jeho připojovací řetězec. Podrobnosti o zařízení můžete exportovat hromadně a získat tak informace potřebné k vytvoření připojovacích řetězců 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 Export.
Spustí se proces exportu. Stav můžete sledovat pomocí panelu Operace zařízení.
Po dokončení exportu se zobrazí zpráva o úspěšném provedení spolu s odkazem na 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ý otisk 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 vaší IoT Central najdete v tématu Připojení zařízení v Azure IoT Central.
Další kroky
Teď, když jste se naučili, jak hromadně spravovat zařízení ve vaší aplikaci Azure IoT Central, je navržený další krok, kde se dozvíte, jak Upravit šablonu zařízení.