Skip to content

Search guides, devices and posts

Back to Meshtastic

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.