Save time series strategies: added description for advanced processing settings mode
This commit is contained in:
parent
8b0fb853aa
commit
148ea630c2
@ -1,3 +1,29 @@
|
|||||||
**TO DO;**
|
#### Potential unexpected behavior with mixed processing strategies
|
||||||
|
|
||||||
Advanced mode doc
|
When configuring the processing strategies, certain combinations can lead to unexpected behavior. Consider the following scenarios:
|
||||||
|
|
||||||
|
- **Disabling WebSocket (WS) updates**
|
||||||
|
|
||||||
|
If WS updates are disabled, any changes to the time series data won’t be pushed to dashboards (or other WS subscriptions).
|
||||||
|
This means that even if a database is updated, dashboards may not display the updated data until browser page is reloaded.
|
||||||
|
|
||||||
|
- **Different deduplication intervals across actions**
|
||||||
|
|
||||||
|
When you configure different deduplication intervals for actions, the same incoming message might be processed differently for each action.
|
||||||
|
For example, a message might be stored immediately in the Time series table (if set to *On every message*) while not being stored in the Latest values table because its deduplication interval hasn’t elapsed.
|
||||||
|
Also, if the WebSocket updates are configured with a different interval, dashboards might show updates that do not match what is stored in the database.
|
||||||
|
|
||||||
|
- **Skipping database storage**
|
||||||
|
|
||||||
|
Choosing to disable one or more persistence actions (for instance, skipping database storage for Time series or Latest values while keeping WS updates enabled) introduces the risk of having only partial data available:
|
||||||
|
- If a message is processed only for real-time notifications (WebSockets) and not stored in the database, historical queries may not match data on the dashboard.
|
||||||
|
- When processing strategies for Time series and Latest values are out-of-sync, telemetry data may be stored in one table (e.g., Time series) while the same data is absent in the other (e.g., Latest values).
|
||||||
|
|
||||||
|
- **Deduplication cache clearing**
|
||||||
|
|
||||||
|
The deduplication mechanism uses a cache to track processed messages within each interval.
|
||||||
|
For performance and system stability reasons, this cache is periodically cleared.
|
||||||
|
As a result, if a cache entry is removed during the deduplication period, messages from the same originator may be processed more than once within that interval.
|
||||||
|
This means deduplication should be used as a performance optimization rather than an absolute guarantee of single processing per interval.
|
||||||
|
|
||||||
|
We recommend using deduplication only when the occasional repeated processing is acceptable and won't cause system correctness issue or data inconsistencies.
|
||||||
|
|||||||
@ -5135,8 +5135,8 @@
|
|||||||
"advanced-mode": "Advanced",
|
"advanced-mode": "Advanced",
|
||||||
"save-time-series": {
|
"save-time-series": {
|
||||||
"processing-settings": "Processing settings",
|
"processing-settings": "Processing settings",
|
||||||
"processing-settings-hint": "Define how time series data is processed. In Basic mode, select a preconfigured processing strategy or enable only WebSocket updates. Advanced mode allows you to select individual processing strategies for each action.",
|
"processing-settings-hint": "Define how incoming messages are processed. In Basic mode, select a preconfigured processing strategy or enable only WebSocket updates. Advanced mode allows you to select individual processing strategies for each action.",
|
||||||
"advanced-settings-hint": "Advanced settings mode is dangerous, and if you do not understand it, you may lose telemetry.",
|
"advanced-settings-hint": "Be cautious when configuring processing strategies. Certain combinations can lead to unexpected behavior.",
|
||||||
"strategy": "Strategy",
|
"strategy": "Strategy",
|
||||||
"deduplication-interval": "Deduplication interval",
|
"deduplication-interval": "Deduplication interval",
|
||||||
"deduplication-interval-required": "Deduplication interval is required",
|
"deduplication-interval-required": "Deduplication interval is required",
|
||||||
@ -5148,7 +5148,7 @@
|
|||||||
"web-sockets-only": "WebSockets only"
|
"web-sockets-only": "WebSockets only"
|
||||||
},
|
},
|
||||||
"time-series": "Time series",
|
"time-series": "Time series",
|
||||||
"latest": "Latest",
|
"latest": "Latest values",
|
||||||
"web-sockets": "WebSockets"
|
"web-sockets": "WebSockets"
|
||||||
},
|
},
|
||||||
"key-val": {
|
"key-val": {
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user