请求级缓存活动命中率
缓存命中或写入的请求中，实际命中已有缓存的比例。
命中请求数 ÷ 去重后的缓存活动请求数
OPERATIONS HOME
运行监控
查看日志导入、索引、数据库空间和最近处理状态。
只读监控 · 实时刷新
LIVE INGEST STATUS
实时队列 · 入库累计 · 数据库空间导入与索引状态
正在读取导入与索引状态…
SEARCH MODULES
检索模块
先选功能，再进入具体页面。事件检索只查已索引字段，临时搜索只做按路径扫描。
只读日志 · 模块入口
EVENT SEARCH
事件检索
在所有已索引日志源中快速定位字段值；结果不包含完整原始日志正文。
粘贴完整 NewAPI 请求 ID 时自动选择“等于”，将 ID 中的 UTC 时间换算为北京日期，优先按请求 ID + 存储日期查询索引；未命中再回退完整 ID 索引。默认“今天”不会限制这类请求 ID 查询，手动设置的时间范围仍按日志内容时间筛选。搜索 ID 片段请使用“包含”。
搜索进度
请选择字段并输入筛选值。
INDEX STATUS
事件概览
加载中…
AVAILABLE FIELDS
点击即可筛选
已提取字段
STREAM ANOMALY SEARCH
异常流式请求
筛选非下游用户主动中断的异常流式请求。当前按现有 request-log.json 信息使用保底识别方法。
只检查 response.response.body.json.events[*].event。值包含 content_block_start 或 message_start，且未完成协议收尾时，才列为异常。Anthropic 流必须出现 message_stop；仅有 message_delta.stop_reason=end_turn 不算完整收尾。content_block_stop 只是单个内容块结束。
搜索进度
请选择时间范围后开始筛选。
TEMP SEARCH
临时搜索 / 路径模板
按时间段和指定路径扫描原始日志，只用于临时定位，不进入默认检索字段。
增加条件时可选择与上一条按“且”或“或”组合，按从上到下计算；“字段不存在”无需填写值。临时搜索只读取原始日志，不修改日志或索引。识别到 request_id 时，仅将 ID 日期作为提示；未手动调整时间时忽略默认时间范围，以免漏掉跨日或缺少时间的日志。ID“等于”匹配可利用索引加速。
尚未发起临时搜索。
尚未发起临时搜索。
DATA ANALYTICS
数据分析
选择要查看的数据统计模块。后续新增统计能力时，会继续在这里扩展。
不读取、不修改原始日志
STATISTICS 01
命中率统计
按日志源、时间和模型查看缓存请求命中率。
进入统计 → STATISTICS 02自定义命中率
按自定义字段映射和保存的计算规则，独立分析命中与创建次数。
进入统计 →
STATISTICS 03
更多统计
后续可在此增加更多 Token、模型和趋势分析页面。
即将支持
等待开始分析
请选择筛选条件，然后点击“开始分析”。
METHOD 01
请求级请求级缓存活动命中率
发生缓存命中或写入的请求中，实际命中已有缓存的请求比例。
METHOD 02
窗口级5 分钟有效窗口命中率
按 user_id（缺失时使用同一事件的 X-Session-Id）+ model 分组；两个字段本身仍独立保存。
METHOD 03
Token 级Token 总量缓存命中率
不考虑 5 分钟窗口，按缓存命中 Token 与写入 Token 的总量计算。
METHOD 04
Token + 窗口5 分钟窗口 Token 命中率
沿用 5 分钟窗口，并排除每个窗口首次创建的 Token。
CALCULATION NOTES
统计方式说明
5 分钟窗口命中率
按 user_id（缺失时使用 X-Session-Id）+ model 分组，排除每个不连续窗口的首次创建。
窗口内命中数 ÷（窗口内命中数 + 窗口内写入数 − 首次创建数）Token 总量命中率
按缓存命中 Token 与写入 Token 的总量计算。
SUM(命中 Token) ÷（SUM(命中 Token) + SUM(写入 Token)）窗口 Token 命中率
应用 5 分钟窗口，并排除首次创建 Token。
窗口命中 Token ÷（窗口命中 Token + 窗口写入 Token − 首次创建 Token）CUSTOM HIT RATE
自定义命中率
使用独立的筛选条件、字段路径和已保存规则，直接读取范围内原始日志后计算。
原始日志只读
CUSTOM METHOD
可保存规则统计规则
字段路径直接从原始日志 JSON 结构填写；填写完成即可计算，保存规则仅用于下次快速复用。
填写统计项和计算流程后即可直接计算；保存规则仅用于后续复用。
EXTRACTION
字段提取
先指定要保留的业务字段名；渠道、用户、缓存 Token 等系统字段由程序自动维护，无需重复添加。
步骤 1 / 2
高级设置：仅在字段名不一致或自动提取失败时使用
API ACCESS
调用密钥
为外部系统创建独立密钥，通过请求 ID 下载原始日志。
正在加载调用密钥…
| 名称 | 密钥 | 状态 | 过期时间 | 最近调用 | 操作 |
|---|
还没有调用密钥
点击“创建密钥”，为每个调用系统设置独立名称。
时间均为北京时间
调用说明与示例
三种方式共用请求 ID 和调用密钥。先选择你需要的返回形式，再复制对应示例。
下载完整日志文件
application/zip需要保存、转发或归档日志时使用。所有匹配的原始日志会打包成一个 ZIP 文件。
GET
下载 ZIP · 只传请求 ID
调用结果-o logs.zip 将响应保存为压缩包。Apifox 中使用“发送并下载”，或发送后下载响应文件。
下载时指定渠道和日期
ZIP 下载 · 指定范围
把 AA 123 和 YYYY-MM-DD 换成真实值；不需要的参数行可以删除。JSON 和 HTML 方式也支持这些范围参数。
在响应中读取完整原文
application/json供程序、脚本或其他系统读取日志。响应中的 files 列出全部匹配文件，files[].content 是完整原文字符串。
GET
读取 JSON · 只传请求 ID
调用结果Apifox 点击“发送”，在响应 Body 中查看 files[].content。无需填写 -o，也无需设置 format。
查看 JSON 响应结构
{
"request_id": "REQUEST_ID",
"file_count": 1,
"lookup": "directory",
"date": "2026-09-28",
"files": [{
"source": "日志源名称",
"file_name": "request-log.json",
"path": "AA_123/2026-09-28/REQUEST_ID/request-log.json",
"size_bytes": 12,
"content": "{\"ok\":true}\n"
}]
}content 保留完整原文，包括未提取到索引的字段。引号和换行会正常转义；原文件是 JSON 时，可再解析 content。按行采集也会返回整个原文件。
像网页一样预览日志
text/html供人直接阅读。返回一份自带日志的独立 HTML 页面，支持格式化、行号、折叠和复制请求体，不会跳转到日志分析器后台。
GET
获取网页预览 · format=html
调用结果Query 增加 format=html。支持 HTML 的工具可预览响应；也可在命令末尾加 -o preview.html，保存后用浏览器打开。
打开 HTML 预览时需要注意什么
复制的 HTML 地址已包含 format=html，不用重复添加。请求仍需要下方的 Bearer 请求头，浏览器地址栏不会自动携带密钥。
获取并保存的页面已包含日志、样式和脚本，打开时无需再次登录或联网。禁用脚本的预览器显示完整原文；折叠和复制等交互需在支持脚本的浏览器中使用。
三种方式的通用设置
使用同一个调用密钥；GET 请求，Body 选 none。在 Headers 中填写：
Authorization
Bearer YOUR_KEY将 YOUR_KEY 替换为列表中“查看”得到的完整密钥，Bearer 后保留一个空格。
必填与可选参数 · request_id / channel / date / source
Apifox 在 Params → Query 中填写，参数名和值分列，不加引号。
request_id必填- 完整请求 ID，精确匹配。
channel可选- 渠道原名或目录名。
AA 123/AA_123均可；aws>>bon/aws__bon均可。 date可选- 日志目录日期，如
2026-09-28。不填时尝试从请求 ID 推算。 source可选- 网页配置的日志源名称。不填时检查所有日志源。
渠道和日期可都不填、只填一个或全填。填写正确的信息可以缩小范围；不确定就留空。显式日期只查这一天。
-H 设置请求头；--data-urlencode 传递 Query 参数并处理空格、+ 等字符；-o 将响应保存到文件。Apifox 不用填写这些命令参数。
查找规则与常见错误
- 未指定日期时，从请求 ID 前 14 位 UTC 时间换算北京日期，先检查各渠道的目标请求目录，不遍历其他请求。目录命中无需等待索引；未命中再查索引。自动日期无结果时可回退完整请求 ID 索引。
- 渠道按 NewAPI 命名规则转换，保留中文、大小写和连续下划线；手动指定日期后不会扩大日期范围。
400参数错误；401密钥无效、停用或过期；404没有匹配日志；410文件已删除或不可读取。JSON / HTML 另有409文件仍在写入，可重试；422非 UTF-8 文本，请使用 ZIP 下载。失败时统一返回 JSON。X-Log-Lookup显示查找方式，X-Log-Date显示限定日期。地址为127.0.0.1时，仅供服务所在电脑调用。
SOURCES & INDEXING
日志源
添加需要读取的目录和文件规则。保存后服务会持续监控新日志并自动入库，且不会修改原始日志。
步骤 2 / 2
日志目录默认使用部署配置中的容器入口 /var/log/input。通常无需再次填写；如只处理某个渠道，可填写该入口下的子目录。
新文件会在传输完成并稳定后自动提取入库。新增字段优先使用“仅补充新增字段”，只读取已有索引文件并合并缺失字段；任务支持暂停、继续和终止，终止后再次提交相同字段会从断点继续；“重新补充该字段”会在二次确认后从头开始。完整重建仅用于规则结构发生重大变化的情况。
FIELD BACKFILL
准备中
新增字段补充任务
0%
任务会在后台运行，刷新页面或重启服务后可继续查看。
DAILY RECONCILIATION
按北京时间执行
每日前一天路径核对
每天只检查执行时间对应的前一天日期目录。已在数据库登记的路径不会读取日志内容；只有发现数据库中没有的路径时，才会补录。
正在读取核对设置…
正在读取定时补扫设置…
NEWAPI COST LOOKUP
仅 root / admin 可见
NewAPI 消费查询设置
用于按 request_id 查询实际消费额度。管理员令牌只在服务端保存，保存后不会再回显到浏览器；留空表示不修改已保存的令牌。
正在读取 NewAPI 设置…
HISTORICAL PATH RECONCILIATION
同一时间仅执行一个任务
历史日志路径核对
按指定时间范围和日志内容中的渠道核对路径是否已录入数据库。只读取文件路径，不读取日志内容；发现遗漏后自动进入补录和失败重试流程。
核对任务任务记录保留一个月
正在读取任务…
ACCESS MANAGEMENT
用户管理
参考 NewAPI 的分级管理方式：先筛选用户，再执行明确、可追溯的账户操作。
角色权限由后端校验
开放自助注册
开启后，登录页允许注册普通用户；注册用户仅可检索和查看数据。
正在加载用户…禁用、降级或重置密码会立即撤销该用户的登录会话。
第 1 页