KVS Factor 목록 가이드
프로젝트에 저장된 KVS(키-값 저장소) factor 항목을 조회하고, 각 factor의 상세 이력이나 최신 값으로 바로 이동하는 방법을 안내합니다.
📋 개요
KVS Factor 목록 페이지는 선택한 프로젝트(CSN)에 기록된 factor 항목들을 한 화면에서 조회하는 도구입니다. 에이전트가 수집한 메트릭·인벤토리·프로세스 등 다양한 factor를 목록으로 확인하고, 각 항목의 이력 또는 최신 값 페이지로 곧바로 이동할 수 있습니다. 접속 시 로그인이 필요합니다.
🔍 화면 구성
1. 프로젝트 선택 (CSN)
상단의 드롭다운에서 조회 대상 프로젝트를 선택합니다. 목록은 로그인한 계정이 접근할 수 있는 프로젝트로 자동 채워지며, 세션에 저장된 프로젝트가 있으면 기본으로 선택됩니다.
2. 실행 (Run)
[Run] 버튼을 누르면 선택한 프로젝트에 대해 KVSFactorList * <csn> 명령이 실행됩니다. *는 특정 kType으로 제한하지 않고 모든 유형의 factor를 조회한다는 의미입니다. 조회 중에는 버튼이 Loading... 상태가 됩니다.
3. 결과 목록
결과는 표(데스크톱) 또는 카드(모바일) 형태로 표시됩니다. 일반적으로 kType(키 유형), kKey(서버 LSSN 또는 DB ID), kFactor(데이터 분류명) 컬럼이 포함됩니다. 데이터를 표로 해석할 수 없는 경우 원본 응답 텍스트가 그대로 표시됩니다.
4. 행 이동 버튼
factor 컬럼에는 두 개의 이동 버튼이 함께 표시됩니다.
- [List]: 해당 행의 kType·kKey·kFactor를 세션에 저장한 뒤 **KVS 목록 페이지(
/ko/kvslist)**로 이동하여 이력 목록을 확인합니다. - [Last]: kType·kKey·kFactor를 쿼리 파라미터로 넘겨 **최신 값 페이지(
/ko/kvslast)**로 이동합니다.
🛠️ 활용 팁
- 프로젝트를 변경하면 선택 값이 세션에 저장되어 다른 KVS 페이지에서도 유지됩니다.
- kType·kKey 정보가 없는 옛 데이터의 경우 시스템이
lssn을 기본 유형으로 간주하여 이동을 처리합니다.
💡 유의 사항
- 결과가 비어 있다면 선택한 프로젝트에 아직 기록된 factor가 없거나 프로젝트가 잘못 지정되었을 수 있습니다.
- 이 페이지는 조회 전용입니다. factor 데이터 기록(KVSPut)에 대해서는 아래 API 참조를 확인하세요.
API 참조
이 기능의 기반이 되는 KVS API 상세 사양은 별도 가이드를 참조하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| 로그인 화면으로 돌아감 | 세션이 만료되었거나 인증되지 않음 | 다시 로그인한 뒤 페이지에 접속합니다. |
| 프로젝트 드롭다운이 비어 있음 | 접근 가능한 프로젝트가 조회되지 않음 | 로그인 상태와 계정 권한을 확인하고 페이지를 새로고침합니다. |
결과가 No results.로 표시됨 | 선택한 프로젝트에 기록된 factor가 없음 | 프로젝트를 올바르게 선택했는지 확인하고, 먼저 KVSPut으로 데이터를 기록합니다. |
| 결과가 표가 아닌 원본 텍스트로 표시됨 | 응답을 표 형식으로 해석할 수 없음 | 응답 내용을 확인하고, 데이터 형식이 올바른지 점검합니다. |
| [List]/[Last] 이동 후 데이터가 비어 있음 | 옛 데이터라 kType/kKey가 없어 기본값으로 처리됨 | 대상 factor를 다시 기록하거나 kKey 값을 확인합니다. |
버전: 1.0
최종 업데이트: 2026-07-22
소스 파일: giipv3/public/help/kvsfactorlist.ko.md