Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In order to cover data loss during a keep alive timeout scenario, the MQTT Transmission History Store includes a Rolling History Buffer that can be configured in the Advanced Properties configuration section. When the Rolling History Buffer is enabled, all tag changes will be written to the History Store regardless of connection status.

The Metrics Stored tag for the History Store will update as data is written to and pruned from the Rolling History Buffer. 

The In-Order History configuration parameter of the Transmitter will determine whether the data is flushed in-order (synchronously) or asynchronously.


Note

Data stored in the Rolling History Buffer for an In-Memory History Store will not be persisted across a module configuration change, module disable/enable, module restart or power loss. 

Data stored in the Rolling History Buffer for a Disk-Backed History Store will persist across a module configuration change, module disable/enable, module restart or power loss however you will lose change events that occur during the update or refresh.


Image AddedImage Removed

  • Enable Rolling History Buffer
    • Enable the Rolling History Buffer to store data in a rolling buffer to cover data loss in a keep alive timeout scenario
  • Rolling History Prune Interval
    • Interval at which to attempt to prune the rolling history buffer in seconds
  • Rolling History Max Age
    • The maximum age allowed of the data in the rolling history buffer in seconds
    Rolling History Prune Quantity
    • Removed in release 4.0.19
    • All data older than the Max Age will be pruned at each prune interval
  • Rolling History Prune Quantity (Deprecated in release 4.0.19)


Tip

It can take MQTT Transmission 1.5 times the configured Server Keep Alive time to determined that there is a connection failure. The Rolling History Max Age should be at least 2x the Transmitter Server Keep Alive timeout to ensure that all tag change events are captured during this period. 

...