Error Tracking Angular

Consult the documentation for API details and framework-specific patterns.

Key principles

• Environment variables: Always use environment variables for PostHog keys and host URLs. Never hardcode them.
• Minimal changes: Add error tracking alongside existing error handling. Don’t replace or restructure existing error handling code.
• Autocapture first: Enable exception autocapture in the SDK initialization before adding manual captures.
• Source maps: Upload source maps so stack traces resolve to original source code, not minified bundles.
• Manual capture for boundaries: Use captureException() at error boundaries and catch blocks for errors that don’t propagate to the global handler.

Framework guidelines

• Use inject() instead of constructor injection. PostHog service should be injected via inject() in components/services that need it.
• Create a dedicated PosthogService as a singleton root service that wraps the PostHog SDK.
• Always use standalone components over NgModules.
• Configure PostHog credentials in src/environments/environment.ts files, as Angular reads environment variables from these configuration files