文档运行数据看板

数据看板

执行总量、成功率、token 用量与成本趋势 —— 账户级运行数据一页看全。

控制台的「执行分析」页把一段时间内的全部执行汇总成一块看板：四张 KPI 卡、执行趋势与耗时趋势两张折线图、执行状态分布环形图，以及按执行次数排序的 Top 工作流表。每天早上扫一眼，就能回答"昨天跑了多少、成没成、token 花在哪"。

打开看板与时间范围

入口在控制台侧边栏 → 执行分析。右上角可切换三档时间范围：24 小时（按小时聚合）、7 天、30 天（均按天聚合）。统计口径：执行的开始时间落在窗口内即计入，且只统计当前账号有权限看到的执行。

看板数据在浏览器侧有约 30 秒的短缓存，切换时间范围时命中缓存会立即渲染；点右上角的刷新按钮会跳过缓存直接拉最新数据。

四张 KPI 卡

指标	口径
总执行次数	窗口内的执行条数，运行中、失败、取消的都算
成功率	状态为 COMPLETED 的执行数 ÷ 总执行次数
平均耗时	已结束且有耗时记录的执行的平均运行时长
Token 总用量	窗口内所有执行的步骤事件里记录的 token 数累加（输入 + 输出）；K 为千，M 为百万

趋势图与状态分布

执行趋势 — 每个时间桶（小时或天）的执行次数折线，看业务节奏和突发峰值
平均耗时趋势 — 每个时间桶内执行的平均耗时（秒），耗时曲线慢慢抬头通常意味着上游接口变慢或工作流被加了步骤
执行状态分布 — 成功 / 失败 / 已取消的环形图，看整体健康度

Top 工作流

看板底部的表格按执行次数从高到低列出工作流，每行包含：执行次数、成功率（带颜色进度条）、平均耗时、最近执行时间、Token 用量。token 花在哪条工作流、哪条的成功率掉下来了，都从这张表先看。

成本核算口径

每次执行的成本是估算值，按执行事件里实际记录的 token 数计算：

text

成本 ≈ 输入 token × 输入单价 + 输出 token × 输出单价
（单价 = 美元 / 100 万 token，按模型查内置单价表）

单价来自平台内置的单价表，按每 100 万 token 的美元价计，输入和输出分开计价
单价表覆盖 Anthropic / OpenAI / Google / DeepSeek / Qwen / Mistral 等常见模型，模型名做模糊匹配
成本可逐步骤拆分：每个步骤的输入 / 输出 token 与对应估算金额单独列出

bash

# 单次执行的成本估算（含逐步骤拆分）
curl "https://braidrun.com/api/executions/<execution-id>/cost" \
  -H "Authorization: Bearer <token>"

json

{
  "executionId": "<execution-id>",
  "totalCostUsd": 0.0837,
  "modelName": "anthropic/claude-3.5-sonnet",
  "inputTokens": 12400,
  "outputTokens": 3100,
  "totalTokens": 15500,
  "stepCosts": [
    {"stepName": "fetch_data", "costUsd": 0.0, "inputTokens": 0, "outputTokens": 0},
    {"stepName": "daily_summary", "costUsd": 0.0837, "inputTokens": 12400, "outputTokens": 3100}
  ]
}

把估算当估算用

单价表内置在平台里，可能滞后于供应商调价；单价表未收录的模型按 0 计
BYOK 模式下实际扣费发生在您自己的供应商账户，对账以供应商账单为准
平台不提供运行前报价 —— 成本只在执行发生后按实际 token 记录计算

用 API 拉取同款数据

看板背后的聚合数据也可以直接请求，方便接入您自己的报表或告警：