ekg

rust · mit / apache-2.0

The machine that goes PING! — without the wall of scrolling text.

ekg pings your hosts and redraws a compact panel in place: a line per host with current latency and a sparkline, plus running stats for jitter, loss, and uptime. It runs all day in the corner of a tmux pane. Your scrollback stays usable.

ekg demo: a live ping panel, then an outage being declared against an unreachable host

Install

$ brew install spaceshipmike/tap/ekg

$ cargo install ekg

$ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/spaceshipmike/ekg/releases/latest/download/ekg-installer.sh | sh

Features

—watches multiple hosts in one panel
—declares an outage when replies stop, and keeps a running count of how long you've been down
—runs your commands on outage and recovery (--on-outage / --on-recovery)
—writes every sample and outage event to a log you can grep later
—works in scripts: --count and --max-loss give cron an exit code it can act on
—ships bash/zsh/fish completions and a man page
—one binary for macOS and Linux, x86_64 and arm64

Why

ping tells you everything and shows you nothing. After an hour it has printed 3,600 lines, and you still have to scroll back to find the gap where your router died. ekg keeps the answer on screen: is the network up, and when did it last break.

Footprint

About 2 MB on disk and 2.5 MB of RAM while it watches. That's roughly one megabyte more than ping itself. The fullscreen graphing tools run three times heavier.

2 MBbinary · 2.5 MBRAM · 0.5 MBdownload