KVS Factor Stats ガイド

tKVS キー要因別の事前集計済み統計 — 管理者画面から事前に収集された統計データ。

🖥️ KVS Factor Stats ページへ →

📋 概要

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時間+: 正当な非アクティブ（例：週末のみプロセス）か、実際に停止しているかを確認してください。
• 事前集計データ: ソーステーブル tKVSHourlyStat は pKvsHourlyStatBuild でビルドされます。

APIリファレンス

コマンド	目的	バックエンドSP
AdmKvsFactorStat	事前集計済みkFactor時間別統計を取得	pApiAdmKvsFactorStatbyAk

トラブルシューティング

症状	原因	解決
ページロードが非常に遅い	pKvsHourlyStatBuild が初回アクセス時に同期実行	再度更新 — 以降のロードはキャッシュを使用
全行アンバー(24時間+)	全要因が報告していない	tKVS 取込みエージェントが実行中か確認
データ全くなし	SP失敗またはtKVSHourlyStatが空	SPログとtKVSソースデータ確認
更新後も陳旧行	要因が実際に報告を停止	関連するエージェント/スクリプトを調査

---

バージョン: 1.0 最終更新: 2026-08-14 ソースファイル: giipv3/public/help/kvs-stats.ja.md