Gateway general chart statistics

Who it’s for

Engineers running a ThingsBoard IoT Gateway who need to know whether the gateway itself is healthy — not what the devices behind it are reporting, but how much data it is moving and how hard the host is working. The question comes up when data goes missing and the cause could be the devices, the gateway or the machine it runs on.

What it does

The Gateway general chart statistics widget plots the gateway’s own service metrics over time. Pointed at a gateway device, it charts bytes sent to the platform, bytes received from it, or host measures such as CPU, RAM and disk usage, so a rising transfer volume and a saturating host are visible on the same time axis.

• Gateway health as a time series, which is what distinguishes a gateway that stopped from a gateway that slowed down.
• Transfer and host metrics are the same shape of data, so throughput can be read against the resource that limits it.
• Several metrics share the chart with a legend, and stacking is available where the parts should add to a total.
• The chart follows the dashboard’s time window, so the same widget serves a live check and an after-the-fact investigation.
• The Gateway general chart statistics widget reads statistics the gateway publishes: it shows no connector detail and no logs, which have their own widgets.

How to set up

Data keys

The Gateway general chart statistics widget takes one series per data key from the gateway device.

Key	Role	Type	Description
Gateway statistic keys	One plotted series	Timeseries	The statistics the gateway publishes as telemetry — bytes sent and received, CPU, RAM and disk among them. Point the datasource at the gateway device and pick the keys it actually reports.

Statistics reporting has to be enabled on the gateway for anything to plot. Confirm the keys exist on the gateway device’s telemetry before configuring the chart, since an unreported key renders as an empty series rather than as an error.

How to customize

• To read a total and its parts together — turn on stacking for series that add up, such as several traffic components.
• To fix the scale — set the Y axis minimum and maximum instead of letting the chart rescale, which keeps a quiet period from looking as busy as a loaded one.
• To label the axis — set its title and the tick label formatting to the unit the metric is actually in.
• To move or drop the legend — set the legend position, or turn it off on a single-metric chart.
• To show every series at one moment — switch the tooltip to report all series rather than the hovered one.

Tips

• Chart a transfer metric and a host metric together rather than on separate widgets. Throughput that flattens exactly as CPU saturates is a diagnosis; either curve alone is only an observation.
• Keep a long window available on this chart even if the dashboard defaults to a short one. Gateway problems are usually noticed hours after they start, and the useful comparison is against the same time yesterday.