Share via

Gestire le configurazioni degli asset in remoto

  • Articolo

Importante

Anteprima delle operazioni di Azure IoT: abilitata da Azure Arc è attualmente disponibile in ANTEPRIMA. Non è consigliabile usare questo software di anteprima negli ambienti di produzione.

Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Un asset in Azure IoT Operations Preview è un'entità logica creata per rappresentare un asset reale. Un asset di Operazioni IoT di Azure può avere proprietà, tag ed eventi che ne descrivono il comportamento e le caratteristiche.

I server OPC UA sono applicazioni software che comunicano con gli asset. I server OPC UA espongono tag OPC UA che rappresentano i punti dati. I tag OPC UA forniscono dati cronologici o in tempo reale sullo stato, sulle prestazioni, sulla qualità o sulla condizione degli asset.

Un endpoint asset è una risorsa personalizzata nel cluster Kubernetes che connette i server OPC UA ai moduli del connettore OPC UA. Questa connessione consente a un connettore OPC UA di accedere ai punti dati di un asset. Senza un endpoint di asset, i dati non possono passare da un server OPC UA all'istanza di Anteprima di Azure IoT OPC UA Broker e all'istanza di anteprima di Azure IoT MQ. Dopo aver configurato le risorse personalizzate nel cluster, viene stabilita una connessione al server OPC UA downstream e il server inoltra i dati di telemetria all'istanza di OPC UA Broker.

Un sito è una raccolta di istanze di Operazioni IoT di Azure. I siti consentono di organizzare le istanze e gestire il controllo di accesso. L'amministratore IT crea siti, assegna istanze a tali siti e concede l'accesso agli utenti OT nell'organizzazione.

Nel portale di Azure IoT Operations (anteprima) un'istanza rappresenta un cluster di Operazioni IoT di Azure. Un'istanza può avere uno o più endpoint di asset.

Questo articolo descrive come usare il portale di Operazioni IoT di Azure (anteprima) e l'interfaccia della riga di comando di Azure per:

  • Definire gli endpoint degli asset
  • Aggiungere asset e definire tag ed eventi

Questi asset, tag ed eventi eseguono il mapping dei dati in ingresso dai server OPC UA ai nomi descrittivi che è possibile usare nelle pipeline mq broker e Azure IoT Data Processor Preview.

Prerequisiti

Per configurare un endpoint asset, è necessaria un'istanza in esecuzione di Operazioni IoT di Azure.

Accedere

Per accedere al portale di Azure IoT Operations (anteprima), passare al portale Di Azure IoT Operations (anteprima) nel browser ed eseguire l'accesso usando le credenziali dell'ID di Microsoft Entra.

Selezionare il sito

Dopo l'accesso, nel portale viene visualizzato un elenco di siti a cui si ha accesso. Ogni sito è una raccolta di istanze di Operazioni IoT di Azure in cui è possibile configurare gli asset. L'amministratore IT è responsabile dell'organizzazione delle istanze nei siti e della concessione dell'accesso agli utenti OT nell'organizzazione. Le istanze che non fanno parte di un sito vengono visualizzate nel nodo Istanze non firmate. Selezionare il sito da usare:

Screenshot che mostra un elenco di siti nel portale di Azure IoT Operations (anteprima).

Suggerimento

È possibile usare la casella di filtro per cercare i siti.

Se non vengono visualizzati siti, potrebbe non trovarsi nel tenant di Azure Active Directory corretto. È possibile modificare il tenant dal menu in alto a destra nel portale. Se non vengono ancora visualizzati siti che indicano che non si è ancora aggiunti ad alcun sito. Contattare l'amministratore IT per richiedere l'accesso.

Selezionare l'istanza

Dopo aver selezionato un sito, nel portale viene visualizzato un elenco delle istanze di Operazioni IoT di Azure che fanno parte del sito. Selezionare l'istanza da usare:

