AgentSkillsCN

sentry-advanced-troubleshooting

执行 Sentry 高级故障排除技术。 在调试复杂 SDK 问题、缺失事件、源映射问题或性能异常时使用。 可通过诸如“sentry 不工作”、“调试 sentry”、“sentry 事件缺失”、“修复 sentry 问题”等短语触发。

SKILL.md
--- frontmatter
name: "sentry-advanced-troubleshooting"
description: |
  Execute advanced Sentry troubleshooting techniques.
  Use when debugging complex SDK issues, missing events,
  source map problems, or performance anomalies.
  Trigger with phrases like "sentry not working", "debug sentry",
  "sentry events missing", "fix sentry issues".
  
allowed-tools: "Read, Write, Edit, Grep, Bash(cmd:*)"
version: 1.0.0
license: MIT
author: "Jeremy Longshore <jeremy@intentsolutions.io>"

Sentry Advanced Troubleshooting

Prerequisites

  • •Debug mode enabled in SDK
  • •Access to application logs
  • •Sentry dashboard access
  • •Sentry CLI installed for source map debugging

Instructions

  1. •Enable debug mode in SDK configuration to see verbose logging
  2. •Verify SDK initialization by checking if client exists after init
  3. •Test network connectivity to Sentry ingest endpoint
  4. •Check sampling configuration to ensure events are not being dropped
  5. •Temporarily disable beforeSend filtering during debugging
  6. •Use sentry-cli sourcemaps explain to diagnose source map issues
  7. •Verify transaction creation and finish calls for performance data
  8. •Check breadcrumb capture with beforeBreadcrumb debugging
  9. •Resolve SDK conflicts by ensuring single initialization
  10. •Run diagnostic script to generate comprehensive health report

Output

  • •Root cause identified for SDK issues
  • •Source map problems resolved
  • •Event capture verified working
  • •Performance monitoring validated

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources