Assetconfiguraties extern beheren

Belangrijk

Azure IoT Operations Preview: ingeschakeld door Azure Arc is momenteel in PREVIEW. Gebruik deze preview-software niet in productieomgevingen.

Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

Een asset in Azure IoT Operations Preview is een logische entiteit die u maakt om een echte asset weer te geven. Een Azure IoT Operations-asset kan eigenschappen, tags en gebeurtenissen bevatten die het gedrag en de kenmerken ervan beschrijven.

OPC UA-servers zijn softwaretoepassingen die communiceren met assets. OPC UA-servers stellen OPC UA-tags beschikbaar die gegevenspunten vertegenwoordigen. OPC UA-tags bieden realtime of historische gegevens over de status, prestaties, kwaliteit of conditie van assets.

Een asseteindpunt is een aangepaste resource in uw Kubernetes-cluster die OPC UA-servers verbindt met OPC UA-connectormodules. Met deze verbinding kan een OPC UA-connector toegang krijgen tot de gegevenspunten van een asset. Zonder een asseteindpunt kunnen gegevens niet stromen van een OPC UA-server naar het Azure IoT OPC UA Broker Preview-exemplaar en azure IoT MQ Preview-exemplaar. Nadat u de aangepaste resources in uw cluster hebt geconfigureerd, wordt er een verbinding tot stand gebracht met de downstream OPC UA-server en stuurt de server telemetrie door naar het OPC UA Broker-exemplaar.

Een site is een verzameling Azure IoT Operations-exemplaren. Met sites kunt u uw exemplaren ordenen en toegangsbeheer beheren. Uw IT-beheerder maakt sites, wijst instanties eraan toe en verleent toegang tot OT-gebruikers in uw organisatie.

In de Azure IoT Operations-portal (preview) vertegenwoordigt een exemplaar een Azure IoT Operations-cluster. Een exemplaar kan een of meer asseteindpunten hebben.

In dit artikel wordt beschreven hoe u de Azure IoT Operations-portal (preview) en de Azure CLI gebruikt om:

• Definieer de asseteindpunten die assets verbinden met uw Azure IoT Operations-exemplaar.
• Voeg assets toe en definieer hun tags en gebeurtenissen om de gegevensstroom van OPC UA-servers naar de Azure IoT MQ-broker in te schakelen.

Met deze assets, tags en gebeurtenissen worden binnenkomende gegevens van OPC UA-servers toegewezen aan beschrijvende namen die u kunt gebruiken in de MQ-broker- en Azure IoT Data Processor Preview-pijplijnen.

Vereisten

Als u een eindpunt voor assets wilt configureren, hebt u een actief exemplaar van Azure IoT Operations nodig.

Aanmelden

Azure IoT Operations-portal

Als u zich wilt aanmelden bij de Azure IoT Operations-portal (preview), gaat u naar de Azure IoT Operations-portal (preview) in uw browser en meldt u zich aan met uw Microsoft Entra ID-referenties.

Uw site selecteren

Nadat u zich hebt aangemeld, wordt in de portal een lijst weergegeven met sites waartoe u toegang hebt. Elke site is een verzameling Azure IoT Operations-exemplaren waar u uw assets kunt configureren. Uw IT-beheerder is verantwoordelijk voor het organiseren van instanties in sites en het verlenen van toegang tot OT-gebruikers in uw organisatie. Exemplaren die geen deel uitmaken van een site, worden weergegeven in het knooppunt Niet-toegewezen exemplaren . Selecteer de site die u wilt gebruiken:

Tip

U kunt het filtervak gebruiken om te zoeken naar sites.

Als u geen sites ziet, bevindt u zich mogelijk niet in de juiste Azure Active Directory-tenant. U kunt de tenant wijzigen in het menu rechtsboven in de portal. Als u nog steeds geen sites ziet, betekent dit dat u nog niet aan een site bent toegevoegd. Neem contact op met uw IT-beheerder om toegang aan te vragen.

Selecteer uw exemplaar

Nadat u een site hebt geselecteerd, wordt in de portal een lijst weergegeven met de Azure IoT Operations-exemplaren die deel uitmaken van de site. Selecteer het exemplaar dat u wilt gebruiken:

