Aan de slag met vooraf geconfigureerde oplossingen

Vooraf geconfigureerde oplossingen voor Azure IoT Suite zijn voorzien van meerdere Azure IoT-services om totaaloplossingen te leveren voor het implementeren van algemene IoT-bedrijfsscenario's. De vooraf geconfigureerde oplossing externe controle maakt verbinding met en controleert uw apparaten. U kunt deze oplossing gebruiken om de datastroom van uw apparaten te analyseren en de bedrijfsresultaten te verbeteren door processen automatisch te laten reageren op die datastroom.

In deze zelfstudie leert u hoe de vooraf geconfigureerde oplossing voor externe controle inricht. Hierbij maakt u ook kennis met de basisfuncties van de vooraf geconfigureerde oplossing. U hebt toegang tot veel van deze functies via het oplossingsdashboard dat als onderdeel van de vooraf geconfigureerde oplossing wordt geïmplementeerd:

U hebt een actief Azure-abonnement nodig om deze zelfstudie te voltooien.

De oplossing inrichten

Als u de vooraf geconfigureerde oplossing voor externe controle in uw account nog niet hebt ingericht:

1. Meld u aan bij azureiotsuite.com met uw Azure-accountreferenties en klik + om een oplossing te maken.
2. Klik op de tegel Externe controle op Selecteren.
3. Voer een oplossingsnaam in voor uw vooraf geconfigureerde oplossing voor externe controle.
4. Selecteer de regio die en het abonnement dat u wilt gebruiken voor het inrichten van de oplossing.
5. Klik op Oplossing maken om het inrichtingsproces te starten. Doorgaans duurt het enkele minuten om dit proces uit te voeren.

Wacht tot het inrichtingsproces is voltooid.

1. Klik op de tegel voor uw oplossing met de status Inrichten.
2. Tijdens de implementatie van Azure-services in uw Azure-abonnement verschijnen verschillende inrichtingstatuswaarden.
3. Nadat het inrichten is voltooid, verandert de status in Gereed.
4. Klik op de tegel om de details van uw oplossing in het rechterdeelvenster weer te geven.

Zijn er voor uw oplossing bepaalde details niet vermeld, die u wel verwacht had te zien? Geef ons suggesties voor functies op User Voice.

Overzicht van scenario's

Wanneer u de vooraf geconfigureerde oplossing voor externe bewaking implementeert, wordt deze vooraf ingevuld met de resources waarmee u een algemeen scenario voor externe controle kunt doorlopen. In dit scenario melden verschillende apparaten die met de oplossing zijn verbonden, onverwachte temperatuurwaarden. De volgende gedeelten laten u zien hoe u:

• De apparaten die de onverwachte temperatuurwaarden melden, kunt identificeren.
• Deze apparaten kunt configureren, zodat ze gedetailleerdere telemetrie verzenden.
• Het probleem kunt oplossen door de firmware op deze apparaten bij te werken.
• Kunt controleren of uw actie het probleem heeft opgelost.

Een belangrijke functie van dit scenario is dat u al deze acties extern kunt uitvoeren vanuit het dashboard van de oplossing. U hebt geen fysieke toegang tot de apparaten nodig.

Het oplossingsdashboard bekijken

Vanaf het dashboard van de oplossing kunt u de geïmplementeerde oplossing beheren. U kunt er bijvoorbeeld telemetrie weergeven, apparaten toevoegen en regels configureren.

1. Wanneer het inrichten is voltooid en voor de tegel voor uw vooraf geconfigureerde oplossing de status Gereed wordt weergegeven, kiest u Starten om uw portal voor de externe bewakingsoplossing te openen in een nieuw tabblad.

   

2. Standaard ziet u in de oplossingsportal het dashboard. U kunt navigeren naar andere gebieden van de portal van de oplossing met het menu aan de linkerkant van de pagina.

   

Het dashboard bevat de volgende informatie:

