Configuration
This section explains each of the properties in the configuration blade.
Property | Description |
---|---|
Collection | This associates the Agent to a specific Collection (defaults to that of the current Data Stream). |
Property | Description |
---|---|
Use Variables? | Tick to select saved Variables for the Authentication, Host URL, and Relay properties; or enter the text manually. |
Subscription Id | The Id of the Azure subscription to which the Client has access.
This is required if you wish to create or manage an Azure Digital Twins instance through this Agent's configuration blade and requires the Client to have additional administration permissions. |
Tenant Id | The Id of the tenant to which the Client belongs. |
Client Id | The Id of the Azure App Registration the Agent should use to connect to the Azure Digital Twin instance. |
Client Secret | The Secret of the Azure App Registration the Agent should use to connect to the Azure Digital Twin instance. |
Once the Authentication details are entered, the Agent will attempt to authenticate and populate the dropdowns with available information from the Digital Twin instance: Model, Resource Group, and the Event Topic Name with the available Topics from your Azure Subscription.
Azure Digital Twins uses Event Routes to send data and is defined by its Endpoint and Filter. The type of Endpoint that it uses is an Event Grid with custom Topics and it Filters events to only notify Changes or Telemetry Messages on the selected Digital Twin Model.
Property | Description |
---|---|
Host Url | The Host Name of the Azure Digital Twins instance. This can either be the simple name or the full URL in the format "https://<instancename>.api.<region>.digitaltwins.azure.net" |
Model | The name of the Digital Twin model to listen to. |
This link opens a sub-page that allows you to create a new Endpoint and Event Route with the selected Topic for the Digital Twins Instance.
Property | Description |
---|---|
Resource Group | The resource group the new resource will be assigned to. |
Resource Location | Choose one of Azure's supported regions in which to create the resource. |
Digital Twin Endpoint Name | The name of the new Digital Twin instance endpoint. |
Digital Twins Route Name | The name of the event route for the new Digital Twin instance endpoint. |
Create Event Topic? | Tick to create a new Event Grid Topic using the input from Event Topic Name. |
Event Topic Name | The name of the Event Grid Topic for the source of Events. Input manually to create a new Event Topic (applies only when Create Event Topic? is ticked). |
An Azure Relay must be set up and attached to the Azure Digital Twins instance to securely communicate with the Event Grid Endpoint and receive event notifications from it.
Property | Description |
---|---|
Namespace | The Namespace of the Azure Relay. |
Connection | The name of the Azure Relay Connection to use. |
Access policy name | The name of the policy for the Azure Relay authentication. |
Access Key | The key for the Azure Relay authentication. |
This link opens a sub-page that allows you to create a new Azure Relay to connect to the Event Grid endpoint.
Property | Description |
---|---|
Resource Group | The resource group the new resource will be assigned to. |
Resource Location | Choose one of Azure's supported regions in which to create the resource. |
Relay Name | The name of the new Azure Relay Connection. |
Once a new Relay is created, click Apply on this blade to insert the new Relay Name, Access policy name, and Access Key into the main configuration blade.
This link opens a sub-page that allows you to create a new connection between the Azure Relay and the Event Grid endpoint. The Relay details must have values in order to create a new Connection.
Property | Description |
---|---|
Resource Group | The resource group that contains the Digital Twin Instance. |
Resource Location | Choose one of Azure's supported regions in which to create the resource. |
Connection Name | The name of the new Azure Relay Connection. |
Create Event Topic? | Tick to create a new Event Grid Topic using the input from Event Topic Name. |
Event Topic Name | The name of the Event Grid Topic for the source of Events. Input manually to create a new Event Topic (applies only when Create Event Topic? is ticked). |
Event Subscription Name | The name of the Event Subscription to an Event Grid Topic |
Once a new Connection is created, the new Connection Name can be used as input for the Connection property on the main configuration blade.
Name | Description |
---|---|
Output | An event per Digital Twin Update or Telemetry Message of the selected Model will be made available on this endpoint with attributes matching the Properties and Telemetry contents of the selected Model. |
Error | Errors encountered during the execution of this Agent will be published on this endpoint. |
Last modified 3mo ago