Delen via

Automatisch IoT-apparaat- en modulebeheer met behulp van Azure Portal

Automatisch apparaatbeheer in Azure IoT Hub automatiseert veel van de terugkerende en complexe taken voor het beheren van grote apparaatvloten. Met automatisch apparaatbeheer kunt u een set apparaten instellen op basis van hun eigenschappen, een gewenste configuratie definiëren en vervolgens ioT Hub de apparaten laten bijwerken wanneer ze binnen het bereik komen. Deze update wordt uitgevoerd met behulp van een automatische apparaatconfiguratie of automatische moduleconfiguratie, waarmee u de voltooiing en naleving kunt samenvatten, samenvoeging en conflicten kunt afhandelen en configuraties in een gefaseerde benadering kunt implementeren.

Opmerking

De functies die in dit artikel worden beschreven, zijn alleen beschikbaar in de standaardlaag van de IoT Hub. Zie De juiste IoT Hub-laag en -grootte kiezen voor uw oplossing voor meer informatie over de Basic- en Standard/gratis IoT Hub-lagen.

Automatisch apparaatbeheer werkt door een set apparaattweelingen of moduultweelingen bij te werken met gewenste eigenschappen en een samenvatting te rapporteren die is gebaseerd op de gerapporteerde eigenschappen van deze tweelingen. Het introduceert een nieuw klasse- en JSON-document met de naam Configuration met drie onderdelen:

  • De doelvoorwaarde definieert het bereik van apparaat-tweelingen of module-tweelingen die bijgewerkt moeten worden. De doelvoorwaarde wordt opgegeven als een query op dubbeltags en/of gerapporteerde eigenschappen.

  • De doelinhoud definieert de gewenste kenmerken die moeten worden toegevoegd of bijgewerkt in de apparaattweelingen of moduletweelingen. De inhoud bevat een pad naar de sectie met gewenste eigenschappen die moeten worden gewijzigd.

  • De metrische gegevens definiëren de samenvattingsaantallen van verschillende configuratiestatussen, zoals Geslaagd, Wordt uitgevoerd en Fout. Aangepaste metrieken worden gespecificeerd als query's op gerapporteerde eigenschappen van tweelingen. Systeemmetriek zijn de standaardmetrieken waarmee de update-status van tweelingen wordt gemeten, zoals het aantal tweelingen dat wordt beoogd en het aantal tweelingen dat succesvol is bijgewerkt.

Automatische configuraties worden voor het eerst uitgevoerd kort nadat de configuratie is gemaakt en vervolgens met intervallen van vijf minuten. Metrische query's worden telkens uitgevoerd wanneer de automatische configuratie wordt uitgevoerd. Er worden maximaal 100 automatische configuraties ondersteund op IoT-hubs in de standard-laag; tien op IoT-hubs in de gratis laag. Doseringslimieten zijn ook van toepassing. Voor meer informatie, zie Quota en Throttling.

Tweelingen implementeren

Voor automatische apparaatconfiguraties is het gebruik van apparaatdubbels vereist om de status tussen de cloud en apparaten te synchroniseren. Zie Apparaatdubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Voor automatische moduleconfiguraties is het gebruik van moduledubbels vereist om de status tussen de cloud en modules te synchroniseren. Zie Moduledubbels begrijpen en gebruiken in IoT Hub voor meer informatie.

Tags gebruiken om je op tweelingen te richten

Voordat u een configuratie maakt, moet u opgeven welke apparaten of modules u wilt beïnvloeden. Azure IoT Hub identificeert apparaten met behulp van tags in de apparaatdubbel en identificeert modules met behulp van tags in de moduledubbel. Elk apparaat of elke module kan meerdere tags hebben en u kunt ze definiëren op elke manier die zinvol is voor uw oplossing. Als u bijvoorbeeld apparaten op verschillende locaties beheert, voegt u de volgende tags toe aan een apparaatdubbel:

"tags": {
	"location": {
		"state": "Washington",
		"city": "Tacoma"
    }
},

Een configuratie maken

U kunt maximaal 100 automatische configuraties maken op IoT-hubs in de standard-laag; tien op IoT-hubs in de gratis laag. Voor meer informatie, zie Quota en Throttling.

  1. Ga in Azure Portal naar uw IoT-hub.

  2. Selecteer Configuraties plus Implementaties in het linkernavigatiedeelvenster.

  3. Selecteer Toevoegen en kies Apparaatdubbelconfiguratie of Moduledubbelconfiguratie in de vervolgkeuzelijst.

    schermopname waarin wordt getoond hoe u een configuratie toevoegt.

Er zijn vijf stappen om een configuratie te maken. In de volgende secties wordt elke sectie beschreven.

Naam en etiket

  1. Geef uw configuratie een unieke naam die maximaal 128 tekens lang is. Kleine letters en de volgende speciale tekens zijn toegestaan: -+%_*!'. Spaties zijn niet toegestaan.

  2. Voeg labels toe om uw configuraties bij te houden. Labels zijn Name, Value paren die uw configuratie beschrijven. Bijvoorbeeld HostPlatform, Linux of Version, 3.0.1.

  3. Selecteer Volgende om naar de volgende stap te gaan.

