From 03ac59ff9dc3ea74f60116eff8f9ba1f327d460b Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Thu, 27 Nov 2025 11:15:55 +0000 Subject: [PATCH 01/20] Initial doc --- ...-AB-Processing-DeiviceHirearchy-chagnes.md | 21 +++++++++++++++++++ .../models-and-devices.md | 10 +++++++++ 2 files changed, 31 insertions(+) create mode 100644 content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md new file mode 100644 index 0000000000..b99d2dd7a5 --- /dev/null +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md @@ -0,0 +1,21 @@ +--- +date: 2025-11-27 +title: Changes in Cumulocity IoT devices are automatically processed by Analytics Builder +change_type: + - value: change-inv-3bw8e + label: Announcement +product_area: Analytics +component: + - value: component-M5-cepIIS + label: Streaming Analytics +build_artifact: + - value: tc-KXXmo2SUR + label: apama-in-c8y +ticket: APMF-94 +version: 26.257.0 +--- + +Analytics Builder models now automatically track changes to the device hierarchy, including Addition, Deletion and updates to devices, group and Assets membership and metadata. +This removes the need to deactivate and reactivate models. + +#to-do Date and version will be upated before merging. \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 30f821436a..ac2174fa01 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -195,3 +195,13 @@ You can combine several values. For example, specify the following if you only w The default value of this tenant option is `not has(c8y_IsVirtualDevice)`. As long as you do not change this tenant option, virtual devices are not shown as they would not make sense in an analytic model. If you change the value for this tenant option, make sure to specify all managed objects that you want to see in the search result. See also [Configuration](/streaming-analytics/analytics-builder/#configuration). + +### Device Hierarchy changes {#device-hierarchy-changes} + +Analytics Builder models now automatically track changes to device group membership and device metadata. A Device addition, deletion, update to metadata such as device type. The affected models immediately reflect these changes without requiring manual deactivation or reactivation. +SmartRules2.0 (Analytics Rules), which are based in Analytics Builder models, Will also be able to track changes to the hierarchy and process the data from these devices. + +Where it does not work +- cascade deletion of a group is not supported (It will need a cache update or a reload of the model) +- deletion of a parent group is not supported (Model will deleted and an Error is logged.) +- deletion of a parent assset is not supported (Model will deleted and an Error is logged.) From 8f54fd352c22b0b89959ca1ff853c043e268d55d Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Thu, 27 Nov 2025 11:29:46 +0000 Subject: [PATCH 02/20] File name change --- ...ma-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md} | 0 .../analytics-builder-bundle/models-and-devices.md | 1 + 2 files changed, 1 insertion(+) rename content/change-logs/analytics/{apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md => apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md} (100%) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md similarity index 100% rename from content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-chagnes.md rename to content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index ac2174fa01..7c025f3d2d 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -202,6 +202,7 @@ Analytics Builder models now automatically track changes to device group members SmartRules2.0 (Analytics Rules), which are based in Analytics Builder models, Will also be able to track changes to the hierarchy and process the data from these devices. Where it does not work + - cascade deletion of a group is not supported (It will need a cache update or a reload of the model) - deletion of a parent group is not supported (Model will deleted and an Error is logged.) - deletion of a parent assset is not supported (Model will deleted and an Error is logged.) From e614ebfe6751ed40c2f17cd5972b564ad2067e36 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Thu, 27 Nov 2025 14:10:20 +0000 Subject: [PATCH 03/20] refernce updates --- ...0251127-AB-Processing-DeiviceHirearchy-changes.md | 5 ++--- .../analytics-builder-bundle/models-and-devices.md | 12 ++++++------ 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index b99d2dd7a5..e32d538e7c 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,7 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models now automatically track changes to the device hierarchy, including Addition, Deletion and updates to devices, group and Assets membership and metadata. -This removes the need to deactivate and reactivate models. +Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, group, and asset membership as well as metadata modifications. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement to deactivate and reactivate models to pick up such updates is now removed. -#to-do Date and version will be upated before merging. \ No newline at end of file +For details, refer to [Device Hierarchy changes ](/streaming-analytics/models-and-devices/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 7c025f3d2d..fb56360d10 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,11 +198,11 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Device Hierarchy changes {#device-hierarchy-changes} -Analytics Builder models now automatically track changes to device group membership and device metadata. A Device addition, deletion, update to metadata such as device type. The affected models immediately reflect these changes without requiring manual deactivation or reactivation. -SmartRules2.0 (Analytics Rules), which are based in Analytics Builder models, Will also be able to track changes to the hierarchy and process the data from these devices. +Analytics Builder models will automatically track changes to device group membership and device metadata. A Device addition, deletion, update to metadata such as device type. The affected models immediately reflect these changes without requiring manual deactivation or reactivation. +[Smart rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin). +, which are based in Analytics Builder models Will also behave in similary to the device changes hierarchy and process the data from these devices. -Where it does not work +This comes with few limitations listed below. -- cascade deletion of a group is not supported (It will need a cache update or a reload of the model) -- deletion of a parent group is not supported (Model will deleted and an Error is logged.) -- deletion of a parent assset is not supported (Model will deleted and an Error is logged.) +- Cascade deletion of a Group is not supported (This Case needs a reload of the model to take effect.) +- Deletion of a parent Group/Asset is not supported (Model will deleted and an Error is logged.) From 7dbfa069853b997febf69cb54a17088e5ccd6ef7 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Fri, 28 Nov 2025 05:24:07 +0000 Subject: [PATCH 04/20] ref update --- ...ma-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index e32d538e7c..a1822da704 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -17,4 +17,4 @@ version: 26.257.0 Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, group, and asset membership as well as metadata modifications. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement to deactivate and reactivate models to pick up such updates is now removed. -For details, refer to [Device Hierarchy changes ](/streaming-analytics/models-and-devices/#device-hierarchy-changes). \ No newline at end of file +For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file From 794c2ffab2b91436565733291342f4fbcd0d8e51 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 1 Dec 2025 09:19:25 +0000 Subject: [PATCH 05/20] more elaborate description --- ...-AB-Processing-DeiviceHirearchy-changes.md | 2 +- .../models-and-devices.md | 26 +++++++++++++++---- 2 files changed, 22 insertions(+), 6 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index a1822da704..6048c8ecf8 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, group, and asset membership as well as metadata modifications. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement to deactivate and reactivate models to pick up such updates is now removed. +Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, group, and asset membership as well as metadata modifications. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement to deactivate and reactivate models to pick up such updates is no longer needed. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index fb56360d10..7bc48429f3 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,11 +198,27 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Device Hierarchy changes {#device-hierarchy-changes} -Analytics Builder models will automatically track changes to device group membership and device metadata. A Device addition, deletion, update to metadata such as device type. The affected models immediately reflect these changes without requiring manual deactivation or reactivation. -[Smart rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin). -, which are based in Analytics Builder models Will also behave in similary to the device changes hierarchy and process the data from these devices. +Analytics Builder models, once deployed, automatically process data from all linked input devices. Any changes to device configuration—such as device addition, deletion, metadata updates (for example, device type changes), or updates to group/asset membership—are now detected automatically. +The affected models immediately reflect these changes without requiring manual deactivation or reactivation. -This comes with few limitations listed below. +#### Behavior of Smart Rules (NEW) Plugin + +[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. It dynamically responds to updates in the device hierarchy and continues processing data from the updated device set. + +#### Model Deletion Scenarios. +Models are automatically deleted in the following cases: + +- When the input device or output device is removed. +- When the parent group or asset configured in the model is deleted. + +In such cases, the model is removed and an error message is recorded in the correlator log. + +#### Handling Structural Changes +Models also automatically adapt to structural changes within a device hierarchy. This includes: +- Re-arrangement of devices inside groups or assets +- Addition of new devices +- Removal of existing devices + +#### Limitations to these changes. - Cascade deletion of a Group is not supported (This Case needs a reload of the model to take effect.) -- Deletion of a parent Group/Asset is not supported (Model will deleted and an Error is logged.) From 97b18e84e18cd5f88682f998dcab9eed738ebbf2 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 1 Dec 2025 09:20:44 +0000 Subject: [PATCH 06/20] Empty groups --- .../analytics-builder-bundle/models-and-devices.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 7bc48429f3..c0d60e3400 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -218,6 +218,7 @@ Models also automatically adapt to structural changes within a device hierarchy. - Re-arrangement of devices inside groups or assets - Addition of new devices - Removal of existing devices +- Assets or Groups without any devices is also possible. #### Limitations to these changes. From b32e69332a2abd5cdd27211d7c3638d32e3acc1e Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Tue, 2 Dec 2025 05:23:31 +0000 Subject: [PATCH 07/20] Group empty case --- .../analytics-builder-bundle/models-and-devices.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index c0d60e3400..aa71d579a7 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -218,6 +218,9 @@ Models also automatically adapt to structural changes within a device hierarchy. - Re-arrangement of devices inside groups or assets - Addition of new devices - Removal of existing devices +{{< c8y-admon-info >}} + When a model is deployed to process a Group, all devices can be removed from the Group, leaving it with zero devices. The model will not be deleted, and it will restart processing again whenever a device is added back to the Group +{{< /c8y-admon-info >}} - Assets or Groups without any devices is also possible. #### Limitations to these changes. From 5edf79a7e458e18fcce4149a83e24edf8ad28e48 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Tue, 2 Dec 2025 06:29:46 +0000 Subject: [PATCH 08/20] rewording of doc --- ...251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- .../analytics-builder-bundle/models-and-devices.md | 13 ++++++------- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 6048c8ecf8..5dd474954a 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, group, and asset membership as well as metadata modifications. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement to deactivate and reactivate models to pick up such updates is no longer needed. +Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, or Group, and Asset membership. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement was to deactivate and reactivate models to pick up such updates is no longer needed. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index aa71d579a7..0eb614d484 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,20 +198,20 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Device Hierarchy changes {#device-hierarchy-changes} -Analytics Builder models, once deployed, automatically process data from all linked input devices. Any changes to device configuration—such as device addition, deletion, metadata updates (for example, device type changes), or updates to group/asset membership—are now detected automatically. +Analytics Builder models, once deployed, automatically process data from all linked devices. Any changes to device configuration—such as device addition, deletion, metadata updates (for example, device type changes), or updates to group/asset membership—are now detected automatically. The affected models immediately reflect these changes without requiring manual deactivation or reactivation. -#### Behavior of Smart Rules (NEW) Plugin - +{{< c8y-admon-info >}} [The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. It dynamically responds to updates in the device hierarchy and continues processing data from the updated device set. +{{}} #### Model Deletion Scenarios. -Models are automatically deleted in the following cases: +Models are automatically deactivated in the following cases: -- When the input device or output device is removed. +- If the input device or output device of the modle is deleted. - When the parent group or asset configured in the model is deleted. -In such cases, the model is removed and an error message is recorded in the correlator log. +In such cases, the model is removed and an error message is recorded in the logs. #### Handling Structural Changes Models also automatically adapt to structural changes within a device hierarchy. This includes: @@ -221,7 +221,6 @@ Models also automatically adapt to structural changes within a device hierarchy. {{< c8y-admon-info >}} When a model is deployed to process a Group, all devices can be removed from the Group, leaving it with zero devices. The model will not be deleted, and it will restart processing again whenever a device is added back to the Group {{< /c8y-admon-info >}} -- Assets or Groups without any devices is also possible. #### Limitations to these changes. From d769aec39572ab923bc6bdf47a87c9a016243831 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Tue, 2 Dec 2025 12:47:11 +0000 Subject: [PATCH 09/20] grammer correction --- ...ma-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 5dd474954a..e727e783cc 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, or Group, and Asset membership. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement was to deactivate and reactivate models to pick up such updates is no longer needed. +Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, members of Group and Asset. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement was to deactivate and reactivate models to pick up such updates is no longer needed. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file From a4d295cf9b7209dae431b9fd970ff1f27debc823 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Fri, 5 Dec 2025 08:15:38 +0000 Subject: [PATCH 10/20] rewritten changelog --- ...c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index e727e783cc..b2c1380361 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -1,9 +1,9 @@ --- date: 2025-11-27 -title: Changes in Cumulocity IoT devices are automatically processed by Analytics Builder +title: Analytics Builder models detect hierarchy changes of devices within device groups, asset groups, and assets. change_type: - - value: change-inv-3bw8e - label: Announcement + - value: change-QHu1GdukP + label: Feature product_area: Analytics component: - value: component-M5-cepIIS @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now automatically track changes to devices, including additions, deletions, and updates to device, members of Group and Asset. This ensures that any structural or configuration changes are immediately reflected in model processing without user intervention. The earlier requirement was to deactivate and reactivate models to pick up such updates is no longer needed. +Analytics Builder models will now detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file From ca42e31ff0753f42c3315dc7a65670708e759a64 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 8 Dec 2025 07:17:50 +0000 Subject: [PATCH 11/20] re-written changelog --- ...-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- .../analytics-builder-bundle/models-and-devices.md | 7 +++---- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index b2c1380361..04463ec222 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. +Analytics Builder models will detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 0eb614d484..eeb1ecce41 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,11 +198,10 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Device Hierarchy changes {#device-hierarchy-changes} -Analytics Builder models, once deployed, automatically process data from all linked devices. Any changes to device configuration—such as device addition, deletion, metadata updates (for example, device type changes), or updates to group/asset membership—are now detected automatically. -The affected models immediately reflect these changes without requiring manual deactivation or reactivation. +Analytics Builder models will now detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. {{< c8y-admon-info >}} -[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. It dynamically responds to updates in the device hierarchy and continues processing data from the updated device set. +[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. {{}} #### Model Deletion Scenarios. @@ -224,4 +223,4 @@ Models also automatically adapt to structural changes within a device hierarchy. #### Limitations to these changes. -- Cascade deletion of a Group is not supported (This Case needs a reload of the model to take effect.) +- Cascaded deletion of a Group is not supported (This Case needs a reload of the model to take effect.) From dce045039b1d0e353c435953eaf155ad6a026abb Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 8 Dec 2025 09:49:28 +0000 Subject: [PATCH 12/20] re-written documentation --- ...-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 4 ++-- .../analytics-builder-bundle/models-and-devices.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 04463ec222..a3eb4dea64 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -1,6 +1,6 @@ --- date: 2025-11-27 -title: Analytics Builder models detect hierarchy changes of devices within device groups, asset groups, and assets. +title: Analytics Builder models detect hierarchy changes within device groups, asset groups, and assets. change_type: - value: change-QHu1GdukP label: Feature @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. +Analytics Builder models will now detect changes to device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index eeb1ecce41..79f3e1995e 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,7 +198,7 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Device Hierarchy changes {#device-hierarchy-changes} -Analytics Builder models will now detect changes to devices within device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. +Dynamic changes to Groups, Assets, and Devices processed by a deployed model are now detected. These include new device or asset additions, deletions, updates, and changes in the hierarchy of devices or sub-assets within a group or asset. With the latest update, the model now automatically processes data based on the updated group or asset structure. {{< c8y-admon-info >}} [The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. @@ -218,7 +218,7 @@ Models also automatically adapt to structural changes within a device hierarchy. - Addition of new devices - Removal of existing devices {{< c8y-admon-info >}} - When a model is deployed to process a Group, all devices can be removed from the Group, leaving it with zero devices. The model will not be deleted, and it will restart processing again whenever a device is added back to the Group + When a model is deployed to process a Group, all devices may be removed from the Group, leaving it with zero devices. The model will not be deleted, and it will automatically resume processing whenever a device is added back to the Group. {{< /c8y-admon-info >}} #### Limitations to these changes. From e3cbe5b4d88ce682e9f48fc511357af59bd6b9b2 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 8 Dec 2025 10:38:38 +0000 Subject: [PATCH 13/20] de-activated in place of deleted models. --- ...-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- .../analytics-builder-bundle/models-and-devices.md | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index a3eb4dea64..23dd1d3169 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now detect changes to device groups, asset groups, and assets. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of devices or sub-assets within a group or asset. The model then processes data based on the updated group or asset structure, providing a seamless user experience. +Analytics Builder models will now detect changes to Groups, Assets, and Devices. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of Groups, Assets. The model then processes data based on the updated Groups, Assets, and Device structure, providing a seamless user experience. For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 79f3e1995e..cd7ce60680 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -207,8 +207,8 @@ Dynamic changes to Groups, Assets, and Devices processed by a deployed model are #### Model Deletion Scenarios. Models are automatically deactivated in the following cases: -- If the input device or output device of the modle is deleted. -- When the parent group or asset configured in the model is deleted. +- If the input device or output device of the modle is de-activated. +- When the parent group or asset configured in the model is de-activated. In such cases, the model is removed and an error message is recorded in the logs. @@ -217,8 +217,9 @@ Models also automatically adapt to structural changes within a device hierarchy. - Re-arrangement of devices inside groups or assets - Addition of new devices - Removal of existing devices +

