用途:Flare CLI 让用户在终端管理 Flare 的错误追踪与性能监控,每个 Flare API 端点都有对应命令。
安装与认证:用 flare --version 检查是否安装;未安装则运行 composer global require spatie/flare-cli,并确保 Composer 全局 bin 目录在 PATH 中。flare login 为交互式,建议用户自行运行,不要在智能体会话中驱动。默认浏览器 OAuth(PKCE),可用 --name 指定连接名;无头/SSH 环境用 --device 设备码流程;自动化/CI 可用 --token 粘贴个人访问令牌。令牌可在 https://flareapp.io/account/api-access 生成。凭据按 OAuth 发行方与 API 基址存于 ~/.flare/config.json,API 基址由 FLARE_BASE_URL 决定,默认 https://flareapp.io/api。
主要能力:用户与团队(get-authenticated-user、get-team、remove-team-user);项目(list-projects、create-project、delete-project);错误(list-project-errors 支持按状态、异常类、文件、阶段、级别过滤与排序,get-project-error-count、get-project-error-occurrence-count);错误操作(resolve-error、unresolve-error、snooze-error 支持永久、指定日期或指定次数,unsnooze-error);发生记录(list-error-occurrences、get-error-occurrence);性能监控(get-monitoring-summary、list-monitoring-aggregations、get-monitoring-time-series、get-monitoring-aggregation、list-aggregation-traces、get-trace)。--type 支持 routes、queries、jobs、commands、external-http、views、livewire-components;--filter-interval 支持 1h、3h、6h、24h(默认)、48h、7d、14d。
使用方式:所有命令输出 JSON,列表命令支持 --page-number 与 --page-size 分页,响应含 meta 与 links。常见流程包括错误分类处理、结合本地代码调试错误、排查慢性能、创建项目并获取 API 密钥。展示结果时建议:错误用表格并附 latest_occurrence_url_on_flare;发生记录突出 application_frame 为 true 的应用帧;solutions 非空时优先展示;attributes 按 group 分组;events 按时间顺序展示;监控聚合用表格并突出高 p95 或高错误率;trace 按层级展示 span 树并突出耗时最长者。
限制:flare login 为交互式,不适合在智能体会话中自动执行;离线清理用 flare logout --local-only 可能使远程 OAuth 连接仍处于活动状态。其余细节暂未提供。