Versions Compared

Key

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

The history configuration for MQTT Engine tags can be configured as needed for your specific requirements as described in Ignition's Configuring Tag History and  How the Tag Historian System Works documents.

Note
History configuration for MQTT Engine tags is not persistent however it may be required to delete MQTT Engine tags in certain cases. Review the options for how to manage history configuration if deleting MQTT Engine tags is required.

However, when using MQTT Store and Forward where historical events will be published, there are some caveats to be aware of.

...

Table of Contents
minLevel2

Anchor
writetodatabase
writetodatabase
Writing historical events directly to the database, via the Historian, bypassing the tag

The configuration parameters required to write historical events directly to the database, via the Historian, bypassing the Tag are shown below.

...

Note
All other properties such as Sample Mode, Max Time Between Samples, Deadband etc are ignored when writing historic data

Examples





Anchor
writetotag
writetotag
Writing historical events directly to tag

There are several reasons why you might need to write directly to the tag which include:

...

Note

If you are using MQTT Transmission as the Edge side client, under the MQTT Transmission Settings for your transmitter, navigate to the History Settings and ensure that In-Order History is selected.

This ensures that when the MQTT Transmission client comes back online and flushes history, it will flush the oldest historical events first (in order) before sending live Tag changes events to Engine. 

Examples


Anchor
options
options
History Configuration Persistence

History configuration for MQTT Engine tags is not persistent however it may be required to delete MQTT Engine tags in certain cases.

For example if UDTs are being propagated from the Edge and the UDT definition on the Edge has been updated. This requires one to delete all instances of the UDT under MQTT Engine and delete the corresponding UDT definition so that it can be recreated/updated at MQTT Engine for the Edge side changes to take affect.

There are two options for persisting history configuration in this case and they are as follows:

Reference Tags

The recommend way of configuring history for MQTT Engine tags is to use reference tags to indirectly reference MQTT Engine tags. This allows the history configuration to be persisted on the Reference tag when the underlying MQTT Engine tags are deleted.

Note
The reference tag must be a Reference tag only.  Derived, Expression and OPC tags (expose MQTT Engine tag provider through OPCUA server) will not properly store history when MQTT Engine tags are updated with historical data at a high rate of speed. This is a limitation within the Ignition platform and may be addressed in a future release.

If using an Ignition release before v8.1.4, in order for the historical tag changes at the MQTT Engine tag to propagate to the referencing tag, MQTT Engine must be configured to write historical data directly to its tags. See the Writing historical events directly to tag section for configuration details.

Historical back-fill support was added in Ignition 8.1.4 which allows Reference Tags in Ignition to be updated even if history arrives out of order. See the following document for details : MQTT History Back-Fill with Reference Tags


Scripting

Use Ignition scripting to reapply history configuration directly on MQTT Engine tags on demand.