watchdog/README.md
NotAShelf 28abcf50e2
docs: improve introduction paragraph; tiny cleanup
Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I2d331809c915f4695603b72ff52857cc6a6a6964
2026-03-02 22:37:49 +03:00

26 lines
747 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Watchdog
Watchdog is a privacy-preserving web analytics platform similar to Plausible,
where data visualisation is deferred to a Prometheus-compatible dashboard such
as Grafana. It is designed to be as simple and lightweight as possible, without
any additional web components to worry about. You, in turn, get to use your
existing monitoring stack to also collect information about your web
applications tracked by Watchdog.
## Design
- No raw event storage
- No persistent identifiers
- Bounded cardinality by design
- Aggregate at ingestion
- Prometheus-native export
## Quick Start
```bash
# Build the prıject
$ go build -o watchdog ./cmd/watchdog
# Start the Watchdog daemon with your own config
$ ./watchdog --config config.yaml
```