Screenshot che mostra l'elenco di istanze nel portale operazioni IoT di Azure (anteprima).

Suggerimento

È possibile usare la casella di filtro per cercare le istanze.

Creare un endpoint di asset

Per impostazione predefinita, una distribuzione di Azure IoT Operations include un simulatore OPC PLC predefinito. Per creare un endpoint di asset che usa il simulatore OPC PLC predefinito:

  1. Selezionare Endpoint asset e quindi Crea endpoint asset:

    Screenshot che mostra la pagina degli endpoint degli asset nel portale operazioni IoT di Azure (anteprima).

    Suggerimento

    È possibile usare la casella di filtro per cercare gli endpoint degli asset.

  2. Immettere le informazioni sull'endpoint seguenti:

    Campo Valore
    Nome opc-ua-connector-0
    OPC UA Broker URL opc.tcp://opcplc-000000:50000
    Autenticazione dell'utente Anonymous
    Autenticazione del trasporto Do not use transport authentication certificate

  3. Per salvare la definizione, selezionare Crea.

Questa configurazione distribuisce una nuova assetendpointprofile risorsa denominata opc-ua-connector-0 nel cluster. Dopo aver definito un asset, un pod del connettore OPC UA lo individua. Il pod usa l'endpoint dell'asset specificato nella definizione dell'asset per connettersi a un server OPC UA.

Quando il simulatore OPC PLC è in esecuzione, i dati passano dal simulatore, al connettore, al broker OPC UA e infine al broker MQ.

Configurare un endpoint di asset per l'uso di un nome utente e una password

Nell'esempio precedente viene usata la Anonymous modalità di autenticazione. Questa modalità non richiede un nome utente o una password.

Per usare la UsernamePassword modalità di autenticazione, completare la procedura seguente:

  1. Seguire la procedura descritta in Configurare l'autenticazione utente OPC UA con nome utente e password per aggiungere segreti per nome utente e password in Azure Key Vault e proiettarli nel cluster Kubernetes.
  2. Nel portale di Azure IoT Operations (anteprima) selezionare Nome utente e password per il campo Autenticazione utente per configurare l'endpoint dell'asset per l'uso di questi segreti. Immettere quindi i valori seguenti per i campi Riferimento nome utente e Riferimento password:
Campo valore
Informazioni di riferimento sul nome utente aio-opc-ua-broker-user-authentication/username
Informazioni di riferimento sulle password aio-opc-ua-broker-user-authentication/password

Configurare un endpoint di asset per l'uso di un certificato di autenticazione del trasporto

Per configurare l'endpoint dell'asset per l'uso di un certificato di autenticazione del trasporto, completare la procedura seguente:

  1. Seguire la procedura descritta in Configurare l'attendibilità reciproca per aggiungere un certificato di trasporto e una chiave privata ad Azure Key Vault e proiettarli nel cluster Kubernetes.
  2. Nel portale di Azure IoT Operations (anteprima) selezionare Usa certificato di autenticazione del trasporto per il campo Autenticazione trasporto e immettere l'identificazione personale del certificato.

Aggiungere un asset, tag ed eventi

Per aggiungere un asset nel portale di Azure IoT Operations (anteprima):

  1. Selezionare la scheda Asset . Prima di creare gli asset, viene visualizzata la schermata seguente:

    Screenshot che mostra una scheda Asset vuota nel portale operazioni IoT di Azure (anteprima).

    Suggerimento

    È possibile usare la casella di filtro per cercare gli asset.

    Selezionare Crea asset.

  2. Nella schermata dei dettagli dell'asset immettere le informazioni seguenti sull'asset:

    • Nome del cespite
    • Endpoint asset. Selezionare l'endpoint dell'asset dall'elenco.
    • Descrizione

    Screenshot che mostra come aggiungere i dettagli dell'asset nel portale di Operazioni IoT di Azure (anteprima).

  3. Configurare il set di proprietà da associare all'asset. È possibile accettare l'elenco predefinito di proprietà o aggiungerne uno personalizzato. Per impostazione predefinita, sono disponibili le proprietà seguenti:

    • Produttore
    • URI produttore
    • Modello
    • Codice prodotto
    • Versione hardware
    • Versione software
    • Numero di serie
    • URI della documentazione

  4. Selezionare Avanti per passare alla pagina Aggiungi tag .

