This is a plugin that enables internet uplink bandwidth graphing in a LibreNMS dashboard. It uses Ookla servers to perform the speedtest by calling Ookla's Speedtest CLI application. Data is stored in the backend into RRD and is visualized by using a LibreNMS style dashboard. Installation should be pretty straight forward.

Screenshot:

Installation

Plugin Prerequisites

A working LibreNMS installation. :D
Shell access to the LibreNMS server.

Speedtest CLI by Ookla. To install this, use the following link and instructions:

https://www.speedtest.net/apps/cli

Verify you are running Speedtest CLI by Ookla by issuing the following command on your CLI:
speedtest --version
Expected example output:
Speedtest by Ookla 1.0.0.2

NOTE:
There is also the "speedtest-cli" package, which is possibly provided by your distribution's repository. 
This package, however, does not follow the same cli commands as the Ookla's Speedtest CLI package and is 
built with Python. It is known to under perform in some cases.<br/>
This dashboard will not work out of the box with the "speedtest-cli" package. Prefer to install Ookla's package.

Plugin Installation

NOTE: 
These instructions assume you are the root user. If you are not, prepend sudo 
to the shell commands or temporarily become a user with root privileges.

Login to your LibreNMS server CLI.
Go to your home dir:
cd ~/
Clone this repository into your home dir:
git clone https://gitlab.com/jackgreyhat/librenms-speedtest.git
Create the plugin directory into LibreNMS plugin folder:
mkdir /opt/librenms/html/plugins/Speedtest
Copy the LibreNMS speedtest plugin contents into the newly created directory:
cp -r ~/librenms-speedtest/. /opt/librenms/html/plugins/Speedtest
Ensure correct ownership and permissions on the Speedtest plugin directory and files:
chown -R librenms:librenms /opt/librenms/html/plugins/Speedtest
chmod -R --reference=/opt/librenms/html/plugins /opt/librenms/html/plugins/Speedtest
chmod +x /opt/librenms/html/plugins/Speedtest/librenms-speedtest.sh
Create a cron job to run the speedtest periodically. Edit the following file:
vi /etc/cron.d/librenms
and add:
30 * * * * librenms /opt/librenms/html/plugins/Speedtest/librenms-speedtest.sh run && /opt/librenms/html/plugins/Speedtest/librenms-speedtest.sh graph
Switch to the librenms user:
su - librenms
Accept the speedtest EULA and GDPR notice (if applicable) and run an initial speedtest:
speedtest --accept-license --accept-gdpr
Go to the Speedtest plugins directory:
cd /opt/librenms/html/plugins/Speedtest/
Create the RRD files:
./librenms-speedtest.sh create
Test and run the speedtest script:
./librenms-speedtest.sh run
Output the speedtest results into PNG files:
./librenms-speedtest.sh graph
Go to your LibreNMS web interface, and go to "Overview" -> "Plugins" -> "Plugin Admin"
Enable the "Speedtest" plugin.
Find the "Speedtest" plugin under "Overview" -> "Plugins" -> "Speedtest"
Profit.