Network Analysis Tools
Understand your mesh performance with built-in tools and third-party monitoring.
Built-in Analysis Features
Range Test Module
A fixed sender node sends numbered test messages at a set interval while you carry the receiver around. Each message the receiver hears is logged with position, SNR, RSSI and distance, so gaps in the numbers show where packets were lost. Both nodes need the module on (Range Test in the app's module settings).
meshtastic --set range_test.enabled true --set range_test.sender 30
Run that on the sender (30 seconds suits LongFast); the receiver only needs range_test.enabled true. It uses a lot of airtime, so turn it off when you're done. It also switches itself off after 8 hours.
Signal Metrics (SNR/RSSI)
Your radio measures SNR (Signal-to-Noise Ratio) and RSSI (Received Signal Strength) on every packet it receives. The app shows them for nodes your radio heard directly. A relayed node shows its hop count instead, because the reading only describes the last hop.
SNR (dB)
Higher = better. Negative is normal on LoRa: LongFast still decodes down to about -17.5 dB, ShortFast to about -7.5 dB.
RSSI (dBm)
Less negative = louder. The Android app colors it green above -115, yellow above -120 and orange above -126.
Trace Route
Send a trace route to a node on a shared channel to see the path the request took through the mesh, up to 8 hops each way. Since 2.5 it records the route back and the SNR of each link. Your node allows one every 30 seconds. Available in the apps and CLI.
meshtastic --traceroute '!nodeId'
Node List & Telemetry
The node list shows every node your radio knows, with the latest data it has heard: battery level, signal quality, distance, last heard time, hop count, and device telemetry (voltage, channel utilization, air time).
meshtastic --nodes
Third-Party Monitoring Tools
Mesh-metrics
A community script that uses the Meshtastic CLI and a USB-connected node to request metrics from a list of nodes, for Prometheus or VictoriaMetrics. It comes with a Grafana dashboard and example alerts.
Stack: Prometheus + Grafana
MeshMap.net
A nearly live map of nodes heard by the public MQTT server, refreshed every minute. Selecting a node shows its telemetry and lines to nodes it was heard through or reported as neighbors.
Platform: Web
MQTT + Node-RED
Feed MQTT uplink data into Node-RED for your own automation, alerts and dashboards. The official guide covers JSON messages and protobuf decoding; 2.8 removed JSON output, so on 2.8 decode the protobufs.
Requires: MQTT-enabled node
Analysis Tips
Testing Your Antenna
Use a NanoVNA to measure SWR and verify your antenna is tuned to 915 MHz (US) before deploying. A badly matched antenna reflects power back to the radio instead of radiating it. See our NanoVNA testing guide.
Interpreting Signal Data
SNR tells you more than RSSI for LoRa, because LoRa can decode signals below the noise floor. An RSSI of -118 dBm with SNR +2 dB is a healthy link. A strong RSSI like -90 dBm with poor SNR points to local interference (a noisy power supply, computer or nearby transmitter), not distance.