Share via


Remoteverwaltung von Ressourcenkonfigurationen

Wichtig

Die von Azure Arc aktivierte Azure IoT Operations Preview befindet sich derzeit in der VORSCHAU. Sie sollten diese Vorschausoftware nicht in Produktionsumgebungen verwenden.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Eine Ressource in Azure IoT Einsatz Preview ist eine logische Entität, die Sie erstellen, um eine reale Ressource darzustellen. Eine Azure IoT Einsatz-Ressource kann Eigenschaften, Tags und Ereignisse aufweisen, die ihr Verhalten und ihre Merkmale beschreiben.

OPC UA-Server sind Softwareanwendungen, die mit Ressourcen kommunizieren. OPC UA-Server machen OPC UA-Tags verfügbar, die Datenpunkte darstellen. OPC UA-Tags können Echtzeit- oder Verlaufsdaten über den Status, die Leistung, die Qualität oder den Zustand von Ressourcen bereitstellen.

Ein Ressourcenendpunkt ist eine benutzerdefinierte Ressource in Ihrem Kubernetes-Cluster, die OPC UA-Server mit OPC UA-Connectormodulen verbindet. Über diese Verbindung kann ein OPC UA-Connector auf die Datenpunkte einer Ressource zugreifen. Ohne einen Ressourcenendpunkt können Daten nicht von einem OPC UA-Server an die Azure IoT OPC UA Broker (Preview)-Instanz und die Azure IoT MQ (Preview)-Instanz fließen. Nachdem Sie die benutzerdefinierten Ressourcen in Ihrem Cluster konfiguriert haben, wird eine Verbindung mit dem nachgeschalteten OPC UA-Server hergestellt, und der Server leitet Telemetriedaten an die OPC UA Broker-Instanz weiter.

Eine Site ist eine Sammlung von Azure IoT Einsatz-Instanzen. Sites helfen Ihnen, Ihre Instanzen zu organisieren und die Zugriffssteuerung zu verwalten. Ihr IT-Administrator erstellt Sites, weist ihnen Instanzen zu und gewährt Ihnen Zugriff auf OT-Benutzer in Ihrer Organisation.

Im Azure IoT Einsatz-Portal (Vorschau) stellt eine Instanz ein Azure IoT Einsatz-Cluster dar. Eine Instanz kann einen oder mehrere Objektendpunkte aufweisen.

Dieser Artikel beschreibt, wie Sie das Azure IoT Operations (Preview) Portal und die Azure CLI verwenden, um:

  • Definieren von Ressourcenendpunkten
  • Hinzufügen von Ressource und Definieren von Tags und Ereignissen

Diese Ressourcen, Tags und Ereignisse ordnen von OPC UA-Servern eingehende Daten Anzeigenamen zu, die Sie in den MQ-Broker- und Azure IoT-Datenverarbeitung (Preview)-Pipelines verwenden können.

Voraussetzungen

Zum Konfigurieren eines Ressourcenendpunkts benötigen Sie eine laufende Instanz von Azure IoT Einsatz.

Anmelden

Gehen Sie wie folgt vor, um sich beim Azure IoT Einsatz-Portal (Vorschau) anzumelden: Navigieren Sie in Ihrem Browser zum Azure IoT Einsatz-Portal (Vorschau), und melden Sie sich mit Ihren Microsoft Entra ID-Anmeldeinformationen an.

Auswählen Ihrer Site

Nachdem Sie sich angemeldet haben, zeigt das Portal eine Liste der Sites an, auf die Sie Zugriff haben. Jede Site ist eine Sammlung von Azure IoT Einsatz-Instanzen, in denen Sie Ihre Ressourcen konfigurieren können. Ihr IT-Administrator ist für das Organisieren von Instanzen in Sites und dem Gewähren des Zugriffs auf OT-Benutzer in Ihrer Organisation verantwortlich. Instanzen, die nicht Teil einer Site sind, werden im Knoten Nicht zugewiesenen Instanzen angezeigt. Wählen Sie die Site aus, die Sie verwenden möchten:

