Lernprogramm: Visualisieren und Analysieren von Ereignissen aus Azure Digital Twins mithilfe von Time Series Insights

Wichtig

Eine neue Version des Azure Digital Twins-Diensts wurde veröffentlicht. Angesichts der erweiterten Funktionen des neuen Diensts wurde der ursprüngliche Azure Digital Twins-Dienst (in diesem Dokumentationssatz beschrieben) eingestellt.

Um die Dokumentation für den neuen Dienst anzuzeigen, besuchen Sie die aktive Azure Digital Twins-Dokumentation.

Nachdem Sie Ihre Azure Digital Twins-Instanz sowie Ihre Gebäudebereiche bereitgestellt und die benutzerdefinierte Funktion zum Überwachen bestimmter Bedingungen implementiert haben, können Sie die Ereignisse und Daten aus den Gebäudebereichen analysieren, um Trends und Abweichungen zu erkennen.

Im ersten Tutorial haben Sie den Raumgraphen eines imaginären Gebäudes mit einem Raum mit Bewegungs-, Kohlendioxid- und Temperatursensoren konfiguriert. Im zweiten Tutorial haben Sie Ihren Graphen und eine benutzerdefinierte Funktion bereitgestellt. Die Funktion überwacht die Sensorwerte und löst Benachrichtigungen aus, wenn die richtigen Bedingungen erfüllt sind, d.h. wenn der Raum leer ist und die Temperatur- und Kohlendioxidwerte normal sind.

In diesem Tutorial erfahren Sie, wie Sie die Benachrichtigungen und Daten aus Ihrem Azure Digital Twins-Setup in Azure Time Series Insights integrieren. Sie können die Sensorwerte dann im Zeitverlauf visualisieren. Sie können nach Trends suchen, beispielsweise welcher Raum am häufigsten genutzt wird und zu welcher Tageszeit der Raum am häufigsten belegt ist. Sie können auch Abweichungen erkennen, beispielsweise in welchen Räumen es wärmer und die Luftqualität schlecht ist oder ob ein Bereich im Gebäude durchgängig hohe Temperaturwerte meldet, die auf eine defekte Klimaanlage hinweisen.

In diesem Tutorial lernen Sie Folgendes:

• Streamen von Daten mithilfe von Azure Event Hubs
• Analysieren mit Time Series Insights

Voraussetzungen

In diesem Tutorial wird vorausgesetzt, dass Sie das Azure Digital Twins-Setup konfiguriert and bereitgestellt haben. Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie fortfahren:

• Ein Azure-Konto.
• Eine aktive Instanz von Azure Digital Twins.
• Die C#-Beispiele für Digital Twins (auf den Arbeitscomputer heruntergeladen und extrahiert).
• .NET Core SDK Version 2.1.403 oder höher auf dem Entwicklungscomputer zum Ausführen des Beispiels. Führen Sie dotnet --version aus, um zu überprüfen, ob die richtige Version installiert ist.

Tipp

Verwenden Sie bei der Bereitstellung einer neuen Instanz einen eindeutigen Namen für die Digital Twins-Instanz.

Streamen von Daten mithilfe von Event Hubs

Mit dem Event Hubs-Dienst können Sie eine Pipeline zum Streamen Ihrer Daten erstellen. In diesem Abschnitt wird erläutert, wie Sie den Event Hub als Konnektor zwischen Ihren Azure Digital Twins- und Time Series Insights-Instanzen erstellen.

Erstellen eines Ereignis-Hubs

1. Melden Sie sich beim Azure-Portal an.

2. Klicken Sie im linken Bereich auf Ressource erstellen.

3. Suchen Sie nach der Option Event Hubs, und wählen Sie sie aus. Klicken Sie auf Erstellen.

   

4. Geben Sie einen Namen für den Event Hubs-Namespace ein. Wählen Sie unter Tarif die Option Standard sowie Ihr Abonnement, die Ressourcengruppe, die Sie für Ihre Digital Twins-Instanz verwendet haben, sowie den Standort aus. Klicken Sie auf Erstellen.

5. Wählen Sie in der Event Hubs-Namespacebereitstellung erst den Bereich Übersicht und dann Zu Ressource wechseln aus.

   

6. Wählen Sie oben im Bereich Übersicht des Event Hubs-Namespace die Schaltfläche Event Hub aus.