• Een kaart die de locatie aangeeft van elk apparaat dat met de oplossing is verbonden. Wanneer u de oplossing voor het eerst uitvoert, zijn er 25 gesimuleerde apparaten. De gesimuleerde apparaten worden geïmplementeerd als Azure WebJobs en de oplossing gebruikt de API van Bing Kaarten om informatie op de kaart te tekenen. Zie de Veelgestelde vragen voor meer informatie over hoe u de kaart dynamisch kunt maken.
• Een deelvenster Telemetriegeschiedenis dat de vochtigheids- en temperatuurtelemetrie van een geselecteerd apparaat in bijna realtime tekent en statistische gegevens weergeeft, zoals de maximale, minimale en gemiddelde vochtigheid.
• Een deelvenster Geschiedenis van waarschuwingen dat recente waarschuwingsgebeurtenissen toont wanneer voor een telemetriewaarde een drempelwaarde wordt overschreden. Naast de voorbeelden die met de vooraf geconfigureerde oplossing zijn gemaakt, kunt u ook uw eigen alarmen definiëren.
• Een deelvenster Taken dat informatie weergeeft over geplande taken. U kunt uw eigen taken plannen op de pagina Beheertaken.

Waarschuwingen weergeven

Het deelvenster Waarschuwingsgeschiedenis laat u zien dat vijf apparaten telemetriewaarden melden die hoger zijn dan verwacht.

Apparaten weergeven

De Apparatenlijst bevat alle geregistreerde apparaten in de oplossing. Uit de apparatenlijst kunt u metagegevens voor apparaten weergeven en bewerken, apparaten toevoegen of verwijderen en methoden aanroepen op apparaten. U kunt de apparatenlijst filteren en sorteren. U kunt ook de weergave van de kolommen in de apparatenlijst aanpassen.

1. Kies Apparaten om de apparatenlijst voor deze oplossing weer te geven.

   

2. De apparatenlijst geeft eerst aan dat bij het inrichtingsproces 25 gesimuleerde apparaten zijn gemaakt. U kunt extra gesimuleerde en fysieke apparaten aan de oplossing toevoegen.

3. Kies in de lijst een apparaat om de details ervan weer te geven.

   

Het deelvenster Apparaatdetails bevat zes gedeeltes:

• Een verzameling van koppelingen waarmee u het apparaatpictogram kunt aanpassen, het apparaat kunt uitschakelen, een regel kunt toevoegen, een methode kunt aanroepen of een opdracht kunt verzenden. Zie Cloud-to-device communications guidance (Richtlijnen voor communicatie tussen cloud en apparaat) voor een vergelijking van opdrachten (berichten van apparaat naar cloud) en methoden (directe methoden).
• In het gedeelte Apparaatdubbel - Tags kunt u tagwaarden voor het apparaat bewerken. U kunt tagwaarden in de apparatenlijst weergeven en tagwaarden gebruiken om de apparatenlijst te filteren.
• In het gedeelte Apparaatdubbel - Gewenste eigenschappen kunt u eigenschapswaarden instellen die moeten worden verzonden naar het apparaat.
• Het gedeelte Apparaatdubbel - Gerapporteerde eigenschappen geeft eigenschapswaarden weer die vanaf het apparaat worden verzonden.
• Het gedeelte Apparaateigenschappen geeft informatie weer vanuit het identiteitsregister, zoals het apparaat-id en de verificatiesleutels.
• Het gedeelte Recente taken geeft informatie weer over taken die onlangs op dit apparaat zijn gericht.

De apparatenlijst filteren

U kunt een filter gebruiken om alleen de apparaten weer te geven die onverwachte temperatuurwaarden verzenden. De vooraf geconfigureerde oplossing voor externe bewaking bevat het filter Beschadigde apparaten om apparaten weer te geven met een gemiddelde temperatuurwaarde die groter is dan 60. U kunt ook uw eigen filters maken.

1. Kies Opgeslagen filter openen om een lijst met beschikbare filters weer te geven. Kies vervolgens Beschadigde apparaten om het filter toe te passen:

   

2. De apparatenlijst geeft nu alleen apparaten weer met een gemiddelde temperatuurwaarde die groter is dan 60.

   

Gewenste eigenschappen bijwerken

U hebt nu een set apparaten geïdentificeerd die mogelijk moeten worden hersteld. U besluit echter dat de gegevensfrequentie van 15 seconden niet voldoende is voor een duidelijke diagnose van het probleem. Als u de telemetrische frequentie wijzigt in vijf seconden, hebt u meer gegevenspunten waarmee u het probleem beter kunt vaststellen. U kunt deze configuratiewijziging pushen naar uw externe apparaten vanuit de portal van de oplossing. U kunt de wijziging eenmaal doorvoeren, de impact controleren en vervolgens actie ondernemen op de resultaten.

