Sentry 只读可观测性技能：快速集成监控与错误追踪，提升开发运维效率

sentry by openai/skills

398 周安装量

15,300 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/openai/skills --skill sentry

自动化开发运维监控

🇨🇳中文介绍

Sentry（只读可观测性）

快速开始

如果尚未认证，请要求用户提供有效的 SENTRY_AUTH_TOKEN（具有只读权限，例如 project:read、event:read），或在运行命令前登录并创建一个。
将 SENTRY_AUTH_TOKEN 设置为环境变量。
可选的默认值：SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。
默认值：组织/项目 {your-org}/{your-project}，时间范围，环境，限制 20（最大 50）。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

核心任务（使用捆绑脚本）

使用 scripts/sentry_api.py 进行确定性的 API 调用。它处理分页并在遇到瞬时错误时重试一次。

技能路径（设置一次）

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export SENTRY_API="$CODEX_HOME/skills/sentry/scripts/sentry_api.py"

用户作用域的技能安装在 $CODEX_HOME/skills 下（默认：~/.codex/skills）。

1) 列出问题（按最近排序）

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"

2) 将问题短 ID 解析为问题 ID

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

使用返回的 id 来获取问题详情或事件。

python3 "$SENTRY_API" \
  issue-detail \
  1234567890

python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20

5) 事件详情（默认不包含堆栈跟踪）

python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

始终使用以下端点（仅限 GET）：

列出问题：/api/0/projects/{org_slug}/{project_slug}/issues/
问题详情：/api/0/issues/{issue_id}/
问题的事件：/api/0/issues/{issue_id}/events/
事件详情：/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

org_slug、project_slug：默认为 {your-org}/{your-project}（避免非生产环境组织）。
time_range：默认 24h（作为 statsPeriod 传递）。
environment：默认 prod。
limit：默认 20，最大 50（分页直到达到限制）。
search_query：可选的 query 参数。
issue_short_id：首先通过 list-issues 查询解析。

输出格式化规则

问题列表：显示标题、short_id、状态、首次出现时间、最后出现时间、计数、环境、顶部标签；按最近排序。
事件详情：包含罪魁祸首、时间戳、环境、发布版本、URL。
如果没有结果，请明确说明。
在输出中编辑 PII（电子邮件、IP 地址）。不要打印原始堆栈跟踪。
切勿回显认证令牌。

组织：{your-org}
项目：{your-project}
问题短 ID：{ABC-123}

示例提示：“列出过去 24 小时内生产环境的 top 10 未解决问题。” 预期：包含标题、短 ID、计数、最后出现时间的排序列表。

🇺🇸English

Sentry (Read-only Observability)

Quick start

If not already authenticated, ask the user to provide a valid SENTRY_AUTH_TOKEN (read-only scopes such as project:read, event:read) or to log in and create one before running commands.
Set SENTRY_AUTH_TOKEN as an env var.
Optional defaults: SENTRY_ORG, SENTRY_PROJECT, SENTRY_BASE_URL.
Defaults: org/project {your-org}/{your-project}, time range 24h, environment prod, 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, and org:read.
Set SENTRY_AUTH_TOKEN as 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.

Core tasks (use bundled script)

Use scripts/sentry_api.py for deterministic API calls. It handles pagination and retries once on transient errors.

Skill path (set once)

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export SENTRY_API="$CODEX_HOME/skills/sentry/scripts/sentry_api.py"

User-scoped skills install under $CODEX_HOME/skills (default: ~/.codex/skills).

1) List issues (ordered by most recent)

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"

2) Resolve an issue short ID to issue ID

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

Use the returned id for issue detail or events.

3) Issue detail

python3 "$SENTRY_API" \
  issue-detail \
  1234567890

4) Issue events

python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20

5) Event detail (no stack traces by default)

python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

API requirements

Always use these endpoints (GET only):

List issues: /api/0/projects/{org_slug}/{project_slug}/issues/
Issue detail: /api/0/issues/{issue_id}/
Events for issue: /api/0/issues/{issue_id}/events/
Event detail: /api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

Inputs and defaults

org_slug, project_slug: default to {your-org}/{your-project} (avoid non-prod orgs).
time_range: default 24h (pass as statsPeriod).
environment: default prod.
limit: default 20, max 50 (paginate until limit reached).
search_query: optional parameter.

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.

Weekly Installs

398

Repository

openai/skills

GitHub Stars

15.3K

First Seen

Feb 1, 2026

Security Audits

Gen Agent Trust HubPass SocketWarn SnykWarn

Installed on

codex358

opencode335

gemini-cli328

github-copilot321

cursor309

amp307

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

100,500 周安装

issue_short_id: resolve via list-issues query first.