Masshantera enheter i Azure IoT Central program
Du kan använda Azure IoT Central för att hantera dina anslutna enheter i stor skala via jobb. Med jobb kan du massuppdateringar av enhets- och molnegenskaper och köra kommandon. Du kan också använda CSV-filer för att importera och exportera enheter i grupp. Den här artikeln visar hur du kommer igång med att använda jobb i ditt eget program och hur du använder import- och exportfunktionerna.
Skapa och köra ett jobb
I följande exempel visas hur du skapar och kör ett jobb för att ange tröskelvärdet för en grupp logistiska gatewayenheter. Du använder jobbguiden för att skapa och köra jobb. Du kan spara ett jobb som ska köras senare.
Välj Jobb i den vänstra rutan.
Välj + Nytt jobb.
På sidan Konfigurera ditt jobb anger du ett namn och en beskrivning för att identifiera det jobb som du skapar.
Om ditt program använder organisationerväljer du den organisation som jobbet ska associeras med. Endast användare i organisationen kan visa eller ändra jobbet. Användarens roll avgör vilka behörigheter användaren har.
Välj den målenhetsgrupp som du vill att jobbet ska gälla för. Om ditt program använder organisationer avgör den valda organisationen vilka enhetsgrupper som är tillgängliga. Du kan se hur många enheter som jobbkonfigurationen gäller för under valet Enhetsgrupp.
Välj Molnegenskap, Egenskap eller Kommando som Jobbtyp:
Om du vill konfigurera ett egenskapsjobb väljer du en egenskap och anger dess nya värde. Om du vill konfigurera ett kommandojobb väljer du det kommando som ska köras. Ett egenskapsjobb kan ange flera egenskaper.
Välj Spara och avsluta för att lägga till jobbet i listan över sparade jobb på sidan Jobb. Du kan senare återgå till ett jobb från listan över sparade jobb.
Välj Nästa för att gå till sidan Leveransalternativ. På sidan Leveransalternativ kan du ange leveransalternativ för det här jobbet: Batchar och tröskelvärde för annullering.
Med batchar kan du sprida jobb för ett stort antal enheter. Jobbet är indelat i flera batchar och varje batch innehåller en delmängd av enheterna. Batcharna köas och körs i följd.
Med tröskelvärdet för annullering kan du automatiskt avbryta ett jobb om antalet fel överskrider den inställda gränsen. Tröskelvärdet kan gälla för alla enheter i jobbet eller för enskilda batchar.
Välj Nästa för att gå till sidan Schema. På sidan Schema kan du aktivera ett schema för att köra jobbet i framtiden:
Välj ett upprepningsalternativ för schemat. Du kan konfigurera ett jobb att köra:
- Engångshändelse
- Varje dag
- Varje vecka
Ange startdatum och -tid för ett schemalagt jobb. Datum och tid är specifika för din tidszon och inte enhetens lokala tid.
Om du vill avsluta ett återkommande schema väljer du:
- Den här dagen för att ange ett slutdatum för schemat.
- Efter för att ange hur många gånger jobbet ska köras.
Schemalagda jobb körs alltid på enheterna i en enhetsgrupp, även om enhetsgruppmedlemskapet ändras över tid.
Välj Nästa för att gå till sidan Granska. Sidan Granska visar information om jobbkonfigurationen. Välj Schema för att schemalägga jobbet:
Jobbinformationssidan visar information om schemalagda jobb. När det schemalagda jobbet körs visas en lista över jobbinstanserna. Den schemalagda jobbkörningen är också en del av listan senaste 30-dagars jobb.
På den här sidan kan du avplanera jobbet eller redigera det schemalagda jobbet. Du kan återgå till ett schemalagt jobb från listan över schemalagda jobb.
I jobbguiden kan du välja att inte schemalägga ett jobb och köra det direkt. Följande skärmbild visar ett jobb utan ett schema som är redo att köras omedelbart. Välj Kör för att köra jobbet:
Ett jobb går igenom väntande, körande och slutförda faser. Jobbkörningsinformationen innehåller resultatmått, varaktighetsinformation och ett rutnät med enhetslistor.
När jobbet är klart kan du välja Resultatlogg för att ladda ned en CSV-fil med jobbinformationen, inklusive enheterna och deras statusvärden. Den här informationen kan vara användbar för felsökning.
Jobbet visas nu i listan Senaste 30 dagarna på sidan Jobb. Den här sidan visar jobb som körs och historiken för tidigare körningar eller sparade jobb.
Anteckning
Du kan visa 30 dagars historik för tidigare körningsjobb.
Hantera jobb
Om du vill stoppa ett jobb som körs öppnar du det och väljer Stoppa. Jobbstatusen ändras så att den visar att jobbet har stoppats. Avsnittet Sammanfattning visar vilka enheter som har slutförts, har misslyckats eller fortfarande väntar.
När ett jobb är i stoppat tillstånd kan du välja Fortsätt för att fortsätta köra jobbet. Jobbstatusen ändras så att den visar att jobbet nu körs igen. Avsnittet Sammanfattning fortsätter att uppdateras med den senaste förloppet.
Kopiera ett jobb
Om du vill kopiera ett befintligt jobb väljer du ett kört jobb. Välj Kopiera på jobbresultatsidan eller jobbinformationssidan:
En kopia av jobbkonfigurationen öppnas där du kan redigera och Kopiera läggs till i jobbnamnet.
Visa jobbstatus
När ett jobb har skapats uppdateras kolumnen Status med det senaste jobbets statusmeddelande. I följande tabell visas möjliga jobbstatusvärden:
| Statusmeddelande | Status som betyder |
|---|---|
| Slutförd | Det här jobbet kördes på alla enheter. |
| Misslyckad | Det här jobbet misslyckades och kunde inte köras helt på enheterna. |
| Väntar | Det här jobbet har ännu inte börjat köras på enheter. |
| Körs | Det här jobbet körs för närvarande på enheter. |
| Stoppad | En användare har stoppat det här jobbet manuellt. |
| Avbrutna | Det här jobbet avbröts eftersom tröskelvärdet som angetts på sidan Leveransalternativ överskreds. |
Statusmeddelandet följs av en översikt över enheterna i jobbet. I följande tabell visas möjliga enhetsstatusvärden:
| Statusmeddelande | Status som betyder |
|---|---|
| Lyckades | Antalet enheter som jobbet har körts på. |
| Misslyckad | Antalet enheter som jobbet inte kunde köras på. |
Om du vill visa status för jobbet och alla berörda enheter öppnar du jobbet. Bredvid varje enhetsnamn visas något av följande statusmeddelanden:
| Statusmeddelande | Status som betyder |
|---|---|
| Slutförd | Jobbet kördes på den här enheten. |
| Misslyckad | Jobbet kunde inte köras på den här enheten. Felmeddelandet visar mer information. |
| Väntar | Jobbet har ännu inte körts på den här enheten. |
Om du vill ladda ned en CSV-fil som innehåller jobbinformationen och listan över enheter och deras statusvärden väljer du Resultatlogg.
Filtrera enhetslistan
Du kan filtrera enhetslistan på sidan Jobbinformation genom att välja filterikonen. Du kan filtrera på fältet Enhets-ID eller Status:
Anpassa kolumner i enhetslistan
Du kan lägga till kolumner i enhetslistan genom att välja ikonen med kolumnalternativ:
Använd dialogrutan Kolumnalternativ för att välja kolumner i enhetslistan. Markera de kolumner som du vill visa, välj högerpilen och välj sedan OK. Om du vill markera alla tillgängliga kolumner väljer du Markera alla. De valda kolumnerna visas i enhetslistan.
Valda kolumner finns kvar i en användarsession eller mellan användarsessioner som har åtkomst till programmet.
Köra jobb igen
Du kan köra ett jobb som har misslyckade enheter igen. Välj Kör om vid misslyckad:
Ange ett jobbnamn och en beskrivning och välj sedan Kör jobbet igen. Ett nytt jobb skickas för att försöka utföra åtgärden igen på enheter som misslyckats.
Anteckning
Du kan inte köra fler än fem jobb samtidigt från ett Azure IoT Central program.
När ett jobb är klart och du tar bort en enhet som finns i jobbets enhetslista visas enhetsposten som borttagna i enhetsnamnet. Informationslänken är inte tillgänglig för den borttagna enheten.
Importera enheter
Om du vill ansluta ett stort antal enheter till ditt program kan du massimporta enheter från en CSV-fil. Du hittar en CSV-exempelfil på lagringsplatsen Azure Samples. CSV-filen bör innehålla följande kolumnrubriker:
| Kolumn | Beskrivning |
|---|---|
| IOTC_DEVICEID | Enhets-ID:t är ett unikt identifierat som den här enheten använder för att ansluta. Enhets-ID:t får innehålla bokstäver, siffror - och tecknet utan blanksteg. Maxlängden är 128 tecken. |
| IOTC_DEVICENAME | Valfritt. Enhetsnamnet är ett eget namn som visas i hela programmet. Om inget anges, samma som enhets-ID:t. Maxlängden är 148 tecken. |
Massregistrera enheter i ditt program:
Välj Enheter i det vänstra fönstret.
På den vänstra panelen väljer du den enhetsmall som du vill mass skapa enheterna för.
Anteckning
Om du inte har någon enhetsmall ännu kan du importera enheter under Alla enheter och registrera dem utan en mall. När enheterna har importerats kan du migrera dem till en mall.
Välj Importera.
Välj en organisation som enheterna ska tilldelas till. Alla enheter som du importerar tilldelas till samma organisation. Om du vill tilldela enheter till olika organisationer skapar du flera importfiler, en för varje organisation. Du kan också ladda upp dem till rotorganisationen och sedan i användargränssnittet tilldela dem till rätt organisationer.
Välj den CSV-fil som innehåller listan över enhets-ID:er som ska importeras.
Enhetsimporten startar när filen har laddats upp. Du kan spåra importstatusen i panelen Enhetsåtgärder. Den här panelen visas automatiskt när importen startar eller så kan du komma åt den via klockikonen i det övre högra hörnet.
När importen är klar visas ett meddelande i panelen Enhetsåtgärder.
Om enhetsimporten misslyckas visas ett felmeddelande på panelen Enhetsåtgärder. En loggfil som samlar in alla fel genereras som du kan ladda ned.
Exportera enheter
Om du vill ansluta en riktig IoT Central till en enhet behöver du dess anslutningssträng. Du kan exportera enhetsinformation i grupp för att få den information du behöver för att skapa enhetsanslutningssträngar. Exportprocessen skapar en CSV-fil med enhetsidentitet, enhetsnamn och nycklar för alla valda enheter.
Massexport av enheter från ditt program:
Välj Enheter i det vänstra fönstret.
Välj den enhetsmall som du vill exportera enheterna från i den vänstra rutan.
Välj de enheter som du vill exportera och välj sedan åtgärden Exportera.
Exportprocessen startar. Du kan spåra statusen med hjälp av panelen Enhetsåtgärder.
När exporten är klar visas ett meddelande med en länk för att ladda ned den genererade filen.
Välj länken Ladda ned fil för att ladda ned filen till en lokal mapp på disken.
Den exporterade CSV-filen innehåller följande kolumner: enhets-ID, enhetsnamn, enhetsnycklar och X509-certifikattumavtryck:
- IOTC_DEVICEID
- IOTC_DEVICENAME
- IOTC_SASKEY_PRIMARY
- IOTC_SASKEY_SECONDARY
- IOTC_X509THUMBPRINT_PRIMARY
- IOTC_X509THUMBPRINT_SECONDARY
Mer information om hur du ansluter verkliga enheter IoT Central ditt program finns i Enhetsanslutning i Azure IoT Central.
Nästa steg
Nu när du har lärt dig att hantera enheter i grupp i ditt Azure IoT Central program föreslår vi att du går vidare med att lära dig hur du redigerar en enhetsmall.