Volg deze stappen voor het uitvoeren van een taak die de gewenste eigenschap TelemetryInterval voor de betreffende apparaten wijzigt. Wanneer de apparaten de nieuwe eigenschapswaarde TelemetryInterval ontvangen, wijzigen ze hun configuratie dusdanig dat er elke vijf seconden telemetrie wordt verzonden, in plaats van elke 15 seconden:

1. Wanneer de lijst met beschadigde apparaten wordt weergegeven in de lijst met apparaten, kiest u Taakplanner en vervolgens Apparaatdubbel bewerken.

2. Roep de taak Telemetrie-interval wijzigen aan.

3. Wijzig de waarde van de Gewenste eigenschap met de naam desired.Config.TelemetryInterval in vijf seconden.

4. Kies Planning.

   

5. U kunt de voortgang bewaken van de taken op de pagina Beheertaken in de portal.

Deze taak stelt de waarde in van de gewenste eigenschap TelemetryInterval in het dubbele apparaat voor alle apparaten die door het filter zijn geselecteerd. De apparaten halen deze waarde op van de dubbele apparaten en werken hun gedrag bij. Wanneer een apparaat een gewenste eigenschap ophaalt uit een dubbel apparaat, wordt de bijbehorende gerapporteerde eigenschapswaarde ingesteld.

Aanroepmethodes

Terwijl de taak wordt uitgevoerd, ziet u in de lijst met beschadigde apparaten dat al deze apparaten oude firmwareversies hebben (ouder dan versie 1.6).

Deze firmwareversie is mogelijk de basisoorzaak voor de onverwachte temperatuurwaarden als u weet dat andere apparaten die wel goed functioneren, onlangs zijn bijgewerkt naar versie 2.0. U kunt het ingebouwde filter Apparaten met oude firmware gebruiken om apparaten met oude firmwareversies te identificeren. Via de portal kunt u vervolgens alle apparaten die nog een oude firmwareversie hebben, extern bijwerken:

1. Kies Opgeslagen filter openen om een lijst met beschikbare filters weer te geven. Kies vervolgens Apparaten met oude firmwareversies om het filter toe te passen:

   

2. In de lijst met apparaten worden nu alleen apparaten met oude firmwareversies weergegeven. Deze lijst bevat de vijf apparaten die zijn geïdentificeerd door het filter Beschadigde apparaten en drie extra apparaten:

   

3. Kies Job Scheduler en vervolgens Aanroepmethode.

4. Stel Taaknaam in op Firmware bijwerken naar versie 2.0.

5. Kies InitiateFirmwareUpdate als de Methode.

6. Stel de parameter FwPackageUri in op https://iotrmassets.blob.core.windows.net/firmwares/FW20.bin.

7. Kies Planning. De standaardwaarde voor de taak is nu uitvoeren.

   

Deze taak roept de directe methode InitiateFirmwareUpdate aan op alle apparaten die door het filter zijn geselecteerd. Apparaten reageren onmiddellijk op IoT Hub en starten het updateproces voor de firmware asynchroon. De apparaten bieden statusinformatie over het updateproces voor de firmware via gemelde eigenschapswaarden, zoals wordt weergegeven in de volgende schermafbeeldingen. Kies het pictogram Vernieuwen om de informatie in de apparaat- en takenlijsten bij te werken:

Samenvatting van scenario

In dit scenario hebt u een mogelijk probleem met enkele van uw externe apparaten geïdentificeerd met behulp van de waarschuwingsgeschiedenis op het dashboard en een filter. Vervolgens hebt u het filter en een taak gebruikt om de apparaten extern te configureren om meer informatie te geven teneinde u te helpen bij het vaststellen van het probleem. Ten slotte hebt u een filter en een taak gebruikt om onderhoud op de beschadigde apparaten te plannen. Als u naar het dashboard terugkeert, kunt u zien dat er geen waarschuwingen meer worden weergegeven voor apparaten in uw oplossing. U kunt een filter gebruiken om te controleren of de firmware op alle apparaten in uw oplossing up-to-date is en er geen beschadigde apparaten meer zijn:

Andere functies

De volgende gedeelten beschrijven een aantal extra functies van de vooraf geconfigureerde oplossing voor externe controle die niet zijn beschreven als onderdeel van het voorgaande scenario.