{{< c8y-admon-info >}} - When a model is deployed to process a Group, all devices may be removed from the Group, leaving it with zero devices. The model will not be deleted, and it will automatically resume processing whenever a device is added back to the Group. + When a model is deployed to process a Group, all devices may be removed from the Group, leaving it with zero devices. The model will not be de-activated, and it will automatically resume processing whenever a device is added back to the Group. {{< /c8y-admon-info >}} #### Limitations to these changes. From e18302aa4f922f846f3e1209dc567887cea62e4f Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 8 Dec 2025 11:24:08 +0000 Subject: [PATCH 14/20] corrections --- ...-AB-Processing-DeiviceHirearchy-changes.md | 6 +++--- .../models-and-devices.md | 20 +++++++++---------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 23dd1d3169..b169ada88c 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -1,6 +1,6 @@ --- date: 2025-11-27 -title: Analytics Builder models detect hierarchy changes within device groups, asset groups, and assets. +title: Analytics Builder models detects hierarchy changes within device groups. change_type: - value: change-QHu1GdukP label: Feature @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models will now detect changes to Groups, Assets, and Devices. This includes new device or asset additions, deletions, and updates, as well as changes in the hierarchy of Groups, Assets. The model then processes data based on the updated Groups, Assets, and Device structure, providing a seamless user experience. +Analytics Builder models detect hierarchy changes within device groups. This includes additions of new devices, sub-groups, or assets, as well as updates, deletions, and structural changes in groups or assets. The model then processes data based on the updated structure, providing a seamless user experience. -For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#device-hierarchy-changes). \ No newline at end of file +For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#group-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index cd7ce60680..01d97e6658 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -196,32 +196,32 @@ The default value of this tenant option is `not has(c8y_IsVirtualDevice)`. As lo See also [Configuration](/streaming-analytics/analytics-builder/#configuration). -### Device Hierarchy changes {#device-hierarchy-changes} +### Group hierarchy changes {#group-hierarchy-changes} -Dynamic changes to Groups, Assets, and Devices processed by a deployed model are now detected. These include new device or asset additions, deletions, updates, and changes in the hierarchy of devices or sub-assets within a group or asset. With the latest update, the model now automatically processes data based on the updated group or asset structure. +Model consuming data from a group of devices or assets groups then any changes to the group hierarchy will now be detected automatically. These include new device or asset additions, deletions, updates, and changes in the hierarchy of devices or sub-assets within a group or asset. With the latest update, the model now automatically processes data based on the updated group or asset structure. {{< c8y-admon-info >}} -[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves the same way. +[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves in this same way. {{}} -#### Model Deletion Scenarios. +#### Model de-activation Scenarios. Models are automatically deactivated in the following cases: -- If the input device or output device of the modle is de-activated. -- When the parent group or asset configured in the model is de-activated. +- If the input device or output device of the model is deleted. +- When the parent group or asset configured in the model is deleted. -In such cases, the model is removed and an error message is recorded in the logs. +In such cases, the model is de-activated and an error message is recorded in the logs. #### Handling Structural Changes Models also automatically adapt to structural changes within a device hierarchy. This includes: -- Re-arrangement of devices inside groups or assets +- Re-arrangement of devices within groups or assets - Addition of new devices - Removal of existing devices

