sentry

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Sentry Skill

Access Sentry data via the API for debugging and investigation. Uses auth token from

~/.sentryclirc

通过API访问Sentry数据，用于调试与问题排查。使用

~/.sentryclirc

中的认证令牌。

Quick Reference

快速参考

Task	Command
Find errors on a date	`search-events.js --org X --start 2025-12-23T15:00:00 --level error`
List open issues	`list-issues.js --org X --status unresolved`
Get issue details	`fetch-issue.js <issue-id-or-url> --latest`
Get event details	`fetch-event.js <event-id> --org X --project Y`
Search logs	`search-logs.js --org X --project Y "level:error"`

任务	命令
按日期查找错误	`search-events.js --org X --start 2025-12-23T15:00:00 --level error`
列出未解决的问题	`list-issues.js --org X --status unresolved`
获取问题详情	`fetch-issue.js <issue-id-or-url> --latest`
获取事件详情	`fetch-event.js <event-id> --org X --project Y`
搜索日志	`search-logs.js --org X --project Y "level:error"`

Common Debugging Workflows

常用调试流程

"What went wrong at this time?"

"特定时间点发生了什么问题？"

Find events around a specific timestamp:

bash

undefined

查找特定时间戳附近的事件：

bash

undefined

Find all events in a 2-hour window

查找2小时时间窗口内的所有事件

./scripts/search-events.js --org myorg --project backend
--start 2025-12-23T15:00:00 --end 2025-12-23T17:00:00

Filter to just errors

仅筛选错误事件

./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00
--level error

Find a specific transaction type

查找特定类型的事务

./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00
--transaction process-incoming-email

undefined

./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00
--transaction process-incoming-email

undefined

"What errors have occurred recently?"

"近期出现了哪些错误？"

bash

undefined

bash

undefined

List unresolved errors from last 24 hours

列出过去24小时内未解决的错误

./scripts/list-issues.js --org myorg --status unresolved --level error --period 24h

Find high-frequency issues

查找高频出现的问题

./scripts/list-issues.js --org myorg --query "times_seen:>50" --sort freq

Issues affecting users

影响用户的问题

./scripts/list-issues.js --org myorg --query "is:unresolved has:user" --sort user

undefined

./scripts/list-issues.js --org myorg --query "is:unresolved has:user" --sort user

undefined

"Get details about a specific issue/event"

"获取特定问题/事件的详情"

bash

undefined

bash

undefined

Get issue with latest stack trace

获取包含最新堆栈跟踪的问题详情

./scripts/fetch-issue.js 5765604106 --latest ./scripts/fetch-issue.js https://sentry.io/organizations/myorg/issues/123/ --latest ./scripts/fetch-issue.js MYPROJ-123 --org myorg --latest

Get specific event with all breadcrumbs

获取包含所有面包屑信息的特定事件详情

./scripts/fetch-event.js abc123def456 --org myorg --project backend --breadcrumbs

undefined

./scripts/fetch-event.js abc123def456 --org myorg --project backend --breadcrumbs

undefined

"Find events with a specific tag"

"查找带有特定标签的事件"

bash

undefined

bash

undefined

Find by custom tag (e.g., thread_id, user_id)

按自定义标签查找（如thread_id、user_id）

./scripts/search-events.js --org myorg --tag thread_id:th_abc123

Find by user email

按用户邮箱查找

./scripts/search-events.js --org myorg --query "user.email:*@example.com"

---

./scripts/search-events.js --org myorg --query "user.email:*@example.com"

---

Fetch Issue

获取问题详情

bash

./scripts/fetch-issue.js <issue-id-or-url> [options]

Get details about a specific issue (grouped error).

Accepts:

Issue ID:
```
5765604106
```

Issue URL:

https://sentry.io/organizations/sentry/issues/5765604106/

New URL format:

https://myorg.sentry.io/issues/5765604106/

Short ID:
```
JAVASCRIPT-ABC
```
(requires
```
--org
```
flag)

Options:

```
--latest
```
- Include the latest event with full stack trace
```
--org <org>
```
- Organization slug (for short IDs)
```
--json
```
- Output raw JSON

Output includes:

Title, culprit, status, level
First/last seen timestamps
Event count and user impact
Tags and environment info
With
```
--latest
```
: stack trace, request details, breadcrumbs, runtime context

bash

./scripts/fetch-issue.js <issue-id-or-url> [options]

获取特定问题（分组错误）的详情。

支持的输入格式：

问题ID：
```
5765604106
```

问题URL：

https://sentry.io/organizations/sentry/issues/5765604106/

新URL格式：

https://myorg.sentry.io/issues/5765604106/

