Skip to main content
Version: 2.8

Node Metrics

The node detail screen provides comprehensive telemetry and metrics for each node on your mesh.

Device Metrics​

Basic operating information reported by each node:

MetricDescription
Battery LevelCurrent battery percentage
VoltageBattery voltage reading
Channel UtilizationPercentage of airtime consumed
AirtimeTransmission time used by this node
UptimeTime since last reboot

Device metrics are displayed as individual cards with trend sparklines showing battery level, voltage, channel utilization, airtime, and uptime over time.

💡 Tip: Tap any metric card to expand it into a full chart with historical data points. Pinch to zoom the time axis.

Environment Metrics​

Environmental sensor data (requires compatible hardware):

MetricSensor Examples
TemperatureBME280, BME680, SHT31
HumidityBME280, BME680, SHT31
Barometric PressureBME280, BMP280
Gas ResistanceBME680
IAQ (Air Quality)BME680

Environment metrics are charted over time for easy trend analysis — temperature, humidity, and pressure each get their own line chart with the measurement unit displayed on the Y axis.

The BME680 IAQ (Indoor Air Quality) index is a single 0–500+ value derived from gas resistance, shown against a color-coded scale from Excellent to Dangerously Polluted:

IAQ index scale from Excellent to Dangerously Polluted

💡 Tip: Environment metrics require a sensor connected to the remote node. Not all nodes report environmental data. See Telemetry & Sensors for a full list of supported sensors.

Air Quality Metrics​

Air Quality is a dedicated metrics view for nodes equipped with a particulate-matter and/or CO₂ sensor. It is separate from the BME680 IAQ reading listed under Environment Metrics — IAQ is a single gas-resistance-derived index, while the Air Quality view charts the underlying particulate and CO₂ measurements.

MetricUnitDescription
PM1.0µg/m³Particulate matter up to 1.0 micron
PM2.5µg/m³Particulate matter up to 2.5 microns
PM10µg/m³Particulate matter up to 10 microns
AQIEPA indexEPA NowCast AQI computed from your recent PM2.5 history, with a color-coded severity label. Shown next to PM2.5 once enough readings have accumulated.
CO₂ppmCarbon dioxide concentration
CO₂ temperature°C / °FTemperature reported by the CO₂ sensor itself (e.g. SCD4x)
CO₂ humidity%Relative humidity reported by the CO₂ sensor

CO₂ readings are color-coded by severity to make air quality easy to read at a glance:

BandCO₂ Range (ppm)Color
Good< 1000Green
Stuffy< 2000Amber
Poor< 5000Orange
Unsafe< 30000Red
Evacuate≥ 30000Dark red

Air quality readings with color-coded CO₂ severity

An air-quality log/metrics button appears on the node detail screen only when the node has reported air-quality telemetry. From the Air Quality view you can:

  • Select a time frame for the charts.
  • Filter with metric chips — only metrics that have data are shown.
  • Refresh / request the latest air-quality telemetry.
  • Export to CSV for analysis in a spreadsheet.

💡 Tip: Air Quality metrics require a compatible air-quality sensor on the remote node. If a node has no particulate or CO₂ sensor, the air-quality button won't appear. See Telemetry & Sensors for supported hardware.

Signal Metrics​

Radio signal quality information:

MetricDescription
SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission.Signal-to-Noise RatioSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. (higher is better)
RSSIRSSI (Received Signal Strength Indicator). The raw power level of a received signal, where a value closer to zero is stronger. Clients rate signal quality from SNR rather than RSSI.Received Signal Strength Indicator (closer to 0 is better)
Noise FloorLocal background RFRF (Radio Frequency). The radio signal a node transmits and receives over LoRa. noise in dBm (more negative is quieter)
Hop CountNumber of mesh hops for last message

Signal Quality Reference​

Signal quality is rated from SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. relative to the active LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. modem preset's demodulation floor, not from fixed thresholds — a given SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. means different things on different presets (e.g. −15 dB is fine on LongSlow but unusable on ShortFast). RSSIRSSI (Received Signal Strength Indicator). The raw power level of a received signal, where a value closer to zero is stronger. Clients rate signal quality from SNR rather than RSSI. is shown but is not part of the rating. Letting limit be the preset's SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. limit:

QualityCriteria
GoodSNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. above the preset's limit
Fairless than 5.5 dB below the limit
Bad5.5 dB to 7.5 dB below the limit
Nonemore than 7.5 dB below the limit

See Understanding the Signal Meter for the full explanation.

Local Stats from your connected radio are also shown in Signal Quality when available. These logs include noise floor, traffic counters, relay counters, online node counts, and radio uptime. The noise floor chart uses a dashed reference line at -85 dBm to help identify a busy RFRF (Radio Frequency). The radio signal a node transmits and receives over LoRa. environment. Use Request to ask the connected radio for a fresh Local Stats telemetry report, Clear to remove Local Stats logs for that node, and Save to export the visible Local Stats history as CSV.

Power Metrics​

Power management telemetry (requires INA sensor or compatible hardware):

MetricDescription
Bus VoltageSupply voltage
CurrentPower draw in milliamps
PowerCalculated wattage

Traceroute​

Traceroute shows the path a message takesTAK (Team Awareness Kit). A situational awareness ecosystem. Meshtastic bridges to it by converting mesh messages to and from Cursor on Target format. through the mesh:

  1. From the node detail screen, tap Traceroute.
  2. The app sends a traceroute request to the target node.
  3. Results show each hop with SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission./RSSIRSSI (Received Signal Strength Indicator). The raw power level of a received signal, where a value closer to zero is stronger. Clients rate signal quality from SNR rather than RSSI. values.

Reading Traceroute Results​

You → Node A (SNR: 8.5) → Node B (SNR: 5.2) → Target

Each hop represents a relay node that forwarded the message.

Position Log​

Historical position data for nodes that share their location:

  • GPSGPS (Global Positioning System). A satellite positioning system. A node with a GPS module determines its own location and can report that position to the mesh. coordinates
  • Altitude
  • Speed (if moving)
  • Timestamp for each position report

Neighbor Info​

Shows which nodes a given node can directly hear, useful for understanding mesh topology.

Viewing Metrics​

  1. Navigate to Nodes.
  2. Tap the node you want to inspect.
  3. Select the metric category from the detail tabs.

Node detail — local device

The position tab shows location data for nodes that share GPSGPS (Global Positioning System). A satellite positioning system. A node with a GPS module determines its own location and can report that position to the mesh.:

Position inline content

⚠️ Note: Metrics are only available when they have been reported by the remote node. Metrics update at intervals configured on each node's telemetry settings.

  • Nodes — node list, filtering, and sorting
  • Telemetry & Sensors — supported sensors and configuration
  • Signal Meter — how signal quality is calculated from SNRSNR (Signal-to-Noise Ratio). A measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission. and RSSIRSSI (Received Signal Strength Indicator). The raw power level of a received signal, where a value closer to zero is stronger. Clients rate signal quality from SNR rather than RSSI.
  • Discovery — traceroute details and neighbor info
  • Units & Locale — temperature, distance, and speed display formats