Fjärrhantera tillgångskonfigurationer

Viktigt!

Förhandsversion av Azure IoT Operations – aktiverad av Azure Arc finns för närvarande i FÖRHANDSVERSION. Du bör inte använda den här förhandsgranskningsprogramvaran i produktionsmiljöer.

Juridiska villkor för Azure-funktioner i betaversion, förhandsversion eller som av någon annan anledning inte har gjorts allmänt tillgängliga ännu finns i kompletterande användningsvillkor för Microsoft Azure-förhandsversioner.

En tillgång i Förhandsversionen av Azure IoT Operations är en logisk entitet som du skapar för att representera en verklig tillgång. En Azure IoT Operations-tillgång kan ha egenskaper, taggar och händelser som beskriver dess beteende och egenskaper.

OPC UA-servrar är program som kommunicerar med tillgångar. OPC UA-servrar exponerar OPC UA-taggar som representerar datapunkter. OPC UA-taggar ger realtidsdata eller historiska data om tillgångars status, prestanda, kvalitet eller villkor.

En tillgångsslutpunkt är en anpassad resurs i ditt Kubernetes-kluster som ansluter OPC UA-servrar till OPC UA-anslutningsmoduler. Den här anslutningen gör det möjligt för en OPC UA-anslutningsapp att komma åt en tillgångs datapunkter. Utan en tillgångsslutpunkt kan data inte flöda från en OPC UA-server till Azure IoT OPC UA Broker Preview-instansen och Azure IoT MQ Preview-instansen. När du har konfigurerat de anpassade resurserna i klustret upprättas en anslutning till den underordnade OPC UA-servern och servern vidarebefordrar telemetri till OPC UA Broker-instansen.

En webbplats är en samling Azure IoT Operations-instanser. Webbplatser hjälper dig att organisera dina instanser och hantera åtkomstkontroll. IT-administratören skapar webbplatser, tilldelar instanser till dem och ger åtkomst till OT-användare i din organisation.

I Azure IoT Operations-portalen (förhandsversion) representerar en instans ett Azure IoT Operations-kluster. En instans kan ha en eller flera tillgångsslutpunkter.

Den här artikeln beskriver hur du använder Azure IoT Operations-portalen (förhandsversion) och Azure CLI för att:

• Definiera tillgångsslutpunkter
• Lägga till tillgångar och definiera taggar och händelser

Dessa tillgångar, taggar och händelser mappar inkommande data från OPC UA-servrar till egna namn som du kan använda i pipelines för förhandsversionen av MQ Broker och Azure IoT Data Processor.

Förutsättningar

För att konfigurera en slutpunkt för tillgångar behöver du en instans av Azure IoT Operations som körs.

Logga in

Azure IoT Operations-portalen

Om du vill logga in på Azure IoT Operations-portalen (förhandsversion) går du till Azure IoT Operations-portalen (förhandsversion) i webbläsaren och loggar in med dina autentiseringsuppgifter för Microsoft Entra-ID.

Välj din webbplats

När du har loggat in visar portalen en lista över webbplatser som du har åtkomst till. Varje webbplats är en samling Azure IoT Operations-instanser där du kan konfigurera dina tillgångar. IT-administratören ansvarar för att organisera instanser på webbplatser och ge åtkomst till OT-användare i din organisation. Instanser som inte är en del av en plats visas i noden Ej tilldelade instanser . Välj den webbplats som du vill använda:

Dricks

Du kan använda filterrutan för att söka efter webbplatser.

Om du inte ser några webbplatser kanske du inte är i rätt Azure Active Directory-klientorganisation. Du kan ändra klientorganisationen från den övre högra menyn i portalen. Om du fortfarande inte ser några webbplatser innebär det att du inte har lagts till i några ännu. Kontakta IT-administratören för att begära åtkomst.

Välj din instans

När du har valt en webbplats visar portalen en lista över De Azure IoT Operations-instanser som är en del av webbplatsen. Välj den instans som du vill använda:

Dricks

Du kan använda filterrutan för att söka efter instanser.

Azure CLI

Innan du använder az iot ops asset kommandona loggar du in på prenumerationen som innehåller din Azure IoT Operations-distribution:

az login

Skapa en tillgångsslutpunkt

Som standard innehåller en Azure IoT Operations-distribution en inbyggd OPC PLC-simulator. Så här skapar du en tillgångsslutpunkt som använder den inbyggda OPC PLC-simulatorn:

Azure IoT Operations-portalen