Gekoppelde instellingen

In deze sectie wordt de inhoud gedefinieerd die moet worden ingesteld in de gewenste eigenschappen van de device twin of module twin. Er zijn twee invoerwaarden voor elke set instellingen. De eerste is het twin-pad, wat het pad is naar de JSON-sectie binnen de gewenste eigenschappen van de twin die worden ingesteld. De tweede is de JSON-inhoud die in die sectie moet worden ingevoegd.

U kunt bijvoorbeeld het tweelingpad instellen op properties.desired.chiller-water en vervolgens de volgende JSON-inhoud opgeven:

{
  "temperature": 66,
  "pressure": 28
}

Schermopname van het instellen van de apparaat- of module twin-eigenschap en json-inhoud.

U kunt ook afzonderlijke instellingen instellen door het hele dubbelpad op te geven en de waarde zonder vierkante haken op te geven. Stel bijvoorbeeld met het dubbelpad properties.desired.chiller-water.temperaturede inhoud in op 66. Maak vervolgens een nieuwe dubbelinstelling voor de drukeigenschap.

Als twee of meer configuraties zijn gericht op hetzelfde dubbelpad, is de inhoud van de configuratie met de hoogste prioriteit van toepassing (prioriteit wordt gedefinieerd in stap 4).

Als u een bestaande eigenschap wilt verwijderen, stelt u de eigenschapswaarde in op null.

U kunt extra instellingen toevoegen door de instelling Apparaatdubbel toevoegen of Moduledubbel-instelling toevoegen te selecteren.

Doelapparaten en modules

Gebruik de eigenschap tags van uw digitale tweelingen om te richten op de specifieke apparaten of modules die deze configuratie moeten ontvangen. U kunt zich ook richten op gerapporteerde eigenschappen van dubbele.

Automatische apparaatconfiguraties kunnen alleen gericht zijn op apparaat-tweelingtags en automatische moduleconfiguraties kunnen alleen gericht zijn op module-tweelingtags.

Aangezien meerdere configuraties op hetzelfde apparaat of dezelfde module kunnen zijn gericht, heeft elke configuratie een prioriteitsnummer nodig. Als er ooit een conflict is, wint de configuratie met de hoogste prioriteit.

  1. Voer een positief geheel getal in voor de configuratie Priority. De hoogste numerieke waarde wordt beschouwd als de hoogste prioriteit. Als twee configuraties hetzelfde prioriteitsnummer hebben, wint het configuratienummer dat het laatst is gemaakt.

  2. Voer een doelvoorwaarde in om te bepalen op welke apparaten of modules deze configuratie wordt toegepast. De voorwaarde is gebaseerd op tweelinglabels of gerapporteerde tweelingeigenschappen en moet overeenkomen met het expressieformaat.

    Voor automatische apparaatconfiguratie kunt u alleen de tag of gerapporteerde eigenschap opgeven voor het doel. Bijvoorbeeld tags.environment='test' of properties.reported.chillerProperties.model='4000x'. U kunt * opgeven om alle apparaten te targeten.

    Voor automatische moduleconfiguratie gebruikt u een query om tags of gerapporteerde eigenschappen op te geven van de modules die zijn geregistreerd bij de IoT-hub. Bijvoorbeeld from devices.modules where tags.environment='test' of from devices.modules where properties.reported.chillerProperties.model='4000x'. Het jokerteken kan niet worden gebruikt om alle modules te selecteren.

Statistieken

Metrische gegevens bieden samenvattingsaantallen van de verschillende statussen die een apparaat of module kan rapporteren na het toepassen van configuratie-inhoud. U kunt bijvoorbeeld een metriek maken voor openstaande instellingenwijzigingen, een metriek voor fouten en een metriek voor geslaagde instellingenwijzigingen.

Elke configuratie kan maximaal vijf aangepaste metrische gegevens bevatten.

  1. Voer een naam in voor metrieknaam.

  2. Voer een query in voor metrische criteria. De query is gebaseerd op de gerapporteerde eigenschappen van de apparaat-tweeling. De metrische waarde vertegenwoordigt het aantal rijen dat door de query wordt geretourneerd.

    Voorbeeld:

    SELECT deviceId FROM devices 
  WHERE properties.reported.chillerWaterSettings.status='pending'

    U kunt een clausule opnemen waarin staat dat de configuratie is toegepast, bijvoorbeeld:

    /* Include the double brackets. */
SELECT deviceId FROM devices 
  WHERE configurations.[[yourconfigname]].status='Applied'

    Als u een metrische waarde bouwt om te rapporteren over geconfigureerde modules, selecteert u moduleId in devices.modules. Voorbeeld:

    SELECT deviceId, moduleId FROM devices.modules
  WHERE properties.reported.lastDesiredStatus.code = 200

Configuratie controleren

Controleer uw configuratiegegevens en selecteer vervolgens Verzenden.

Een configuratie bewaken

