sentry-monitoring

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.

模式：认知/提示驱动 — 无独立实用脚本；需通过agent上下文使用。

Sentry Monitoring Skill

Sentry监控Skill

Overview

概述

Provides 90%+ context savings vs raw Sentry API calls. Progressive disclosure by feature category: error tracking, performance monitoring, release management, and project configuration.

与原生Sentry API调用相比，可节省90%以上的上下文信息。按功能类别逐步披露：错误追踪、性能监控、版本发布管理和项目配置。

Requirements

要求

Sentry account with project configured
```
SENTRY_AUTH_TOKEN
```
environment variable (optional, for authenticated API calls)
```
SENTRY_ORG
```
environment variable (optional, defaults to first organization)
```
SENTRY_PROJECT
```
environment variable (optional, defaults to first project)

已配置项目的Sentry账户
```
SENTRY_AUTH_TOKEN
```
环境变量（可选，用于已认证的API调用）
```
SENTRY_ORG
```
环境变量（可选，默认使用第一个组织）
```
SENTRY_PROJECT
```
环境变量（可选，默认使用第一个项目）

Tools (Progressive Disclosure)

工具（逐步披露）

Error Tracking

错误追踪

Tool	Description	Confirmation
list-issues	List recent issues/errors	No
issue-details	Get detailed issue info	No
resolve-issue	Mark issue as resolved	Yes
ignore-issue	Ignore/snooze issue	Yes

工具	描述	需确认
list-issues	列出近期问题/错误	否
issue-details	获取问题详细信息	否
resolve-issue	将问题标记为已解决	是
ignore-issue	忽略/暂缓处理问题	是

Performance Monitoring

性能监控

Tool	Description	Confirmation
list-transactions	List performance transactions	No
transaction-summary	Get transaction performance stats	No
slow-queries	Identify slow database queries	No

工具	描述	需确认
list-transactions	列出性能事务	否
transaction-summary	获取事务性能统计数据	否
slow-queries	识别慢速数据库查询	否

Release Management

版本发布管理

Tool	Description	Confirmation
list-releases	List releases	No
create-release	Create new release	Yes
set-commits	Associate commits with release	Yes

工具	描述	需确认
list-releases	列出版本发布记录	否
create-release	创建新版本	是
set-commits	将提交记录与版本关联	是

Project Configuration

项目配置

Tool	Description	Confirmation
list-projects	List Sentry projects	No
project-settings	View project settings	No
list-alerts	List alert rules	No

工具	描述	需确认
list-projects	列出Sentry项目	否
project-settings	查看项目设置	否
list-alerts	列出告警规则	否

Quick Reference

快速参考

bash

undefined

bash

undefined

List recent issues

curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/projects/$SENTRY_ORG/$SENTRY_PROJECT/issues/?query=is:unresolved"

Get issue details

curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/issues/{issue_id}/"

Resolve issue

curl -X PUT -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/issues/{issue_id}/"
-d '{"status": "resolved"}'

List transactions

curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/organizations/$SENTRY_ORG/events/?field=transaction"

Create release

curl -X POST -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/organizations/$SENTRY_ORG/releases/"
-d '{"version": "1.0.0", "projects": ["project-slug"]}'

List projects

curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/organizations/$SENTRY_ORG/projects/"

undefined

curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN"
"https://sentry.io/api/0/organizations/$SENTRY_ORG/projects/"

undefined

Configuration

配置

Environment Variables

环境变量

Variable	Required	Description
`SENTRY_AUTH_TOKEN`	Optional	Sentry authentication token for API calls
`SENTRY_ORG`	Optional	Organization slug (defaults to first org)
`SENTRY_PROJECT`	Optional	Project slug (defaults to first project)
`SENTRY_DSN`	No	For SDK integration (not used by this skill)

变量名	是否必填	描述
`SENTRY_AUTH_TOKEN`	可选	用于API调用的Sentry认证令牌
`SENTRY_ORG`	可选	组织slug（默认使用第一个组织）
`SENTRY_PROJECT`	可选	项目slug（默认使用第一个项目）
`SENTRY_DSN`	否	用于SDK集成（本Skill未使用）

Getting Auth Token

获取认证令牌

Navigate to Sentry Settings → Account → API → Auth Tokens
Create new token with scopes:
```
project:read
```
,
```
project:write
```
,
```
event:read
```

Set as environment variable:

export SENTRY_AUTH_TOKEN=your_token_here

导航至Sentry设置 → 账户 → API → 认证令牌
创建新令牌，权限范围：
```
project:read
```
,
```
project:write
```
,
```
event:read
```

设置为环境变量：

export SENTRY_AUTH_TOKEN=your_token_here

Security

安全