1. Välj Tillgångsslutpunkter och sedan Skapa tillgångsslutpunkt:

   

   Dricks

   Du kan använda filterrutan för att söka efter tillgångsslutpunkter.

2. Ange följande slutpunktsinformation:

   Fält	Värde
   Name	opc-ua-connector-0
   OPC UA Broker URL	opc.tcp://opcplc-000000:50000
   Användarautentisering	Anonymous
   Transportautentisering	Do not use transport authentication certificate

3. Spara definitionen genom att välja Skapa.

Azure CLI

Kör följande kommando:

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} 

Dricks

Använd az connectedk8s list för att lista de kluster som du har åtkomst till.

Mer information finns i az iot ops asset endpoint (az iot ops asset endpoint).

Den här konfigurationen distribuerar en ny assetendpointprofile resurs som heter opc-ua-connector-0 till klustret. När du har definierat en tillgång identifierar en OPC UA-anslutningspodd den. Podden använder den tillgångsslutpunkt som du anger i tillgångsdefinitionen för att ansluta till en OPC UA-server.

När OPC PLC-simulatorn körs flödar data från simulatorn, till anslutningsappen, till OPC UA-koordinatorn och slutligen till MQ-koordinatorn.

Konfigurera en tillgångsslutpunkt för att använda ett användarnamn och lösenord

I föregående exempel används autentiseringsläget Anonymous . Det här läget kräver inget användarnamn eller lösenord.

Azure IoT Operations-portalen

Utför följande steg för att använda UsernamePassword autentiseringsläget:

1. Följ stegen i Konfigurera OPC UA-användarautentisering med användarnamn och lösenord för att lägga till hemligheter för användarnamn och lösenord i Azure Key Vault och projicera dem i Kubernetes-klustret.
2. I Azure IoT Operations-portalen (förhandsversion) väljer du Användarnamn och lösenord för fältet Användarautentisering för att konfigurera tillgångsslutpunkten så att den använder dessa hemligheter. Ange sedan följande värden för referensfälten Användarnamn och Lösenord:

Fält	Värde
Användarnamnsreferens	aio-opc-ua-broker-user-authentication/username
Lösenordsreferens	aio-opc-ua-broker-user-authentication/password

Azure CLI

Utför följande steg för att använda UsernamePassword autentiseringsläget:

1. Följ stegen i Konfigurera OPC UA-användarautentisering med användarnamn och lösenord för att lägga till hemligheter för användarnamn och lösenord i Azure Key Vault och projicera dem i Kubernetes-klustret.

2. Använd ett kommando som i följande exempel för att skapa tillgångsslutpunkten:

   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"
   

Konfigurera en tillgångsslutpunkt för att använda ett certifikat för transportautentisering

Utför följande steg för att konfigurera tillgångsslutpunkten så att den använder ett certifikat för transportautentisering:

Azure IoT Operations-portalen

1. Följ stegen i konfigurera ömsesidigt förtroende för att lägga till ett transportcertifikat och en privat nyckel i Azure Key Vault och projicera dem i Kubernetes-kluster.
2. I Azure IoT Operations-portalen (förhandsversion) väljer du Använd transportautentiseringscertifikat för fältet Transportautentisering och anger tumavtrycket för certifikatet.

Azure CLI

1. Följ stegen i konfigurera ömsesidigt förtroende för att lägga till ett transportcertifikat och en privat nyckel i Azure Key Vault och projicera dem i Kubernetes-kluster.

2. Använd ett kommando som i följande exempel för att skapa tillgångsslutpunkten:

   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"
   

Mer information finns i az iot ops asset( az iot ops asset).

Lägga till en tillgång, taggar och händelser

Azure IoT Operations-portalen

Så här lägger du till en tillgång i Azure IoT Operations-portalen (förhandsversion):

1. Välj fliken Tillgångar . Innan du skapar några tillgångar visas följande skärm:

   

   Dricks

   Du kan använda filterrutan för att söka efter tillgångar.

   Välj Skapa tillgång.

2. På skärmen tillgångsinformation anger du följande tillgångsinformation:

   • Tillgångsnamn
   • Tillgångsslutpunkt. Välj din tillgångsslutpunkt i listan.
   • beskrivning

   

3. Konfigurera den uppsättning egenskaper som du vill associera med tillgången. Du kan acceptera standardlistan med egenskaper eller lägga till en egen. Följande egenskaper är tillgängliga som standard:

   • Tillverkare
   • Tillverkarens URI
   • Modell
   • Produktkod
   • Maskinvaruversion
   • Programvaruversion
   • Serienummer
   • Dokumentations-URI

