Browse documentation
Running on-demand scans
↩ Devices
Some device data is expensive to collect or only useful as a point-in-time snapshot — a switch's MAC table, a router's routing table, an access point's connected clients. JOATOS collects these on demand, when you ask, rather than on every poll. This article covers the on-demand actions and how to trigger them.
Full rescan — "Scan now"
The Scan now button in the device detail page header runs a complete poll immediately: identity, ports, interface stats, VLANs, PoE, firmware version, and logs. Use it after making a change on the device, or to confirm current state without waiting for the next scheduled poll.
Scan now appears when the device has a scanning profile and a reachable address.
On-demand data by device type
Each of these has a Refresh button next to its table, showing when it was last updated:
| Action | Device types | What you get |
|---|---|---|
| LLDP neighbours | Switch, Router, Firewall | Connected devices — remote name, remote port, local port |
| MAC address table | Switch | Learned MAC addresses with VLAN and port |
| Routing table | Router, Firewall | Destinations, next hops, interface, metric, protocol |
| ARP table | Router | IP-to-MAC mappings per interface |
| Interface error counters | Router | RX/TX errors and discards for an interface |
| Wireless clients | Access Point | Connected clients — signal, band, SSID, rates |
| Radio stats | Access Point | Channel, width, TX power, noise, utilisation |
| UPS alarms | UPS | Active alarms with severity |
Wireless clients and radio stats require a vendor API credential assigned to the access point.
Stored vs. live
- Some results are stored with a last updated time and shown until you refresh again (LLDP neighbours, MAC table, wireless clients, UPS alarms).
- Others are fetched live each time and not saved (routing table, ARP table, interface error counters) — so they always reflect the device right now.
Notes & tips
- On-demand actions run through the site's Site Collector, so the collector must be online and the credential valid.
- Because these aren't polled continuously, the data reflects the moment you last refreshed — check the timestamp next to each table.