Simple analytics and product insights for your project.

How it works

You send events. agg keeps live numbers over sliding windows and shows them where you look.

1. Collect

   A 3 KB script sends page views and your own events, agg.track('feature_used', {…}), in batches, with retries, plus page, browser and device. Backends, cron jobs and CI send the same events with one HTTP request.

2. Aggregate

   Define what to compute, without code: count, sum, distinct count, last value or last time; grouped by any field; ranked inside groups. Values update as events arrive.

3. Look

   A built-in UI with tiles, trends against the previous period, top lists and history. Or export to Prometheus and use Grafana.

4. Act

   Alerts when something happens or stops happening: browser notifications, in-app, or a Slack / Discord webhook. A JSON API returns the values you mark public.

What you can compute

Presets for each of these are one click away when you add a site.

agg.track('purchase', { order_id, value,
  items: [{ id, name, category, quantity }] }, order_id)

Events     purchase
Explode    props.items
Operation  sum of item.quantity
Group by   category = item.category
Rank by    product  = item.id
Windows    5m 1h 6h 24h 7d 30d (+ previous)

GET /v1/top?site=pk_…&aggregate=bestsellers
           &window=7d&category=shoes

{ "items": [
  { "key": "73", "label": "Trail shoe", "value": 41 },
  { "key": "12", "label": "Road shoe",  "value": 27 }
] }

Privacy by default

• You decide what to send. As a safety net the server removes personal-data fields (email, phone, addresses…) from properties; you can add your own. IPs are not stored unless you turn it on.
• No cookies, no fingerprinting. The optional visitor id is a random value in localStorage, used only to count distinct visitors.
• Consent-aware. It can wait for your consent banner before sending or storing anything.
• Your server, one file. Events and aggregates stay in one SQLite file. Raw events are kept 7 days by default.
• Only real numbers. Missing values are null, never estimated.

Quick start

docker run -d --name agg -p 8080:8080 -v agg-data:/data ghcr.io/worotyns/agg:latest
docker logs agg        # shows the admin token

git clone https://github.com/worotyns/agg && cd agg
# edit app and AGG_PUBLIC_URL in deploy/fly/fly.toml, then:
fly apps create agg-example
fly volumes create agg_data --size 1 --region waw -c deploy/fly/fly.toml
fly secrets set AGG_ADMIN_TOKEN=$(openssl rand -hex 24) -c deploy/fly/fly.toml
fly deploy -c deploy/fly/fly.toml

git clone https://github.com/worotyns/agg && cd agg
go build -o agg ./cmd/agg   # Go 1.27+
./agg serve                 # prints the admin token, UI on http://localhost:8080

<script async src="https://agg.example.com/agg.js" data-site="pk_…"></script>

agg.track('feature_used', { feature: 'export_pdf' })

curl -X POST https://agg.example.com/e -H 'Content-Type: application/json' \
  -d '{"site":"pk_…","events":[{"name":"invoice_paid","id":"inv-42","props":{"amount":49}}]}'