Tip

U kunt het filtervak gebruiken om te zoeken naar exemplaren.

Azure-CLI

Voordat u de az iot ops asset opdrachten gebruikt, meldt u zich aan bij het abonnement dat uw Azure IoT Operations-implementatie bevat:

az login

Een asseteindpunt maken

Een Azure IoT Operations-implementatie bevat standaard een ingebouwde OPC PLC-simulator. Een asseteindpunt maken dat gebruikmaakt van de ingebouwde OPC PLC-simulator:

Azure IoT Operations-portal

1. Selecteer Asseteindpunten en vervolgens Asseteindpunt maken:

   

   Tip

   U kunt het filtervak gebruiken om te zoeken naar asseteindpunten.

2. Voer de volgende eindpuntgegevens in:

   Veld	Weergegeven als
   Naam	opc-ua-connector-0
   OPC UA Broker URL	opc.tcp://opcplc-000000:50000
   Gebruikersverificatie	Anonymous
   Transportverificatie	Do not use transport authentication certificate

3. Als u de definitie wilt opslaan, selecteert u Maken.

Azure-CLI

Voer de volgende opdracht uit:

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

Tip

Gebruik az connectedk8s list dit om de clusters weer te geven waar u toegang toe hebt.

Zie az iot ops asset endpoint voor meer informatie.

Met deze configuratie wordt een nieuwe assetendpointprofile resource geïmplementeerd die naar het cluster wordt aangeroepen opc-ua-connector-0 . Nadat u een asset hebt gedefinieerd, detecteert een OPC UA-connectorpod deze. De pod maakt gebruik van het asseteindpunt dat u in de assetdefinitie opgeeft om verbinding te maken met een OPC UA-server.

Wanneer de OPC PLC-simulator wordt uitgevoerd, stromen gegevens van de simulator naar de connector, naar de OPC UA-broker en ten slotte naar de MQ-broker.

Een asseteindpunt configureren voor het gebruik van een gebruikersnaam en wachtwoord

In het vorige voorbeeld wordt de Anonymous verificatiemodus gebruikt. Voor deze modus is geen gebruikersnaam of wachtwoord vereist.

Azure IoT Operations-portal

Voer de volgende stappen uit om de UsernamePassword verificatiemodus te gebruiken:

1. Volg de stappen in OPC UA-gebruikersverificatie configureren met gebruikersnaam en wachtwoord om geheimen voor gebruikersnaam en wachtwoord toe te voegen in Azure Key Vault en deze te projecteren in een Kubernetes-cluster.
2. Selecteer in de Azure IoT Operations-portal (preview) gebruikersnaam en wachtwoord voor het veld Gebruikersverificatie om het asseteindpunt te configureren voor het gebruik van deze geheimen. Voer vervolgens de volgende waarden in voor de velden Gebruikersnaam en Wachtwoordreferentie :

Veld	Waarde
Naslaginformatie voor gebruikersnaam	aio-opc-ua-broker-user-authentication/username
Wachtwoordreferentie	aio-opc-ua-broker-user-authentication/password

Azure-CLI

Voer de volgende stappen uit om de UsernamePassword verificatiemodus te gebruiken:

1. Volg de stappen in OPC UA-gebruikersverificatie configureren met gebruikersnaam en wachtwoord om geheimen voor gebruikersnaam en wachtwoord toe te voegen in Azure Key Vault en deze te projecteren in een Kubernetes-cluster.

2. Gebruik een opdracht zoals in het volgende voorbeeld om uw asseteindpunt te maken:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Een asseteindpunt configureren voor het gebruik van een transportverificatiecertificaat

Voer de volgende stappen uit om het asseteindpunt te configureren voor het gebruik van een certificaat voor transportverificatie:

Azure IoT Operations-portal

1. Volg de stappen bij het configureren van wederzijdse vertrouwen om een transportcertificaat en een persoonlijke sleutel toe te voegen aan Azure Key Vault en deze te projecteren in een Kubernetes-cluster.
2. Selecteer in de Azure IoT Operations-portal (preview) transportverificatiecertificaat gebruiken voor het veld Transportverificatie en voer de vingerafdruk van het certificaat in.