Screenshot, der eine Liste von Sites im Azure Iot Einsatz-Portal (Vorschau) anzeigt.

Tipp

Sie können das Filterfeld verwenden, um nach Sites zu suchen.

Wenn keine Sites angezeigt werden, befinden Sie sich möglicherweise nicht im richtigen Azure Active Directory-Mandanten. Sie können den Mandanten über das Menü rechts oben im Portal ändern. Wenn immer noch keine Sites angezeigt werden, bedeutet das, dass Sie noch zu keinem hinzugefügt wurden. Wenden Sie sich an Ihren IT-Administrator, um Zugriff anzufordern.

Auswählen Ihrer Instanz

Nachdem Sie eine Site ausgewählt haben, zeigt das Portal eine Liste der Azure IoT Einsatz-Instanzen an, die Teil der Site sind. Wählen Sie die Instanz aus, die Sie verwenden möchten:

Screenshot, der eine Liste der Instanzen im Azure IoT Einsatz-Portal (Vorschau) anzeigt.

Tipp

Sie können das Filterfeld verwenden, um nach Instanzen zu suchen.

Erstellen eines Ressourcenendpunkts

Standardmäßig enthält eine Azure IoT Einsatz-Bereitstellung einen integrierten OPC PLC-Simulator. So erstellen Sie einen Ressourcenendpunkt, der den integrierten OPC PLC-Simulator verwendet:

  1. Wählen Sie Ressourcenendpunkte und dann Ressourcenendpunkt erstellen aus:

    Screenshot: Seite „Asset endpoints“ (Ressourcenendpunkte) im Azure IoT Einsatz-Portal (Vorschau)

    Tipp

    Sie können das Filterfeld verwenden, um nach Objektendpunkten zu suchen.

  2. Geben Sie die folgenden Informationen für den Endpunkt ein:

    Feld Wert
    Name opc-ua-connector-0
    OPC UA Broker-URL opc.tcp://opcplc-000000:50000
    Benutzerauthentifizierung Anonymous
    Transportauthentifizierung Do not use transport authentication certificate
  3. Wählen Sie Erstellen aus, um die Definition zu speichern.

Diese Konfiguration stellt dem Cluster eine neue assetendpointprofile-Ressource namens opc-ua-connector-0 zur Verfügung. Nachdem Sie eine Ressource definiert haben, wird sie von einem OPC UA-Connector-Pod erkannt. Der Pod verwendet den Ressourcenendpunkt, den Sie in der Ressourcendefinition angeben, um eine Verbindung mit einem OPC UA-Server herzustellen.

Wenn der OPC PLC-Simulator ausgeführt wird, fließen die Daten vom Simulator zum Connector, weiter zum OPC UA-Broker und schließlich zum MQ-Broker.

Konfigurieren eines Ressourcenendpunkts für die Verwendung von Benutzernamen und Kennwort

Im vorherigen Beispiel wird der Authentifizierungsmodus Anonymous verwendet. Dieser Modus erfordert weder einen Benutzernamen noch ein Kennwort.

Führen Sie die folgenden Schritte aus, um den Authentifizierungsmodus UsernamePassword zu verwenden:

  1. Führen Sie die Schritte unter Konfigurieren der OPC UA-Benutzerauthentifizierung mit Benutzername und Kennwort aus, um geheime Schlüssel für Benutzername und Kennwort in Azure Key Vault hinzuzufügen und sie in Kubernetes-Cluster zu projizieren.
  2. Wählen Sie im Azure IoT Einsatz-Portal (Vorschau) im Feld Benutzerauthentifizierung die Option Username & password (Benutzername und Kennwort) aus, um den Ressourcenendpunkt so zu konfigurieren, dass diese Geheimnisse verwendet werden. Geben Sie dann die folgenden Werte für die Felder Verweis auf Benutzername und Verweis auf Kennwort ein:
