Analytics & Observability
1.0.0Event tracking, dashboards, and KPIs across tenants.
Event tracking
- The landing app and dashboard call helpers in
apps/landing/src/lib/analytics.tsandcommon/lib/analytics. trackEventdelegates to @vercel/analytics and logs in development.- Add new event enums before instrumenting new flows.
Recommended events
| Event | Description |
|---|---|
docs_page_viewed | Emitted via <DocsAnalyticsTracker /> whenever a doc renders. |
docs_search | Logged when users trigger search queries. |
paywall_viewed | Fired from the paywall when enterprise gating blocks access. |
Success
Events are thin wrappers over Vercel Analytics. Layer other providers by
extending trackEvent without touching callers.
Reporting
- Export raw events from Vercel Analytics into your data warehouse.
- Join docs search events with Supabase org data to understand enterprise engagement.
- Feed plan + usage metrics back into the dashboard via the Forge API.
Health checks
pnpm test:smokeverifies top-level routes../docs/scripts/health-check.shpings Supabase, Stripe, and Vercel endpoints.
Warning
Always gate enterprise-only analytics with Supabase session checks. Avoid emitting doc metrics for anonymous users viewing gated content.