Page History

...

• Client ID

  • Optional MQTT client ID to use.  If specified this will be used in the MQTT Transmission connect packet when connecting to the server.  If left blank, a random client ID will be create of the form 'MT-xxxxxxxx-xxxx-xxxx'.

    Warning
    Caution: MQTT Clients IDs must be unique and if two clients attempt to connect with the same client ID, one will be forcefully disconnected from the server to allow the other client to connect.

    
    

• Anchor
  Keep Alive Keep Alive

  Keep Alive
  • The maximum interval in seconds (5-65,535) between any two MQTT protocol control packets sent by the client to the server.
  • The minimum Keep Alive for MQTT Transmission is 5.
  • If the client is idle and has no control packets to send, it will send PINGREQ protocol packet and the server is required to respond with a PINGRESP packet. If no response is received from the server within 1.5 times the Keep Alive, the client will close the connection.

  • If the server does not receive, at minimum, a PINGREQ message from a client within 1.5 times the Keep Alive, it will terminate the connection and send the client's LWT if it has been defined.

  • For MQTT Transmission, this is an DEATH message.

• Random Startup Delay
  • A clients variable reconnect delay in milliseconds - not configured by default
  • Entered in the format of The Random Startup Delay in milliseconds of the form 'min-max' where min is the low end and max is the high end of the random range. e.g. '10-1000'. 
  • Used to minimise "NBIRTH message storms" on reconnect from Edge nodes with many clients 
• Reconnect Delay
  • The A clients fixed reconnect delay in millisecond.milliseconds with a default of 1000
• Subscribe to Legacy STATE Topic
  
  • Allow the Transmission Client to subscribe to a legacy state topic (eg. STATE/IamHost) for primary host ID notifications (available from release 4.0.16)
  • Review Changes to the STATE messages in the Sparkplug v3.0.0 Specification
• Data Format Type
  • The format of the data to send. Default is Sparkplug_B_v1_0_Protobuf with JSON as an option.

...

Anchor
ServerSettingsRPCClient ServerSettingsRPCClient

Server Settings - RPC Client Connection

This section was added in release 4.0.18

...

Anchor
TransmittersAlarmSettings TransmittersAlarmSettings

Transmitters - Alarm Settings

Image Removed

...

When enabled and alarms are enabled on tags, the contents of the triggered alarms will be transmitted via Sparkplug to MQTT Engine and will be inserted into the Ignition Alarm Journal on the server where MQTT Engine is installed.

...

Image Added

• Alarm Event Enable

  • When enabled and alarms are enabled on tags, the contents of the triggered alarms will be transmitted via Sparkplug to MQTT Engine and will be inserted into the Ignition Alarm Journal on the server where MQTT Engine is installed.

    but replace the 'XX' with the proper index per the wrapper.java.additional statements:
    wrapper.java.additional.XX=--add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED

Anchor
TransmittersSparkplugSettings TransmittersSparkplugSettings

Transmitters - Sparkplug Settings

...

The History tab contains a Main section and an Advanced section.

...

• Name
  • The name of the History Store.
• Enabled
  
  • Checkbox to enable/disable the History Store. Not selected by default.
• Type
  • The type of History Store.
  • Data stored in 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 a Disk-Backed History Store will persist across a module configuration change, module disable/enable, module restart or power loss.
• History Max Size
  • Maximum number of megabytes history can use before dropping the data
  • An In-Memory History store will use the Ignition Java Heap memory
• History Max Age
  
  • Maximum number of minutes to store history before dropping the data.
• Flush Quantity
  • The maximum number of tags to publish in a single message upon reestablishing communication.
• • number of megabytes history can use before dropping the data
  • An In-Memory History store will use the Ignition Java Heap memory
• History Max Age
  
  • Maximum number of minutes to store history before dropping the data.
• Flush Quantity
  • The maximum number of tags to publish in a single message upon reestablishing communication.
• Flush Period
  • The period to wait in milliseconds between acquisition and publishing of the historical data when flushing messages upon re-establishing communication
  • MQTT Transmission queries the history store and builds up a publish, and publishes it, and then delays by the Flush Period.
    The actual message publish frequency is not deterministic as the time to gather the publish from the history store can vary depending on the frequency tag change events occurring, disk speed, CPU availability, etc. For example, if it takes 5s to gather up and publish that payload, the actual message publish frequency will be it will be 5s + the flush period
  Flush Period
  • The period to wait in milliseconds between publishes when flushing messages upon re-establishing communication

Anchor
HistoryAdvanced HistoryAdvanced

History - Advanced

...

• H2 Database Port
  • TCP Port to connect to H2 Database for Disk-Backed History Store