sentry-monitoring

oimiragieo's avatarfrom oimiragieo

Sentry error tracking and performance monitoring for real-time visibility into application errors, performance issues, and release health

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 11, 2026
[Monitoring]

When & Why to Use This Skill

This Claude skill integrates Sentry's comprehensive error tracking and performance monitoring suite directly into your AI workflow. It provides real-time visibility into application health, enabling agents to efficiently triage issues, analyze performance bottlenecks, and manage software releases with over 90% context savings compared to standard API interactions.

Use Cases

  • Real-time Incident Response: Quickly list unresolved issues and fetch detailed error logs to diagnose and resolve production bugs faster.
  • Performance Bottleneck Analysis: Identify slow database queries and high-latency transactions to optimize application speed and resource usage.
  • Release Health Tracking: Create new releases and associate commits to monitor the stability of new deployments and detect regressions early.
  • Streamlined Project Management: View and update project settings, alert rules, and issue statuses (resolve/ignore) directly through the agent interface.
namesentry-monitoring
descriptionSentry error tracking and performance monitoring for real-time visibility into application errors, performance issues, and release health
version1.0.0
allowed-tools[Bash, Read, WebFetch]

Sentry Monitoring Skill

Overview

Provides 90%+ context savings vs raw Sentry API calls. Progressive disclosure by feature category: error tracking, performance monitoring, release management, and project configuration.

Requirements

  • Sentry account with project configured
  • SENTRY_AUTH_TOKEN environment variable (optional, for authenticated API calls)
  • SENTRY_ORG environment variable (optional, defaults to first organization)
  • SENTRY_PROJECT environment variable (optional, defaults to first project)

Tools (Progressive Disclosure)

Error Tracking

Tool Description Confirmation
list-issues List recent issues/errors No
issue-details Get detailed issue info No
resolve-issue Mark issue as resolved Yes
ignore-issue Ignore/snooze issue Yes

Performance Monitoring

Tool Description Confirmation
list-transactions List performance transactions No
transaction-summary Get transaction performance stats No
slow-queries Identify slow database queries No

Release Management

Tool Description Confirmation
list-releases List releases No
create-release Create new release Yes
set-commits Associate commits with release Yes

Project Configuration

Tool Description Confirmation
list-projects List Sentry projects No
project-settings View project settings No
list-alerts List alert rules No

Quick Reference

# List recent issues
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/projects/$SENTRY_ORG/$SENTRY_PROJECT/issues/?query=is:unresolved"

# Get issue details
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/issues/{issue_id}/"

# Resolve issue
curl -X PUT -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/issues/{issue_id}/" \
  -d '{"status": "resolved"}'

# List transactions
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/organizations/$SENTRY_ORG/events/?field=transaction"

# Create release
curl -X POST -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/organizations/$SENTRY_ORG/releases/" \
  -d '{"version": "1.0.0", "projects": ["project-slug"]}'

# List projects
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
  "https://sentry.io/api/0/organizations/$SENTRY_ORG/projects/"

Configuration

Environment Variables

Variable Required Description
SENTRY_AUTH_TOKEN Optional Sentry authentication token for API calls
SENTRY_ORG Optional Organization slug (defaults to first org)
SENTRY_PROJECT Optional Project slug (defaults to first project)
SENTRY_DSN No For SDK integration (not used by this skill)

Getting Auth Token

  1. Navigate to Sentry Settings → Account → API → Auth Tokens
  2. Create new token with scopes: project:read, project:write, event:read
  3. Set as environment variable: export SENTRY_AUTH_TOKEN=your_token_here

Security

⚠️ Never expose auth tokens in output ⚠️ Destructive operations (resolve-issue, ignore-issue, create-release, set-commits) require confirmation ⚠️ Use environment variables for credentials, never hardcode

Agent Integration

  • devops (primary): Production monitoring, incident response
  • incident-responder (primary): Error triage, issue resolution
  • developer (secondary): Debugging, performance optimization
  • qa (secondary): Test environment monitoring

Error Handling

If tool execution fails:

  1. Verify SENTRY_AUTH_TOKEN is set: echo $SENTRY_AUTH_TOKEN
  2. Check token permissions include required scopes
  3. Verify organization and project slugs are correct
  4. Review Sentry API rate limits (default: 3000 requests/minute)

Common Workflows

Incident Response

  1. list-issues - Get recent unresolved errors
  2. issue-details - Investigate specific issue
  3. resolve-issue - Mark as resolved after fix deployed

Performance Optimization

  1. list-transactions - Identify slow endpoints
  2. transaction-summary - Analyze performance patterns
  3. slow-queries - Find database bottlenecks

Release Management

  1. create-release - Create new release version
  2. set-commits - Associate commits with release
  3. list-releases - Track release health

Troubleshooting

Issue Solution
401 Unauthorized Check SENTRY_AUTH_TOKEN is valid and not expired
403 Forbidden Verify token has required scopes (project:read, project:write, event:read)
404 Not Found Verify SENTRY_ORG and SENTRY_PROJECT are correct slugs
Rate limit exceeded Wait 1 minute, reduce request frequency