@gajae-code/数据
AI使用统计的本地可观察仪表板.
特征
- 会话日志解析:从
~/.gjc/agent/sessions/ - SQLite 聚合: 使用高效数据存储和查询
bun:sqlite - 网络仪表板: 图.js的实时可视化计量
- 递增同步: 只处理新/已修改的日志条目
- 角色使用细分数字 :
gjc stats --summary和 JSON 报告默认使用、执行者、规划者、建筑师和评论家;没有身份元数据的自定义角色和遗留会议归为other或者说unknown
跟踪到的量子
| 度量衡 | 计算 |
|---|---|
| 键/秒 | output_tokens / (duration / 1000) |
| 缓存率 | cache_read / (input + cache_read) * 100 |
| 错误率 | count(stopReason=error) / total_calls * 100 |
| 费用共计 | 总计 usage.cost.total |
| Avg 纬度 | 平均值 duration |
| TTFT 电话 | 平均值 ttft (时间到第一令牌) |
使用量
通过 CLI
# Start dashboard server (default: http://localhost:3847)
gjc stats
# Custom port
gjc stats --port 8080
# Print summary to console
gjc stats --summary
# Output as JSON (for scripting)
gjc stats --json
程序化
import { getDashboardStats, syncAllSessions } from "@gajae-code/stats";
// Sync session logs to database
const { processed, files } = await syncAllSessions();
// Get aggregated stats
const stats = await getDashboardStats();
console.log(stats.overall.totalCost);
console.log(stats.byModel[0].avgTokensPerSecond);
console.log(stats.byAgent.find(agent => agent.agent === "executor")?.totalCost);
API 终点
标记终点 范围 接受 ?range=1h|24h|7d|30d|90d|all (默认) 24h; 未知值会回到 24h) (中文(简体) ). 时间序列使用小时桶 1h 财务报告和审定财务报表 24h 和长距离的日用桶.
| 终点 | 说明 |
|---|---|
GET /api/stats | 全数 DashboardStats 对象:总体情况、失败情况、每个模型/文件夹/代理件的分解情况、时间、模型、模型性能和成本序列,以及缓存缺失的归属(范围(中文(简体) ) |
GET /api/stats/overview | overall 财务报告和审定财务报表 timeSeries 仅限(范围(中文(简体) ) |
GET /api/stats/models | 按要求统计的每个模型统计(范围(中文(简体) ) |
GET /api/stats/model-dashboard | byModel, (中文(简体) ), modelSeries,以及 modelPerformanceSeries (单位:千美元)范围(中文(简体) ) |
GET /api/stats/folders | 每个文件夹/项目统计(范围(中文(简体) ) |
GET /api/stats/timeseries | 请求、错误、符号和每桶时间成本(范围(中文(简体) ) |
GET /api/stats/costs | 每个模型和供应商的每日费用,分为投入/产出/包范围(中文(简体) ) |
GET /api/stats/behavior | 用户信息行为信号(大叫、放屁、重复等):整体而言,每个模型,并随着时间推移(范围(中文(简体) ) |
GET /api/stats/recent | 最近的请求,最先?limit=,默认 100) |
GET /api/stats/errors | 最近以出错停止的请求( E)?limit=,默认 100) |
GET /api/request/:id | 一份请求及其存储的信息和输出; 404 如果未知,则 |
POST /api/sync | 同步会话文件并返回 { processed, files, totalMessages }· ; 409 当同步已经运行时 |
本地服务器安全
仪表盘只绑住 127.0.0.1; CLI 打开默认浏览器 URL localhost。API 请求必须使用 HTTP, 服务器的实际端口, 并且准确无误 localhost 或者说 127.0.0.1。浏览器请求必须保持同一来源,会话同步需要同一来源 POST 请求。 服务器无法启用跨源访问或信任转发主机头 .
反向代用和不回放部署是不支持的. 它们需要单独的经过认证的部署边界,而不是放松这些仅在当地进行的检查.
数据存储
- 会话日志数字 :
~/.gjc/agent/sessions/(JSONL档案) - 数据库数字 :
~/.gjc/stats.db(SQLite) (英语)
盘子
网络仪表板提供:
- 总的衡量卡(要求、成本、缓存率、出错率、持续时间、信使)
- 显示请求和长期错误的时间序列图表
- 按模型分列的表格
- 每个文件夹的细分表
- 每30秒自动刷新一次
提示常见模式( C)
同步并打印摘要
每个 gjc stats 引用同步会话文件后再做其他任何事情,所以没有单独的同步旗.
gjc stats --summary
JSON 脚本输出
与 --json,stdout只载有 JSON 文件;同步进度和 Synced N new entries ... 摘要转到 stderr .
gjc stats --json | jq '.overall.totalCost'
在自定义端口上的 Dashboard
gjc stats --port 3000
--summary 财务报告和审定财务报表 --json 打印并退出而不启动服务器, 因此 --port 与它们结合时没有效果.
程序: 费用最高的文件夹
import { getDashboardStats, syncAllSessions } from "@gajae-code/stats";
await syncAllSessions();
const stats = await getDashboardStats();
const [first, ...rest] = stats.byFolder;
if (first) {
const topFolder = rest.reduce((a, b) => (b.totalCost > a.totalCost ? b : a), first);
console.log(`Highest cost folder: ${topFolder.folder} ($${topFolder.totalCost.toFixed(2)})`);
} else {
console.log("No folder data available");
}
程序:最需要的模型
import { getDashboardStats, syncAllSessions } from "@gajae-code/stats";
await syncAllSessions();
const stats = await getDashboardStats();
// byModel is ordered by request count, highest first.
const topModel = stats.byModel[0];
if (topModel) {
console.log(`Most requested model: ${topModel.model} (${topModel.totalRequests} requests)`);
}
解决问题
- 没有显示数据吗? 检查此会话日志是否存在于
~/.gjc/agent/sessions/(单位:千美元)~/<GJC_CONFIG_DIR>/agent/sessions/如果设置了变量). 有习惯GJC_CODING_AGENT_DIR,会话在$GJC_CODING_AGENT_DIR/sessions/否则,在Linux和macOS上,如果XDG_DATA_HOME设置和$XDG_DATA_HOME/gjc存在( 创建于gjc config init-xdg页:1$XDG_DATA_HOME/gjc/sessions/。这些变量必须来自您的外壳环境。 一个项目.env无法设置,如果.env条目用途$扩展它也会阻断 shell 值;在两种情况下都适用默认路径. - 达克板没有开始吗? 请检查access-date=中的日期值 (帮助) 端口 3847(或通过端口
--port)是免费的.
许可证
麻省理工学院