| name | sentry-upgrade-migration |
|---|---|
| description | Execute upgrade Sentry SDK and migrate between versions. Use when upgrading Sentry SDK, handling breaking changes, or migrating from legacy versions. Trigger with phrases like "upgrade sentry", "sentry migration", "update sentry sdk", "sentry breaking changes". |
| allowed-tools | Read, Write, Edit, Bash(npm:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <[email protected]> |
Sentry Upgrade Migration
Prerequisites
- Current Sentry SDK version identified
- Target version changelog reviewed
- Non-production environment for testing
- Test suite for error capture and performance monitoring
Instructions
- Check current SDK version with npm list or pip show
- Review release notes and changelog for target version
- Back up current Sentry configuration file
- Update package to target version in non-production first
- Run tests to identify breaking changes
- Update deprecated APIs following migration guide patterns
- Verify error capture works with test error
- Verify performance monitoring works with test transaction
- Deploy to staging and monitor for issues
- Deploy to production after staging validation
Output
- SDK upgraded to target version
- Breaking changes resolved
- Code updated for new APIs
- Error capture verified working
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.