短ID：
```
JAVASCRIPT-ABC
```
（需要配合
```
--org
```
参数）

可选参数：

```
--latest
```
- 包含带有完整堆栈跟踪的最新事件
```
--org <org>
```
- 组织标识（用于短ID格式）
```
--json
```
- 输出原始JSON数据

输出内容包括：

标题、问题根源、状态、级别
首次/末次出现时间戳
事件数量与用户影响范围
标签与环境信息
使用
```
--latest
```
参数时：堆栈跟踪、请求详情、面包屑信息、运行时上下文

Fetch Event

获取事件详情

bash

./scripts/fetch-event.js <event-id> --org <org> --project <project> [options]

Get full details of a specific event by its ID.

Options:

```
--org, -o <org>
```
- Organization slug (required)
```
--project, -p <project>
```
- Project slug (required)
```
--breadcrumbs, -b
```
- Show all breadcrumbs (default: last 30)
```
--spans
```
- Show span tree for transactions
```
--json
```
- Output raw JSON

Output includes:

Timestamp, project, title, message
All tags
Context (runtime, browser, OS, trace info)
Request details
Exception with stack trace
Breadcrumbs
Spans (with
```
--spans
```
)

bash

./scripts/fetch-event.js <event-id> --org <org> --project <project> [options]

通过事件ID获取特定事件的完整详情。

可选参数：

```
--org, -o <org>
```
- 组织标识（必填）
```
--project, -p <project>
```
- 项目标识（必填）
```
--breadcrumbs, -b
```
- 显示所有面包屑信息（默认显示最近30条）
```
--spans
```
- 显示事务的调用链路树
```
--json
```
- 输出原始JSON数据

输出内容包括：

时间戳、项目、标题、消息
所有标签
上下文信息（运行时、浏览器、操作系统、追踪信息）
请求详情
异常信息与堆栈跟踪
面包屑信息
使用
```
--spans
```
参数时：调用链路信息

Search Events

搜索事件

bash

./scripts/search-events.js [options]

Search for events (transactions, errors) using Sentry Discover.

Time Range Options:

```
--period, -t <period>
```
- Relative time (24h, 7d, 14d)
```
--start <datetime>
```
- Start time (ISO 8601: 2025-12-23T15:00:00)
```
--end <datetime>
```
- End time (ISO 8601)

Filter Options:

```
--org, -o <org>
```
- Organization slug (required)
```
--project, -p <project>
```
- Project slug or ID
```
--query, -q <query>
```
- Discover search query
```
--transaction <name>
```
- Transaction name filter
```
--tag <key:value>
```
- Tag filter (repeatable)
```
--level <level>
```
- Level filter (error, warning, info)
```
--limit, -n <n>
```
- Max results (default: 25, max: 100)
```
--fields <fields>
```
- Comma-separated fields to include

Query Syntax:

transaction:process-*     Wildcard transaction match
level:error               Filter by level
user.email:foo@bar.com    Filter by user
environment:production    Filter by environment
has:stack.filename        Has stack trace

bash

./scripts/search-events.js [options]

使用Sentry Discover功能搜索事件（事务、错误）。

时间范围参数：

```
--period, -t <period>
```
- 相对时间范围（如24h、7d、14d）
```
--start <datetime>
```
- 开始时间（ISO 8601格式：2025-12-23T15:00:00）
```
--end <datetime>
```
- 结束时间（ISO 8601格式）

筛选参数：

```
--org, -o <org>
```
- 组织标识（必填）
```
--project, -p <project>
```
- 项目标识或ID
```
--query, -q <query>
```
- Discover搜索查询语句
```
--transaction <name>
```
- 事务名称筛选
```
--tag <key:value>
```
- 标签筛选（可重复使用）
```
--level <level>
```
- 级别筛选（error、warning、info）
```
--limit, -n <n>
```
- 最大结果数量（默认25，上限100）
```
--fields <fields>
```
- 要包含的字段，用逗号分隔

查询语法示例：

transaction:process-*     通配符匹配事务名称
level:error               按级别筛选
user.email:foo@bar.com    按用户邮箱筛选
environment:production    按环境筛选
has:stack.filename        包含堆栈跟踪文件信息

List Issues

列出问题

bash

./scripts/list-issues.js [options]

List and search issues (grouped errors) in a project.

Options:

```
--org, -o <org>
```
- Organization slug (required)
```
--project, -p <project>
```
- Project slug (repeatable)
```
--query, -q <query>
```
- Issue search query
```
--status <status>
```
- unresolved, resolved, ignored
```
--level <level>
```
- error, warning, info, fatal
```
--period, -t <period>
```
- Time period (default: 14d)
```
--limit, -n <n>
```
- Max results (default: 25)
```
--sort <sort>
```
- date, new, priority, freq, user
```
--json
```
- Output raw JSON

