sentry

# Sentry (Read-only)

Read production errors and issues from Sentry.

## Setup

```bash
# Check token is set (does not print the value)
[ -n "$SENTRY_AUTH_TOKEN" ] && echo "SENTRY_AUTH_TOKEN: set" || echo "SENTRY_AUTH_TOKEN: MISSING"
echo "ORG=${SENTRY_ORG:-not set}"
echo "PROJECT=${SENTRY_PROJECT:-not set}"
```

If `SENTRY_AUTH_TOKEN` is missing:
1. Go to https://sentry.io/settings/account/api/auth-tokens/
2. Create a token with scopes: `project:read`, `event:read`, `org:read`
3. Set `SENTRY_AUTH_TOKEN` in your environment

Set optional defaults to avoid passing flags every time:
```bash
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug
```

## Script path

```bash
SKILL_DIR="$(python3 -c "import os; print(os.path.dirname(os.path.realpath('$0')))" 2>/dev/null || echo "$HOME/.claude/skills/sentry")"
SENTRY_API="$SKILL_DIR/scripts/sentry_api.py"
```

## Commands

### List recent issues

```bash
python3 "$SENTRY_API" list-issues \
  --org "$SENTRY_ORG" \
  --project "$SENTRY_PROJECT" \
  --time-range 24h \
  --environment prod \
  --limit 20 \
  --query "is:unresolved"
```

### Get issue detail

```bash
python3 "$SENTRY_API" issue-detail ISSUE_ID
```

### Get events for an issue

```bash
python3 "$SENTRY_API" issue-events ISSUE_ID --limit 10
```

### Get event detail (no stack traces by default)

```bash
python3 "$SENTRY_API" event-detail \
  --org "$SENTRY_ORG" \
  --project "$SENTRY_PROJECT" \
  EVENT_ID
```

Add `--include-entries` to include stack traces.

### Resolve a short ID (e.g. ABC-123) to issue ID

```bash
python3 "$SENTRY_API" list-issues \
  --org "$SENTRY_ORG" \
  --project "$SENTRY_PROJECT" \
  --query "ABC-123" \
  --limit 1
```

## Parameters

| Flag | Default | Description |
|------|---------|-------------|
| `--org` | `$SENTRY_ORG` | Org slug |
| `--project` | `$SENTRY_PROJECT` | Project slug |
| `--time-range` | `24h` | Stats period (e.g. `7d`, `30d`) |
| `--environment` | `prod` | Environment filter |
| `--limit` | `20` | Ma...

# sentry

Read production errors and issues from [Sentry](https://sentry.io) via the Sentry REST API.

## What it does

- List recent unresolved issues
- Get issue details
- List events for an issue
- Get event detail (with optional stack traces)
- Resolve short IDs (e.g. `MYAPP-123`) to internal IDs
- PII redacted by default (emails, IPs)

## Requirements

- Python 3 (stdlib only, no pip needed)
- A Sentry auth token with read-only scopes

## Auth token setup

1. Go to https://sentry.io/settings/account/api/auth-tokens/
2. Create a token with scopes: `project:read`, `event:read`, `org:read`
3. Export it:
   ```bash
   export SENTRY_AUTH_TOKEN=sntrys_...
   export SENTRY_ORG=your-org-slug
   export SENTRY_PROJECT=your-project-slug
   ```

## Usage

```bash
# List recent issues
python3 scripts/sentry_api.py list-issues --time-range 24h --limit 20

# Issue detail
python3 scripts/sentry_api.py issue-detail 1234567890

# Events for an issue
python3 scripts/sentry_api.py issue-events 1234567890 --limit 10

# Event detail (no stack traces)
python3 scripts/sentry_api.py event-detail abcdef1234567890

# Event detail (with stack traces)
python3 scripts/sentry_api.py event-detail abcdef1234567890 --include-entries
```

## Self-hosted Sentry

```bash
export SENTRY_BASE_URL=https://sentry.yourcompany.com
```

## Notes

- Works with OpenClaw and other Claude Code-compatible skill runners
- Script is pure Python stdlib — no dependencies to install