{{< c8y-admon-info >}} - When a model is deployed to process a Group, all devices may be removed from the Group, leaving it with zero devices. The model will not be de-activated, and it will automatically resume processing whenever a device is added back to the Group. +When a model is deployed to process a group of devices, all devices may be removed from the group, leaving the group with zero devices. The model will not be deactivated, and it will automatically resume processing whenever a device is added back to the group. {{< /c8y-admon-info >}} #### Limitations to these changes. -- Cascaded deletion of a Group is not supported (This Case needs a reload of the model to take effect.) +- Cascaded deletion of a sub-group is not supported. The model must be undeployed and redeployed \ No newline at end of file From f3b6bb38a16c1a74a4f03a2c8ea6e2dbebebb20f Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Mon, 8 Dec 2025 11:33:29 +0000 Subject: [PATCH 15/20] tag to group hierachy changes --- ...-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 4 ++-- .../analytics-builder-bundle/models-and-devices.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index b169ada88c..6db71fbe52 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models detect hierarchy changes within device groups. This includes additions of new devices, sub-groups, or assets, as well as updates, deletions, and structural changes in groups or assets. The model then processes data based on the updated structure, providing a seamless user experience. +Analytics Builder models that consumes data from group of devices or assets will detect hierarchy changes within device groups. This includes additions of new devices, sub-groups, or assets, as well as updates, deletions, and structural changes in groups or assets. The model then processes data based on the updated structure, providing a seamless user experience. -For details, refer to [Device Hierarchy changes ](/streaming-analytics/analytics-builder/#group-hierarchy-changes). \ No newline at end of file +For details, refer to [Group hierarchy changes ](/streaming-analytics/analytics-builder/#group-hierarchy-changes). \ No newline at end of file diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 01d97e6658..74989bacde 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -198,7 +198,7 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). ### Group hierarchy changes {#group-hierarchy-changes} -Model consuming data from a group of devices or assets groups then any changes to the group hierarchy will now be detected automatically. These include new device or asset additions, deletions, updates, and changes in the hierarchy of devices or sub-assets within a group or asset. With the latest update, the model now automatically processes data based on the updated group or asset structure. +Input blocks in an Analytics Builder model receive data from a group of devices or assets. Any change to this group hierarchy is now detected automatically. This includes new device or asset, deletions, updates and changes in the hierarchy of devices or sub-assets within a group or asset. Model now processes data based on the updated group or asset structure. {{< c8y-admon-info >}} [The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves in this same way. From 84f7b8372a833e30260deab37f9faee55ec7b368 Mon Sep 17 00:00:00 2001 From: Yagna Sri Tannedi Date: Tue, 9 Dec 2025 11:49:20 +0530 Subject: [PATCH 16/20] Update content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md Co-authored-by: Sandeep Komarneni <87428699+skom-c8y@users.noreply.github.com> --- ...ma-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 6db71fbe52..572c3db072 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -15,6 +15,6 @@ ticket: APMF-94 version: 26.257.0 --- -Analytics Builder models that consumes data from group of devices or assets will detect hierarchy changes within device groups. This includes additions of new devices, sub-groups, or assets, as well as updates, deletions, and structural changes in groups or assets. The model then processes data based on the updated structure, providing a seamless user experience. +Analytics Builder models that consumes data from group of devices or assets will detect hierarchy changes. This includes additions of new devices, sub-groups, or assets, as well as updates, deletions, and structural changes in groups or assets. The model then processes data based on the updated structure, providing a seamless user experience. For details, refer to [Group hierarchy changes ](/streaming-analytics/analytics-builder/#group-hierarchy-changes). \ No newline at end of file From 2b3f73ee5c68ec970f7d115cc80c3b91eaeb7951 Mon Sep 17 00:00:00 2001 From: Yagna Sri Tannedi Date: Tue, 9 Dec 2025 11:49:38 +0530 Subject: [PATCH 17/20] Update content/streaming-analytics/analytics-builder-bundle/models-and-devices.md Co-authored-by: Sandeep Komarneni <87428699+skom-c8y@users.noreply.github.com> --- .../analytics-builder-bundle/models-and-devices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 74989bacde..3f52ab1e56 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -201,7 +201,7 @@ See also [Configuration](/streaming-analytics/analytics-builder/#configuration). Input blocks in an Analytics Builder model receive data from a group of devices or assets. Any change to this group hierarchy is now detected automatically. This includes new device or asset, deletions, updates and changes in the hierarchy of devices or sub-assets within a group or asset. Model now processes data based on the updated group or asset structure. {{< c8y-admon-info >}} -[The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin), which internally uses Analytics Builder models, behaves in this same way. +This change is also applicable to [The Smart Rules (NEW) plugin](https://cumulocity.com/docs/streaming-analytics/smart-rules-plugin#what-is-the-smart-rules-plugin) {{}} #### Model de-activation Scenarios. From a80f280207965b498a51332642bac24c82dad62f Mon Sep 17 00:00:00 2001 From: Yagna Sri Tannedi Date: Tue, 9 Dec 2025 11:49:58 +0530 Subject: [PATCH 18/20] Update content/streaming-analytics/analytics-builder-bundle/models-and-devices.md Co-authored-by: Sandeep Komarneni <87428699+skom-c8y@users.noreply.github.com> --- .../analytics-builder-bundle/models-and-devices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 3f52ab1e56..736c9b4e87 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -224,4 +224,4 @@ When a model is deployed to process a group of devices, all devices may be remov #### Limitations to these changes. -- Cascaded deletion of a sub-group is not supported. The model must be undeployed and redeployed \ No newline at end of file +- Deletion of nested group and cascaded deletion of devices is not supported. The model must be un-deployed and redeployed to refer to the updated group hierarchy \ No newline at end of file From 3faeb803b7315bd02426a332263863bc26f3e1c6 Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Tue, 9 Dec 2025 06:53:38 +0000 Subject: [PATCH 19/20] correction to title and state of model --- ...ma-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md | 2 +- .../analytics-builder-bundle/models-and-devices.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md index 572c3db072..643f386e92 100644 --- a/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md +++ b/content/change-logs/analytics/apama-in-c8y-20251127-AB-Processing-DeiviceHirearchy-changes.md @@ -1,6 +1,6 @@ --- date: 2025-11-27 -title: Analytics Builder models detects hierarchy changes within device groups. +title: Analytics Builder models detects hierarchy changes within group of devices and assets. change_type: - value: change-QHu1GdukP label: Feature diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 736c9b4e87..23a8d3bb44 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -210,7 +210,7 @@ Models are automatically deactivated in the following cases: - If the input device or output device of the model is deleted. - When the parent group or asset configured in the model is deleted. -In such cases, the model is de-activated and an error message is recorded in the logs. +In such cases, the runtime state is set to `FAILED` and logged in the audit log. #### Handling Structural Changes Models also automatically adapt to structural changes within a device hierarchy. This includes: From 092433fb444e4822f8743cbdd268a106527905eb Mon Sep 17 00:00:00 2001 From: YagnaSri Tannedi Date: Tue, 9 Dec 2025 07:09:52 +0000 Subject: [PATCH 20/20] hierarchy docs --- .../analytics-builder-bundle/models-and-devices.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md index 23a8d3bb44..bb9a7956b9 100644 --- a/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md +++ b/content/streaming-analytics/analytics-builder-bundle/models-and-devices.md @@ -213,10 +213,11 @@ Models are automatically deactivated in the following cases: In such cases, the runtime state is set to `FAILED` and logged in the audit log. #### Handling Structural Changes -Models also automatically adapt to structural changes within a device hierarchy. This includes: -- Re-arrangement of devices within groups or assets -- Addition of new devices -- Removal of existing devices +Models also automatically adapt to structural changes within a group hierarchy. This includes: +- Addition of new devices, assets and sub-groups +- Removal of existing devices or assets +- Updating the internal device layout of groups or assets +

{{< c8y-admon-info >}} When a model is deployed to process a group of devices, all devices may be removed from the group, leaving the group with zero devices. The model will not be deactivated, and it will automatically resume processing whenever a device is added back to the group.