sebclem/huawei_lte_exporter
Archived
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases 4 Wiki Activity
Prometheus exporter for Huawei LTE routers
This repository has been archived on 2024-10-15. You can view files and clone it, but cannot push or open issues or pull requests.
28 Commits 2 Branches 4 Tags 161 KiB
Python 95.3%
Dockerfile 4.7%
1b9c4ac14b
Go to file
sebclem 1b9c4ac14b
All checks were successful
ci / docker (push) Successful in 17s
Details
Add ROUTER_ADDRESS
2024-03-26 15:04:57 +01:00
.gitea/workflows Update .gitea/workflows/docker.yml 2024-03-26 14:38:49 +01:00
examples Updated dashboard for 3G signal information 2020-04-10 11:43:17 +01:00
.gitignore Initial commit 2020-04-06 21:27:29 +01:00
Dockerfile Initial commit 2020-04-06 21:27:29 +01:00
huwawei_lte_exporter Fixing typo 2021-06-12 21:34:47 +01:00
README.md Fixing typo 2020-04-10 12:05:06 +01:00
requirements.txt Initial commit 2020-04-06 21:27:29 +01:00
ROUTER_ADDRESS Add ROUTER_ADDRESS 2024-03-26 15:04:57 +01:00

README.md

huawei_lte_exporter

A promethus exporter for the Huawei series of 4G LTE routers, exporting various LTE signal strength measures e.g. rssi, sinr etc ... It should be compatible with a range of Huawei routers including B310, B315, B525 and B535. A full range is listed at huawei-lte-api.

Example

Grafana Dashboard Screenshot

Data Availability

Different connection types expose different signal data:

  • 3G connections expose rssi, rscp and ec/io
  • 4G connections expose rssi, rscp, rsrq and sinr

A handy way to validate the available information is to login to your router and then visit device api and view source.

Install

Follow the usual docker build and run flow.

Required environment variables:

  • ROUTER_ADDRESS - IP address of the Huawei router on your network (typically '192.168.8.1')
  • ROUTER_USER - Username to login to the router (typically 'admin')
  • ROUTER_PASS - Password to login to the router (typically 'admin')
  • PROM_PORT - Port to start the exporter on in the container
docker build -t huawei_lte_exporter .

export ROUTER_ADDRESS=192.168.8.1
export ROUTER_USER=admin
export ROUTER_PASS=admin
export PROM_PORT=8080

docker run -d -it -p $PROM_PORT:$PROM_PORT -e ROUTER_ADDRESS=$ROUTER_ADDRESS -e ROUTER_USER=$ROUTER_USER -e ROUTER_PASS=$ROUTER_PASS -e PROM_PORT=$PROM_PORT --name=hle huawei_lte_exporter
sleep 5
curl http://localhost:$PROM_PORT

#HELP band The signal band the LTE connection is using
#TYPE band gauge
band{deviceName="B535-232",iccid="8944200119514034161"} 20
#HELP rsrp The average power received from a single Reference signal in dBm
#TYPE rsrp gauge
rsrp{deviceName="B535-232",iccid="8944200119514034161"} -75
#HELP rsrq Indicates quality of the received signal in db
#TYPE rsrq gauge
rsrq{deviceName="B535-232",iccid="8944200119514034161"} -9.0
#HELP rssi Represents the entire received power including the wanted power from the serving cell as well as all co-channel power and other sources of noise in dBm
#TYPE rssi gauge
rssi{deviceName="B535-232",iccid="8944200119514034161"} -53
#HELP sinr The signal-to-noise ratio of the given signal in dB
#TYPE sinr gauge
sinr{deviceName="B535-232",iccid="8944200119514034161"} 18

Configure

Prometheus

  - job_name: '4g'
    scrape_interval: 1m
    static_configs:
    - targets:
      - server.home:8080

Grafana

Example dashboard config

Guage values taken from: https://wiki.teltonika-networks.com/view/Mobile_Signal_Strength_Recommendations

Todo