Gateway status

Who it’s for

Anyone with a ThingsBoard IoT Gateway in service who needs one clear answer at the top of a dashboard: is this gateway connected right now? Everything else on a gateway page is meaningless if the answer is no, so it belongs where it is read first.

What it does

The Gateway status widget indicates whether a gateway is currently connected to the platform. Pointed at a gateway device, it renders that device’s connection state as a status panel, which is the single fact that decides whether anything else on the dashboard can be trusted.

• One unambiguous answer, rather than a state inferred from whether telemetry looks recent.
• The status follows the gateway device the widget is pointed at, so a per-site dashboard reports its own gateway.
• A wide, shallow footprint suited to sitting across the top of a gateway dashboard.
• The state updates as the gateway’s connection changes, so a disconnection is visible without a reload.
• The Gateway status widget reports connectivity: a connected gateway with a broken connector still shows as connected, and that distinction is what the connector and statistics widgets are for.

How to set up

Data keys

The Gateway status widget takes its state from the gateway device it is pointed at rather than from a configured key list.

Key	Role	Type	Description
Gateway connection state	The indicator’s state	Attribute	Point the datasource at the gateway device; the widget reads that device’s connection status.

Point the datasource at the gateway device itself, not at a device behind it. A connected device behind a gateway says nothing about the gateway’s own link to the platform.

How to customize

• To report a different gateway — point the datasource at that gateway device.
• To place it as a header — keep the wide, shallow default proportions and put the widget at the top of the dashboard.

Tips

• Put this widget above everything else on a gateway dashboard. Every chart and table below it is read as current, and a disconnected gateway makes all of them a picture of the past — which nobody notices unless the status is the first thing on the page.
• Pair it with the gateway’s statistics charts rather than treating it as the whole health check. Connectivity is binary and a gateway can be connected while forwarding nothing, which shows up in the throughput long before the connection drops.