sentry-upgrade-migration

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sentry Upgrade Migration

Sentry SDK升级迁移指南

Prerequisites

前置条件

  • Current Sentry SDK version identified
  • Target version changelog reviewed
  • Non-production environment for testing
  • Test suite for error capture and performance monitoring
  • 已确定当前使用的Sentry SDK版本
  • 已查阅目标版本的更新日志
  • 具备用于测试的非生产环境
  • 拥有用于错误捕获和性能监控的测试套件

Instructions

操作步骤

  1. Check current SDK version with npm list or pip show
  2. Review release notes and changelog for target version
  3. Back up current Sentry configuration file
  4. Update package to target version in non-production first
  5. Run tests to identify breaking changes
  6. Update deprecated APIs following migration guide patterns
  7. Verify error capture works with test error
  8. Verify performance monitoring works with test transaction
  9. Deploy to staging and monitor for issues
  10. Deploy to production after staging validation
  1. 使用npm list或pip show命令查看当前SDK版本
  2. 查阅目标版本的发布说明和更新日志
  3. 备份当前的Sentry配置文件
  4. 先在非生产环境中将包更新至目标版本
  5. 运行测试以识别破坏性变更
  6. 按照迁移指南的模式更新已废弃的API
  7. 通过测试错误验证错误捕获功能是否正常
  8. 通过测试事务验证性能监控功能是否正常
  9. 部署至预发布环境并监控问题
  10. 预发布环境验证通过后再部署至生产环境

Output

输出结果

  • SDK upgraded to target version
  • Breaking changes resolved
  • Code updated for new APIs
  • Error capture verified working
  • SDK已升级至目标版本
  • 已解决所有破坏性变更问题
  • 代码已适配新的API
  • 错误捕获功能验证正常

Error Handling

错误处理

See
{baseDir}/references/errors.md
for comprehensive error handling.
如需全面的错误处理方案,请查看
{baseDir}/references/errors.md

Examples

示例

See
{baseDir}/references/examples.md
for detailed examples.
如需详细示例,请查看
{baseDir}/references/examples.md

Resources

参考资源