internet_monitor_webthing
A web connected local internet speed and connectivity monitor
This project implements an internet monitor agent providing a speed monitor webthing API as well as a connectivity monitor webthing API.
The internet_monitor_webthing package exposes an http webthing endpoint which supports reading the internet speed results as well as an endpoint to read 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 run this software you may use Docker or PIP package manager such as shown below
Docker approach
sudo docker run -p 8433:8433 grro/internet-monitor
PIP approach
sudo pip install internet_monitor_webthing
After this installation you may start the webthing http endpoint inside your python code or via command line using
sudo netmonitor --command listen --port 8433 --speedtest_period 900 --connecttest_period 10
Here, the webthing API will be bind to on port 8433. The internet speed monitor as well as the connectivity monitor will be started by performing the listen command above. The speed test will be executed each 15 min (900 sec), the connectivity test will be executed each 10 sec. THe WebThing server provides mDNS to enable clients discovering the WebThing interfaces.
By running a systemd-based Linux distribution you may 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 --port 8433 --speedtest_period 900 --connecttest_period 10
To start the speedtest monitor only just omit the --connecttest_period parameter
sudo netmonitor --command listen --port 8433 --speedtest_period 900
1 maintainer
Release files for internet-monitor-webthing 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| internet_monitor_webthing-1.0.1.tar.gz | 10.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| internet_monitor_webthing-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.9 kB
Release files / internet_monitor_webthing-1.0.1.tar.gz
| Download URL | internet_monitor_webthing-1.0.1.tar.gz |
|---|---|
| Size | 10.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75c870e8cb4162882fe49f5d9860d7a6e3257dd6d58d218f26be826784cb97ff
|
|
BLAKE2b-256 checksum How to use checksums |
2ee46ac9154f73a729117d75b636ed3080e4e4748cfae0f868ba5c8ff4eb5cbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.9.12
|
Release files / internet_monitor_webthing-1.0.1-py3-none-any.whl
| Download URL | internet_monitor_webthing-1.0.1-py3-none-any.whl |
|---|---|
| Size | 16.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
98553cf059247a754be30529091de3c0036778b5d5462e0059bc7a5b406e4db9
|
|
BLAKE2b-256 checksum How to use checksums |
dc6853ef05300f97d507909735e022ceaa5c816c1e778e8c67d4121ed5c36b6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.9.12
|
