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-TW.md