API 参考 / admin

搜索服务运行指标（平台超管）

GET /api/v1/admin/search/metrics · adminSearchMetrics

项目内搜索（GET /search）的 per-process 运行指标：查询计数、缓存命中与未命中、错误数、 结果行数、零结果查询数、延迟分位（P95/P99，基于环形窗口近似）、缓存命中率与零结果率。 单实例内存态，进程重启清零。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

adminSearchMetrics 即将上线

这个接口已经写进 API 合同，但还没有在本环境实现：现在调用会返回 501，不会有数据。合同与字段表可以照常用来预先对接，别把它排进正在跑的流程里。

响应字段 · 200

queries（必填）
integer —— 搜索请求总数（含缓存命中）。
cacheHits（必填）
integer —— 缓存命中的请求数。
cacheMiss（必填）
integer —— 缓存未命中、实际查库的请求数。
errors（必填）
integer —— 查询错误数。
resultRows（必填）
integer —— 累计返回的结果行数。
zeroResults（必填）
integer —— 实际查库后返回零结果的查询数。
latencyCount（必填）
integer —— 已采样的延迟样本数。
latencyP95Ms（必填）
integer —— 近似 P95 延迟（毫秒），基于环形窗口。
latencyP99Ms（必填）
integer —— 近似 P99 延迟（毫秒），基于环形窗口。
cacheHitRate（必填）
number —— 缓存命中率（cacheHits / (cacheHits + cacheMiss)）。
zeroResultRate（必填）
number —— 零结果率（zeroResults / cacheMiss）。

错误

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/search/metrics" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "queries": 1,
  "cacheHits": 1,
  "cacheMiss": 1,
  "errors": 1,
  "resultRows": 1,
  "zeroResults": 1,
  "latencyCount": 1,
  "latencyP95Ms": 1,
  "latencyP99Ms": 1,
  "cacheHitRate": 1,
  "zeroResultRate": 1
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…