You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

MQTT Engine automatically creates a known set of tags for MQTT Engine control, MQTT Engine telemetry, for Sparkplug edge nodes and devices, for its MQTT client connections, etc. The tables below describes these tags.

Node Control Tags

The tags below are created based on a supplied metric within the NBIRTH 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 NBIRTH. If the Edge Node does not support the specific control, it should not include it in the NBIRTH payload.


NameDescription
Node Control/Next ServerRequests the Edge Node to walk to the next MQTT server
Node Control/RebirthRequests the Edge Node to resend its NBIRTH and DBIRTH messages without disconnecting or sending DEATH messages first
Node Control/RebootRequests the Edge Node to reboot resulting in DEATH messages and a full BIRTH sequence
Node Control/*These can be any custom functionality the Edge Node may support

Node Info Tags

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


NameDescription
Node Info/bdSeqThe last bdSeq number sent by the Edge Node in an NBIRTH message

Node Info/Birth Count

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

Node Info/Current ServerThe current MQTT Server the Edge Node is connected to
Node Info/Data Latency

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

Node Info/Death CountThe number of NDEATH messages since the last time the info metrics were reset via the Node Info/Reset Info tag
Node Info/Message SchemaThe schema associated with the Edge Node (e.g. Sparkplug B)
Node Info/Offline DateTimeThe time at which the last NDEATH message was received by MQTT Engine
Node Info/OnlineWhether or not the Edge Node is online. This is determined by whether the last lifecycle message was an NBIRTH or NDEATH
Node Info/Online DateTimeThe time at which the last NBIRTH message was received by MQTT Engine
Node Info/Reset InfoWritable tag to 'reset' the Node Info metrics
Node Info/seqThe last Sparkplug seq number received from the Edge Node
Node Info/Total Bytes RecvdThe number of bytes received from the Edge Node since the last time the info metrics were reset via the Node Info/Reset Info tag
Node Info/Total Bytes Xmit

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

Device Info Tags

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


NameDescription
Device Info/Birth CountThe number of DBIRTH messages since the last time the info metrics were reset via the Device Info/Reset Info tag
Device Info/Data Message CountThe number of DDATA messages since the last time the info metrics were reset via the Device Info/Reset Info tag
Device Info/Death CountThe number of DDEATH messages since the last time the info metrics were reset via the Device Info/Reset Info tag
Device Info/Last Command SizeThe size in bytes of the last DCMD that was sent from MQTT Engine
Device Info/Last Data Message SizeThe size in bytes of the last DDATA that was received from the Device
Device Info/Offline DateTimeThe time at which the last DDEATH message was received by MQTT Engine
Device Info/OnlineWhether or not the Device is online. This is determined by whether the last lifecycle message was an DBIRTH or NBIRTH
Device Info/Online DateTime

The time at which the last DBIRTH message was received by MQTT Engine

Device Info/Reset Info

Writable tag to 'reset' the Device Info metrics



  • No labels