4. Välj Nästa för att gå till sidan Lägg till taggar .

Lägga till enskilda taggar i en tillgång

Nu kan du definiera taggarna som är associerade med tillgången. Så här lägger du till OPC UA-taggar:

1. Välj Lägg till tagg eller CSV > Lägg till tagg.

2. Ange din tagginformation:

   • Nod-ID. Det här värdet är nod-ID:t från OPC UA-servern.
   • Taggnamn (valfritt). Det här värdet är det eget namn som du vill använda för taggen. Om du inte anger ett taggnamn används nod-ID:t som taggnamn.
   • Observerbarhetsläge (valfritt) med följande alternativ:
     • Ingen
     • Mätare
     • Räknare
     • Histogram
     • Loggas
   • Samplingsintervall (millisekunder). Du kan åsidosätta standardvärdet för den här taggen.
   • Köstorlek. Du kan åsidosätta standardvärdet för den här taggen.

   

   I följande tabell visas några exempeltaggvärden som du kan använda med den inbyggda OPC PLC-simulatorn:

   Nod-ID	Taggnamn	Observerbarhetsläge
   ns=3; s=FastUInt10	temperatur	inget
   ns=3; s=FastUInt100	Tagg 10	inget

3. Välj Hantera standardinställningar för att konfigurera standardtelemetriinställningar för tillgången. De här inställningarna gäller för alla OPC UA-taggar som tillhör tillgången. Du kan åsidosätta de här inställningarna för varje tagg som du lägger till. Standardinställningarna för telemetri är:

   • Samplingsintervall (millisekunder): Samplingsintervallet anger den snabbaste hastighet med vilken OPC UA-servern ska prova sin underliggande källa för dataändringar.
   • Publiceringsintervall (millisekunder): Den hastighet med vilken OPC UA Server ska publicera data.
   • Köstorlek: Köns djup för att lagra samplingsdata innan du publicerar dem.

Lägga till taggar i bulk till en tillgång

Du kan importera upp till 1 000 OPC UA-taggar åt gången från en CSV-fil:

1. Skapa en CSV-fil som ser ut som i följande exempel:

   NodeID	Tagname	Samplingsintervall millisekunder	Köstorlek	ObservabilityMode
   ns=3; s=FastUInt1000	Tagg 1000	1 000	5	inget
   ns=3; s=FastUInt1001	Tagg 1001	1 000	5	inget
   ns=3; s=FastUInt1002	Tagg 1002	5000	10	inget

2. Välj Lägg till tagg eller CSV > Importera CSV-fil (.csv). Välj csv-filen som du skapade och välj Öppna. Taggarna som definierats i CSV-filen importeras:

   

   Om du importerar en CSV-fil som innehåller taggar som är dubbletter av befintliga taggar visas följande meddelande i Azure IoT Operations-portalen (förhandsversion):

   

   Du kan antingen ersätta de duplicerade taggarna och lägga till nya taggar från importfilen, eller så kan du avbryta importen.

3. Om du vill exportera alla taggar från en tillgång till en CSV-fil väljer du Exportera alla och väljer en plats för filen:

   

4. På sidan Taggar väljer du Nästa för att gå till sidan Lägg till händelser .

Dricks

Du kan använda filterrutan för att söka efter taggar.

Azure CLI

Använd följande kommando för att lägga till en "termostat"-tillgång med hjälp av Azure CLI. Kommandot lägger till två taggar i tillgången med hjälp av parametern --data :

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'

När du skapar en tillgång med hjälp av Azure CLI kan du definiera:

• Flera taggar med hjälp av parametern --data flera gånger.
• Flera händelser med hjälp av parametern --event flera gånger.
• Valfri information för tillgången, till exempel:
  • Tillverkare
  • Tillverkarens URI
  • Modell
  • Produktkod
  • Maskinvaruversion
  • Programvaruversion
  • Serienummer
  • Dokumentations-URI
• Standardvärden för samplingsintervall, publiceringsintervall och köstorlek.
• Tagga specifika värden för samplingsintervall, publiceringsintervall och köstorlek.
• Händelsespecifika värden för sampling av publiceringsintervall och köstorlek.
• Observerbarhetsläget för varje tagg och händelse

Lägga till enskilda händelser i en tillgång

Azure IoT Operations-portalen

Nu kan du definiera de händelser som är associerade med tillgången. Så här lägger du till OPC UA-händelser:

1. Välj Lägg till händelse eller CSV > Lägg till händelse.

