beattrack

Network monitoring tool that tracks packet loss, latency, DNS resolution, route hops, and WiFi signal over time. Runs on Linux and macOS, built for headless machines like a Raspberry Pi.

Collects data from ping, mtr, iw, and Go's DNS resolver, stores everything in a local SQLite database, and serves a real-time dashboard you can open from any browser on the network.

Install

curl -fsSL https://raw.githubusercontent.com/This-Is-NPC/beattrack/main/install.sh | sh

This detects your OS and architecture, downloads the latest release binary, and installs it to ~/.local/bin. Use --global to install to /usr/local/bin instead.

Requirements

• ping (available on virtually all systems)
• mtr for route analysis (optional — install with your package manager)
• iw for WiFi metrics (optional — Linux only)

Getting started

Run all collectors once:

beattrack run

Start the dashboard with scheduled collection every 5 minutes:

beattrack dashboard

Open http://localhost:8080 to see live ping, latency charts, DNS resolution times, and route analysis.

Generate a report from stored data:

beattrack report --last 24h
beattrack report --last 7d --format md

Quick config

beattrack looks for beattrack.toml in the current directory, then ~/.config/beattrack/config.toml. Create one to customize targets:

[ping]
targets = ["8.8.8.8", "1.1.1.1", "192.168.0.1"]
count = 20

[scheduler]
interval = "5m"

Commands

beattrack run        Run all collectors once
beattrack daemon     Run collectors on a schedule
beattrack report     Generate report from collected data
beattrack dashboard  Start web dashboard with real-time updates
beattrack version    Print version

Docs

Document	Description
Configuration	All config options, collector tuning, display names
Dashboard	Web UI features, API endpoints, SSE events
Deployment	Raspberry Pi setup, running as a service, cross-compilation