sentry-common-errors

排查Sentry集成常见问题和修复。在遇到Sentry错误、事件缺失或配置问题时使用。触发词:'sentry不工作','sentry错误缺失','修复sentry','sentry排查'。

📖 中文导读:排查Sentry集成常见问题和修复。在遇到Sentry错误、事件缺失或配置问题时使用。触发词:'sentry不工作','sentry错误缺失','修复sentry','sentry排查'。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: sentry-common-errors description: | Execute 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". 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

  1. Enable debug mode in SDK configuration for verbose output
  2. Verify DSN is set correctly in environment variables
  3. Check beforeSend function returns event (not undefined)
  4. Review sampling rates to ensure events are not being dropped
  5. Verify source maps are uploaded with correct release version
  6. Set user context after authentication for user tracking
  7. Add ignoreErrors patterns for noisy errors to reduce volume
  8. Enable Breadcrumbs integration with appropriate options
  9. Set tracesSampleRate greater than 0 for performance monitoring
  10. 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.

Resources