sentry

# 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.

```bash
export SENTRY_AUTH_TOKEN="your-token-here"
```

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

## Quick Start

List recent unresolved issues:
```bash
python3 scripts/sentry_issues.py --org <org-slug> --project <project-slug>
```

Get issue details with stack trace:
```bash
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:**
```bash
# 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

| Query | Description |
|-------|-------------|
| `is:unresolved` | Open issues only |
| `is:resolved` | Resolved issues |
| `is:ignored` | Ignored issues |
| `level:error` | Error-level issues |
| `level:warning` | Warning-level issues |
| `firstSeen:>-24h` | New in last 24 hours |
| `la...