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 クリック:
/ja/lsvrdetail?id=<kaKey>— 対象サーバーの詳細ページへ移動します。 - kaFactor クリック:
- factor が
sqlnetinvの場合 →/ja/sql3d?kasn=...&kaf=...&kKey=...（SQL 3D ビュー） - その他の factor →
/ja/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 クリック時に想定と異なる画面へ遷移 | factor が sqlnetinv なら SQL 3D ビュー、その他は KVS 一覧へ分岐 | 正常動作です。factor の種類により遷移先が異なります。 |
| アドバイス本文が空 | 該当項目の kaAdvText がまだ生成されていない | 元 factor データを記録した後、アドバイスの生成有無を確認します。 |
バージョン: 1.0
最終更新: 2026-07-22
ソースファイル: giipv3/public/help/kvsadvlist.ja.md