Kolommen aanpassen

U kunt de informatie die in de apparatenlijst wordt weergegeven, aanpassen door Kolomeditor te kiezen. U kunt kolommen die gerapporteerde eigenschaps- en tagwaarden weergeven, toevoegen en verwijderen. U kunt ook de volgorde en namen van de kolommen wijzigen:

Het apparaatpictogram aanpassen

U kunt als volgt vanuit het deelvenster Apparaatdetails het apparaatpictogram aanpassen dat wordt weergegeven in de apparatenlijst:

1. Kies het potloodpictogram om het deelvenster Installatiekopie bewerken voor een apparaat te openen:

   

2. Upload een nieuwe installatiekopie of gebruik een van de bestaande installatiekopieën en klik vervolgens op Opslaan:

   

3. De geselecteerde afbeelding wordt nu weergegeven in de kolom Pictogram voor het apparaat.

Een apparaat toevoegen

Wanneer u de vooraf geconfigureerde oplossing implementeert, richt u automatisch de 25 proefapparaten in die u in de apparatenlijst ziet. Deze apparaten zijn gesimuleerde apparaten uitgevoerd in een Azure WebJob. Gesimuleerde apparaten maken het voor u gemakkelijk om te experimenteren met een vooraf geconfigureerde oplossing zonder echte, fysieke apparaten te moeten implementeren. Raadpleeg de zelfstudie Uw apparaat koppelen aan de vooraf geconfigureerde oplossing voor externe bewaking als u een echt apparaat op de oplossing wilt aansluiten.

De volgende stappen laten zien hoe u een gesimuleerd apparaat toevoegt aan de oplossing:

1. Ga terug naar de lijst met apparaten.

2. Kies linksonder + Een apparaat toevoegen om een nieuw apparaat toe te voegen.

   

3. Kies Nieuwe toevoegen op de tegel Gesimuleerd apparaat.

   

   U kunt niet alleen een nieuw gesimuleerd apparaat maken, maar ook een fysiek apparaat toevoegen als u ervoor kiest om een aangepast apparaat te maken. Zie Uw apparaat aansluiten op de vooraf geconfigureerde IoT Suite-oplossing voor externe bewaking voor meer informatie over het koppelen van fysieke apparaten aan de oplossing.

4. Selecteer Laat mij mijn eigen apparaat-id definiëren en voer de unieke id van een apparaatnaam in, zoals mijnapparaat_01.

5. Kies Maken.

   

6. Kies in stap 3 van Een gesimuleerd apparaat toevoegen de optie Gereed om terug te keren naar de apparatenlijst.

7. In de lijst met apparaten kunt u zien dat uw apparaat wordt uitgevoerd.

   

8. U kunt op het dashboard ook de gesimuleerde telemetrie van het nieuwe apparaat bekijken:

   

Een apparaat uitschakelen en verwijderen

U kunt een apparaat uitschakelen en nadat het is uitgeschakeld kunt u het verwijderen:

Een regel toevoegen

Er zijn geen regels voor het nieuwe apparaat dat u zojuist hebt toegevoegd. In deze sectie voegt u een regel toe die een waarschuwing activeert wanneer de door het nieuwe apparaat gemelde temperatuur 47 graden overschrijdt. Voordat u begint, kunt u al zien dat de telemetriegeschiedenis voor het nieuwe apparaat op het dashboard aantoont dat de temperatuur van het apparaat nooit meer dan 45 graden bedraagt.

1. Ga terug naar de lijst met apparaten.

2. Selecteer het nieuwe apparaat in de apparatenlijst en kies daarna Regel toevoegen om een regel voor het apparaat toe te voegen.

3. Maak een regel die Temperatuur als gegevensveld gebruikt en AlarmTemp gebruikt als de uitvoer wanneer de temperatuur 47 graden overschrijdt:

   

4. Kies Regels opslaan en weergeven om uw wijzigingen op te slaan.

5. Kies Opdrachten in het deelvenster Apparaatdetails voor het nieuwe apparaat.

   

6. Selecteer ChangeSetPointTemp in de opdrachtlijst en stel SetPointTemp in op 45. Kies vervolgens Opdracht verzenden:

   

