用途 sentry-cli 用于从命令行操作 Sentry，涵盖问题与事件查看、追踪与性能分析、日志流式查看、发布管理、看板组件配置、文档查询、API 架构浏览以及直接调用 API 等任务。该页面是使用指南，说明如何通过这些命令与 Sentry 交互。
主要能力
- 问题与事件：sentry issue list、sentry issue view 可列出和查看问题，支持一次传入多个问题 ID，并可通过 --json 输出机器可读结果，或用 --fields 只取需要的字段。sentry issue explain 与 sentry issue plan 提供 AI 根因分析与修复计划。
- 追踪与性能：sentry trace list、sentry trace view、sentry span list、sentry trace logs 用于查看追踪、跨度树及关联日志。
- 日志：sentry log list 支持 --follow 实时流式查看，支持按严重级别过滤及 RE2 正则匹配（格式 key://pattern//）。
- 本地事件捕获（Spotlight）：sentry local run 可在本地启动服务并追踪错误、追踪与日志；无 DSN 时事件只发往本地服务，不消耗生产配额。
- 发布管理：sentry release create、set-commits（--auto/--local）、finalize、deploy，版本需与 SDK 中 release 值一致。
- 看板：sentry dashboard widget add 支持按 6 列网格布局配置组件，提供 big_number、line、area、bar、table 等显示类型及 spans、errors、metrics、issue、logs 数据集。
- 其他：sentry docs 查询文档、sentry schema 浏览 API、sentry status 查看服务状态、sentry api 以类 curl 方式直接请求、sentry agent-conversation 查看代理会话、sentry wasm-split 处理 WebAssembly 模块。
使用方式 直接运行命令即可，CLI 会通过 .sentryclirc、环境变量中的 DSN、源码中的 DSN 及目录名自动检测组织与项目；仅在无法检测或检测错误时显式传入 <org>/<project>。使用 --json 输出便于管道处理，配合 jq 过滤；--limit 控制结果数量；-w/--web 在浏览器打开资源。认证由 CLI 自动管理，缺失或过期时会提示登录，可用 sentry auth login 添加账号、sentry auth switch 切换账号。
适用场景 适合开发者与 AI 编码代理在终端中快速调查线上问题、分析性能追踪、流式查看日志、管理版本发布、配置监控看板，以及查询 Sentry 文档和 API。
限制与安全 破坏性命令（如 project delete、trial start）需先经用户确认；变更操作后应核对输出中的组织与项目上下文；不得存储或记录认证令牌。CLI 使用语义化退出码：0 成功，10–19 认证错误，20–29 输入错误，30–39 API 错误，40–49 功能不可用，50–59 操作错误，60–69 命令特定错误。问题应使用 PROJECT-123 短 ID，而非数字 ID。其他未在资料中说明的功能、收费与平台支持情况暂未提供。