KVS Factor Stats 指南
在单一管理界面查看 tKVS 关键因子的事前聚合小时级统计 — 容量、近期趋势、时效性和采样数据。
📋 概述
KVS Factor Stats 页面展示 tKVS 关键因子的事前聚合小时级统计。可查看各因子的数据量、近期趋势和时效性信息，帮助运维人员识别哪些因子在活跃报告、哪些可能已停止。数据来自事前聚合表 tKVSHourlyStat，因此即使是大规模 tKVS 数据集，页面也能快速加载。
⚠️ 此屏幕仅限管理员访问。 需要
uLevel >= 70的管理员级别。
🔍 页面布局
1. 顶部标题栏
- 页面标题/描述: "KVS Factor Stats"（本地化）+ 描述文字。
- 刷新按钮: 立即重新加载统计数据。数据不缓存（
useCache: false）。
2. 时效性提示
按钮下方提示："24小时以上无新数据的行将被高亮显示（可能是无效或过时的因子）。"
3. 数据表格
| 列 | 说明 |
|---|---|
| 因子名称 | kFactor 标识符 |
| 容量 | 聚合期间内的记录数 |
| 趋势 | 因子活动的近期方向 |
| 距上次时间 | 自最后数据报告以来的小时数（≥24小时时琥珀色高亮） |
| 采样 | 该因子的采样数据 |
- 琥珀色高亮:
hours_since_last >= 24的行会显示为琥珀色，表示潜在过时或无必要的因子。 - 排序: 通常按时效性（最旧的在前）或按容量排序。
💡 注意事项
- 不缓存: 页面有意使用
useCache: false以始终显示最新数据。如果页面加载慢，可能是pKvsHourlyStatBuild在首次访问时同步运行。 - 琥珀色 = 24小时+: 有
hours_since_last >= 24的因子可能是合法非活跃（如仅周末运行的进程）或确实已停止。请先调查关联的代理/脚本再标记为不必要。 - 事前聚合数据: 源表
tKVSHourlyStat由pKvsHourlyStatBuild构建。如果统计数据有误，请检查该存储过程是否按计划运行。
API 参考
| 命令 | 用途 | 后端存储过程 |
|---|---|---|
AdmKvsFactorStat | 获取事前聚合的 kFactor 小时级统计 | pApiAdmKvsFactorStatbyAk |
故障排除
| 症状 | 原因 | 解决方案 |
|---|---|---|
| 页面加载非常慢 | pKvsHourlyStatBuild 在长时间间隔后首次访问时同步运行 | 再次刷新 — 后续加载使用缓存聚合 |
| 所有行都呈琥珀色(24小时+) | 没有任何因子在报告 | 检查 tKVS 采集代理是否在运行 |
| 完全没有数据 | 存储过程可能失败或 tKVSHourlyStat 为空 | 检查存储过程日志和 tKVS 源数据 |
| "会话过期" / 401 | 认证令牌过期 | 重新登录 |
| 刷新后仍有陈旧行 | 因子实际上已停止报告 | 调查关联的代理/脚本 — 可能是已终止的工作进程 |
版本: 1.0
最后更新: 2026-08-14
源文件: giipv3/public/help/kvs-stats.zh-CN.md