用途:通过 rollbar 命令行工具查询与管理 Rollbar 错误追踪,用于调查生产错误、为修复缺陷提供上下文,以及解决(resolve)问题项。
前置条件:需在环境中设置 ROLLBAR_ACCESS_TOKEN,或项目中存在 .rollbar.yaml 配置文件。解决项需要具有 write 作用域的项目访问令牌,若报权限错误说明令牌只有读权限。
主要能力与常用命令:
- 列出近期错误:rollbar items --since "8 hours ago" --level error,critical;可按环境筛选,如 --env production。
- 列出活跃问题:rollbar items --status active --limit 10。
- 调查单个错误:rollbar item 123 获取详情;rollbar context 123 获取用于修复的完整上下文(含堆栈、请求数据、浏览器、用户邮箱);rollbar context 123 --occurrences 5 包含多次近期发生记录。上下文可能包含异常类、消息与完整堆栈、请求 URL/方法/User-Agent、登录用户邮箱与 ID、服务器主机、分支与代码版本。
- 搜索错误:rollbar items --query "TypeError" --level error;可按环境与时间筛选,或按发生次数排序 rollbar items --sort occurrences --limit 10。
- 查看发生记录:rollbar occurrences --item 123 --limit 5;rollbar occurrence 453568801204 获取单次发生详情。
- 解决项:rollbar resolve 123;rollbar resolve 93 95 97;rollbar resolve --uuid 8675309。
输出格式:--output table(默认,可读表格)、--output json(完整 JSON)、--output compact 或 --ai(省 token,适合 AI 上下文)、--output markdown。
关键筛选标志:--level(debug、info、warning、error、critical)、--status(active、resolved、muted、any)、--env(如 production、staging)、--since(如 "8 hours ago"、"24h"、"7 days")、--query(标题文本搜索)、--sort(recent、occurrences、first-seen、level)、--limit(限制结果数)。
典型排查流程:先列出近期错误,查看标题与发生次数定位问题,再用 context 获取完整上下文并分析堆栈中的文件路径与行号,查看多次发生理解触发条件,修复部署后 resolve 该问题项。
限制:写入与解决操作需要写权限令牌;上下文中的各项字段仅在有数据时提供;该资料未说明其他配置、平台支持或收费情况。