KVS 어드바이스 목록 가이드

프로젝트(CSN) 단위로 수집된 KVS 데이터에 대한 어드바이스(진단·분석) 목록을 조회하고, 각 항목의 상세 내용과 권고 사항을 확인하는 방법을 안내합니다.

🚀 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 목록)

🛠️ 액션 버튼

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 상세는 별도 가이드를 참조하세요.

📘 KVS(키-값 저장소) 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