Feld Wert
Verweis auf Benutzername aio-opc-ua-broker-user-authentication/username
Verweis auf Kennwort aio-opc-ua-broker-user-authentication/password

Konfigurieren eines Ressourcenendpunkts für die Verwendung eines Transportauthentifizierungszertifikats

Führen Sie die folgenden Schritte aus, um den Objektendpunkt für die Verwendung eines Transportauthentifizierungszertifikats zu konfigurieren:

  1. Führen Sie die Schritte zum Konfigurieren der gegenseitigen Vertrauensstellung aus, um einem Azure Key Vault ein Transportzertifikat und einen privaten Schlüssel hinzuzufügen, und projizieren Sie sie in Kubernetes-Cluster.
  2. Wählen Sie im Azure IoT Einsatz-Portal (Vorschau) im Feld Transport authentication (Transportauthentifizierung) die Option Use transport authentication certificate (Transportauthentifizierungszertifikat verwenden) aus, und geben Sie den Zertifikatfingerabdruck ein.

Hinzufügen von Ressourcen, Tags und Ereignissen

So fügen Sie eine Ressource im Azure IoT Einsatz-Portal (Vorschau) hinzu:

  1. Wählen Sie die Registerkarte Objekte aus. Bevor Sie Objekte erstellen, wird der folgende Bildschirm angezeigt:

    Screenshot: Leere Registerkarte „Ressourcen“ im Azure IoT Einsatz-Portal (Vorschau)

    Tipp

    Sie können das Filterfeld verwenden, um nach Ressourcen zu suchen.

    Wählen Sie Ressource erstellen aus.

  2. Geben Sie auf dem Bildschirm „Ressourcendetails“ die folgenden Ressourceninformationen ein:

    • Name der Anlage
    • Ressourcenendpunkt. Wählen Sie Ihren Ressourcenendpunkt aus der Liste aus.
    • Beschreibung

    Screenshot: Hinzufügen von Ressourcendetails im Azure IoT Einsatz-Portal (Vorschau)

  3. Konfigurieren Sie den Satz von Eigenschaften, die Sie dem Objekt zuordnen möchten. Sie können die Standardliste der Eigenschaften akzeptieren oder Eigene hinzufügen. Die folgenden Eigenschaften sind standardmäßig verfügbar:

    • Hersteller
    • Hersteller-URI
    • Modell
    • Produktcode
    • Hardware version
    • Softwareversion
    • Seriennummer
    • Dokumentations-URI
  4. Wählen Sie Weiter aus, um zur Seite Tags hinzufügen zu wechseln.

Hinzufügen einzelner Tags zu einer Ressource

Jetzt können Sie die Tags definieren, die der Ressource zugeordnet sind. So fügen Sie OPC UA-Tags hinzu:

  1. Wählen Sie "Tag hinzufügen" oder "CSV-Tag > hinzufügen" aus.

  2. Geben Sie Ihre Tagdetails ein:

    • Knoten-ID. Dieser Wert entspricht der Knoten-ID vom OPC UA-Server.
    • Tagname (optional). Dieser Wert ist der Anzeigename, den Sie für das Tag verwenden möchten. Wenn Sie keinen Tagnamen angeben, wird die Knoten-ID als Tagname verwendet.
    • Einblickmodus (optional) mit folgenden Optionen:
      • None
      • Maßstab
      • Leistungsindikator
      • Histogramm
      • Protokoll
    • Samplingintervall (Millisekunden). Sie können den Standardwert für dieses Tag überschreiben.
    • Warteschlangengröße. Sie können den Standardwert für dieses Tag überschreiben.

    Screenshot: Hinzufügen von Tags im Azure IoT Einsatz-Portal (Vorschau)

    In der folgenden Tabelle sind einige Beispieltagwerte aufgeführt, die Sie mit dem integrierten OPC PLC-Simulator verwenden können:

    Knoten-ID Tagname Einblickmodus
    ns=3;s=FastUInt10 Temperatur Keine
    ns=3;s=FastUInt100 Tag 10 Keine
  3. Wählen Sie Standardeinstellungen verwalten aus, um die Standard-Telemetrieeinstellungen für die Ressource zu konfigurieren. Diese Einstellungen gelten für alle OPC UA-Tags, die zu dieser Ressource gehören. Sie können diese Einstellungen für jedes von Ihnen hinzugefügte Tag überschreiben. Zu den Standard-Telemetrieeinstellungen gehören:

    • Samplingintervall (Millisekunden): Das Samplingintervall gibt die schnellste Rate an, mit der der OPC UA Server Stichproben von seiner zugrunde liegenden Quelle abrufen soll, um diese auf Datenänderungen zu überprüfen.
    • Veröffentlichungsintervall (Millisekunden): Die Rate, mit der der OPC UA Server Daten veröffentlichen soll.
    • Warteschlangengröße: Die Größe der Warteschlange zum Speichern der Samplingdaten, bevor sie veröffentlicht werden.

