observability-and-growthlisted
Install: claude install-skill heymegabyte/claude-skills
# 13 — Observability and Growth
## Instrumentation tiers
Per `_kernel/standards.md#integrations`:
- **Tier 1 (solo)** — PostHog + Workers Tracing OTLP (2 vendors max, cookie-free, free tier covers <10k MAU)
- **Tier 2 (enterprise)** — + Sentry @sentry/cloudflare v9 + GA4/GTM + Axiom
- **Tier 3 (LLM-heavy >10k calls/mo)** — + AI Gateway
## PostHog (Tier 1 cornerstone)
- Snippet on every HTML page w/ `persistence:'memory'` (cookie-free)
- `capture_pageview` + `capture_pageleave` + `autocapture:true`
- Unified platform: product analytics + feature flags + session replay + error tracking
- CSP: `script-src` + `connect-src` for posthog domain
- Per-feature event naming: `<feature>:<action>` (`signup:complete`, `editor:save`, `share:copy`)
## Sentry (Tier 2)
- `@sentry/cloudflare` v9 + `withSentry` wrapper
- Project created via `mcp__sentry__create_project` (org:`megabyte-labs`)
- `SENTRY_DSN` via `wrangler secret put`
- Pattern: `withSentry(env => ({ dsn, tracesSampleRate: 1.0, sendDefaultPii: false }), worker)`
- Breadcrumbs before risky ops; capture exception w/ context tags (`worker` | `route` | `userId`)
- Release tracking via `SENTRY_RELEASE` env
- Focus on exceptions; Workers Tracing handles I/O spans
## Workers Tracing (Tier 1 + Tier 2)
- `[observability] enabled = true` in `wrangler.jsonc` — zero-config OTel I/O tracing
- Free until Mar 1 2026 then billed
- Export to Axiom (cheapest at edge), Honeycomb (BubbleUp), Grafana, Datadog via `@opentelemetry/exporter-trac