Query Syntax:

is:unresolved             Status filter
is:assigned               Has assignee
assigned:me               Assigned to current user
level:error               Level filter
firstSeen:+7d             First seen > 7 days ago
lastSeen:-24h             Last seen within 24h
times_seen:>100           Event count filter
has:user                  Has user context
error.handled:0           Unhandled errors only

bash

./scripts/list-issues.js [options]

列出并搜索项目中的问题（分组错误）。

可选参数：

```
--org, -o <org>
```
- 组织标识（必填）
```
--project, -p <project>
```
- 项目标识（可重复使用）
```
--query, -q <query>
```
- 问题搜索查询语句
```
--status <status>
```
- 状态筛选：unresolved（未解决）、resolved（已解决）、ignored（已忽略）
```
--level <level>
```
- 级别筛选：error、warning、info、fatal
```
--period, -t <period>
```
- 时间范围（默认14d）
```
--limit, -n <n>
```
- 最大结果数量（默认25）
```
--sort <sort>
```
- 排序方式：date（日期）、new（最新）、priority（优先级）、freq（频率）、user（用户影响）
```
--json
```
- 输出原始JSON数据

查询语法示例：

is:unresolved             状态为未解决
is:assigned               已分配负责人
assigned:me               分配给当前用户
level:error               按级别筛选
firstSeen:+7d             首次出现时间超过7天
lastSeen:-24h             末次出现时间在24小时内
times_seen:>100           事件数量超过100
has:user                  包含用户上下文
error.handled:0           仅显示未捕获的错误

Search Logs

搜索日志

bash

./scripts/search-logs.js [query|url] [options]

Search for logs in Sentry's Logs Explorer.

Options:

```
--org, -o <org>
```
- Organization slug (required unless URL provided)
```
--project, -p <project>
```
- Filter by project slug or ID
```
--period, -t <period>
```
- Time period (default: 24h)
```
--limit, -n <n>
```
- Max results (default: 100, max: 1000)
```
--json
```
- Output raw JSON

Query Syntax:

level:error              Filter by level (trace, debug, info, warn, error, fatal)
message:*timeout*        Search message text with wildcards
trace:abc123             Filter by trace ID
project:my-project       Filter by project slug

Accepts Sentry URLs:

bash

./scripts/search-logs.js "https://myorg.sentry.io/explore/logs/?project=123&statsPeriod=7d"

bash

./scripts/search-logs.js [query|url] [options]

使用Sentry的日志资源管理器搜索日志。

可选参数：

```
--org, -o <org>
```
- 组织标识（如果提供了URL则可选）
```
--project, -p <project>
```
- 按项目标识或ID筛选
```
--period, -t <period>
```
- 时间范围（默认24h）
```
--limit, -n <n>
```
- 最大结果数量（默认100，上限1000）
```
--json
```
- 输出原始JSON数据

查询语法示例：

level:error              按级别筛选（trace、debug、info、warn、error、fatal）
message:*timeout*        通配符匹配日志消息内容
trace:abc123             按追踪ID筛选
project:my-project       按项目标识筛选

支持传入Sentry URL：

bash

./scripts/search-logs.js "https://myorg.sentry.io/explore/logs/?project=123&statsPeriod=7d"

Tips for Debugging

调试技巧

Start broad, then narrow down: Use
```
search-events.js
```
with a time range first, then drill into specific events
Use breadcrumbs: The
```
--breadcrumbs
```
flag on
```
fetch-event.js
```
shows the full history of what happened before an error
Look for patterns: Use
```
list-issues.js --sort freq
```
to find frequently occurring problems
Check related events: If you find one event, look for others with the same transaction name or trace ID
Tags are your friend: Custom tags like
```
thread_id
```
,
```
user_id
```
,
```
request_id
```
help correlate events

先宽泛搜索，再逐步缩小范围：先使用
```
search-events.js
```
指定时间范围进行搜索，再深入到特定事件
利用面包屑信息：
```
fetch-event.js
```
的
```
--breadcrumbs
```
参数可以显示错误发生前的完整操作历史
寻找规律模式：使用
```
list-issues.js --sort freq
```
查找高频出现的问题
查看关联事件：如果找到某个事件，可查找具有相同事务名称或追踪ID的其他事件
标签是好帮手：自定义标签如
```
thread_id
```
、
```
user_id
```
、
```
request_id
```
有助于关联相关事件