NotAShelf/watchdog
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Lightweight, stateless and privacy-first analytics system
6 commits 1 branch 0 tags 159 KiB
  • Go 87.6%
  • Nix 6%
  • JavaScript 4.7%
  • HTML 1.7%
Find a file
NotAShelf 0691e5ee34
 internal: implement path normalization w/ configurable rules 
Strips query strings and URL fragmenets, prevents unbounded Prometheus
metrics by normalizing paths like:

- `/users/12345/profile -> /users/:id/profile`
- `/page?utm_source=twitter -> /page`
- `/a/../b -> /b`

etc.

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I72f2fa2452f4666567143d052b5716476a6a6964
2026-03-02 22:37:50 +03:00
internal internal: implement path normalization w/ configurable rules 2026-03-02 22:37:50 +03:00
nix nix: initial tooling 2026-03-02 22:37:46 +03:00
testdata internal: implement path normalization w/ configurable rules 2026-03-02 22:37:50 +03:00
.envrc meta: add direnv support 2026-03-02 22:37:48 +03:00
.gitignore initial commit 2026-03-02 22:37:45 +03:00
flake.lock nix: initial tooling 2026-03-02 22:37:46 +03:00
flake.nix nix: initial tooling 2026-03-02 22:37:46 +03:00
go.mod config: data structures; basic tests 2026-03-02 22:37:47 +03:00
go.sum config: data structures; basic tests 2026-03-02 22:37:47 +03:00
README.md docs: improve introduction paragraph; tiny cleanup 2026-03-02 22:37:49 +03:00

README.md

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

# Build the prıject
$ go build -o watchdog ./cmd/watchdog

# Start the Watchdog daemon with your own config
$ ./watchdog --config config.yaml