| name | error-tracking |
| description | Set up error tracking with actionable context. Use when configuring error capture or error boundaries. |
| triggers | error tracking, capture errors, error boundaries |
| priority | 1 |
Error Tracking
Capture errors with the context needed to debug them.
Core Principle
An error without context is useless. Every error should include:
| Context | Why | Example |
|---|---|---|
route |
Where it happened | "/checkout" |
job_name |
What user was doing | "checkout" |
job_step |
Where in the flow | "payment" |
user_segment |
Who's affected | "premium" |
app_version |
Release correlation | "1.2.3" |
Error Types to Capture
| Type | Capture Method |
|---|---|
| Unhandled exceptions | window.onerror, SDK auto-capture |
| Promise rejections | window.onunhandledrejection |
| Component errors | Error boundaries |
| Async/await errors | try/catch with context |
| API errors | Fetch/axios interceptors |
What NOT to Include
| Don't | Why |
|---|---|
| Passwords | Security |
| Email/phone | PII |
| Full request bodies | PII, size limits |
| Entire app state | Unbounded |
| Localized messages | Breaks grouping |
Implementation
See templates/error-boundary.tsx for React error boundary with telemetry.
Use Read tool to load template when generating implementation.
Anti-Patterns
See references/anti-patterns.md for common error tracking mistakes.
Related
skills/source-map-setup- Readable stack tracesskills/api-tracing- API error correlationreferences/frameworks/*.md- Framework-specific error handling