ThinkWheel Docs
接入指南

应用统计

查看应用调用量、成功率、失败次数、平均耗时与每日能力用量。

在控制台左侧选择「应用统计」,查看当前账号创建的应用。统计列表包含应用名称、状态、调用量、成功率、失败次数和平均耗时;点击「详情」在右侧抽屉按天、按模型查看单次调用流水。

支持最近 7 天、最近 30 天与自定义日期(最多 366 天)。日期范围、页码保存在 URL 中,刷新或浏览器前进、后退时可恢复。详情抽屉通过页面状态控制,打开、关闭不会修改 URL,刷新后保持关闭。

统计口径

  • 按北京时间自然日统计,包含起止日期,按请求开始时间归属日期。
  • 有效 Access Key 能识别到应用的调用会记录,包括应用停用、未绑定能力等校验失败。无效密钥无法归属应用,不进入应用统计。
  • 成功:HTTP 状态码为 2xx 且响应完整结束。HTTP 2xx 内的业务错误或 SSE 事件中的业务错误不会被解析为失败。
  • 失败次数:总调用量减成功次数,包含权限拒绝、上游 HTTP 错误、超时、连接中断或客户端提前断开。
  • 平均耗时:所有已结束请求的总耗时平均值,包含鉴权、上游响应及传输时间;SSE 统计完整流传输耗时,不是首 Token 延迟。
  • 统计从该功能上线后开始采集,历史调用无法补算。正在进行的 SSE 请求结束后才进入统计,刷新可查询最新数据。
  • 无调用的应用仍显示在列表中,成功率与平均耗时显示为「—」。已删除应用不再出现在统计列表。

权限与记录内容

仅当前应用所有者可查看其统计,不能通过修改应用 ID 读取其他账号的数据。记录仅包含应用 ID、用户 ID、能力 model、开始时间、耗时、HTTP 状态码及成功标记,不保存 Access Key 或上游密钥。失败调用另外保存限长、脱敏后的 JSON/查询参数和失败原因,不保存完整响应正文。

统计写入异常不会中断能力响应,服务端会记录告警。当前为直接写入数据库的统计方案,异常期间可能漏记,不作为计费依据。

管理接口

以下接口使用统一登录会话或管理接口的 Bearer 登录凭证,不使用应用 Access Key。

  • GET /api/statistics/applications?start=2026-09-01&end=2026-09-07&page=1:当前账号的应用统计列表,每页 10 条。
  • GET /api/statistics/applications/{applicationId}?start=2026-09-01&end=2026-09-07:应用汇总、逐日数据和各 model 用量。

省略日期时默认最近 7 天,详情会为没有调用的日期补零。

首页概览

控制台首页展示当前账号的应用总数、启用数量,以及最近 7 天或 30 天的调用量、成功率、失败次数、平均耗时、每日趋势和各能力用量。应用数量是当前状态,调用指标受日期范围影响。汇总覆盖所有现存应用,不受统计列表分页影响。点击「查看应用统计」可继续按应用查看详情。

首页数据接口为 GET /api/statistics/applications/overview?start=2026-09-01&end=2026-09-07,使用与统计列表相同的登录认证和日期校验。

单次调用流水

应用详情默认展示今天、全部模型的调用流水。支持今天、昨天、指定日期和模型筛选,切换立即查询并返回第一页,不修改 URL。顶部仅展示当前筛选下的调用、成功、失败次数;表格按最新调用倒序,每页 10 条,包含流水编号、北京时间、模型、结果、状态码和耗时。模型选项来自该应用的历史调用,便于查看已解绑模型的历史记录。成功调用不保存请求正文。失败调用可点击「失败详情」查看限长、脱敏后的 JSON/查询参数和失败原因。

接口:GET /api/statistics/applications/{applicationId}/calls?start=2026-09-01&end=2026-09-07&page=1&model=deepseekV4Pro。省略 model 查询全部模型。仅应用所有者可查询,页码从 1 开始。状态码 499 表示响应未完整结束,可能是客户端或上游连接中断。

失败调用排查

在调用流水中点击失败行的「失败详情」,可查看权限拒绝、上游 HTTP 错误、连接失败或超时原因,以及调用方原始 JSON 和查询参数(不会展示平台替换后的上游模型配置)。只允许应用所有者查询,接口为 GET /api/statistics/applications/{applicationId}/calls/{callId}。

仅新采集的失败调用包含这些字段;历史记录显示未采集。请求体超过 16KB、无效 JSON、非 JSON 或请求未完整读取时不保存正文,并展示说明。嵌套凭证字段与可识别的密钥会脱敏,字符串、数组及嵌套深度受限,因此排查需要完整参数时请结合调用端记录。上游错误仅提取限长的 JSON 错误说明,非 JSON 错误响应仅显示 HTTP 状态,不保存整页内容。

On this page