KVS Factor List Guide

Learn how to browse the KVS (Key-Value Store) factor entries recorded for a project, and jump straight to each factor's history or latest value.

🚀 Go to KVS Factor List →

📋 Overview

The KVS Factor List page lets you browse the factor entries recorded for a selected project (CSN) on a single screen. You can review the various factors an agent has collected — metrics, inventory, process lists, and more — and jump directly to each entry's history or latest-value page. Login is required to access this page.

🔍 Screen Layout

1. Project Selection (CSN)

Choose the target project from the dropdown at the top. The list is populated automatically with projects the logged-in account can access, and a project saved in your session is selected by default.

2. Run

Clicking [Run] executes the command KVSFactorList * <csn> for the selected project. The * means factors of every type are queried rather than restricting to a specific kType. While loading, the button shows a Loading... state.

3. Results List

Results are shown as a table (desktop) or cards (mobile). They typically include the kType (key type), kKey (server LSSN or DB ID), and kFactor (data category) columns. If the data cannot be parsed as a table, the raw response text is displayed as-is.

4. Row Navigation Buttons

Factor columns display two navigation buttons alongside the value.

• [List]: Saves the row's kType, kKey, and kFactor to the session, then navigates to the KVS List page (/en/kvslist) to view the history list.
• [Last]: Passes kType, kKey, and kFactor as query parameters and navigates to the Latest Value page (/en/kvslast).

🛠️ Tips

• Changing the project saves the selection to your session, so it persists across other KVS pages.
• For legacy data without kType/kKey information, the system treats lssn as the default type when handling navigation.

💡 Important Notes

• If results are empty, the selected project may have no recorded factors yet, or the wrong project may be selected.
• This page is read-only. For recording factor data (KVSPut), see the API reference below.

API Reference

For the detailed KVS API specifications behind this feature, refer to the dedicated guide.

📘 KVS (Key-Value Store) API Guide

Troubleshooting

Symptom	Cause	Resolution
Redirected to the login screen	The session expired or you are not authenticated	Log in again, then open the page.
Project dropdown is empty	No accessible projects were retrieved	Verify your login state and account permissions, then refresh the page.
Results show No results.	The selected project has no recorded factors	Confirm the correct project is selected, and record data with KVSPut first.
Results show raw text instead of a table	The response could not be parsed as a table	Review the response content and check that the data format is valid.
Data is empty after [List]/[Last] navigation	Legacy data lacks kType/kKey and was handled with defaults	Re-record the target factor or verify the kKey value.

---

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