47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# Speedtest to InfluxDB
|
|
|
|
This is a small Python script that will continuously run the Speedtest CLI application by Ookla, reformat the data output and forward it on to an InfluxDB database.
|
|
|
|
You may want to do this so that you can track your internet connections consistency over time. Using Grafana you can view and explore this data easily.
|
|
|
|
|
|
|
|
## Using the script
|
|
|
|
The InfluxDB connection settings are controlled by environment variables.
|
|
|
|
The variables available are:
|
|
- INFLUX_DB_ADDRESS = 192.168.1.xxx
|
|
- INFLUX_DB_PORT = 8086
|
|
- INFLUX_DB_USER = user
|
|
- INFLUX_DB_PASSWORD = pass
|
|
- INFLUX_DB_DATABASE = speedtest
|
|
- SPEEDTEST_INTERVAL = 1800
|
|
- SPEEDTEST_FAIL_INTERVAL = 300
|
|
|
|
Be aware that this script will automatically accept the license and GDPR statement so that it can run non-interactively. Make sure you agree with them before running.
|
|
|
|
### 1. No Container
|
|
|
|
1. [Install the Speedtest CLI application by Ookla.](https://www.speedtest.net/apps/cli)
|
|
|
|
NOTE: The `speedtest-cli` package in distro repositories is an unofficial client. It will need to be uninstalled before installing the Ookla Speedtest CLI application with the directions on their website.
|
|
|
|
2. Install the InfluxDB client for library from Python.
|
|
|
|
`pip install influxdb`
|
|
|
|
3. Run the script.
|
|
|
|
`python3 ./main.py`
|
|
|
|
### 2. Run with Docker or Podman
|
|
|
|
1. Build the container.
|
|
|
|
`docker build -t aidengilmartin/speedtest-influx ./`
|
|
|
|
2. Run the container.
|
|
|
|
`docker run -d --name speedtest-influx aidengilmartin/speedtest-influx`
|
|
|