用途:AppSignal CLI 用于从 AppSignal 拉取错误事件(incidents)与样本(samples),辅助调试和异常分析,适合排查报错、调查异常,或用户提到 AppSignal、incidents、error 等场景。
主要能力:可列出与查看错误事件、按状态(open、closed、wip)、命名空间(web、background、frontend)、日期(ISO 8601)和最小发生次数过滤;查看事件详情与回溯;导出为 markdown;管理事件(关闭、重开);列出与查看错误样本,包含 params、session、environment 等信息;查看和初始化配置。
使用方式:先确保设置 APPSIGNAL_TOKEN、APPSIGNAL_APP_ID 环境变量,或存在 .appsignal-cli.yaml 配置文件。常用命令:appsignal-cli incidents list;appsignal-cli incidents get <number>;appsignal-cli incidents list --state open --namespace web --since 2024-01-15 --min-occurrences 10;appsignal-cli --verbose incidents get <number>;appsignal-cli incidents export <number> -o error-report.md;appsignal-cli samples list --limit 10;appsignal-cli samples get <sample-id>;appsignal-cli incidents close <number>;appsignal-cli incidents reopen <number>。可加 --compact 减少输出 token,用 --json 获取结构化数据。
推荐调试步骤:列出事件找到相关错误,获取含回溯的事件详情,分析回溯定位根因,在代码库中找到相关代码,再基于错误上下文提出修复方案。
可用命令还包括 apps、config show、config init、config set <k> <v>。
限制:资料未说明价格、平台支持范围与速率限制等信息。