roseatoni/foptimum repository overview

⁠Foptimum

Foptimum is a lightweight, dockerized app to monitor your internet speed and uptime so you can keep your ISP accountable.

Foptimum exports its data to Prometheus⁠ so it can easily be visualized with a tool like Grafana⁠.

⁠Deployment

⁠Docker

The Docker image is available on Docker Hub⁠. Pull the container using the following command:

docker pull roseatoni/foptimum

All variables are passed to the program as environment variables. These variables are:

The speedtest and/or the pings can be disabled by setting their respective intervals to 0.

** I reccomend setting the Speedtest interval to 30 minutes at minimum. In testing, I ran into issues with the speedtest failing when set to an interval lower than 30 minutes. This was probably due to some sort of rate limiting with the service.

The Prometheus server is exposed in the container on port 9191. When deploying this container, map port 9191 to your desired host port.

Putting it all together, here is an example Docker run command:

docker run -d -p 9191:9191 -e SPEEDTEST_INTERVAL=900 -e PING_INTERVAL=15 -e SERVER_LIST=1.1.1.1,8.8.8.8 roseatoni/foptimum:latest

⁠unRAID

This application has also been added to the unRAID community apps store.

⁠Grafana

A very basic Grafana dashboard has been added to this repository to get you started with visualizing the data. Download Grafana_Dashboard.json and import it into your Grafana instance.

⁠Logs

If you do not have a means of visualizing the Prometheus data, you can also manually look at the logs to identify internet outages.

Logs are written to a file called app.log. So, you can read the logs by running a command such as:

docker exec dc5a365ad9a572863a3cdeb3f2a3c3c82034fe669c74e75df1730469286e335e tail -n 100 app.log

One thing that the logs can provide that Grafana can not is the IP address of failed pings. This allows you to determine if your internet is really down, or it is just one of the servers you chose to ping.