3分鐘閱讀

KVS 建議清單指南

介紹如何依專案（CSN）檢視基於 KVS 資料產生的建議（診斷與分析）清單，並查看每個項目的詳細內容與建議事項。

🚀 前往 KVS 建議清單頁面 →

📋 概述

KVS 建議清單是一個依專案（CSN）彙整顯示診斷與建議（advice）項目的畫面，這些項目係根據代理程式寫入 KVS（鍵值儲存）的 factor 資料所產生。每則建議都會一併標註它分析的是哪一台伺服器（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：/zh-TW/lsvrdetail?id=<kaKey> — 跳轉至目標伺服器的詳細頁面。
點擊 kaFactor：
- 當 factor 為 sqlnetinv 時 → /zh-TW/sql3d?kasn=...&kaf=...&kKey=...（SQL 3D 檢視）
- 其他 factor → /zh-TW/kvslist?kasn=...&kaf=...（該 factor 的 KVS 清單）

🛠️ 動作按鈕

1. 詳細（Details）

以彈出視窗顯示所選建議的全部欄位。可查看 kasn、ksn、kaType、kaKey、kaFactor、建議內文（kaAdvText，以 Markdown 呈現）、kaRegdt、kaStatus 以及 kValue（原始值）。

2. 建議（Advice）

在較寬的彈出視窗中將建議內文（kaAdvText）以 Markdown 呈現顯示。內文可能包含可能的根本原因（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 跳轉至非預期畫面	`sqlnetinv` 跳轉至 SQL 3D 檢視，其他 factor 跳轉至 KVS 清單	屬正常行為。跳轉目標取決於 factor 類型。
建議內文為空	該項目的 `kaAdvText` 尚未產生	寫入原始 factor 資料後，再確認是否已產生建議。

版本: 1.0 最後更新: 2026-07-22 原始檔案: giipv3/public/help/kvsadvlist.zh-TW.md