Product Features
Digital Twins
Add an Instance
8min
note to access the digital twins feature, you need a scale or growth litmus license you can add a digital twins instance by navigating to digital twins > instances instances are inherited from a model they are the actual data objects that contain static and dynamic data from different sources you must create a model before creating an instance before you begin before you add an instance, you will need to create a digital twins model see create and import models docid 09kftudhjli4ujyvwdcke for details step 1 add instance to add an instance navigate to digital twins > instances the instances pane appears from the instances pane, click the add an instance tile the add an instance dialog box appears select a model to associate with the instance either search for a model or select one from the list enter the details for the instance name enter a name for the instance interval enter the interval between retrieving data from the instance the minimum interval allowed is one second topic review the default topic name for the instance you have the option of entering a custom topic name flatten hierarchy select the checkbox to send hierarchy data in a flat json structure when selected, it will take a nested json object and convert it into a json object with one layer using dot notation this is useful when sending json objects to influxdb, because influxdb does not accept nested json objects click add step 2 configure instance after creating the instance, you can customize the model parameters it is associated with click the instance tile (grid view) to view the instance details after making changes to an instance, you must save the changes and then restart the instance to implement the updates see the "restart instance" section below static attributes the static attributes tab displays the metadata values for the model the instance belongs to you can customize the attribute values for the instance action details \[1] search attributes search for static attributes configured in the model the instance is associated with \[2] refresh refresh attribute values \[3] import attributes import attributes see create and import models docid 09kftudhjli4ujyvwdcke to learn more about importing static attributes \[4] save instance save changes to the instance \[5] edit customize static attribute value dynamic attributes the dynamic attributes tab displays the variable data attributes configured in the model the instance belongs to you can map one to one relationships with data topics and attributes by updating the topic field for the instance important to view data from a topic in the instance payload, you must map the topic to a dynamic attribute action details \[1] search attributes search for dynamic attributes in the model the instance is associated with \[2] edit you have the option of adding topics from different data sources in litmus edge, such as from devicehub or an integration click the edit icon, and search for a devicehub tag or enter the topic name in the topic field \[3] refresh refresh attribute values \[4] import attributes import attributes see create and import models docid 09kftudhjli4ujyvwdcke to learn more about importing dynamic attributes \[5] save instance save changes to the instance data access the data access tab allows you to view real time data for the instance details \[1] review the topic name and interval configured for the instance click the copy icon to copy the topic name \[2] subscribe and unsubscribe for data access to view real time data for the instance restart instance after making changes to the instance, make sure to click save instance and then restart instance to implement the updates