Versions Compared

Key

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

...

The tags below are general information tags with respect to Sparkplug Edge Nodes. These are created, managed and updated by MQTT Engine based on messages arriving from each given Edge Node.

NameData TypeDescription
bdSeqLongThe last bdSeq number sent by the Edge Node in an NBIRTH message

Birth Count

Long

The number of NBIRTH messages since the last time the info metrics were reset via the Node Info/Reset Info tag

Current ServerStringThe current MQTT Server the Edge Node is connected to
Data Latency (ms)Long

The time in milliseconds between MQTT Engine receiving of the last message and the payload's reported time. Note: For this to be very accurate the edge node's clock and the system clock running MQTT Engine should be synced

Death CountLongThe number of NDEATH messages since the last time the info metrics were reset via the Node Info/Reset Info tag
Message SchemaStringThe schema associated with the Edge Node (e.g. Sparkplug B)
Offline DateTimeDateTimeThe time at which the last NDEATH message was received by MQTT Engine
OnlineBooleanWhether or not the Edge Node is online. This is determined by whether the last lifecycle message was an NBIRTH or NDEATH
Online DateTimeDateTimeThe time at which the last NBIRTH message was received by MQTT Engine
Rebirth (Last) CauseStringThe reason for the last rebirth request to be issued for this Edge Node by MQTT Engine (added 4.0.22)
Rebirth (Last) DateTimeDateTimeThe time at which the last rebirth was issued for this Edge Node by MQTT Engine (added 4.0.22)
Rebirth CountIntegerThe count of rebirth requests issued for this Edge Node by MQTT Engine (added 4.0.22)
Reset InfoBooleanWritable tag to 'reset' the Node Info metrics
seqLongThe last Sparkplug seq number received from the Edge Node
Total Bytes Recvd (bytes)LongThe number of bytes received from the Edge Node since the last time the info metrics were reset via the Node Info/Reset Info tag
Total Bytes Xmit (bytes)Long

The number of bytes sent to the Edge Node since the last time the info metrics were reset via the Node Info/Reset Info tag

Transmission VersionStringThe version of MQTT Transmission installed at the Edge Node

Device Control

The tags in each Device Control folder are created based on a supplied metric within the DBIRTH message from the Edge Node. These will only appear if the Edge Node implementation supports them. It is up to the Edge Node implementation (MQTT Transmission for example) to support any functionality it supplies via the DBIRTH. If the Edge Node does not support the specific control, it should not include it in the DBIRTH payload.

NameData TypeDescription
RebirthBooleanWriteable tag to request the Edge Node to resend its cached DBIRTH message for the specific Device without disconnecting or sending DEATH messages first

Device Info

The tags below are general information tags with respect to Sparkplug Devices. These are created, managed and updated by MQTT Engine based on messages arriving from each given Device.

...

The tags below provide information regarding the MQTT Engine Devices, Edge Nodes, Latches, MQTT Client as well as information on MQTT Engine.

NameData TypeDescription
Enable Tag TrackingBooleanWritable tag to control whether or not to update Tags Per Seconds (added 4.0.17)
Rebirth (Last) CauseStringThe reason for the last rebirth request to be issued by MQTT Engine (added 4.0.22)
Rebirth (Last) DateTimeDateTimeThe time at which the last rebirth was issued by MQTT Engine (added 4.0.22)
Rebirth (Last) NodeStringThe Sparkplug EdgeNode ID for which the last rebirth was issued by MQTT Engine (added 4.0.22) 
Rebirth CountIntegerThe count of rebirth requests issued by MQTT Engine (added 4.0.22)
Redundancy RoleStringThe redundancy configuration of the Ignition system that MQTT engine is installed on. Options are Independent, Master and Backup
Redundancy StateStringThe redundancy status of the Ignition system that MQTT engine is installed on. Options are Active or Cold
Reordered Mesg CountIntegerThe number of messages that have been reordered by MQTT Engine (added 4.0.22)
Reordered Mesg ResetBooleanWritable tag to reset the Reordered Mesg Count metric (added 4.0.22)
System-Wide Reset InfoBooleanWriteable tag to 'reset' all Engine metrics
Tag CountLongThe sum of tags included in the last NBIRTH and DBIRTH messages received from each Edge Node. When an LWT is received form the Edge Node, the tag count for that Edge Node is set to 0 and repopulated on connect when the next BIRTH messages are received (added 4.0.17)
Tags Per SecondLongThe number of tags changes received per second with the value updated every two seconds (added 4.0.17)
Total Bytes Recvd (bytes)IntegerThe number of bytes received by Engine since the last time the info metrics were reset via the System-Wide Reset Info tag
Total Bytes Xmit (bytes)IntegerThe number of bytes sent from Engine since the last time the info metrics were reset via the System-Wide Reset Info tag
Total Data Mesg CountIntegerThe number of messages received by Engine since the last time the info metrics were reset via the System-Wide Reset Info tag
VersionStringThe version MQTT Engine currently installed

Devices

The Devices folder tags provide information on the connected devices.

...