Repository navigation
v0.1.0
First release of tail-watch, a tailnet reachability monitor. It runs beside a
kernel-mode tailscaled, checks your nodes and the subnets behind them, and
tells you which layer failed.
Highlights
- Checks:
icmp,tcp,http, andtsping, configured from one YAML
file.--onceruns every check once, andcheck-configvalidates a file
without contactingtailscaled. - Failure layers: a failed check is labeled
unrouted,control,
tunnel,service, orlan. Remote LAN targets learn a parent from disco
and primary routes. - Alert state: targets move between
UNKNOWN,UP,DOWN, and
SUPPRESSEDafter consecutive failures, with flap damping and suppression
of dependents behind a down reachability parent. - Notifications:
slackandwebhooksinks with grouping, retries, and
HMAC-signed webhook payloads. Incidents and queues persist instate_dir
and replay at startup, giving at-least-once delivery.tail-watch notify-testsends a test event to one sink or all of them. - Heartbeat: an optional dead-man's-switch ping on an interval.
- Monitor UI: an opt-in web UI and JSON API (
--uiorcollector.ui) to
add, edit, and delete monitors on a running collector. It has no login, so
read the risks first. - Metrics: Prometheus series under the
tailwatch_prefix, served at
/metrics.
Documentation
Start with the first-monitor tutorial, or
see the documentation index. Each archive includes the
docs/ tree, examples/tail-watch.yaml, README.md, and the license.
Downloads
Archives for Linux, macOS, and Windows on amd64 and arm64, with
checksums.txt. tail-watch --version prints 0.1.0.