Skip to content
Stand with Ukraine flag

Monitor message statistics

The message statistics dashboard lets you monitor the state of uplink (Edge → server) and downlink (server → Edge) message flows in real time. Use it to identify message backlogs, delivery failures, and queue lag before they affect data visibility on the server.

  1. Download the preconfigured dashboard file: uplink_downlink_edge_stats.json

  2. Log in to your ThingsBoard server and go to Dashboards.

  3. Click Add (+) and select Import dashboard. Browse for the downloaded .json file and click Import.

ThingsBoard Edge exposes the following telemetry keys on the Edge entity. These keys power the dashboard widgets and can also be queried directly or used in rule chains.

KeyDescription
uplinkMsgsAddedMessages added to the uplink queue
uplinkMsgsPushedMessages successfully delivered to the server
uplinkMsgsPermanentlyFailedMessages that failed and will not be retried
uplinkMsgsTmpFailedMessages that failed temporarily (e.g., network issue) and will be retried
uplinkMsgsLagMessages remaining in the queue — a sustained non-zero value indicates a backlog
KeyDescription
downlinkMsgsAddedMessages added to the downlink queue
downlinkMsgsPushedMessages successfully delivered to Edge
downlinkMsgsPermanentlyFailedMessages that failed and will not be retried
downlinkMsgsTmpFailedMessages that failed temporarily and will be retried
downlinkMsgsLagMessages remaining in the queue — a sustained non-zero value indicates a backlog

A rising *MsgsLag value means messages are accumulating faster than they are delivered. Check network connectivity and Edge resource usage if this occurs.