⚠️ Never expose auth tokens in output ⚠️ Destructive operations (resolve-issue, ignore-issue, create-release, set-commits) require confirmation ⚠️ Use environment variables for credentials, never hardcode

⚠️ 切勿在输出中暴露认证令牌 ⚠️ 破坏性操作（resolve-issue、ignore-issue、create-release、set-commits）需要确认 ⚠️ 使用环境变量存储凭证，切勿硬编码

Agent Integration

Agent集成

devops (primary): Production monitoring, incident response
incident-responder (primary): Error triage, issue resolution
developer (secondary): Debugging, performance optimization
qa (secondary): Test environment monitoring

devops（主要）：生产环境监控、事件响应
incident-responder（主要）：错误分类、问题解决
developer（次要）：调试、性能优化
qa（次要）：测试环境监控

Error Handling

错误处理

If tool execution fails:

Verify

SENTRY_AUTH_TOKEN

is set:

echo $SENTRY_AUTH_TOKEN

Check token permissions include required scopes
Verify organization and project slugs are correct
Review Sentry API rate limits (default: 3000 requests/minute)

如果工具执行失败：

验证

SENTRY_AUTH_TOKEN

已设置：

echo $SENTRY_AUTH_TOKEN

检查令牌权限是否包含所需范围
验证组织和项目slug是否正确
查看Sentry API速率限制（默认：3000请求/分钟）

Common Workflows

常见工作流

Incident Response

事件响应

```
list-issues
```
- Get recent unresolved errors
```
issue-details
```
- Investigate specific issue
```
resolve-issue
```
- Mark as resolved after fix deployed

```
list-issues
```
- 获取近期未解决的错误
```
issue-details
```
- 调查特定问题
```
resolve-issue
```
- 修复部署后标记为已解决

Performance Optimization

性能优化

```
list-transactions
```
- Identify slow endpoints
```
transaction-summary
```
- Analyze performance patterns
```
slow-queries
```
- Find database bottlenecks

```
list-transactions
```
- 识别慢速端点
```
transaction-summary
```
- 分析性能模式
```
slow-queries
```
- 查找数据库瓶颈

Release Management

版本发布管理

```
create-release
```
- Create new release version
```
set-commits
```
- Associate commits with release
```
list-releases
```
- Track release health

```
create-release
```
- 创建新版本号
```
set-commits
```
- 将提交记录与版本关联
```
list-releases
```
- 跟踪版本发布健康状态

Troubleshooting

故障排除

Issue	Solution
401 Unauthorized	Check `SENTRY_AUTH_TOKEN` is valid and not expired
403 Forbidden	Verify token has required scopes (project:read, project:write, event:read)
404 Not Found	Verify `SENTRY_ORG` and `SENTRY_PROJECT` are correct slugs
Rate limit exceeded	Wait 1 minute, reduce request frequency

问题	解决方案
401 Unauthorized	检查 `SENTRY_AUTH_TOKEN` 是否有效且未过期
403 Forbidden	验证令牌是否包含所需权限范围（project:read, project:write, event:read）
404 Not Found	验证 `SENTRY_ORG` 和 `SENTRY_PROJECT` 是否为正确的slug
Rate limit exceeded	等待1分钟，降低请求频率

Memory Protocol (MANDATORY)

内存协议（强制）

Before starting: Read

.claude/context/memory/learnings.md

After completing:

New pattern ->
```
.claude/context/memory/learnings.md
```
Issue found ->
```
.claude/context/memory/issues.md
```
Decision made ->
```
.claude/context/memory/decisions.md
```

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.

开始前： 读取

.claude/context/memory/learnings.md

完成后：

新模式 →
```
.claude/context/memory/learnings.md
```
发现问题 →
```
.claude/context/memory/issues.md
```
已做决策 →
```
.claude/context/memory/decisions.md
```

假设中断：如果未记录在内存中，则视为未发生。

sentry-monitoring

Original

Translation

Sentry Monitoring Skill

Sentry监控Skill

Overview

概述

Requirements

要求

Tools (Progressive Disclosure)

工具（逐步披露）

Error Tracking

错误追踪

Performance Monitoring

性能监控

Release Management

版本发布管理

Project Configuration

项目配置

Quick Reference

快速参考

List recent issues

List recent issues

Get issue details

Get issue details

Resolve issue

Resolve issue

List transactions

List transactions

Create release

Create release

List projects

List projects

Configuration

配置

Environment Variables

环境变量

Getting Auth Token

获取认证令牌

Security

安全

Agent Integration

Agent集成

Error Handling

错误处理

Common Workflows

常见工作流

Incident Response

事件响应

Performance Optimization

性能优化

Release Management

版本发布管理

Troubleshooting

故障排除

Related

相关链接

Memory Protocol (MANDATORY)

内存协议（强制）