Massenhinzufügen von Tags zu einer Ressource

Sie können bis zu 1.000 OPC UA-Tags gleichzeitig aus einer CSV-Datei importieren:

  1. Erstellen Sie eine CSV-Datei, die wie das folgende Beispiel aussieht:

    Knoten-ID (NodeID) TagName Samplingintervall – Millisekunden QueueSize ObservabilityMode
    ns=3;s=FastUInt1000 Tag 1000 1.000 5 Keine
    ns=3;s=FastUInt1001 Tag 1001 1.000 5 Keine
    ns=3;s=FastUInt1002 Tag 1002 5.000 10 Keine
  2. Wählen Sie "Tag- oder CSV-Import > CSV-Datei(.csv)" aus. Wählen Sie die CSV-Datei, die Sie erstellt haben, und anschließend Öffnen aus. Die in der CSV-Datei definierten Tags werden importiert:

    Screenshot: Abgeschlossener Import der Excel-Datei im Azure IoT Einsatz-Portal (Vorschau)

    Wenn Sie eine CSV-Datei importieren, die Tags enthält, die Duplikate bereits vorhandener Tags sind, wird im Azure IoT Einsatz-Portal (Vorschau) die folgende Meldung angezeigt:

    Screenshot: Fehlermeldung beim Importieren doppelter Tagdefinitionen im Azure IoT Einsatz-Portal (Vorschau)

    Sie können die doppelten Tags entweder ersetzen und neue Tags aus der Importdatei hinzufügen oder den Import abbrechen.

  3. Wenn Sie alle Tags aus einer Ressource in eine CSV-Datei exportieren möchten, wählen Sie Alle exportieren und einen Speicherort für die Datei aus:

    Screenshot: Exportieren von Tagdefinitionen aus einer Ressource im Azure IoT Einsatz-Portal (Vorschau)

  4. Wählen Sie auf der Seite Tags die Option Weiter aus, um zur Seite Ereignisse hinzufügen zu wechseln.

Tipp

Sie können das Filterfeld verwenden, um nach Tags zu suchen.

Hinzufügen einzelner Ereignisse zu einer Ressource

