Condividi tramite


Gestire le configurazioni degli asset in remoto

Un asset in Operazioni di Azure IoT è 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 i tag OPC UA che rappresentano i punti dati. I tag OPC UA possono fornire dati in tempo reale o dati storici sullo stato, le prestazioni, la qualità o la condizione degli asset.

Un endpoint dell'asset è una risorsa personalizzata nel cluster Kubernetes che connette i server OPC UA al connettore per i moduli OPC UA. Questa connessione consente a un connettore per OPC UA di accedere ai punti dati di un asset. Senza un endpoint di asset, i dati non possono essere trasmessi da un server OPC UA al connettore per OPC UA e a un broker MQTT. 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 al connettore per OPC UA.

Un sito è una raccolta di istanze di Operazioni IoT di Azure. I siti raggruppano in genere le istanze in base alla posizione fisica e semplificano l'individuazione e la gestione degli asset da parte degli utenti OT. Un amministratore IT crea siti e assegna le istanze di Operazioni di Azure IoT. Per altre informazioni, vedere Che cos'è Azure Arc site manager (anteprima)?.

Nell'interfaccia utente Web dell'esperienza operativa un'istanza rappresenta un cluster delle Operazioni di Azure IoT. Un'istanza può avere uno o più endpoint degli asset.

Questo articolo illustra come usare l'interfaccia utente Web dell'esperienza operativa e l'interfaccia della riga di comando di Azure per:

  • Definire gli endpoint degli asset che connettono gli asset all'istanza di Operazioni di Azure IoT.
  • Aggiungere asset e definire i tag e gli eventi per abilitare il flusso di dati dai server OPC UA al broker MQTT.

Questi asset, tag ed eventi eseguono il mapping dei dati in ingresso dai server OPC UA ai nomi descrittivi che è possibile usare nel broker MQTT e nei flussi di dati.

Prerequisiti

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

Per accedere all'interfaccia utente Web dell'esperienza operativa, è necessario un account MICROSOFT Entra ID con almeno autorizzazioni di collaboratore per il gruppo di risorse che contiene l'istanza di Kubernetes - Azure Arc . Non è possibile accedere con un account Microsoft (MSA). Per creare un account MICROSOFT Entra ID appropriato nel tenant di Azure:

  1. Accedere al portale di Azure con lo stesso tenant e lo stesso nome utente usati per distribuire Operazioni di Azure IoT.
  2. Nel portale di Azure passare alla sezione Microsoft Entra ID, selezionare Utenti > +Nuovo utente > Crea nuovo utente. Creare un nuovo utente e prendere nota della password, necessaria per eseguire l'accesso in un secondo momento.
  3. Nel portale di Azure passare al gruppo di risorse che contiene l'istanza di Kubernetes - Azure Arc. Nella pagina Controllo di accesso (IAM) selezionare +Aggiungi > Aggiungi assegnazione di ruolo.
  4. Nella pagina Aggiungi assegnazione di ruolo selezionare Ruoli di amministratore con privilegi. Selezionare quindi Collaboratore e infine selezionare Avanti.
  5. Nella pagina Membri aggiungere il nuovo utente al ruolo.
  6. Selezionare Rivedere e assegnare per completare la configurazione del nuovo utente.

È ora possibile usare il nuovo account utente per accedere al portale di Operazioni di Azure IoT.

Accedere

Per accedere all'esperienza operativa, passare all'esperienza operativa nel browser e accedere con le credenziali di Microsoft Entra ID.

Selezionare il sito

Dopo l'accesso, l'esperienza operativa visualizza un elenco di siti. Ogni sito è una raccolta di istanze di Operazioni di Azure IoT in cui è possibile configurare e gestire gli asset. Un sito rappresenta in genere una posizione fisica in cui sono stati distribuiti asset fisici. I siti semplificano l'individuazione e la gestione degli asset. L'amministratore IT è responsabile del raggruppamento delle istanze in nei siti. Tutte le istanze di Operazioni di Azure IoT non assegnate a un sito vengono visualizzate nel nodo Istanze non assegnate. Selezionare il sito che si vuole usare:

