Skip to content

PostHog

  1. Settings → Integrations → PostHog → Connect. Choose EU Cloud, US Cloud or enter your self-hosted URL.
  2. In PostHog, create a personal API key with read access to the projects you want (Settings → Personal API keys → scopes project:read, insight:read, query:read). Paste it into Ubrella.
  3. Ubrella lists the projects it can see.

Each PostHog project is a source. Typical setup: one production project per Ubrella project. If you also have a staging project, leave it unassigned — it would only add noise.

Metric (per day, rolled to 7d)Event
active users (daily and weekly)active users materially above / below previous week
event volume
signups, if you have a signed_up-style event configuredsignups materially above / below previous week

Ubrella runs a handful of aggregate queries per sync — a few HogQL count() and count(distinct person_id) calls per project per day. It does not export, copy or store individual events, persons or properties.

  • Active users materially below baseline — attention at −25 %, critical at −50 %; waits for you to resolve. Fires only after 14 days of snapshots and above roughly 50 weekly active users.

If your product has a signup event, name it in the source settings (Settings → Sources → PostHog → Signup event). Ubrella then tracks it as a metric and mentions material changes in the brief and timeline. Nothing else is configured per project.