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를 나타냅니다. 일반적인 컬럼:

컬럼	설명
팩터 이름	kFactor 식별자
볼륨	집계 기간 내 레코드 수
추세	팩터 활동의 최근 방향
마지막 이후 시간	마지막 데이터 보고 후 경과 시간 (24시간 이상 시 앰버 강조)
샘플	해당 팩터의 샘플 데이터

• 앰버 강조: hours_since_last >= 24인 행은 잠재적으로 임박하거나 불필요한 팩터를 표시하기 위해 앰버색으로 강조됩니다.
• 정렬: 일반적으로 임박도(가장 임박한 것부터) 또는 볼륨순으로 정렬됩니다.

🛠️ 사용 방법

1. 임박 팩터 식별: Hours Since Last가 24 이상인 앰버 강조 행을 찾으세요 — 이러한 팩터는 보고를 중단한 상태입니다.
2. 팩터 상태 확인: 정상적인 팩터는 최근 추세 데이터가 있고 Hours Since Last가 0에 가까워야 합니다.
3. 볼륨 검토: 비정상적으로 높거나 낮은 볼륨은 보고 에이전트에 문제가 있을 수 있습니다.
4. 새로고침 클릭하여 tKVSHourlyStat의 최신 데이터로 다시 로드합니다.

💡 참고사항

• 캐시 없음: 페이지는 항상 현재 데이터를 표시하기 위해 의도적으로 useCache: false를 사용합니다. 페이지 로드가 느리다면 pKvsHourlyStatBuild 집계가 처음 접근 시 동기적으로 실행되고 있을 수 있습니다.
• 앰버 = 24시간+ 임박: hours_since_last >= 24인 팩터는 합법적으로 비활성 상태일 수 있습니다(예: 주말에만 실행되는 프로세스). 불필요하다고 표시하기 전에 연결된 에이전트/스크립트를 조사하세요.
• 사전 집계 데이터: 소스 테이블 tKVSHourlyStat는 pKvsHourlyStatBuild로 빌드됩니다. 통계를 확인하세요.

API 레퍼런스

커맨드	목적	백엔드 SP
AdmKvsFactorStat	사전 집계된 kFactor 시간별 통계 조회	pApiAdmKvsFactorStatbyAk

• 응답은 parseToTableData로 헤더 + 행으로 파싱됩니다.
• RstVal = 200은 성공; RstVal = 401은 인증/세션 문제입니다.

트러블슈팅

증상	원인	해결책
페이지 로드가 매우 느림	긴 시간 접근이 없으면 pKvsHourlyStatBuild가 동기적으로 실행됨	다시 새로고침 — 이후 로드는 캐시된 집계를 사용
모든 행이 앰버(24시간+)	어떤 팩터도 보고하고 있지 않음	tKVS 수집 에이전트가 실행 중인지 확인
데이터가 전혀 없음	SP 실패 가능 또는 tKVSHourlyStat이 비어있음	SP 로그 및 tKVS 소스 데이터 확인
"세션 만료" / 401	인증 토큰 만료	다시 로그인
새로고침 후에도 임박 행	팩터가 실제로 보고를 중단함	연결된 에이전트/스크립트 조사 — 죽은 워커일 수 있음

---

버전: 1.0 최종 업데이트: 2026-08-14 소스 파일: giipv3/public/help/kvs-stats.ko.md