Azure Digital Twin

The Azure Digital Twin Agents allow you to connect your Data Stream to an Azure Digital Twins instance.

The Azure Digital Twin platform is a cloud-based IoT offering that helps you create digital representations of real-world devices or business entities, including their intrinsic attributes as well as how their relationships with each other. For more information about the Azure Digital Twin platform, please see their store page and documentation.

The Listener allows you to listen for changes on an Azure Digital Twins Model. The Agent uses an Azure Relay Hybrid Connection to receive Event Notifications from a Digital Twin and output it to your Data Stream.

The Context Provider allows you to fetch the twin data from the Azure Digital Twins instance and output it as contextual data for the Data Stream. The information for every digital twin that the Agent is configured to read will be output every time it polls.

The Action Agent allows you to keep your Digital Twin instances up to date by taking Data Stream events and sending them as update or create requests. In addition, the Action Agent can integrate with an Azure Data Explorer instance, which enables you to contextualize the up-to-date information from the Digital Twin instance with historical data.

Azure resource creation

This Agent includes the capability to create Azure resources directly from the configuration blade. However, the functionality has to be enabled by adding a Variable to the Data Stream's environment with the name "Azure:EnableResourceManagement" and a value of "true".

Pre-requisites

The following is required to use this Agent:

  • The credentials of an Azure App Registration with permission to read the Azure Digital Twin instance.

  • The Action Agent requires additional permission when Azure resource creation is enabled: to manage Azure Digital Twin instances.

  • The Listener v1.08 requires a minimum XMPro Stream Host (SH) version required is 4.3.14, i.e. download the SH installer from XMPro Data Stream Designer v4.3.14 or later.

Download

Please contact XMPro if you're looking for an older version of this Agent.

Last updated