KVS 建议列表指南
介绍如何按项目（CSN）查看基于 KVS 数据生成的建议（诊断与分析）列表，并查看每个条目的详细内容与推荐事项。
📋 概述
KVS 建议列表是一个按项目（CSN）汇总展示诊断与推荐（建议）条目的界面，这些条目基于代理写入 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-CN/lsvrdetail?id=<kaKey>— 跳转到目标服务器的详情页面。 - 点击 kaFactor：
- 当 factor 为
sqlnetinv时 →/zh-CN/sql3d?kasn=...&kaf=...&kKey=...（SQL 3D 视图） - 其他 factor →
/zh-CN/kvslist?kasn=...&kaf=...（该 factor 的 KVS 列表）
- 当 factor 为
🛠️ 操作按钮
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 详情，请参阅专门的指南。
故障排查
| 现象 | 原因 | 解决 |
|---|---|---|
列表为空（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-CN.md