
sentry
β Officialβ 4,081by openai Β· part of openai/plugins
Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.
This is the playbook your agent receives when the skill activates β you don't need to read it to use the skill, but it's here to audit before installing.
Sentry (Read-only Observability)
Core tasks (use bundled script)
Use scripts/sentry_api.py for deterministic API calls. It handles pagination and retries once on transient errors.
Bundled script path
export SENTRY_API="plugins/sentry/skills/sentry/scripts/sentry_api.py"If you are running from an installed plugin copy instead of this repo checkout, use the same
skills/sentry/scripts/sentry_api.py path inside the installed plugin directory.
1) List issues (ordered by most recent)
python3 "$SENTRY_API" \
--org {your-org} \
--project {your-project} \
list-issues \
--environment prod \
--time-range 24h \
--limit 20 \
--query "is:unresolved"2) Resolve an issue short ID to issue ID
python3 "$SENTRY_API" \
--org {your-org} \
--project {your-project} \
list-issues \
--query "ABC-123" \
--limit 1Use the returned id for issue detail or events.
3) Issue detail
python3 "$SENTRY_API" \
--org {your-org} \
issue-detail \
12345678904) Issue events
python3 "$SENTRY_API" \
--org {your-org} \
issue-events \
1234567890 \
--environment prod \
--time-range 24h \
--limit 205) Event detail (no stack traces by default)
python3 "$SENTRY_API" \
--org {your-org} \
--project {your-project} \
event-detail \
abcdef1234567890Inputs and defaults
org_slug: default to{your-org}(required for issue detail, issue events, and event detail).project_slug: default to{your-project}(required for list issues and event detail).time_range: default24h(pass asstatsPeriodfor list issues and issue events).environment: defaultprod(used by list issues and issue events).limit: default 20, max 50 (paginate until limit reached).search_query: optionalqueryparameter.issue_short_id: resolve via list-issues query first.
Output formatting rules
- Issue list: show title, short_id, status, first_seen, last_seen, count, environments, top_tags; order by most recent.
- Event detail: include culprit, timestamp, environment, release, url.
- If no results, state explicitly.
- Redact PII in output (emails, IPs). Do not print raw stack traces.
- Never echo auth tokens.
Golden test inputs
- Org:
{your-org} - Project:
{your-project} - Issue short ID:
{ABC-123}
Example prompt: βList the top 10 open issues for prod in the last 24h.β Expected: ordered list with titles, short IDs, counts, last seen.
npx skills add openai/plugins --skill "sentry" --full-depthRun this in your project β your agent picks the skill up automatically.
Quick start
- If not already authenticated, ask the user to provide a valid
SENTRY_AUTH_TOKEN(read-only scopes such asproject:read,event:read) or to log in and create one before running commands. - Set
SENTRY_AUTH_TOKENas an env var. - Optional defaults:
SENTRY_ORG,SENTRY_PROJECT,SENTRY_BASE_URL. - Defaults: org/project
{your-org}/{your-project}, time range24h, environmentprod, limit 20 (max 50). - Always call the Sentry API (no heuristics, no caching).
If the token is missing, give the user these steps:
- Create a Sentry auth token: https://sentry.io/settings/account/api/auth-tokens/
- Create a token with read-only scopes such as
project:read,event:read, andorg:read. - Set
SENTRY_AUTH_TOKENas an environment variable in their system. - Offer to guide them through setting the environment variable for their OS/shell if needed.
- Never ask the user to paste the full token in chat. Ask them to set it locally and confirm when ready.
API requirements
Always use these endpoints (GET only):
- List issues:
/api/0/projects/{org_slug}/{project_slug}/issues/ - Issue detail:
/api/0/organizations/{org_slug}/issues/{issue_id}/ - Events for issue:
/api/0/organizations/{org_slug}/issues/{issue_id}/events/ - Event detail:
/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.