2. Ange din händelseinformation:

   • Händelse anmälare. Det här värdet är händelse anmälaren från OPC UA-servern.
   • Händelsenamn (valfritt). Det här värdet är det eget namn som du vill använda för händelsen. Om du inte anger något händelsenamn används händelsekontrollanten som händelsenamn.
   • Observerbarhetsläge (valfritt) med följande alternativ:
     • Ingen
     • Mätare
     • Räknare
     • Histogram
     • Loggas
   • Köstorlek. Du kan åsidosätta standardvärdet för den här taggen.

   

3. Välj Hantera standardinställningar för att konfigurera standardhändelseinställningar för tillgången. De här inställningarna gäller för alla OPC UA-händelser som tillhör tillgången. Du kan åsidosätta de här inställningarna för varje händelse som du lägger till. Standardinställningar för händelser är:

   • Publiceringsintervall (millisekunder): Den hastighet med vilken OPC UA Server ska publicera data.
   • Köstorlek: Köns djup för att lagra samplingsdata innan du publicerar dem.

Lägga till händelser i bulk till en tillgång

Du kan importera upp till 1 000 OPC UA-händelser åt gången från en CSV-fil.

Om du vill exportera alla händelser från en tillgång till en CSV-fil väljer du Exportera alla och väljer en plats för filen.

På sidan Händelser väljer du Nästa för att gå till sidan Granska .

Dricks

Du kan använda filterrutan för att söka efter händelser.

Granska dina ändringar

Granska din tillgång och OPC UA-tagg och händelseinformation och gör eventuella justeringar som du behöver:

Azure CLI

När du skapar en tillgång med hjälp av Azure CLI kan du definiera flera händelser med hjälp av parametern --event flera gånger. Syntaxen för parametern --event liknar parametern --data :

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

För varje händelse som du definierar kan du ange följande:

• Händelse anmälare. Det här värdet är händelse anmälaren från OPC UA-servern.
• Händelsenamn. Det här värdet är det eget namn som du vill använda för händelsen. Om du inte anger något händelsenamn används händelsekontrollanten som händelsenamn.
• Observerbarhetsläge.
• Köstorlek.

Uppdatera en tillgång

Azure IoT Operations-portalen

Leta upp och välj den tillgång som du skapade tidigare. Använd flikarna Tillgångsinformation, Taggar och Händelser för att göra ändringar:

På fliken Taggar kan du lägga till taggar, uppdatera befintliga taggar eller ta bort taggar.

Om du vill uppdatera en tagg väljer du en befintlig tagg och uppdaterar tagginformationen. Välj sedan Uppdatera:

Om du vill ta bort taggar väljer du en eller flera taggar och väljer sedan Ta bort taggar:

Du kan också lägga till, uppdatera och ta bort händelser och egenskaper på samma sätt.

När du är klar med ändringarna väljer du Spara för att spara ändringarna.

Azure CLI

Om du vill visa en lista över dina tillgångar använder du följande kommando:

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

Dricks

Du kan förfina frågekommandot för att söka efter tillgångar som matchar specifika villkor. Du kan till exempel söka efter tillgångar efter tillverkare.

Om du vill visa information om termostattillgången använder du följande kommando:

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

Om du vill uppdatera en tillgång använder du az iot ops asset update kommandot . Om du till exempel vill uppdatera tillgångens beskrivning använder du ett kommando som i följande exempel:

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

Om du vill visa termostattillgångens taggar använder du följande kommando:

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

Om du vill visa termostattillgångens händelser använder du följande kommando:

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

Om du vill lägga till en ny tagg i termostattillgången använder du ett kommando som i följande exempel:

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

Om du vill ta bort en tagg använder du az iot ops asset data-point remove kommandot .

Du kan hantera en tillgångs händelser med hjälp av kommandona az iot ops asset event .

Ta bort en tillgång

Azure IoT Operations-portalen

Om du vill ta bort en tillgång väljer du den tillgång som du vill ta bort. På sidan Tillgångsinformation väljer du Ta bort. Bekräfta ändringarna för att ta bort tillgången:

Azure CLI

Om du vill ta bort en tillgång använder du ett kommando som ser ut som i följande exempel:

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

Meddelanden

När du gör en ändring av tillgången i Azure IoT Operations-portalen (förhandsversion) visas ett meddelande som rapporterar status för åtgärden:

Relaterat innehåll

• Översikt över Azure OPC UA Broker
• Översikt över Azure IoT Akri
• az iot ops asset
• az iot ops asset endpoint