Prometheus exporter for Compal CH7465LG cable modems, commonly sold as "Connect Box"
Project description
Connectbox Prometheus
A Prometheus exporter for monitoring Compal CH7465LG cable modems. These are sold under the name "Connect Box" by Unitymedia in Germany, Ziggo in the Netherlands and UPC in Switzerland/Austria. Or as "Virgin Media Super Hub 3" by Virgin Media.
Makes thorough use of compal_CH7465LG_py by @ties (thanks!).
Installation
On your Prometheus server host:
- Create a virtual environment using python3.7 or higher
- Install the exporter via
pip install connectbox-prometheus
Usage
This exporter queries exactly one Connect Box as a remote target.
To get started, modify config.yml
from this repository or start out with the following content:
# Connect Box IP address
ip_address: 192.168.0.1
# Connect Box web interface password
password: WhatEverYourPasswordIs
Then run connectbox_exporter path/to/your/config.yml
Prometheus Configuration
Add the following to your prometheus.yml
:
scrape_configs:
- job_name: 'connectbox'
static_configs:
- targets:
- localhost:9705
One scrape takes roughly 6 seconds.
Exported Metrics
Metric name | Description |
---|---|
connectbox_device_info |
Assorted device information |
connectbox_uptime_seconds_total |
Device uptime in seconds |
connectbox_tuner_temperature_celsius |
Tuner temperature |
connectbox_temperature_celsius |
Temperature |
connectbox_lan_user_speed_mbit |
LAN user network speed |
connectbox_downstream_frequency_hz |
Downstream channel frequency |
connectbox_downstream_power_level_dbmv |
Downstream channel power level |
connectbox_downstream_snr_db |
Downstream channel signal-to-noise ratio (SNR) |
connectbox_downstream_rxmer_db |
Downstream channel receive modulation error ratio (RxMER) |
connectbox_downstream_codewords_unerrored_total |
Unerrored downstream codewords |
connectbox_downstream_codewords_corrected_total |
Corrected downstream codewords |
connectbox_downstream_codewords_uncorrectable_total |
Uncorrectable downstream codewords |
connectbox_upstream_frequency_hz |
Upstream channel frequency |
connectbox_upstream_power_level_dbmv |
Upstream channel power level |
connectbox_upstream_symbol_rate_ksps |
Upstream channel symbol rate |
connectbox_upstream_timeouts_total |
Upstream channel timeout occurrences |
connectbox_scrape_duration_seconds |
Connect Box exporter scrape duration |
connectbox_scrape_success |
Connect Box exporter scrape success |
Grafana Dashboard
The above metrics can be monitored nicely in Grafana using this dashboard:
Contributing / Development
Pull requests are welcome. 😊 In particular, metrics on connected Wifi devices are unchartered territory since I'm not using the Wifi functionality of my device.
To install development dependencies, run:
pip install -r requirements/development.txt
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for connectbox-prometheus-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c58d3c919ec38d27b82a0c5a14b7d4b1f1fa2788f3fa961a9bde857ab776e06d |
|
MD5 | 3480e6a49adb7987f7c9e8313b0ea478 |
|
BLAKE2b-256 | 7126aac867bc8515080b0f9ceffb16c4d8701ae9dea1206b0d2063a167df8e40 |
Hashes for connectbox_prometheus-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b4e60595a8a57ab012b1cadb900d1a172df0e24db90ba8938f02805ad219064 |
|
MD5 | b357f46430c7511925e4dbabf6092578 |
|
BLAKE2b-256 | b64f4dd0587a025f2538cbe06acb1cbe5236d274ffe0f4ffb5706a60addd4533 |