Azure-CLI

1. Volg de stappen bij het configureren van wederzijdse vertrouwen om een transportcertificaat en een persoonlijke sleutel toe te voegen aan Azure Key Vault en deze te projecteren in een Kubernetes-cluster.

2. Gebruik een opdracht zoals in het volgende voorbeeld om uw asseteindpunt te maken:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Zie az iot ops asset voor meer informatie.

Een asset, tags en gebeurtenissen toevoegen

Azure IoT Operations-portal

Een asset toevoegen in de Azure IoT Operations-portal (preview):

1. Selecteer het tabblad Assets . Voordat u assets maakt, ziet u het volgende scherm:

   

   Tip

   U kunt het filtervak gebruiken om te zoeken naar assets.

   Selecteer Asset maken.

2. Voer in het scherm met assetdetails de volgende assetgegevens in:

   • Assetnaam
   • Asseteindpunt. Selecteer uw asseteindpunt in de lijst.
   • Beschrijving

3. Configureer de set eigenschappen die u aan de asset wilt koppelen. U kunt de standaardlijst met eigenschappen accepteren of uw eigen eigenschappen toevoegen. De volgende eigenschappen zijn standaard beschikbaar:

   • Fabrikant
   • Fabrikant-URI
   • Model
   • Productcode
   • Hardwareversie
   • Softwareversie
   • Serienummer
   • Documentatie-URI

   

4. Selecteer Volgende om naar de pagina Tags toevoegen te gaan.

Afzonderlijke tags toevoegen aan een asset

U kunt nu de tags definiëren die aan de asset zijn gekoppeld. OPC UA-tags toevoegen:

1. Selecteer Tag toevoegen of CSV-tag> toevoegen.

2. Voer uw taggegevens in:

   • Knooppunt-id. Deze waarde is de knooppunt-id van de OPC UA-server.
   • Tagnaam (optioneel). Deze waarde is de beschrijvende naam die u voor de tag wilt gebruiken. Als u geen tagnaam opgeeft, wordt de knooppunt-id gebruikt als tagnaam.
   • De waarneembaarheidsmodus (optioneel) met de volgende opties:
     • Geen
     • Meter
     • teller
     • Histogram
     • Logboek
   • Samplinginterval (milliseconden). U kunt de standaardwaarde voor deze tag overschrijven.
   • Wachtrijgrootte. U kunt de standaardwaarde voor deze tag overschrijven.

   

   In de volgende tabel ziet u enkele voorbeeldcodewaarden die u kunt gebruiken met de ingebouwde OPC PLC-simulator:

   Knooppunt-id	Naam van tag	Waarneembaarheidsmodus
   ns=3; s=FastUInt10	temperatuur	Geen
   ns=3; s=FastUInt100	Tag 10	Geen

3. Selecteer Standaardinstellingen beheren om standaardtelemetrie-instellingen voor de asset te configureren. Deze instellingen zijn van toepassing op alle OPC UA-tags die deel uitmaken van de asset. U kunt deze instellingen overschrijven voor elke tag die u toevoegt. Standaardtelemetrie-instellingen zijn onder andere:

   • Sampling-interval (milliseconden): het steekproefinterval geeft de snelste snelheid aan waarmee de OPC UA-server de onderliggende bron moet samplen voor gegevenswijzigingen.
   • Publicatie-interval (milliseconden): de snelheid waarmee OPC UA Server gegevens moet publiceren.
   • Wachtrijgrootte: de diepte van de wachtrij voor het opslaan van de samplinggegevens voordat u deze publiceert.

Tags bulksgewijs toevoegen aan een asset

U kunt maximaal 1000 OPC UA-tags tegelijk importeren vanuit een CSV-bestand:

1. Maak een CSV-bestand dat eruitziet als in het volgende voorbeeld:

   NodeID	TagName	Steekproefinterval milliseconden	Wachtrijen aanpassen	Waarneembaarheidsmodus
   ns=3; s=FastUInt1000	Tag 1000	1000	5	Geen
   ns=3; s=FastUInt1001	Tag 1001	1000	5	Geen
   ns=3; s=FastUInt1002	Tag 1002	5000	10	Geen