Screenshot che mostra un elenco di siti nell'esperienza operativa.

Suggerimento

Usare la casella 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 significa che non si è stati ancora aggiunti ad alcun sito. Contattare l'amministratore IT per richiedere l'accesso.

Selezionare l'istanza

Dopo aver selezionato un sito, l'esperienza operativa visualizza un elenco delle istanze di Operazioni di Azure IoT che fanno parte del sito. Selezionare l'istanza da usare:

Screenshot che mostra un elenco di istanze nell'esperienza operativa.

Suggerimento

Usare la casella Filtro per cercare le istanze.

Dopo aver selezionato l'istanza, l'esperienza operativa visualizza la pagina Panoramica per l'istanza. La pagina Panoramica mostra lo stato dell'istanza e le risorse, ad esempio gli asset, associati:

Screenshot che mostra la pagina di panoramica per un'istanza nell'esperienza operativa.

Creare un endpoint di asset

Una distribuzione di Operazioni di Azure IoT può includere un simulatore PLC OPC facoltativo. Per creare un endpoint di asset che usa il simulatore PLC OPC predefinito:

  1. Selezionare Endpoint di asset e quindi Crea endpoint di asset:

    Screenshot che mostra la pagina degli endpoint dell'asset nell'esperienza operativa.

    Suggerimento

    È possibile usare la casella Filtro per cercare le istanze.

  2. Immettere le informazioni sull'endpoint seguenti:

    Campo Valore
    Nome opc-ua-connector-0
    Connettore per l'URL per OPC UA opc.tcp://opcplc-000000:50000
    Autenticazione dell'utente Anonymous
  3. Per salvare la definizione, selezionare Crea.

Questa configurazione distribuisce una nuova risorsa assetendpointprofile denominata opc-ua-connector-0 nel cluster. Dopo aver definito un asset, un connettore per 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 per OPC UA e quindi al broker MQTT.

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

L'esempio precedente usa la modalità di autenticazione Anonymous. Questa modalità non richiede un nome utente o una password.

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

  1. Seguire i passaggi descritti in Configurare l'autenticazione utente OPC UA con nome utente e password per aggiungere i segreti per nome utente e password in Azure Key Vault e spostarli nel cluster Kubernetes.
  2. Nell'esperienza operativa, selezionare Password e nome utente per il campo Autenticazione utente in modo da configurare l'endpoint dell'asset per l'uso dei segreti. Immettere quindi i valori seguenti per i campi delle informazioni di riferimento sul nome utente e sulla 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

Aggiungere asset, tag ed eventi

Per aggiungere un asset nell'esperienza operativa:

  1. Fare clic sulla scheda Asset . Prima di creare un asset, viene visualizzata la schermata seguente:

    Screenshot che mostra una scheda Asset vuota nell'esperienza operativa.

    Suggerimento

    Usare la casella Filtro per cercare gli asset.

  2. Selezionare Crea asset.

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

    • Endpoint dell'asset. Selezionare l'endpoint del proprio asset dall'elenco.
    • Nome del cespite
    • Descrizione
    • Argomento MQTT in cui viene pubblicato l'asset. Il valore predefinito è <namespace>/data/<asset-name>.
  4. Configurare il set di proprietà che si desidera 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

    Screenshot che mostra come aggiungere i dettagli dell'asset all'esperienza operativa.

  5. Selezionare Avanti per passare alla pagina Aggiungi tag.

