Övervaka IoT Edge-distributioner

Gäller för: IoT Edge 1.5

Azure IoT Edge ger dig realtidsinformation om de moduler som distribueras till dina IoT Edge-enheter. IoT Hub-tjänsten hämtar status från enheterna och visar den för dig. Övervakning är också viktigt för distributioner i stor skala som omfattar automatiska distributioner och distributioner i lager.

Enheter och moduler har liknande data, till exempel anslutning, så du får värden baserat på enhets-ID eller modul-ID.

IoT Hub-tjänsten samlar in data som rapporteras av enhets- och modultvillingar och ger dig antal olika tillstånd som enheter kan ha. IoT Hub-tjänsten organiserar dessa data i fyra grupper med mått:

Du kan övervaka dessa data i Azure-portalen eller använda Azure CLI.

Övervaka en distribution i Azure Portal

Följ dessa steg om du vill visa distributionsinformation och övervaka enheterna som kör den:

1. Logga in på Azure-portalen och gå sedan till din IoT Hub.

2. Välj Konfigurationer + distributioner under Enhetshantering.

3. Granska distributionslistan. För varje distribution ser du följande information:

   Kolumn	Beskrivning
   ID-nummer	Namnet på distributionen.
   Typ	Typ av distribution, antingen Distribution eller Lagerdistribution.
   Målvillkor	Taggen som definierar riktade enheter.
   Prioritet	Det prioritetsnummer som tilldelats distributionen.
   Systemmått	Antalet enhetstvillingar i IoT Hub som matchar målvillkoret. Tillämpad visar antalet enheter som har distributionsinnehållet tillämpat på sina modultvillingar i IoT Hub.
   Enhetsmått	Antalet IoT Edge-enheter som rapporterar lyckade eller fel från IoT Edge-klientkörningen.
   Anpassade mått	Antalet IoT Edge-enheter som rapporterar data för alla mått som du definierar för distributionen.
   Skapad	Tidpunkten när distributionen skapas. Den här tidsstämpeln används för att bryta banden när två distributioner har samma prioritet.

4. Välj den distribution som du vill övervaka.

5. På sidan Distributionsinformation går du till fliken Målvillkor . Välj Visa för att visa de enheter som matchar målvillkoret. Ändra villkoret eller Prioritet efter behov och välj sedan Spara.

   

6. Välj fliken Mått . När du väljer ett mått i listrutan Välj mått visas knappen Visa så att du kan visa resultatet. Välj Redigera mått för att justera kriterierna för alla anpassade mått som du definierar. Välj Spara om du gör ändringar.

   

Information om hur du ändrar distributionen finns i Ändra en distribution.

Övervaka en distribution med Azure CLI

Använd kommandot az iot edge deployment show för att visa information om en enskild distribution:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

Kommandot deployment show använder följande parametrar:

• --deployment-id – namnet på distributionen i IoT-hubben. Obligatorisk parameter.
• --hub-name – namnet på den IoT-hubb där distributionen finns. Hubben måste finnas i den aktuella prenumerationen. Växla till prenumerationen med az account set -s [subscription name]

Kontrollera distributionen i kommandofönstret. Egenskapen metrics visar ett antal för varje mått som utvärderas av varje hubb:

• targetedCount – antalet enhetstvillingar i IoT Hub som matchar målvillkoret.
• appliedCount – Antalet enheter som har distributionsinnehållet tillämpat på sina modultvillingar i IoT Hub.
• reportedSuccessfulCount – antalet IoT Edge-enheter i distributionen som rapporterar lyckade resultat från IoT Edge-klientkörningen.
• reportedFailedCount – antalet IoT Edge-enheter i distributionen som rapporterar fel från IoT Edge-klientens körning.

Visa en lista över enhets-ID:n eller objekt för varje mått med kommandot az iot edge deployment show-metric :

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

Kommandot deployment show-metric använder följande parametrar:

• --deployment-id – namnet på distributionen i IoT-hubben.
• --metric-id – Namnet på måttet för att visa listan över enhets-ID:n, till exempel reportedFailedCount.
• --hub-name – namnet på den IoT-hubb där distributionen finns. Hubben måste finnas i den aktuella prenumerationen. Växla till prenumerationen med az account set -s [subscription name]. Information om hur du gör ändringar i distributionen finns i Ändra en distribution.

Nästa steg

Lär dig hur du övervakar modultvillingar, främst IoT Edge-agenten och IoT Edge Hub-körningsmodulerna, för att kontrollera anslutningen och hälsotillståndet för dina IoT Edge-distributioner.