2. Selecteer Label toevoegen of CSV-bestand >importeren (.csv). Selecteer het CSV-bestand dat u hebt gemaakt en selecteer Openen. De tags die in het CSV-bestand zijn gedefinieerd, worden geïmporteerd:

   

   Als u een CSV-bestand importeert dat tags bevat die duplicaten van bestaande tags zijn, wordt in de Azure IoT Operations-portal (preview) het volgende bericht weergegeven:

   

   U kunt de dubbele tags vervangen en nieuwe tags toevoegen uit het importbestand of u kunt het importeren annuleren.

3. Als u alle tags van een asset naar een CSV-bestand wilt exporteren, selecteert u Alles exporteren en kiest u een locatie voor het bestand:

   

4. Selecteer Op de pagina Tags de optie Volgende om naar de pagina Gebeurtenissen toevoegen te gaan.

Tip

U kunt het filtervak gebruiken om te zoeken naar tags.

Azure-CLI

Gebruik de volgende opdracht om een thermostaatasset toe te voegen met behulp van de Azure CLI. Met de opdracht worden twee tags aan de asset toegevoegd met behulp van de --data parameter:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

Wanneer u een asset maakt met behulp van de Azure CLI, kunt u het volgende definiëren:

• Meerdere tags met behulp van de --data parameter meerdere keren.
• Meerdere gebeurtenissen met behulp van de --event parameter meerdere keren.
• Optionele informatie voor de asset, zoals:
  • Fabrikant
  • Fabrikant-URI
  • Model
  • Productcode
  • Hardwareversie
  • Softwareversie
  • Serienummer
  • Documentatie-URI
• Standaardwaarden voor steekproefinterval, publicatie-interval en wachtrijgrootte.
• Tag specifieke waarden voor steekproefinterval, publicatie-interval en wachtrijgrootte.
• Gebeurtenisspecifieke waarden voor het interval voor het nemen van steekproeven en de grootte van de wachtrij.
• De waarneembaarheidsmodus voor elke tag en gebeurtenis

Afzonderlijke gebeurtenissen toevoegen aan een asset

Azure IoT Operations-portal

U kunt nu de gebeurtenissen definiëren die zijn gekoppeld aan de asset. OPC UA-gebeurtenissen toevoegen:

1. Selecteer Gebeurtenis toevoegen of CSV-gebeurtenis> toevoegen.

2. Voer uw gebeurtenisgegevens in:

   • Gebeurtenis notifier. Deze waarde is de gebeurtenis notifier van de OPC UA-server.
   • Gebeurtenisnaam (optioneel). Deze waarde is de beschrijvende naam die u wilt gebruiken voor de gebeurtenis. Als u geen gebeurtenisnaam opgeeft, wordt de gebeurtenis notifier gebruikt als de gebeurtenisnaam.
   • De waarneembaarheidsmodus (optioneel) met de volgende opties:
     • Geen
     • Meter
     • teller
     • Histogram
     • Logboek
   • Wachtrijgrootte. U kunt de standaardwaarde voor deze tag overschrijven.

   

3. Selecteer Standaardinstellingen beheren om standaard gebeurtenisinstellingen voor de asset te configureren. Deze instellingen zijn van toepassing op alle OPC UA-gebeurtenissen die deel uitmaken van de asset. U kunt deze instellingen overschrijven voor elke gebeurtenis die u toevoegt. Standaardinstellingen voor gebeurtenissen zijn onder andere:

   • Publicatie-interval (milliseconden): de snelheid waarmee OPC UA Server gegevens moet publiceren.
   • Wachtrijgrootte: de diepte van de wachtrij voor het opslaan van de samplinggegevens voordat u deze publiceert.

Gebeurtenissen bulksgewijs toevoegen aan een asset

U kunt maximaal 1000 OPC UA-gebeurtenissen tegelijk importeren vanuit een CSV-bestand.

Als u alle gebeurtenissen van een asset naar een CSV-bestand wilt exporteren, selecteert u Alles exporteren en kiest u een locatie voor het bestand.

