Grafana exporter for ZTE 5G modems

Getting started

One can just run the provided python script by python3 zte_exporter.py <ip address> <password>

The script accepts following options

--port <port> port whereupon the HTTP service serves the metrics
--username <admin username> username used for MULTI login (username/password login instead of just password)
--device <device type> device type, valid choices are mc7010, dictates the RD key hash and login method (MULTI vs SINGLE)
--reset yes/anything TR069 reset, see below

TR069 reset?

You can safely ignore everything else, and just use the script with --reset to clear out TR069 configuration. Just run python3 <ip> <password> --reset yes and follow the output. If it quietly fails, take a look at the code and check --device options.

Docker?

A docker file is provided to compile this and example compose.yml to use in compose tools. To use with docker run, just create .env with the correct values. A compose.yml file is provided as example. There's no current version image available on docker hub as I'm lazy and use systemd jobbie instead.

Prometheus configuration

A simple scrape config will suffice. Scrape interval will dicatete how often data is fetch. The path to metrics is root /.

  - job_name: 'zte'
    static_configs:
      - targets: ['localhost:port']
        labels:
          instance: '5g'

Dashboard

Is provided with the dashboard.json. It should just work.

Running via systemd

Create a systemd unit file to /etc/systemd/system/zte-exporter.service with following

[Unit]
Description=ZTE exporter service

[Service]
Type=simple
ExecStart=/bin/python3 /opt/zte.py --port 8082 192.168.8.1 1234

[Install]
WantedBy=network-online.target

Tested devices

Devices currently supported / tested are only MC889A and it should just work with passing IP and password, default username is admin.

Thanks

Largely based on https://github.com/Kajkac/ZTE-MC-Home-assistant