Skip to main content

A web connected local internet speed and connectivity monitor

Project description

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 install this software you may use PIP package manager such as shown below

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 --hostname 192.168.0.23 --port 8433 --speedtest_period 900 --connecttest_period 5 

Here, the webthing API will be bind to hostname 192.168.0.23 running 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 5 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 --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 --hostname 192.168.0.23 --port 8433 --speedtest_period 900

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

internet_monitor_webthing-0.0.35.tar.gz (9.1 kB view hashes)

Uploaded Source

Built Distribution

internet_monitor_webthing-0.0.35-py3-none-any.whl (14.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page