2021-11-13 19:36:28 +01:00
|
|
|
# livebox-exporter
|
|
|
|
|
|
|
|
|
|
A prometheus exporter for Livebox. This exporter was tested with a Livebox 5 and
|
|
|
|
|
FTTH subscription.
|
|
|
|
|
|
|
|
|
|
## Metrics
|
|
|
|
|
|
|
|
|
|
This exporter currently exposes the following metrics:
|
|
|
|
|
|
2023-05-23 20:55:05 +02:00
|
|
|
| Name | Type | Description | Labels | Experimental |
|
|
|
|
|
| --------------------------------------- | ----- | ------------------------------------------------- | --------- | ------------ |
|
|
|
|
|
| livebox_interface_rx_mbits | gauge | Received Mbits per second | interface | No |
|
|
|
|
|
| livebox_interface_tx_mbits | gauge | Transmitted Mbits per second | interface | No |
|
|
|
|
|
| livebox_devices_total | gauge | The total number of active devices | type | No |
|
|
|
|
|
| livebox_deviceinfo_reboots_total | gauge | Number of Livebox reboots | | No |
|
|
|
|
|
| livebox_deviceinfo_uptime_seconds_total | gauge | Livebox current uptime | | No |
|
|
|
|
|
| livebox_deviceinfo_memory_total_bytes | gauge | Livebox system total memory | | No |
|
|
|
|
|
| livebox_deviceinfo_memory_usage_bytes | gauge | Livebox system used memory | | No |
|
|
|
|
|
| livebox_interface_homelan_rx_mbits | gauge | Received Mbits per second | interface | Yes |
|
|
|
|
|
| livebox_interface_homelan_tx_mbits | gauge | Transmitted Mbits per second | interface | Yes |
|
|
|
|
|
| livebox_interface_netdev_rx_mbits | gauge | Received Mbits per second | interface | Yes |
|
|
|
|
|
| livebox_interface_netdev_tx_mbits | gauge | Transmitted Mbits per second | interface | Yes |
|
|
|
|
|
| livebox_wan_rx_mbits | gauge | Received Mbits per second on the WAN interface | | Yes |
|
|
|
|
|
| livebox_wan_tx_mbits | gauge | Transmitted Mbits per second on the WAN interface | | Yes |
|
2023-04-21 18:58:34 +02:00
|
|
|
|
|
|
|
|
Experimental metrics are not enabled by default, use the `-experimental`
|
|
|
|
|
command-line option to enable them.
|
2021-11-13 19:36:28 +01:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
### Options
|
|
|
|
|
|
|
|
|
|
The exporter accepts the following command-line options:
|
|
|
|
|
|
2023-04-21 18:58:34 +02:00
|
|
|
| Name | Description | Default value |
|
|
|
|
|
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------- |
|
|
|
|
|
| -polling-frequency | Polling frequency | 30 |
|
|
|
|
|
| -listen | Listening address | :8080 |
|
|
|
|
|
| -experimental | Comma separated list of experimental metrics to enable (available metrics: livebox_interface_homelan,livebox_interface_netdev,livebox_wan) | |
|
2021-11-13 19:36:28 +01:00
|
|
|
|
|
|
|
|
The exporter reads the following environment variables:
|
|
|
|
|
|
2023-06-03 11:30:01 +02:00
|
|
|
| Name | Description | Default value |
|
|
|
|
|
| --------------- | --------------------------------------------------------------------------------------------------------- | -------------------- |
|
|
|
|
|
| ADMIN_PASSWORD | Password of the Livebox "admin" user. The exporter will exit if this environment variable is not defined. | |
|
|
|
|
|
| LIVEBOX_ADDRESS | Address of the Livebox. | `http://192.168.1.1` |
|
|
|
|
|
| LIVEBOX_CACERT | Optional path to a PEM-encoded CA certificate file on the local disk. | |
|
2021-11-13 19:36:28 +01:00
|
|
|
|
|
|
|
|
### Docker
|
|
|
|
|
|
|
|
|
|
Use the following commands to run the exporter in Docker:
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
docker build -t livebox-exporter .
|
|
|
|
|
docker run -p 8080:8080 -e ADMIN_PASSWORD=<changeme> livebox-exporter
|
|
|
|
|
```
|
