77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
# 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](https://pypi.org/project/huawei-lte-api/).
|
|
|
|
## Example
|
|
|
|
|
|
|
|
## 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](http://192.168.8.1/api/device/signal) 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](/examples/grafana.json)
|
|
|
|
Guage values taken from: https://wiki.teltonika-networks.com/view/Mobile_Signal_Strength_Recommendations
|
|
|
|
## Todo
|
|
|