sentry-common-errors
Troubleshoot common Sentry integration issues and fixes.Use when encountering Sentry errors, missing events,or configuration problems.Trigger with phrases like "sentry not working", "sentry errors missing","fix sentry", "sentry troubleshoot".
When & Why to Use This Skill
This Claude skill is a specialized diagnostic tool designed to troubleshoot and resolve common Sentry integration issues. It streamlines the debugging process for developers by identifying root causes for missing events, configuration errors, and source map mismatches, ensuring that application monitoring remains reliable and accurate.
Use Cases
- 1. Resolving Missing Events: Diagnose why application errors are not appearing in the Sentry dashboard by verifying DSN settings, environment variables, and beforeSend logic.
- 2. SDK Configuration Audit: Automatically check for correct SDK initialization, including debug mode activation and breadcrumb integration settings.
- 3. Source Map & Release Troubleshooting: Fix unreadable stack traces by verifying that source maps are correctly uploaded and matched with the appropriate release versions.
- 4. Performance & Volume Optimization: Review and adjust tracesSampleRate and ignoreErrors patterns to manage event quotas and reduce noise in monitoring data.
| name | sentry-common-errors |
|---|---|
| description | | |
| allowed-tools | Read, Grep, Bash(npm:*), Bash(curl:*) |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Sentry Common Errors
Prerequisites
- Sentry SDK installed
- Debug mode enabled for troubleshooting
- Access to Sentry dashboard
- Application logs available
Instructions
- Enable debug mode in SDK configuration for verbose output
- Verify DSN is set correctly in environment variables
- Check beforeSend function returns event (not undefined)
- Review sampling rates to ensure events are not being dropped
- Verify source maps are uploaded with correct release version
- Set user context after authentication for user tracking
- Add ignoreErrors patterns for noisy errors to reduce volume
- Enable Breadcrumbs integration with appropriate options
- Set tracesSampleRate greater than 0 for performance monitoring
- Run diagnostic commands to verify connectivity and capture
Output
- Issue root cause identified
- Configuration fix applied
- Error capture verified working
- Documentation of resolution
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.