Aggiungere singoli tag a un asset

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

  1. Selezionare Aggiungi tag o CSV > Aggiungi tag.

  2. Immettere le informazioni 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 all'esperienza operativa.

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

    ID nodo Nome tag Modalità di osservabilità
    ns=3;s=FastUInt10 Temperatura None
    ns=3;s=FastUInt100 Umidità None
  3. Selezionare Gestisci impostazioni predefinite per configurare le impostazioni di telemetria predefinite dell'asset. Queste impostazioni si applicano a tutti i tag di OPC UA appartenenti 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ù elevata con cui il server OPC UA deve campionarne l'origine sottostante per modificare i dati.
    • Intervallo di pubblicazione (millisecondi): la velocità con cui il server OPC UA deve pubblicare i dati.
    • Dimensioni coda: la 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 QueueSize ObservabilityMode Intervallo di campionamento in millisecondi
    ns=3;s=FastUInt1000 Tag 1000 5 None 1000
    ns=3;s=FastUInt1001 Tag 1001 5 None 1000
    ns=3;s=FastUInt1002 Tag 1002 10 None 5000
  2. Selezionare Aggiungi tag o file CSV> Importa file CSV (.csv). Selezionare il file CSV creato e selezionare Apri. I tag definiti nel file CSV vengono importati:

    Screenshot che mostra l'importazione dal file di Excel nell'esperienza operativa completata.

    Se si importa un file CSV che contiene tag duplicati di tag esistenti, l'esperienza operativa visualizza il messaggio seguente:

    Screenshot che mostra il messaggio di errore che si ottiene quando si importano definizioni di tag duplicati nell'esperienza operativa.

    È 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 tutti i e scegliere un percorso per il file:

    Screenshot che mostra come esportare le definizioni dei tag da un asset nell'esperienza operativa.

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

Suggerimento

Usare la casella Filtro per cercare i tags.

Aggiungere eventi singoli a un asset

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

  1. Selezionare Aggiungi evento o CSV >Aggiungi evento.

  2. Immettere i dettagli dell'evento:

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

    Screenshot che mostra l'aggiunta di eventi all'esperienza operativa.

  3. Selezionare Gestisci impostazioni predefinite per configurare le impostazioni dell'evento predefinite per l'asset. Queste impostazioni si applicano agli eventi OPC UA appartenenti all'asset. È possibile eseguire l'override di queste impostazioni per ogni evento aggiunto. Le impostazioni dell'evento predefinite includono:

    • Intervallo di pubblicazione (millisecondi): la velocità con cui il server OPC UA deve pubblicare i dati.
    • Dimensioni coda: la 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 a un file CSV, selezionare Esporta tutti i e scegliere una posizione per il file.

Nella pagina Eventi, selezionare Avanti per passare alla pagina Revisione.

Suggerimento

Usare la casella Filtro per cercare gli eventi.

Esaminare le modifiche

Rivedere i dettagli dell'asset e degli eventi e dei tag OPC UA, quindi apportare eventuali modifiche necessarie:

Screenshot che mostra come esaminare l'asset, i tag e gli eventi nell'esperienza operativa.

Aggiornare un asset

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

Screenshot che mostra come aggiornare l'asset esistente nell'esperienza operativa.

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

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

Screenshot che mostra come aggiornare un tag esistente nell'esperienza operativa.

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

Screenshot che mostra come eliminare un tag nell'esperienza operativa.

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

Dopo aver apportato tutte le modifiche, selezionare Salva per salvare le modifiche.

Eliminare un asset

Per eliminare un asset, selezionare l'asset da eliminare. Nella pagina dei dettagli dell'Asset, selezionare Elimina. Confermare le modifiche per eliminare l'asset:

Screenshot che mostra come eliminare un asset dall'esperienza operativa.

Notifications

Ogni volta che si apporta una modifica all'asset nell'esperienza operativa, viene visualizzata una notifica che segnala lo stato dell'operazione:

Screenshot che mostra le notifiche nell'esperienza operativa.

Visualizzare i log attività

Nell'esperienza operativa è possibile visualizzare i log attività per ogni istanza o ogni risorsa in un'istanza.

Per visualizzare i log attività a livello di istanza, selezionare la scheda Log attività. È possibile usare i filtri Intervallo di tempo e Tipo di risorsa per personalizzare la visualizzazione.

Screenshot che mostra i log attività per un istanza nell'esperienza operativa.

Per visualizzare i log attività come livello di risorsa, selezionare la risorsa da esaminare. La risorsa può essere un asset, un endpoint dell'asset o una pipeline di dati. Nella panoramica della risorsa, selezionare Visualizzare i log attività. È possibile usare il filtro Intervallo di tempo per personalizzare la visualizzazione.