Manage asset configurations remotely

To sign in to the operations experience, go to the operations experience in your browser and sign in by using your Microsoft Entra ID credentials.

Select your site

After you sign in, the operations experience displays a list of sites. Each site is a collection of Azure IoT Operations instances where you can configure and manage your assets. A site typically represents a physical location where you have physical assets deployed. Sites make it easier for you to locate and manage assets. Your IT administrator is responsible for grouping instances in to sites. Any Azure IoT Operations instances that aren't assigned to a site appear in the Unassigned instances node. Select the site that you want to use:

If you don't see any sites, you might not be in the right Azure Active Directory tenant. You can change the tenant from the top right menu in the operations experience. If you still don't see any sites that means you aren't added to any yet. Reach out to your IT administrator to request access.

Select your instance

After you select a site, the operations experience displays a list of the Azure IoT Operations instances that are part of the site. Select the instance that you want to use:

Before you use the az iot ops asset commands, sign in to the subscription that contains your Azure IoT Operations deployment:

az login

1. Select Asset endpoints and then Create asset endpoint:

   

   Tip

   You can use the filter box to search for asset endpoints.

2. Enter the following endpoint information:

   Field	Value
   Name	opc-ua-connector-0
   Connector for OPC UA URL	opc.tcp://opcplc-000000:50000
   User authentication	Anonymous

3. To save the definition, select Create.

Run the following command:

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

To learn more, see az iot ops asset endpoint.

1. Follow the steps in Configure OPC UA user authentication with username and password to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.
2. In the operations experience, select Username password for the User authentication field to configure the asset endpoint to use these secrets. Then enter the following values for the Username reference and Password reference fields:

1. Follow the steps in Configure OPC UA user authentication with username and password to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.

2. Use a command like the following example to create your asset endpoint:

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

To add an asset in the operations experience:

1. Select the Assets tab. Before you create any assets, you see the following screen:

   

   Tip

   You can use the filter box to search for assets.

2. Select Create asset.

3. On the asset details screen, enter the following asset information:

   • Asset endpoint. Select your asset endpoint from the list.
   • Asset name
   • Description
   • The MQTT topic that the asset publishes to. The default is <namespace>/data/<asset-name>.

4. Configure the set of properties that you want to associate with the asset. You can accept the default list of properties or add your own. The following properties are available by default:

   • Manufacturer
   • Manufacturer URI
   • Model
   • Product code
   • Hardware version
   • Software version
   • Serial number
   • Documentation URI

   

5. Select Next to go to the Add tags page.

Add individual tags to an asset

Now you can define the tags associated with the asset. To add OPC UA tags:

1. Select Add tag or CSV > Add tag.

2. Enter your tag details:

   • Node ID. This value is the node ID from the OPC UA server.
   • Tag name (Optional). This value is the friendly name that you want to use for the tag. If you don't specify a tag name, the node ID is used as the tag name.
   • Observability mode (Optional) with following choices:
     • None
     • Gauge
     • Counter
     • Histogram
     • Log
   • Sampling Interval (milliseconds). You can override the default value for this tag.
   • Queue size. You can override the default value for this tag.

   

   The following table shows some example tag values that you can use with the built-in OPC PLC simulator:

   Node ID	Tag name	Observability mode
   ns=3;s=FastUInt10	Temperature	None
   ns=3;s=FastUInt100	Humidity	None

3. Select Manage default settings to configure default telemetry settings for the asset. These settings apply to all the OPC UA tags that belong to the asset. You can override these settings for each tag that you add. Default telemetry settings include:

   • Sampling interval (milliseconds): The sampling interval indicates the fastest rate at which the OPC UA server should sample its underlying source for data changes.
   • Publishing interval (milliseconds): The rate at which OPC UA server should publish data.
   • Queue size: The depth of the queue to hold the sampling data before publishing it.

Add tags in bulk to an asset

You can import up to 1000 OPC UA tags at a time from a CSV file:

1. Create a CSV file that looks like the following example:

   NodeID	TagName	QueueSize	ObservabilityMode	Sampling Interval Milliseconds
   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. Select Add tag or CSV > Import CSV (.csv) file. Select the CSV file you created and select Open. The tags defined in the CSV file are imported:

   

   If you import a CSV file that contains tags that are duplicates of existing tags, the operations experience displays the following message:

   

   You can either replace the duplicate tags and add new tags from the import file, or you can cancel the import.

3. To export all the tags from an asset to a CSV file, select Export all and choose a location for the file:

   

4. On the Tags page, select Next to go to the Add events page.

Use the following commands to add a "thermostat" asset by using the Azure CLI. The commands add two tags/datapoints to the asset by using the point add command:

# Create the asset
az iot ops asset create --name thermostat -g {your resource group name} --instance {your instance name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset'

# Add the datapoints
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt10' --name temperature
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt100' --name 'Tag 10'

# Show the datapoints
az iot ops asset dataset show --asset thermostat -n default -g {your resource group name}

When you create an asset by using the Azure CLI, you can define:

• Multiple datapoints/tags by using the point add command multiple times.
• Multiple events by using the --event parameter multiple times.
• Optional information for the asset such as:
  • Manufacturer
  • Manufacturer URI
  • Model
  • Product code
  • Hardware version
  • Software version
  • Serial number
  • Documentation URI
• Default values for sampling interval, publishing interval, and queue size.
• Datapoint specific values for sampling interval, publishing interval, and queue size.
• Event specific values for sampling publishing interval, and queue size.
• The observability mode for each tag and event

Now you can define the events associated with the asset. To add OPC UA events:

1. Select Add event or CSV > Add event.

2. Enter your event details:

   • Event notifier. This value is the event notifier from the OPC UA server.
   • Event name (Optional). This value is the friendly name that you want to use for the event. If you don't specify an event name, the event notifier is used as the event name.
   • Observability mode (Optional) with following choices:
     • None
     • Log
   • Queue size. You can override the default value for this tag.

   

3. Select Manage default settings to configure default event settings for the asset. These settings apply to all the OPC UA events that belong to the asset. You can override these settings for each event that you add. Default event settings include:

   • Publishing interval (milliseconds): The rate at which OPC UA server should publish data.
   • Queue size: The depth of the queue to hold the sampling data before publishing it.

Add events in bulk to an asset

You can import up to 1000 OPC UA events at a time from a CSV file.

To export all the events from an asset to a CSV file, select Export all and choose a location for the file.

On the Events page, select Next to go to the Review page.

Review your changes

Review your asset and OPC UA tag and event details and make any adjustments you need:

When you create an asset by using the Azure CLI, you can define multiple events by using the --event parameter multiple times:

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

For each event that you define, you can specify the:

• Event notifier. This value is the event notifier from the OPC UA server.
• Event name. This value is the friendly name that you want to use for the event. If you don't specify an event name, the event notifier is used as the event name.
• Observability mode.
• Queue size.

You can also use the az iot ops asset event commands to add and remove events from an asset.

Find and select the asset you created previously. Use the Asset details, Tags, and Events tabs to make any changes:

On the Tags tab, you can add tags, update existing tags, or remove tags.

To update a tag, select an existing tag and update the tag information. Then select Update:

To remove tags, select one or more tags and then select Remove tags:

You can also add, update, and delete events and properties in the same way.

When you're finished making changes, select Save to save your changes.

To list your assets, use the following command:

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

To view the details of the thermostat asset, use the following command:

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

To update an asset, use the az iot ops asset update command. For example, to update the asset's description, use a command like the following example:

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

To list the thermostat asset's tags, use the following command:

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

To list the thermostat asset's events, use the following command:

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

To add a new tag to the thermostat asset, use a command like the following example:

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

To delete a tag, use the az iot ops asset dataset point remove command.

You can manage an asset's events by using the az iot ops asset event commands.

To delete an asset, select the asset you want to delete. On the Asset details page, select Delete. Confirm your changes to delete the asset:

To delete an asset, use a command that looks like the following example:

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