Sentry Issues

该 Skill 提供一个 Python 脚本，通过 Sentry API 按组织与项目拉取错误问题列表，支持查询过滤、排序和数量限制，并能获取指定问题的堆栈轨迹与最新事件上下文，结果以 JSON 输出。使用前需配置 Sentry API 令牌（SENTRY_AUTH_TOKEN）并具备相应读取权限。

dave-b-b

热度 75.81

最近更新 2026-05-11 17:26:25

分类：开发依赖：代码执行 / 第三方 API应用场景：调试排错 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add sentry-issues

Metadata

name: sentry
description: Fetch and analyze issues from Sentry error tracking. Use when asked to check Sentry errors, pull issues, investigate exceptions, review error trends, or get crash reports from a Sentry project.
version: 1.0.0

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

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
`lastSeen:>-1h`	Active in last hour
`assigned:me`	Assigned to current user
`has:release`	Issues with release info

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)