Virtual devices

Apama Analytics Builder for Cumulocity IoT 10.5 | Apama Analytics Builder for Cumulocity IoT Documentation | Using Apama Analytics Builder for Cumulocity IoT | Models and Devices | Virtual devices

Virtual devices

A virtual device is used when a model is deployed in test or simulation mode. See also Deploying a model.

Virtual devices are objects in the Cumulocity IoT inventory with a c8y_VirtualDevice property. This property refers to the identifier of the real device of which the virtual device is a copy.

Use the creationDate to find out what virtualDevice was created for a model activation and which measurements have that device as their source.

By default, the virtual devices are kept for 30 days. If you want to change this default, you need to change the tenant options. That is, you need to send a POST /tenant/options request. For detailed information, see the information on tenants in the Reference guide at https://www.cumulocity.com/guides/. For example, specify the following to set the retention period for the virtual devices to 1 day:

{
"category": "analytics.builder",
"key": "retention.virtualDevicesMaxDays",
"value": "1"
}