7. Geben Sie einen Namen für den Event Hub ein, und wählen Sie Erstellen aus.

   Nach der Bereitstellung wird der Event Hub im Bereich Event Hubs des Event Hubs-Namespace mit dem Status Aktiv angezeigt. Wählen Sie diesen Event Hub aus, um den Bereich Übersicht zu öffnen.

8. Wählen Sie im oberen Bereich die Schaltfläche Consumergruppe, und geben Sie einen Namen für die Consumergruppe ein, beispielsweise tsievents. Klicken Sie auf Erstellen.

   

   Nach der Erstellung wird die Consumergruppe in der Liste unten im Bereich Übersicht des Event Hubs angezeigt.

9. Öffnen Sie den Bereich Freigegebene Zugriffsrichtlinien für Ihren Event Hub, und wählen Sie die Schaltfläche Hinzufügen aus. Geben Sie als Richtlinienname ManageSend ein, vergewissern Sie sich, dass alle Kontrollkästchen aktiviert sind, und wählen Sie Erstellen aus.

   

   Tipp

   Vergewissern Sie sich, dass Sie eine SAS-Richtlinie für Ihre Event Hub-Instanz und nicht den Namespace erstellen.

10. Öffnen Sie die von Ihnen erstellte ManageSend-Richtlinie , und kopieren Sie die Werte für Verbindungszeichenfolge – Primärschlüssel und Verbindungszeichenfolge – sekundärer Schlüssel in eine temporäre Datei. Sie benötigen diese Werte im nächsten Abschnitt, um einen Endpunkt für den Event Hub zu erstellen.

Erstellen eines Endpunkts für den Event Hub

1. Vergewissern Sie sich im Befehlsfenster, dass Sie sich im Ordner occupancy-quickstart\src des Azure Digital Twins-Beispiels befinden.

2. Öffnen Sie die Datei actions\createEndpoints.yaml im Editor. Ersetzen Sie den Inhalt durch den folgenden Code:

   - type: EventHub
     eventTypes:
     - SensorChange
     - SpaceChange
     - TopologyOperation
     - UdfCustom
     connectionString: Primary_connection_string_for_your_event_hub
     secondaryConnectionString: Secondary_connection_string_for_your_event_hub
     path: Name_of_your_Event_Hub
   - type: EventHub
     eventTypes:
     - DeviceMessage
     connectionString: Primary_connection_string_for_your_event_hub
     secondaryConnectionString: Secondary_connection_string_for_your_event_hub
     path: Name_of_your_Event_Hub
   

3. Ersetzen Sie die Platzhalter Primary_connection_string_for_your_event_hub durch den Wert der Verbindungszeichenfolge – Primärschlüssel für den Ereignishub. Stellen Sie sicher, dass die Verbindungszeichenfolge das folgende Format aufweist:

   Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey1GUID;EntityPath=nameOfYourEventHub
   

4. Ersetzen Sie die Platzhalter Secondary_connection_string_for_your_event_hub durch den Wert der Verbindungszeichenfolge – sekundärer Schlüssel für den Ereignishub. Stellen Sie sicher, dass die Verbindungszeichenfolge das folgende Format aufweist:

   Endpoint=sb://nameOfYourEventHubNamespace.servicebus.windows.net/;SharedAccessKeyName=ManageSend;SharedAccessKey=yourShareAccessKey2GUID;EntityPath=nameOfYourEventHub
   

5. Ersetzen Sie die Platzhalter Name_of_your_Event_Hub durch den Namen Ihres Event Hubs.

   Wichtig

   Geben Sie alle Werte ohne Anführungszeichen ein. Stellen Sie sicher, dass nach den Doppelpunkten in der YAML-Datei mindestens ein Leerzeichen vorhanden ist. Sie können ihre YAML-Dateiinhalte auch mithilfe eines beliebigen Online-YAML-Validators überprüfen, z. B. dieses Tool.

6. Speichern und schließen Sie die Datei. Führen Sie im Befehlsfenster den folgenden Befehl aus, und melden Sie sich mit Ihrem Azure-Konto an, wenn Sie dazu aufgefordert werden.

   dotnet run CreateEndpoints
   

   Dieser Befehl erstellt zwei Endpunkte für Ihren Event Hub.

   

Analysieren mit Time Series Insights