7. Ga terug naar het dashboard. Na korte tijd verschijnt in het deelvenster Geschiedenis van waarschuwingen een nieuwe vermelding wanneer de door het nieuwe apparaat gemelde temperatuur 47 graden overschrijdt:

   

8. Op de pagina Regels van het dashboard kunt u al uw regels bekijken en bewerken:

   

9. Op de pagina Acties van het dashboard kunt u alle acties die worden uitgevoerd in reactie op een regel bekijken en bewerken:

   

Filters beheren

In de apparatenlijst kunt u filters maken, opslaan en opnieuw laden om een aangepaste lijst met apparaten die zijn verbonden met uw hub weer te geven. Een filter maken:

1. Kies het pictogram Filter bewerken boven de apparatenlijst:

   

2. Voeg in de Filtereditor de velden, operators en waarden toe om de apparatenlijst te filteren. U kunt meerdere clausules toevoegen om uw filter te verfijnen. Kies Filteren om het filter toe te passen:

   

3. In dit voorbeeld wordt de lijst gefilterd op fabrikant en modelnummer:

   

4. Als u uw filter met een aangepaste naam wilt opslaan, kiest u het pictogram Opslaan als:

   

5. Als u een eerder opgeslagen filter opnieuw wilt toepassen, kiest u het pictogram Opgeslagen filter openen:

   

U kunt filters maken op basis van apparaat-id, apparaatstatus gewenste eigenschappen, gerapporteerde eigenschappen en tags. U kunt uw eigen aangepaste tags toevoegen aan een apparaat in het gedeelte Tags van het deelvenster Apparaatdetails of een taak voor het bijwerken van tags op meerdere apparaten uitvoeren.

Opdracht

Vanuit het deelvenster Apparaatdetails kunt u opdrachten naar het apparaat verzenden. Wanneer een apparaat voor het eerst wordt gestart, stuurt het naar de oplossing informatie over de opdrachten die het apparaat ondersteunt. Zie Opties van Azure IoT-Hub cloud-naar-apparaat voor een beschrijving van de verschillen tussen opdrachten en methoden.

1. Kies in het deelvenster Apparaatdetails de optie Opdrachten voor het geselecteerde apparaat:

   

2. Selecteer PingDevice in de lijst met opdrachten.

3. Kies Opdracht verzenden.

4. U ziet de status van de opdracht in de opdrachtgeschiedenis.

   

De oplossing houdt de status van elke opdracht bij die met de oplossing wordt verzonden. In eerste instantie is het resultaat In behandeling. Wanneer het apparaat meldt dat het de opdracht heeft uitgevoerd, wordt het resultaat ingesteld op Geslaagd.

Achter de schermen

Wanneer u een vooraf geconfigureerde oplossing implementeert, maakt het implementatieproces meerdere resources in het door u geselecteerde Azure-abonnement. U kunt deze resources weergeven in Azure Portal. Het implementatieproces maakt een resourcegroep met een naam die is gebaseerd op de naam die u voor uw vooraf geconfigureerde oplossing hebt gekozen:

U kunt de instellingen van elke resource weergeven door deze te selecteren in de lijst met resources in de resourcegroep.

U kunt ook de broncode voor de vooraf geconfigureerde oplossing weergeven. De broncode van de vooraf geconfigureerde oplossing voor externe bewaking bevindt zich in de GitHub-opslagplaats azure-iot-remote-monitoring:

• De map DeviceAdministration bevat de broncode voor het dashboard.
• De map Simulator bevat de broncode voor het gesimuleerde apparaat.
• De map EventProcessor bevat de broncode voor het back-endproces dat de binnenkomende telemetrie verwerkt.

Wanneer u klaar bent, kunt u de vooraf geconfigureerde oplossing verwijderen uit uw Azure-abonnement op de site azureiotsuite.com. Met de site kunt u gemakkelijk resources verwijderen die werden aangevoerd toen u de vooraf geconfigureerde oplossing hebt gemaakt.

Volgende stappen

Nu u een werkende vooraf geconfigureerde oplossing hebt geïmplementeerd, kunt u doorgaan met IoT Suite door de volgende artikels te lezen:

• Walkthrough over de vooraf geconfigureerde oplossing voor externe bewaking
• Uw apparaat koppelen aan de vooraf geconfigureerde oplossing voor externe bewaking
• Machtigingen op de site azureiotsuite.com