Skip to content

Containerized application to record internet speeds over time and email results periodically as csv.

Notifications You must be signed in to change notification settings

tkonya/connection-log

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Connection Logger

This is a lightweight container which periodically logs internet connection liveness (ping) and speed, and emails the results of these in csv format. The intended use-case is to track whether you are getting the speeds you pay for with your ISP.

This container should run as a daemon, aka running all the time. Memory consumption when idle is ~5MiB. A gmail address is required for sending the email. Can send to any valid email address.

Required environmental variables:

EMAIL_USER - full gmail address, the emailing portion of this is hardcoded to work with gmail

EMAIL_PASS - password to above account

EMAIL_TO - email address to send the email to

Create the secret in your kubernetes namespace like this:

kubectl create secret generic tk-email-creds --from-literal=EMAIL_USER=youremail@gmail.com --from-literal=EMAIL_PASS=password1234

Optional environmental Variables

PING_INTERVAL - time between ping checks - default "30s"

SPEED_INTERVAL - time between speed checks - default "20m"

EMAIL_INTERVAL - time between emailing the report - default "168h" (1 week)

See this link on how to specify duration.

Uses github.com/sparrc/go-ping for pings.

Uses Ookla Speedtest CLI for speed tests.

Uses github.com/jordan-wright/email for email.

Container Image on Docker Hub

About

Containerized application to record internet speeds over time and email results periodically as csv.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published