Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.

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

• Navigate to Sentry Settings → Account → API → Auth Tokens

• Create new token with scopes: project:read , project:write , event:read

• 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:

• Verify SENTRY_AUTH_TOKEN is set: echo $SENTRY_AUTH_TOKEN

• Check token permissions include required scopes

• Verify organization and project slugs are correct

• Review Sentry API rate limits (default: 3000 requests/minute)

Common Workflows

Incident Response

• list-issues

• Get recent unresolved errors

• issue-details

• Investigate specific issue

• resolve-issue

• Mark as resolved after fix deployed

Performance Optimization

• list-transactions

• Identify slow endpoints

• transaction-summary

• Analyze performance patterns

• slow-queries

• Find database bottlenecks

Release Management

• create-release

• Create new release version

• set-commits

• Associate commits with release

• 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

Related

• Sentry API Documentation: https://docs.sentry.io/api/

• Sentry Error Tracking: https://docs.sentry.io/product/issues/

• Sentry Performance: https://docs.sentry.io/product/performance/

• Sentry Releases: https://docs.sentry.io/product/releases/

Memory Protocol (MANDATORY)

Before starting: Read .claude/context/memory/learnings.md

After completing:

• New pattern -> .claude/context/memory/learnings.md

• Issue found -> .claude/context/memory/issues.md

• Decision made -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.