Aggiungere singoli tag a un asset

È ora possibile definire i tag associati all'asset. Per aggiungere tag OPC UA:

  1. Selezionare Add tag (Aggiungi tag) o CSV Add tag (Aggiungi tag CSV>).

  2. Immettere i dettagli del tag:

    • ID nodo. Questo valore è l'ID nodo del server OPC UA.
    • Nome tag (facoltativo). Questo valore è il nome descrittivo che si vuole usare per il tag. Se non si specifica un nome di tag, l'ID del nodo viene usato come nome del tag.
    • Modalità osservabilità (facoltativo) con le opzioni seguenti:
      • None
      • Misuratore
      • Contatore
      • Istogramma
      • Log
    • Intervallo di campionamento (millisecondi). È possibile eseguire l'override del valore predefinito per questo tag.
    • Dimensioni della coda. È possibile eseguire l'override del valore predefinito per questo tag.

    Screenshot che mostra l'aggiunta di tag nel portale di Azure IoT Operations (anteprima).

    La tabella seguente mostra alcuni valori di tag di esempio che è possibile usare con il simulatore OPC PLC predefinito:

    ID nodo Nome tag Modalità osservabilità
    ns=3; s=FastUInt10 temperatura Nessuno
    ns=3; s=FastUInt100 Tag 10 Nessuno

  3. Selezionare Gestisci impostazioni predefinite per configurare le impostazioni di telemetria predefinite per l'asset. Queste impostazioni si applicano a tutti i tag OPC UA che appartengono all'asset. È possibile eseguire l'override di queste impostazioni per ogni tag aggiunto. Le impostazioni di telemetria predefinite includono:

    • Intervallo di campionamento (millisecondi): l'intervallo di campionamento indica la velocità più veloce con cui il server OPC UA deve campionarne l'origine sottostante per le modifiche ai dati.
    • Intervallo di pubblicazione (millisecondi): frequenza con cui il server OPC UA deve pubblicare i dati.
    • Dimensioni coda: profondità della coda per contenere i dati di campionamento prima di pubblicarli.

Aggiungere tag in blocco a un asset

È possibile importare fino a 1000 tag OPC UA alla volta da un file CSV:

  1. Creare un file CSV simile all'esempio seguente:

    NodeID Tagname Intervallo di campionamento millisecondi QueueSize ObservabilityMode
    ns=3; s=FastUInt1000 Tag 1000 1000 5 Nessuno
    ns=3; s=FastUInt1001 Tag 1001 1000 5 Nessuno
    ns=3; s=FastUInt1002 Tag 1002 5000 10 Nessuno

  2. Selezionare Aggiungi tag o file CSV Import CSV > (.csv). Selezionare il file CSV creato e selezionare Apri. I tag definiti nel file CSV vengono importati:

    Screenshot che mostra l'importazione completata dal file di Excel nel portale di Azure IoT Operations (anteprima).

    Se si importa un file CSV che contiene tag duplicati di tag esistenti, il portale di Azure IoT Operations (anteprima) visualizza il messaggio seguente:

    Screenshot che mostra il messaggio di errore quando si importano definizioni di tag duplicati nel portale di Azure IoT Operations (anteprima).

    È possibile sostituire i tag duplicati e aggiungere nuovi tag dal file di importazione oppure annullare l'importazione.

  3. Per esportare tutti i tag da un asset in un file CSV, selezionare Esporta tutto e scegliere un percorso per il file:

    Screenshot che mostra come esportare definizioni di tag da un asset nel portale di Azure IoT Operations (anteprima).

  4. Nella pagina Tag selezionare Avanti per passare alla pagina Aggiungi eventi.

