Simple network latency and speed collection service with a web UI for displaying collected data.

Based on ping and provides:

• loss - percentage of lost packets
• average - average latency to target host (in milliseconds)
• minimum - minimum latency to target host (in milliseconds)
• maximum - maximum latency to target host (in milliseconds)

Based on speedtest.net and provides:

• download - download speed (in bits per second)
• upload - upload speed (in bits per second)
• server - server used for performing the test

By default, the web UI can be accessed at http://localhost:8000.

By default, the Prometheus metrics endpoint can be accessed at http://localhost:9000.

docker pull sndnv/instability

docker run \
    -e LATENCY_TARGETS='192.168.1.1,8.8.8.8,google.com' \
    -e SERVICE_HOST='0.0.0.0' \
    -e PROMETHEUS_HOST='0.0.0.0' \
    -e SERVICE_PORT='5000' \
    -e LATENCY_COLLECTION_INTERVAL='30' \
    -p 9000:5000 \
    sndnv/instability

Starts the service with hosts for latency queries 192.168.1.1, 8.8.8.8 and google.com; with latency collection interval of 30 seconds, default speed connection interval (1 hour) and binds the web UI to port 5000 (inside the container) and port 9000 (on the host).

cd ./example && docker-compose up

Uses the example docker-compose.yml file to start prometheus (http://localhost:9090), grafana (http://localhost:3000) and instability (http://localhost:8000).

We use SemVer for versioning.

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details

Copyright 2018 https://github.com/sndnv

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.