KVS 어드바이스 목록 가이드
프로젝트(CSN) 단위로 수집된 KVS 데이터에 대한 어드바이스(진단·분석) 목록을 조회하고, 각 항목의 상세 내용과 권고 사항을 확인하는 방법을 안내합니다.
📋 개요
KVS 어드바이스 목록은 에이전트가 KVS(Key-Value Store)에 기록한 factor 데이터를 기반으로 생성된 진단·권고(어드바이스) 항목을 프로젝트(CSN) 단위로 모아 보여주는 화면입니다. 각 어드바이스는 어떤 서버(kaKey)의 어떤 factor(kaFactor)에 대한 분석인지 함께 표시되며, 클릭 한 번으로 원본 데이터나 서버 상세로 이동할 수 있습니다.
이 페이지는 로그인이 필요합니다. 접근 시 인증되지 않은 경우 로그인 화면으로 이동합니다.
🚀 시작하기 — CSN 입력
화면 상단의 CSN 입력란에 조회할 프로젝트의 CSN을 입력합니다. CSN은 세션에 저장되어 다음 접속 시 자동으로 채워집니다.
- CSN이 설정되면
KVSAdvList csn명령이 자동 실행되어 해당 프로젝트의 어드바이스 목록을 불러옵니다. - 목록은 등록 일시(kaRegdt) 내림차순(최신순)으로 정렬됩니다.
- 조회 중에는 상단에 로딩 표시가 나타납니다.
🔍 목록 컬럼 설명
| 컬럼 | 설명 |
|---|---|
kasn | 어드바이스 레코드의 고유 번호 (KVS Advice Serial Number) |
ksn | 어드바이스가 참조하는 원본 KVS 레코드 번호 |
kaKey | 대상 키 값(서버 LSSN 등). 클릭하면 해당 서버 상세로 이동합니다. |
kaFactor | 대상 factor 분류명(예: netstat, processlist, sqlnetinv). 클릭하면 관련 데이터 화면으로 이동합니다. |
kaRegdt | 어드바이스 등록 일시 |
kaStatus | 어드바이스 상태 |
Action | [상세]·[어드바이스] 버튼 |
데스크톱에서는 표 형태, 모바일에서는 카드 형태로 동일한 항목이 표시됩니다.
🔗 링크로 이동하기
- kaKey 클릭:
/ko/lsvrdetail?id=<kaKey>— 대상 서버의 상세 페이지로 이동합니다. - kaFactor 클릭:
- factor가
sqlnetinv인 경우 →/ko/sql3d?kasn=...&kaf=...&kKey=...(SQL 3D 뷰) - 그 외의 factor →
/ko/kvslist?kasn=...&kaf=...(해당 factor의 KVS 목록)
- factor가
🛠️ 액션 버튼
1. 상세 (Details)
선택한 어드바이스의 전체 필드를 모달로 보여줍니다. kasn, ksn, kaType, kaKey, kaFactor, 어드바이스 본문(kaAdvText, 마크다운 렌더링), kaRegdt, kaStatus, kValue(원본 값)를 확인할 수 있습니다.
2. 어드바이스 (Advice)
넓은 모달에서 어드바이스 본문(kaAdvText)을 마크다운으로 렌더링해 보여줍니다. 본문에는 추정 원인(likely_root_causes), 제안(suggestions), 권고(recommendations), 추가 점검(additional_checks) 등의 구조화된 섹션이 포함될 수 있으며, 읽기 쉬운 목록 형태로 정리되어 표시됩니다.
💡 유의 사항
- 목록이 비어 있으면 "No advices found for this CSN"(해당 CSN에 어드바이스 없음)이 표시됩니다. CSN 값이 올바른지 확인하세요.
- 어드바이스는 KVS에 factor 데이터가 기록되어 있어야 생성됩니다. 원본 데이터 기록 방법은 KVS API 가이드를 참조하세요.
API 참조
이 페이지가 다루는 데이터의 기록·조회 API 상세는 별도 가이드를 참조하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
목록이 비어 있음(No advices found) | 입력한 CSN에 어드바이스가 없거나 CSN 값이 잘못됨 | CSN 값을 확인하고, 해당 프로젝트에 factor 데이터가 기록되었는지 점검합니다. |
| 로그인 화면으로 이동됨 | 세션이 만료되었거나 인증되지 않음 | 다시 로그인한 뒤 페이지에 접근합니다. |
| kaFactor 클릭 시 예상과 다른 화면으로 이동 | factor가 sqlnetinv이면 SQL 3D 뷰, 그 외에는 KVS 목록으로 분기됨 | 정상 동작입니다. factor 종류에 따라 이동 대상이 다릅니다. |
| 어드바이스 본문이 비어 있음 | 해당 항목의 kaAdvText가 아직 생성되지 않음 | 원본 factor 데이터 기록 후 어드바이스 생성 여부를 확인합니다. |
버전: 1.0
최종 업데이트: 2026-07-22
소스 파일: giipv3/public/help/kvsadvlist.ko.md