Selecteer Op de pagina Gebeurtenissen de optie Volgende om naar de pagina Controleren te gaan.

Tip

U kunt het filtervak gebruiken om te zoeken naar gebeurtenissen.

Controleer uw wijzigingen

Controleer uw asset en OPC UA-tag en gebeurtenisdetails en breng eventuele aanpassingen aan die u nodig hebt:

Azure-CLI

Wanneer u een asset maakt met behulp van de Azure CLI, kunt u meerdere gebeurtenissen definiëren met behulp van de --event parameter meerdere keren. De syntaxis voor de --event parameter is vergelijkbaar met de --data parameter:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

Voor elke gebeurtenis die u definieert, kunt u het volgende opgeven:

• Gebeurtenis notifier. Deze waarde is de gebeurtenis notifier van de OPC UA-server.
• Gebeurtenisnaam. Deze waarde is de beschrijvende naam die u wilt gebruiken voor de gebeurtenis. Als u geen gebeurtenisnaam opgeeft, wordt de gebeurtenis notifier gebruikt als de gebeurtenisnaam.
• Waarneembaarheidsmodus.
• Wachtrijgrootte.

Een asset bijwerken

Azure IoT Operations-portal

Zoek en selecteer de asset die u eerder hebt gemaakt. Gebruik de tabbladen Assetdetails, Tags en Gebeurtenissen om wijzigingen aan te brengen:

Op het tabblad Tags kunt u tags toevoegen, bestaande tags bijwerken of tags verwijderen.

Als u een tag wilt bijwerken, selecteert u een bestaande tag en werkt u de taggegevens bij. Selecteer Vervolgens Bijwerken:

Als u tags wilt verwijderen, selecteert u een of meer tags en selecteert u Tags verwijderen:

U kunt ook gebeurtenissen en eigenschappen op dezelfde manier toevoegen, bijwerken en verwijderen.

Wanneer u klaar bent met het aanbrengen van wijzigingen, selecteert u Opslaan om uw wijzigingen op te slaan.

Azure-CLI

Gebruik de volgende opdracht om uw assets weer te geven:

az iot ops asset query -g {your resource group name}

Tip

U kunt de queryopdracht verfijnen om te zoeken naar assets die voldoen aan specifieke criteria. U kunt bijvoorbeeld zoeken naar assets per fabrikant.

Gebruik de volgende opdracht om de details van de thermostaatasset weer te geven:

az iot ops asset show --name thermostat -g {your resource group}

Gebruik de az iot ops asset update opdracht om een asset bij te werken. Als u bijvoorbeeld de beschrijving van de asset wilt bijwerken, gebruikt u een opdracht zoals in het volgende voorbeeld:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

Gebruik de volgende opdracht om de tags van de thermostaatasset weer te geven:

az iot ops asset data-point list --asset thermostat -g {your resource group}

Gebruik de volgende opdracht om de gebeurtenissen van de thermostaatasset weer te geven:

az iot ops asset event list --asset thermostat -g {your resource group}

Als u een nieuwe tag wilt toevoegen aan de thermostaatasset, gebruikt u een opdracht zoals in het volgende voorbeeld:

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

Als u een tag wilt verwijderen, gebruikt u de az iot ops asset data-point remove opdracht.

U kunt de gebeurtenissen van een asset beheren met behulp van de az iot ops asset event opdrachten.

Een asset verwijderen

Azure IoT Operations-portal

Als u een asset wilt verwijderen, selecteert u de asset die u wilt verwijderen. Selecteer Verwijderen op de pagina Assetdetails. Bevestig uw wijzigingen om de asset te verwijderen:

Azure-CLI

Als u een asset wilt verwijderen, gebruikt u een opdracht die eruitziet als in het volgende voorbeeld:

az iot ops asset delete --name thermostat -g {your resource group name}

Meldingen

Wanneer u een wijziging aanbrengt in de Azure IoT Operations -portal (preview), ziet u een melding waarin de status van de bewerking wordt gerapporteerd:

Gerelateerde inhoud

• Overzicht van Azure OPC UA Broker
• Overzicht van Azure IoT Akri
• az iot ops asset
• az iot ops asset endpoint