meshtastic-prometheus-exporter 2.1

No project description provided

meshtastic-prometheus-exporter

Meshtastic Prometheus Exporter captures and parses every MeshPacket from your Meshtastic network, exposing detailed metrics about the packets. It supports data collection via MQTT, BLE, Serial, or TCP, and makes these metrics available to Prometheus. It comes with grafana dashboards that help visualize network performance, node status, and telemetry for real-time or historical monitoring.

Supported metrics

See SUPPORTED_METRICS.md for a list of supported metrics

Usage

Use with MQTT

1. Find an MQTT server you want to use or use the public Meshtastic MQTT server (mqtt.meshtastic.org).
2. For your Meshtastic node, configure and enable MQTT module for uplink.
3. Clone the repo, or download (preferably) latest release, uncompress it and navigate to the directory with the docker-compose.yml file.
4. Edit the docker-compose.yml file and specify connection details to the MQTT server there too.
5. In your terminal, run docker-compose up (for this, you need Docker installed).

Use with BLE

1. Ensure your Meshtastic device supports Bluetooth Low Energy (BLE) and is powered on.
2. Clone the repo, or download (preferably) latest release, uncompress it and navigate to the directory with the docker-compose.yml file.
3. Edit the docker-compose.yml file and set MESHTASTIC_INTERFACE to BLE and specify the BLE address of your device by setting INTERFACE_BLE_ADDR to the address of your device, for example AA:BB:CC:EE:AA:BB
4. In your terminal, run docker-compose up (for this, you need Docker installed).

Use with Serial

1. Connect your Meshtastic device to your computer via a serial interface (e.g., USB).
2. Clone the repo, or download (preferably) latest release, uncompress it and navigate to the directory with the docker-compose.yml file.
3. Edit the docker-compose.yml file and set MESHTASTIC_INTERFACE to SERIAL and optionally specify the serial device path.
4. In your terminal, run docker-compose up (for this, you need Docker installed).

Use with TCP

1. Ensure your Meshtastic device is accessible over a TCP interface.
2. Clone the repo, or download (preferably) latest release, uncompress it and navigate to the directory with the docker-compose.yml file.
3. Edit the docker-compose.yml file and set MESHTASTIC_INTERFACE to TCP and specify the TCP address and port of your device.
4. In your terminal, run docker-compose up (for this, you need Docker installed).

Accessing Grafana

In your web browser, navigate to http://localhost:3000/dashboards and authenticate using default Grafana credentials (username admin, password admin).

Installation using pipx

If you prefer to install the exporter using pipx, you can do so by running the following command:

pipx install meshtastic-prometheus-exporter

You could then run it outside docker, and configure Prometheus to scrape it:

global:
  scrape_interval: 15s
  evaluation_interval: 15s
scrape_configs:
  - job_name: "meshtastic"
    static_configs:
      - targets: ["host.docker.internal:9464"]

Installation using helm

Coming soon.

Known limitations

• Running two exporters for the same meshtastic network that write to the same Prometheus is not supported
• While mostly reporting useful information, Grafana dashboards do contain mistakes in some of the visualizations
• Using TLS for MQTT on meshtastic side may be problematic for performance and reliability (third-party issue)
• Exception handling & code quality need improvement

Contributing

Please feel free to contribute