Gestire le configurazioni degli asset in remoto

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'interfaccia utente Web visualizza un elenco di siti a cui si ha accesso. Ogni sito è una raccolta di istanze di Operazioni di Azure IoT 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 che si vuole usare:

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:

Prima di usare i comandi az iot ops asset, accedere alla sottoscrizione che contiene la distribuzione di Operazioni di Azure IoT:

az login

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

   

   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.

Esegui questo comando:

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} 

Per altre informazioni, vedere az iot ops asset endpoint.

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:

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. Usare un comando simile all'esempio seguente per creare l'endpoint dell'asset:

   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"
   

Per aggiungere un asset nell'esperienza operativa:

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

   

   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

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

   

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.

   

   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	Nessuno
   ns=3;s=FastUInt100	Tag 10	Nessuno

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	Intervallo di campionamento in 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> Importa file CSV (.csv). Selezionare il file CSV creato e selezionare Apri. I tag definiti nel file CSV vengono importati:

   

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

   

   È 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:

   

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

Usare il comando seguente per aggiungere un asset "termostato" usando l'interfaccia della riga di comando di Azure. Il comando aggiunge due tag all'asset usando il parametro --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'

Quando si crea un asset usando l'interfaccia della riga di comando di Azure, è possibile definire:

• Più tag usando il parametro --data più volte.
• Più eventi usando il parametro --event più volte.
• Informazioni facoltative per l'asset, ad esempio:
  • Produttore
  • URI produttore
  • Modello
  • Codice prodotto
  • Versione hardware
  • Versione software
  • Numero di serie
  • URI della documentazione
• Valori predefiniti per l'intervallo di campionamento, l'intervallo di pubblicazione e le dimensioni della coda.
• Valori specifici del tag per l'intervallo di campionamento, l'intervallo di pubblicazione e le dimensioni della coda.
• Valori specifici dell'evento per l'intervallo di pubblicazione del campionamento e le dimensioni della coda.
• Modalità di osservabilità per ogni tag e evento

È 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.

   

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.

Esaminare le modifiche

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

Quando si crea un asset usando l'interfaccia della riga di comando di Azure, è possibile definire più eventi usando il parametro --event più volte. La sintassi del parametro --event è simile al parametro --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

Per ogni evento definito, è possibile specificare:

• Componente di notifica dell'evento. Questo valore è il componente di notifica dell'evento del server OPC UA.
• Nome evento. 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à di osservabilità.
• Dimensioni della coda.

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

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:

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

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

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

Per elencare gli asset, usare il comando seguente:

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

Per visualizzare i dettagli dell'asset "termostato", usare il comando seguente:

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

Per aggiornare un asset, usare il comando az iot ops asset update. Ad esempio, per aggiornare la descrizione dell'asset, usare un comando simile all'esempio seguente:

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

Per elencare i tag dell'asset "termostato", usare il comando seguente:

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

Per elencare gli eventi dell'asset "termostato", usare il comando seguente:

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

Per aggiungere un nuovo tag all'asset "termostato", usare un comando simile all'esempio seguente:

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

Per eliminare un tag, usare il comando az iot ops asset data-point remove.

È possibile gestire gli eventi di un asset usando i comandi az iot ops asset event.

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

Per eliminare un asset, usare un comando simile all'esempio seguente:

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