KVS Advice List Guide

Learn how to browse the list of advices (diagnostics and analyses) generated from KVS data per project (CSN), and how to inspect the details and recommendations for each item.

🚀 Go to KVS Advice List →

📋 Overview

The KVS Advice List is a screen that gathers diagnostic and advisory (advice) items — generated from the factor data that agents record into the KVS (Key-Value Store) — grouped by project (CSN). Each advice shows which server (kaKey) and which factor (kaFactor) it analyzes, and a single click takes you to the source data or the server detail.

This page requires login. If you are not authenticated, you are redirected to the login screen.

🚀 Getting Started — Enter CSN

Type the CSN of the project you want to inspect into the CSN input at the top of the screen. The CSN is stored in your session and is auto-filled on your next visit.

• Once a CSN is set, the KVSAdvList csn command runs automatically to load that project's advice list.
• The list is sorted by registration date (kaRegdt) descending (newest first).
• A loading indicator appears at the top while the query runs.

🔍 List Columns

Column	Description
kasn	Unique ID of the advice record (KVS Advice Serial Number)
ksn	Serial number of the source KVS record the advice references
kaKey	Target key value (e.g. server LSSN). Click to open the server detail.
kaFactor	Target factor category (e.g. netstat, processlist, sqlnetinv). Click to open the related data view.
kaRegdt	Advice registration date/time
kaStatus	Advice status
Action	[Details] / [Advice] buttons

The same items are shown as a table on desktop and as cards on mobile.

🔗 Navigating via Links

• Click kaKey: /en/lsvrdetail?id=<kaKey> — opens the detail page of the target server.
• Click kaFactor:
  • If the factor is sqlnetinv → /en/sql3d?kasn=...&kaf=...&kKey=... (SQL 3D view)
  • Any other factor → /en/kvslist?kasn=...&kaf=... (KVS list for that factor)

🛠️ Action Buttons

1. Details

Opens a modal showing all fields of the selected advice. You can inspect kasn, ksn, kaType, kaKey, kaFactor, the advice body (kaAdvText, rendered as Markdown), kaRegdt, kaStatus, and kValue (the source value).

2. Advice

Renders the advice body (kaAdvText) as Markdown in a wide modal. The body may contain structured sections such as likely root causes (likely_root_causes), suggestions (suggestions), recommendations (recommendations), and additional checks (additional_checks), presented as easy-to-read lists.

💡 Important Notes

• If the list is empty, "No advices found for this CSN" is displayed. Verify that the CSN value is correct.
• Advices are generated only when factor data exists in the KVS. See the KVS API guide for how to record source data.

API Reference

For details on the APIs that write and read the data shown on this page, refer to the dedicated guide.

📘 KVS (Key-Value Store) API Guide

Troubleshooting

Symptom	Cause	Resolution
List is empty (No advices found)	The CSN has no advices, or the CSN value is wrong	Check the CSN value and verify that factor data has been recorded for that project.
Redirected to the login screen	The session expired or you are not authenticated	Log in again and reopen the page.
Clicking kaFactor opens an unexpected screen	sqlnetinv routes to the SQL 3D view; all other factors route to the KVS list	This is expected. The destination depends on the factor type.
Advice body is empty	The kaAdvText for that item has not been generated yet	Record the source factor data, then check whether the advice was generated.

---

Version: 1.0 Last Updated: 2026-07-22 Source: giipv3/public/help/kvsadvlist.en.md