Sentry Issue Tracker

Fetch and analyze issues from Sentry using the Sentry API.

Prerequisites

• Sentry API token with project:read and event:read scopes
• Organization slug and project slug

Authentication

Set the SENTRY_AUTH_TOKEN environment variable, or pass --token to the script.

export SENTRY_AUTH_TOKEN="your-token-here"

To create a token: Sentry → Settings → Auth Tokens → Create New Token

Quick Start

List recent unresolved issues:

python3 scripts/sentry_issues.py --org <org-slug> --project <project-slug>

Get issue details with stack trace:

python3 scripts/sentry_issues.py --org <org-slug> --project <project-slug> --issue <issue-id> --details

Script Reference

scripts/sentry_issues.py

Fetches issues from Sentry API.

Arguments:

• --org (required): Sentry organization slug
• --project (required): Project slug
• --token: Auth token (defaults to SENTRY_AUTH_TOKEN env var)
• --issue: Specific issue ID to fetch details
• --details: Include stack trace and event details
• --query: Filter query (e.g., is:unresolved, level:error)
• --limit: Max issues to return (default: 25)
• --sort: Sort by date, new, priority, freq, or user (default: date)

Examples:

# List 10 most recent unresolved errors
python3 scripts/sentry_issues.py --org myorg --project myproject --query "is:unresolved level:error" --limit 10

# Get details for specific issue
python3 scripts/sentry_issues.py --org myorg --project myproject --issue 12345 --details

# Sort by most users affected
python3 scripts/sentry_issues.py --org myorg --project myproject --sort user --limit 5

Common Queries

Combine queries: is:unresolved level:error firstSeen:>-24h

Output Format

Issues are returned as JSON with key fields:

• id: Issue ID for fetching details
• title: Error message/title
• culprit: Source location
• count: Number of events
• userCount: Affected users
• firstSeen / lastSeen: Timestamps
• level: error/warning/info
• status: unresolved/resolved/ignored

When --details is used, includes:

• Full stack trace
• Latest event context
• Tags and metadata
• Browser/OS info (if available)