Example

Viewing Server Information

BMC information (IP address, user name, and password) is required for collecting information about some modules. If you do not enter the required BMC information, the collection process skips those BMC-dependent modules.
The tool recommends the optimal memory insertion method.
The tool provides the complete server information in multiple file formats (HTML, JSON, CSV, and TAR.GZ) and dmesg logs.
In a report, the red color indicates the ERROR information, yellow indicates the WARNING information, green indicates the INFO information, and pink indicates the tuning suggestions (symptom description and modification procedure).
A report displays only key information about each module. For detailed information, see the JSON or CSV file.
The HTML report can be viewed using a browser. It contains all data collected by commands and provides legends of illustrating the current memory insertion status and recommended insertion method.
To view the content of a specific module, run the corresponding subcommand.

Display the complete server information.
1

./kspect -l 0 all
The complete information includes network, NUMA, PCIe, storage, and other information. Use the tool to see more details.

Figure 1 Diagnosis Information

The tuning suggestions provided by the tool are for reference only. Adapt the operations to your requirements.

Figure 2 CPU information

Figure 3 Memory information

Figure 4 Generating a data file
Display information about a single module (PCIe information).
1

./kspect -l 0 pcie
Figure 5 PCIe information
Display an HTML static file.
You can download the HTML file to the local PC and open it in a browser.
Figure 6 HTML File – Memory slots

Figure 7 HTML File – Basic information

You can view the NUMA, BIOS, CPU, memory, network interrupt, storage, BMC, PCIe topology, and kernel information as well as the basic information.

Figure 8 HTML-PCIe topology information

Displaying and Comparing Historical Reports

Displaying historical reports:

        
             kspect -l 0 report -h

Command output:

        
             USAGE
    kspect report [-h] [-r REPORT] [-d DIFF [-t THRESHOLD]] [--diff_x86 DIFF_X86 [-t THRESHOLD]]

OPTIONS:
    -h, -H, --help
    Views the help information and exits.

    -r REPORT, --report REPORT
                        Indicates the report to be displayed. (You can also enter the report path. Tool collection reports and reported generated using diff/diff_x86 are supported.
    1: /home/kspect/output/kspect-report-20250812-154619/kspect-json-20250812-154619.json <2025-08-12 15:55:32>
    2: /home/kspect/output/kspect-report-20250812-155941/kspect-json-20250812-155941.json <2025-08-12 15:55:32>

    -d DIFF, --diff DIFF
    Selects two reports and compares them.
                        --diff 0                                : generates a new report and compare it with the previous report.
                        --diff N                                : generates a new report and compare it with the historical report No.<N>.
                        --diff N,M                              : compares historical reports No.<N> and No.<M>.
                        --diff <INPUT_PATH>                    : generates a new report and compares it with the input report.
                        --diff <INPUT_PATH_A>,<INPUT_PATH_B>    : compares the input reports <A> and <B>.

    --diff_x86 DIFF_X86
    Compares with x86 reports. Only reports generated using perfspect report --all are supported (perfspect address: https://github.com/intel/PerfSpect).
                        --diff_x86 <X86_PATH>                   : generates a new report and compares it with the x86 report.
                        --diff_x86 N,<X86_PATH>                 : compares the historical report No.<N> with the x86 report.
                        --diff_x86 <INPUT_PATH>,<X86_PATH>      : compares the input collection report with the input x86 report.

    -t THRESHOLD, --threshold THRESHOLD
                        specifies the threshold for comparison. Data that exceeds the threshold is marked. The default threshold is 20% (no percent sign is required). Only --diff/--diff_x86 is supported.

Selecting the latest report and the specified x86 report for comparison. The comparison threshold is 90%.

        
             ./kspect report --diff_x86 1,/home/kspect/perfspect/localhost.localdomain3.0.0.json -t 90

-t 90 indicates data items whose difference exceeds 90% are marked in red in the comparison report.
If there is a value in the brackets and the difference exceeds the threshold, the value is displayed in red. [--] indicates that the threshold cannot be calculated and the value is also displayed in red.
[arm] and [x86] indicate the unique Arm and x86 report data, respectively. [common] contains data shared by both. [same] indicates that the compared data is identical in the two reports.

Figure 9 Report comparison (file systems)

Parent topic: Kunpeng Health Inspector