Watch a gateway's live logs from the web app
When a gateway is misbehaving — not connecting, not reading a sensor, or dropping offline — its live logs show you what it's doing moment to moment. You can now stream them straight from the web app, without plugging the gateway into your computer.
This talks to the gateway through the platform over its existing secure connection, so it works from anywhere as long as the gateway is online.
Open the live logs
- Go to Gateways and open the gateway you want to inspect.
- Click Live Logs in the actions row. A console panel opens below.
- Tick the categories you want to see (see below).
- Click Start. Log lines begin streaming in as the gateway produces them.
- Click Stop when you're done, or Clear to empty the console.
The stream auto-stops after 5 minutes (and whenever you close the panel or leave the page) to avoid leaving it running in the background.
Choose what to stream
Every line the gateway streams belongs to a category, shown in brackets at the start of the line — for example [modbus] read fail id=1 hr2.
| Category | What you see |
|---|---|
| System | The tail starting and stopping, boot, configuration applied. Always on. |
| Network | Wi-Fi, Ethernet and cloud connection: connect, disconnect, reconnect, IP address. |
| Commands | Commands the gateway receives from the platform, writes and their outcome. |
| Modbus | Modbus RTU/TCP setup and probes, each poll's read results, read failures and retries. |
| Sensors | I2C, SPI, 1-Wire, GPIO, UART and other sensor start-up and read errors. |
| Macros | Macro start, each step, abort and errors. |
- You can pick up to 3 categories at a time. System is always included and doesn't count towards the 3.
- You can change the ticked categories while the stream is running — the gateway switches over straight away, no restart needed.
- Some categories need a paid plan. Categories your plan doesn't include are shown greyed out with an upgrade hint. Your plan's categories apply to everyone streaming from your gateways, including team members.
- Start with the category closest to the problem — Modbus for a meter that isn't reading, Network for a gateway that keeps dropping offline.
"… N lines dropped"
To keep the stream from swamping the gateway's connection, it sends at most about 20 lines a second. Very chatty categories (Modbus polling many registers quickly, for example) can go over that. When they do, the extra lines are skipped and the console shows a System line such as … 37 lines dropped (rate limit). If you see this often, untick the categories you don't need so the ones you do fit in.
What is never streamed
Live logs only carry the curated categories above. Raw serial output is never streamed, and nothing containing credentials — the MQTT password, Wi-Fi password, access keys or tokens — is ever sent, in any category.
Requirements
- The gateway must be online — an offline gateway can't be reached. Bring it back onto Wi‑Fi first. The Start button is disabled while the gateway is offline.
- The gateway needs firmware 1.3.0 or newer for live logs, and firmware 1.5.2 or newer for categories. Older firmware ignores the category choice and streams only a few basic lines (tail start/stop and commands received), without a category tag. Update the gateway's firmware to get the full stream.
Live logs are read-only — they never change what the gateway monitors or how it's configured. To change devices, use the device pages; to reboot or wipe settings, use Restart / Reset configuration on the gateway page.
Prefer your phone? You can also pull a full diagnostics snapshot and tail logs from the mobile app — see Debug a gateway remotely from the mobile app. For a wired connection over USB, see Open a gateway's serial console.