A web connected local internet speed and connectivity monitor
Project description
pi_internet_webthing
A web connected local internet speed and connectivity monitor
This project provides a webthing API to a internet monitor agent.
The pi_internet_webthing package exposes an http webthing endpoint which supports reading the internet speed results as well as the internet connectivity results via http E.g.
# webthing has been started on host 192.168.0.23
# internet speed
curl http://192.168.0.23:8433/0/properties
{
"test_period": 900,
"downloadspeed": 215.2,
"uploadspeed": 11,
"ping": 17.763,
"testdate": "2020-10-11T13:44:51.346706",
"speedtest_server": "Mobile Breitbandnetze GmbH/Freisbach",
"speedtest_report_uri": "http://www.speedtest.net/result/10231336474.png"
}
# connectivity
curl http://192.168.0.23:8433/1/properties
{
"test_url": "http://google.com",
"test_period": 5,
"connected": true,
"ip_address": "95.88.57.72"
}
To install this software you may use PIP package manager such as shown below
sudo pip install pi_internet_webthing
After this installation you may start the webthing http endpoint inside your python code or via command line using
sudo netmonitor --command listen --hostname 192.168.0.23 --port 8433 --speedtest_period 900 --connecttest_period 5
Here, the webthing API will be bind to the hostname 192.168.0.23 with local port 8433. The internet speed montior as well as the connectivity monitor will be started. The speed test will be executed each 15 min (900 sec), the connectivity test will be executed each 5 sec.
Alternatively to the listen command, you can use the register command to register and start the webthing service as systemd unit. By doing this the webthing service will be started automatically on boot. Starting the server manually using the listen command is no longer necessary.
sudo netmonitor --command register --hostname 192.168.0.23 --port 8433 --speedtest_period 900 --connecttest_period 5
To start the speedtest monitor only just omit the --connecttest_period parameter
sudo netmonitor --command listen --port 8433 --speedtest_period 900
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 pi_internet_webthing-0.0.12.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f7fcabe5b65c641eaa69158557baec001203d0c6dd5196c717234f1d334524f |
|
MD5 | c4efbc364c81a30798af9f03179574e6 |
|
BLAKE2b-256 | 7f2eab40de5187746fb00ae0454b38d21f219e30105169eb162510b7c3e3cb99 |
Hashes for pi_internet_webthing-0.0.12-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c968e0592c865b0109e2c3191b6c2f5577e60403c844479965945b5a46dc18d8 |
|
MD5 | fbf1fe88c754814e955927d20c31308d |
|
BLAKE2b-256 | 628ba397155309459741c673e768bd9ce72f405d9b21c3db479750747fac81c3 |