IoT Edge-implementaties bewaken

Van toepassing op:IoT Edge 1.4 checkmark IoT Edge 1.4

Belangrijk

IoT Edge 1.4 is de ondersteunde release. Raadpleeg IoT Edge bijwerken als u een eerdere versie hebt.

Azure IoT Edge biedt rapportage waarmee u realtime informatie kunt bewaken over de modules die zijn geïmplementeerd op uw IoT Edge-apparaten. De IoT Hub-service haalt de status van de apparaten op en stelt deze beschikbaar voor de operator. Bewaking is ook belangrijk voor implementaties op schaal die automatische implementaties en gelaagde implementaties omvatten.

Zowel apparaten als modules hebben vergelijkbare gegevens, zoals connectiviteit, zodat waarden worden verkregen op basis van de apparaat-id of de module-id.

De IoT Hub-service verzamelt gegevens die zijn gerapporteerd door apparaat- en moduledubbels en biedt tellingen van de verschillende statussen die apparaten mogelijk hebben. De IoT Hub-service organiseert deze gegevens in vier groepen metrische gegevens:

Type Omschrijving
Beoogd Toont de IoT Edge-apparaten die overeenkomen met de implementatievoorwaarde.
Applied Toont de beoogde IoT Edge-apparaten die niet zijn gericht op een andere implementatie met een hogere prioriteit.
Geslaagde rapportage Toont de IoT Edge-apparaten die hebben gerapporteerd dat de modules zijn geïmplementeerd.
Rapportagefout Toont de IoT Edge-apparaten die hebben gerapporteerd dat een of meer modules niet zijn geïmplementeerd. Als u de fout verder wilt onderzoeken, maakt u extern verbinding met deze apparaten en bekijkt u de logboekbestanden.

De IoT Hub-service maakt deze gegevens beschikbaar voor u om te bewaken in Azure Portal en in de Azure CLI.

Een implementatie bewaken in Azure Portal

Als u de details van een implementatie wilt bekijken en de apparaten wilt bewaken waarop deze wordt uitgevoerd, voert u de volgende stappen uit:

  1. Meld u aan bij Azure Portal en navigeer naar uw IoT Hub.

  2. Selecteer Configuraties en implementaties in het menu Apparaatbeheer .

  3. Controleer de implementatielijst. Voor elke implementatie kunt u de volgende details bekijken:

    Kolom Omschrijving
    Id De naam van de implementatie.
    Type Het type implementatie, implementatie of gelaagde implementatie.
    Doelvoorwaarde De tag die wordt gebruikt om doelapparaten te definiëren.
    Prioriteit Het prioriteitsnummer dat is toegewezen aan de implementatie.
    Metrische systeemgegevens Het aantal apparaatdubbels in IoT Hub dat overeenkomt met de doelvoorwaarde. Toegepast geeft het aantal apparaten op waarop de implementatie-inhoud is toegepast op hun moduledubbels in IoT Hub.
    Metrische apparaatgegevens Het aantal IoT Edge-apparaten dat succes of fouten rapporteert van de Runtime van de IoT Edge-client.
    Aangepaste metrische gegevens Het aantal IoT Edge-apparaten dat gegevens rapporteert voor metrische gegevens die u voor de implementatie hebt gedefinieerd.
    Gemaakt De tijdstempel vanaf het moment dat de implementatie is gemaakt. Deze tijdstempel wordt gebruikt om de banden te verbreken wanneer twee implementaties dezelfde prioriteit hebben.
  4. Selecteer de implementatie die u wilt bewaken.

  5. Schuif op de pagina Implementatiedetails omlaag naar de onderste sectie en selecteer het tabblad Doelvoorwaarde . Selecteer Weergave om de apparaten weer te geven die overeenkomen met de doelvoorwaarde. U kunt de voorwaarde en ook de prioriteit wijzigen. Selecteer Opslaan als u wijzigingen hebt aangebracht.

    Screenshot showing targeted devices for a deployment.

  6. Selecteer het tabblad Metrische gegevens. Als u een metrische waarde kiest in de vervolgkeuzelijst Metrische gegevens selecteren, wordt er een weergaveknop weergegeven om de resultaten weer te geven. U kunt ook Metrische gegevens bewerken selecteren om de criteria aan te passen voor aangepaste metrische gegevens die u hebt gedefinieerd. Selecteer Opslaan als u wijzigingen hebt aangebracht.

    Screenshot showing the metrics for a deployment.

Zie Een implementatie wijzigen om wijzigingen aan te brengen in uw implementatie.

Een implementatie bewaken met Azure CLI

Gebruik de opdracht az iot edge deployment show om de details van één implementatie weer te geven:

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

De opdracht implementatievoorstelling heeft de volgende parameters:

  • --deployment-id : de naam van de implementatie die bestaat in de IoT-hub. Vereiste parameter.
  • --hub-name : naam van de IoT-hub waarin de implementatie bestaat. De hub moet zich in het huidige abonnement bevinden. Overschakelen naar het gewenste abonnement met de opdracht az account set -s [subscription name]

Inspecteer de implementatie in het opdrachtvenster. De eigenschap metrische gegevens bevat een telling voor elke metrische waarde die door elke hub wordt geëvalueerd:

  • targetedCount : een systeemmetriek waarmee het aantal apparaatdubbels in IoT Hub wordt opgegeven dat overeenkomt met de doelvoorwaarde.
  • appliedCount - Een systeemmetriek geeft het aantal apparaten aan waarop de implementatie-inhoud is toegepast op hun moduledubbels in IoT Hub.
  • reportedSuccessfulCount : een apparaatmetriek waarmee het aantal IoT Edge-apparaten wordt opgegeven in de implementatierapportage van de Runtime van de IoT Edge-client.
  • reportedFailedCount : een metrische apparaatwaarde die het aantal IoT Edge-apparaten in de implementatierapportagefout aangeeft vanuit de Runtime van de IoT Edge-client.

U kunt een lijst met apparaat-id's of objecten voor elk van de metrische gegevens weergeven met de opdracht az iot edge deployment show-metric :

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

Met de opdracht show-metric deployment worden de volgende parameters gebruikt:

  • --deployment-id : de naam van de implementatie die bestaat in de IoT-hub.
  • --metric-id - De naam van de metrische waarde waarvoor u de lijst met apparaat-id's wilt zien, bijvoorbeeld reportedFailedCount.
  • --hub-name : naam van de IoT-hub waarin de implementatie bestaat. De hub moet zich in het huidige abonnement bevinden. Schakel over naar het gewenste abonnement met de opdracht az account set -s [subscription name].

Zie Een implementatie wijzigen om wijzigingen aan te brengen in uw implementatie.

Volgende stappen

Meer informatie over het bewaken van moduledubbels, met name de IoT Edge Agent- en IoT Edge Hub-runtimemodules, voor de connectiviteit en status van uw IoT Edge-implementaties.