Jetzt können Sie die Ereignisse definieren, die der Ressource zugeordnet sind. So fügen Sie OPC UA-Ereignisse hinzu:

  1. Wählen Sie Ereignis hinzufügen oder CSV>Ereignis hinzufügen aus.

  2. Geben Sie die Ereignisdetails ein:

    • Ereignisbenachrichtigung. Dieser Wert entspricht der Ereignisbenachrichtigung vom OPC UA-Server.
    • Ereignisname (optional). Dieser Wert ist der Anzeigename, den Sie für das Ereignis verwenden möchten. Wenn Sie keinen Ereignisnamen angeben, wird die Ereignisbenachrichtigung als Ereignisname verwendet.
    • Einblickmodus (optional) mit folgenden Optionen:
      • None
      • Maßstab
      • Leistungsindikator
      • Histogramm
      • Protokoll
    • Warteschlangengröße. Sie können den Standardwert für dieses Tag überschreiben.

    Screenshot: Hinzufügen von Ereignissen im Azure IoT Einsatz-Portal (Vorschau)

  3. Wählen Sie Standardeinstellungen verwalten aus, um die Standardereigniseinstellungen für die Ressource zu konfigurieren. Diese Einstellungen gelten für alle OPC UA-Ereignisse, die zu dieser Ressource gehören. Sie können diese Einstellungen für jedes von Ihnen hinzugefügte Ereignis überschreiben. Diese Standardereigniseinstellungen umfassen Folgendes:

    • Veröffentlichungsintervall (Millisekunden): Die Rate, mit der der OPC UA Server Daten veröffentlichen soll.
    • Warteschlangengröße: Die Größe der Warteschlange zum Speichern der Samplingdaten, bevor sie veröffentlicht werden.

Massenhinzufügen von Ereignissen zu einer Ressource

Sie können bis zu 1.000 OPC UA-Ereignisse gleichzeitig aus einer CSV-Datei importieren.

Wenn Sie alle Ereignisse aus einer Ressource in eine CSV-Datei exportieren möchten, wählen Sie Alle exportieren und einen Speicherort für die Datei aus.

Wählen Sie auf der Seite Ereignisse die Option Weiter aus, um zur Seite Überprüfen zu wechseln.

Tipp

Sie können das Filterfeld verwenden, um nach Ereignissen zu suchen.

Änderungen überprüfen

Überprüfen Sie Ihre Angaben zur Ressource, OPC UA-Tag- und Ereignisdetails, und nehmen Sie alle ggf. gewünschten Anpassungen vor:

Screenshot: Überprüfen von Ressource, Tags und Ereignissen im Azure IoT Einsatz-Portal (Vorschau)

Aktualisieren einer Ressource

Wählen Sie die zuvor erstellten Ressource aus. Verwenden Sie die Registerkarten Objektdetails, Tags und Ereignisse, um Änderungen vorzunehmen:

Screenshot: Aktualisieren einer bereits vorhandenen Ressource im Azure IoT Einsatz-Portal (Vorschau)

Auf der Registerkarte Tags können Sie Tags hinzufügen, vorhandene Tags aktualisieren oder Tags entfernen.

Um ein Tag zu aktualisieren, wählen Sie ein vorhandenes Tag aus, und aktualisieren Sie die Taginformationen. Wählen Sie dann Aktualisieren aus:

Screenshot: Aktualisieren eines bereits vorhandenen Tags im Azure IoT Einsatz-Portal (Vorschau)

Um Tags zu entfernen, wählen Sie ein oder mehrere Tags aus, und wählen Sie dann Tags entfernen aus:

Screenshot: Löschen eines Tags im Azure IoT Einsatz-Portal (Vorschau)

Sie können auf die gleiche Weise auch Ereignisse und Eigenschaften hinzufügen, aktualisieren und löschen.

Wenn Sie mit der Bearbeitung fertig sind, wählen Sie Speichern aus, um Ihre Änderungen zu speichern.

Löschen eines Medienobjekts

Um eine Ressource zu löschen, wählen Sie die Ressource aus, das Sie löschen möchten. Wählen Sie auf der Detailseite der Ressource die Option Löschen aus. Bestätigen Sie Ihre Änderungen, um die Ressource zu löschen:

Screenshot: Löschen einer Ressource im Azure IoT Einsatz-Portal (Vorschau)

Benachrichtigungen

Immer wenn Sie im Azure IoT Einsatz-Portal (Vorschau) eine Änderung an einer Ressource vornehmen, wird eine Benachrichtigung mit Angaben zum Status des Vorgangs angezeigt:

Screenshot: Benachrichtigungen im Azure IoT Einsatz-Portal (Vorschau)