Skip to content
© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

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.

Key Description
uplinkMsgsAdded Messages added to the uplink queue
uplinkMsgsPushed Messages successfully delivered to the server
uplinkMsgsPermanentlyFailed Messages that failed and will not be retried
uplinkMsgsTmpFailed Messages that failed temporarily (e.g., network issue) and will be retried
uplinkMsgsLag Messages remaining in the queue — a sustained non-zero value indicates a backlog
Key Description
downlinkMsgsAdded Messages added to the downlink queue
downlinkMsgsPushed Messages successfully delivered to Edge
downlinkMsgsPermanentlyFailed Messages that failed and will not be retried
downlinkMsgsTmpFailed Messages that failed temporarily and will be retried
downlinkMsgsLag Messages 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.