1. Wählen Sie auf der linken Seite im Azure-Portal die Option Ressource erstellen aus.

2. Suchen Sie nach einer allgemein verfügbaren Time Series Insights-Ressource, und wählen Sie sie aus. Klicken Sie auf Erstellen.

3. Geben Sie einen Namen für Ihre Time Series Insights-Instanz ein, und wählen Sie dann Ihr Abonnement aus. Wählen Sie die Ressourcengruppe, die Sie für Ihre Digital Twins-Instanz verwendet haben, und den Standort aus. Wählen Sie "Weiter" aus: Schaltfläche "Ereignisquelle " oder die Registerkarte " Ereignisquelle ".

   

4. Geben Sie auf der Registerkarte Ereignisquelle einen Namen ein. Wählen Sie Event Hub als Quelltyp aus, und stellen Sie sicher, dass die anderen Werte ordnungsgemäß ausgewählt sind, um auf den erstellten Event Hub zu verweisen. Wählen Sie unter Event Hub-Richtlinienname den Namen ManageSend und anschließend die im vorherigen Abschnitt erstellte Consumergruppe für Event Hub-Consumergruppe aus. Klicken Sie auf Überprüfen + erstellen.

   

5. Überprüfen Sie im Bereich Überprüfen + erstellen die von Ihnen eingegebenen Informationen, und klicken Sie auf Erstellen.

6. Wählen Sie im Bereitstellungsbereich die Time Series Insights-Ressource aus, die Sie erstellt haben. Der Bereich Übersicht für Ihre Time Series Insights-Umgebung wird geöffnet.

7. Klicken Sie oben auf die Schaltfläche Zur Umgebung wechseln. Falls eine Datenzugriffswarnung angezeigt wird, öffnen Sie den Bereich Datenzugriffsrichtlinien für Ihre Time Series Insights-Instanz, und wählen Sie Hinzufügen, die Rolle Mitwirkender und anschließend den gewünschten Benutzer aus.

8. Die Schaltfläche Zur Umgebung wechseln öffnet den Time Series Insights-Explorer. Wenn keine Ereignisse angezeigt werden, simulieren Sie Geräteereignisse, indem Sie zum Projekt device-connectivity des Digital Twins-Beispiels navigieren und dotnet run ausführen.

9. Nachdem einige simulierte Ereignisse generiert wurden, kehren Sie zum Time Series Insights-Explorer zurück, und wählen Sie oben die Schaltfläche „Aktualisieren“. Daraufhin sollten Analysediagramme, die für Ihre simulierten Sensordaten erstellt werden, angezeigt werden.

   

10. Im Time Series Insights-Explorer können Sie dann Diagramme und Wärmebilder für verschiedene Ereignisse und Daten von Ihren Räumen, Sensoren und anderen Ressourcen generieren. Klicken Sie auf der linken Seite auf die Dropdownfelder MEASURE und TEILEN NACH, um eigene Visualisierungen zu erstellen.

    Wählen Sie beispielsweise im Feld MEASURE die Option Ereignisse und im Feld TEILEN NACH die Option DigitalTwins-SensorHardwareId aus, um ein Wärmebild für jeden Sensor zu generieren. Das Wärmebild sieht etwa wie in der folgenden Abbildung aus:

    

Bereinigen von Ressourcen

Falls Sie sich nicht weiter mit Azure Digital Twins befassen möchten, können Sie die in diesem Tutorial erstellten Ressourcen löschen:

1. Wählen Sie im Azure-Portal im Menü auf der linken Seite Alle Ressourcen und Ihre Digital Twins-Ressourcengruppe aus, und klicken Sie dann auf Löschen.

   Tipp

   Für den Fall, dass bei Ihnen Probleme beim Löschen der Digital Twins-Instanz aufgetreten sind, wurde ein Dienstupdate mit einer entsprechenden Korrektur bereitgestellt. Versuchen Sie erneut, die Instanz zu löschen.

2. Löschen Sie ggf. die Beispielanwendungen auf Ihrem Arbeitscomputer.

Nächste Schritte

Im nächsten Artikel erfahren Sie mehr über Raumintelligenzgraphen und Objektmodelle in Azure Digital Twins.

Grundlegendes zum Digital Twins-Objektmodell und zum Raumintelligenzgraphen