Suggerimento

È possibile usare la casella di filtro per cercare i tag.

Aggiungere singoli eventi a un asset

È ora possibile definire gli eventi associati all'asset. Per aggiungere eventi OPC UA:

  1. Selezionare Aggiungi evento o evento CSV > Add.

  2. Immettere i dettagli dell'evento:

    • Notifier dell'evento. Questo valore è il notifier dell'evento dal server OPC UA.
    • Nome evento (facoltativo). Questo valore è il nome descrittivo che si vuole usare per l'evento. Se non si specifica un nome di evento, il notifier dell'evento viene usato come nome dell'evento.
    • Modalità osservabilità (facoltativo) con le opzioni seguenti:
      • None
      • Misuratore
      • Contatore
      • Istogramma
      • Log
    • Dimensioni della coda. È possibile eseguire l'override del valore predefinito per questo tag.

    Screenshot che mostra l'aggiunta di eventi nel portale di Azure IoT Operations (anteprima).

  3. Selezionare Gestisci impostazioni predefinite per configurare le impostazioni predefinite degli eventi per l'asset. Queste impostazioni si applicano a tutti gli eventi OPC UA che appartengono all'asset. È possibile eseguire l'override di queste impostazioni per ogni evento aggiunto. Le impostazioni predefinite degli eventi includono:

    • Intervallo di pubblicazione (millisecondi): frequenza con cui il server OPC UA deve pubblicare i dati.
    • Dimensioni coda: profondità della coda per contenere i dati di campionamento prima di pubblicarli.

Aggiungere eventi in blocco a un asset

È possibile importare fino a 1000 eventi OPC UA alla volta da un file CSV.

Per esportare tutti gli eventi da un asset in un file CSV, selezionare Esporta tutto e scegliere un percorso per il file.

Nella pagina Eventi selezionare Avanti per passare alla pagina Revisione.

Suggerimento

È possibile usare la casella di filtro per cercare gli eventi.

Esaminare le modifiche

Esaminare i dettagli del tag e dell'evento OPC UA e apportare eventuali modifiche necessarie:

Screenshot che mostra come esaminare l'asset, i tag e gli eventi nel portale di Operazioni IoT di Azure (anteprima).

Aggiornare un asset

Trovare e selezionare l'asset creato in precedenza. Usare le schede Dettagli asset, Tag ed Eventi per apportare eventuali modifiche:

Screenshot che mostra come aggiornare un asset esistente nel portale di Azure IoT Operations (anteprima).

Nella scheda Tag è possibile aggiungere tag, aggiornare i tag esistenti o rimuovere tag.

Per aggiornare un tag, selezionare un tag esistente e aggiornare le informazioni sul tag. Selezionare quindi Aggiorna:

Screenshot che mostra come aggiornare un tag esistente nel portale di Azure IoT Operations (anteprima).

Per rimuovere i tag, selezionare uno o più tag e quindi selezionare Rimuovi tag:

Screenshot che mostra come eliminare un tag nel portale di Azure IoT Operations (anteprima).

È anche possibile aggiungere, aggiornare ed eliminare eventi e proprietà nello stesso modo.

Al termine delle modifiche, selezionare Salva per salvare le modifiche.

Eliminare un asset

Per eliminare un asset, selezionare l'asset da eliminare. Nella pagina Dettagli asset selezionare Elimina. Confermare le modifiche per eliminare l'asset:

Screenshot che mostra come eliminare un asset dal portale di Azure IoT Operations (anteprima).

Notifications

Ogni volta che si apporta una modifica all'asset nel portale di Operazioni IoT di Azure (anteprima), viene visualizzata una notifica che segnala lo stato dell'operazione:

Screenshot che mostra le notifiche nel portale di Azure IoT Operations (anteprima).

Contenuto correlato