Als u de details van een configuratie wilt bekijken en de apparaten wilt bewaken waarop deze wordt uitgevoerd, gebruikt u de volgende stappen:

  1. Ga in Azure Portal naar uw IoT-hub.

  2. Selecteer Configuraties in Apparaatbeheer.

  3. Controleer de configuratielijst. Voor elke configuratie kunt u de volgende details bekijken:

    • id : de naam van de configuratie.

    • doelvoorwaarde: de query die wordt gebruikt om doelapparaten of modules te definiëren.

    • Priority : het prioriteitsnummer dat aan de configuratie is toegewezen.

    • aanmaaktijd: de tijdstempel vanaf het moment waarop de configuratie is gemaakt. Deze tijdstempel wordt gebruikt om de banden te verbreken wanneer twee configuraties dezelfde prioriteit hebben.

    • Metrische gegevens van het systeem: metrische gegevens die worden berekend door IoT Hub en die niet kunnen worden aangepast door ontwikkelaars. Doelgericht specificeert het aantal apparaatkoppelingen dat overeenkomt met de doelconditie. Hiermee wordt het aantal apparaatdubbels opgegeven dat door de configuratie is gewijzigd. Dit kan gedeeltelijke wijzigingen bevatten in het geval dat ook een afzonderlijke configuratie met een hogere prioriteit wijzigingen heeft aangebracht.

    • Aangepaste metrieken die door de ontwikkelaar zijn opgegeven als query's van gerapporteerde eigenschappen van tweelingen. Er kunnen maximaal vijf aangepaste metrische gegevens per configuratie worden gedefinieerd.

  4. Selecteer de configuratie die u wilt bewaken.

  5. Controleer de configuratiedetails. U kunt tabbladen gebruiken om specifieke details weer te geven over de apparaten die de configuratie hebben ontvangen.

    • Doelapparaten of doelmodules : de apparaten of modules die overeenkomen met de doelvoorwaarde.

    • metrische gegevens: een lijst met metrische systeemgegevens en aangepaste metrische gegevens. U kunt een lijst met apparaten of modules weergeven die voor elke metriek worden geteld door de metrische waarde in de vervolgkeuzelijst te selecteren en vervolgens Apparaten weergeven of Modules weergeven te selecteren.

    • Labels - sleutel-waardeparen die worden gebruikt om een configuratie te beschrijven. Labels hebben geen invloed op functionaliteit.

    • nl-NL: Instellingen voor apparaatdubbels of moduledubbels: de dubbelinstellingen die zijn vastgesteld door de configuratie, indien van toepassing.

Een configuratie wijzigen

Wanneer u een configuratie wijzigt, worden de wijzigingen onmiddellijk gerepliceerd naar alle doelapparaten of modules.

Als u de doelvoorwaarde bijwerkt, worden de volgende updates uitgevoerd:

  • Als een dubbel niet voldoet aan de oude doelvoorwaarde, maar voldoet aan de nieuwe doelvoorwaarde en deze configuratie de hoogste prioriteit voor die dubbel is, wordt deze configuratie toegepast.

  • Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd, niet meer voldoet aan de doelvoorwaarde, worden de instellingen van de configuratie verwijderd en wordt de tweeling gewijzigd door de volgende configuratie met de hoogste prioriteit.

  • Als een tweeling waarop deze configuratie momenteel wordt uitgevoerd niet meer voldoet aan de doelvoorwaarde en niet voldoet aan de doelvoorwaarde van andere configuraties, worden de instellingen uit de configuratie verwijderd en worden er geen andere wijzigingen aangebracht op de tweeling.

Als u een configuratie wilt wijzigen, gebruikt u de volgende stappen:

  1. Ga in Azure Portal naar uw IoT-hub.

  2. Selecteer Configuraties en implementaties in Apparaatbeheer.

  3. Selecteer de configuratie die u wilt wijzigen.

  4. U kunt de volgende velden bijwerken:

    • Prioriteit
    • Statistieken
    • Doeltoestand
    • Etiketten

  5. Selecteer Opslaan.

  6. Volg de stappen in Een configuratie bewaken om de uitrol van de wijzigingen te volgen.

Een configuratie verwijderen

Wanneer u een configuratie verwijdert, nemen alle apparaatkoppels de eerstvolgende configuratie met de hoogste prioriteit aan. Als apparaat-tweelingen niet voldoen aan de doelvoorwaarde van een andere configuratie, worden er geen verdere instellingen toegepast.

  1. Ga in Azure Portal naar uw IoT-hub.

  2. Selecteer Configuraties en implementaties in Apparaatbeheer.

  3. Gebruik het selectievakje om de configuratie te selecteren die u wilt verwijderen.

  4. Selecteer verwijderen.

  5. Er verschijnt een melding waarin u wordt gevraagd om te bevestigen.

Volgende stappen

In dit artikel hebt u geleerd hoe u IoT-apparaten op schaal configureert en bewaakt.

Zie IoT Hub-apparaatidentiteiten bulksgewijs importeren en exporteren voor meer informatie over het bulksgewijs beheren van IoT Hub-apparaatidentiteiten