Rate This Document
Findability
Accuracy
Completeness
Readability

Analyzing Collected Data

Analyzes the collected data and presents the analysis result in a sequence diagram; uses a sequence diagram to visualize the function call information and the creation relationship between processes/threads, and to analyze the network I/O feature of the application, aiming to present overall network data to locate network problems; analyzes and displays compatibility information to identify the affinity between the K-NET network acceleration kit and users' services.

Command Function

Analyzes the collected data and displays the sequence diagram and compatibility information.

The tool also detects compatibility rules for SO_REUSEPORT and SO_REUSEADDR.

Syntax

Analyzing and displaying the sequence diagram:

1
devkit advisor knet [-h | --help] {seq-diag} {-d DIR_OF_RECORDED_DATA} {-o OUTPUT_FILE_PATH} [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]

Analyzing and displaying compatibility information:

1
devkit advisor knet [-h | --help] {compat} {-d DIR_OF_RECORDED_DATA} {-c JSON_CONF_FILE_PATH} [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]

Parameter Description

Table 1 Parameters for displaying a sequence diagram

Parameter

Option

Description

-h/--help

-

Obtains help information. This parameter is optional.

-d

-

Data file directory. This parameter is mandatory.

-o

-

Path to the sequence diagram package to be outputted. This parameter is mandatory. The package name is in the format of knet-analysis_Timestamp.tar.gz.

-l/--log-level

0/1/2/3

Log level, which defaults to 1. This parameter is optional.

  • 0: DEBUG
  • 1: INFO
  • 2: WARNING
  • 3: ERROR

--set-timeout

-

Timeout interval of a task, in minutes. If the execution duration exceeds the timeout interval, the task exits. This parameter is optional. By default, there is no timeout interval. The task will be executed until it is complete.

Table 2 Parameters for displaying compatibility information

Parameter

Option

Description

-h/--help

-

Obtains help information. This parameter is optional.

-d

-

Data file directory. This parameter is mandatory.

-c

-

Path to the compatibility configuration file in JSON format. This parameter is mandatory.

NOTE:

The tool provides the configuration file template compat_conf.json, which is stored in the /path/to/DevKit-CLI/advisor/devkitplugins/affinity/tools/compileopt/templates/compat_conf.json directory.

/path/to/DevKit-CLI/ indicates the installation path of the command line tool.

-l/--log-level

0/1/2/3

Log level, which defaults to 1. This parameter is optional.

  • 0: DEBUG
  • 1: INFO
  • 2: WARNING
  • 3: ERROR

--set-timeout

-

Timeout interval of a task, in minutes. If the execution duration exceeds the timeout interval, the task exits. This parameter is optional. By default, there is no timeout interval. The task will be executed until it is complete.

Example

Display the sequence diagram and supported functions:
1
devkit advisor knet -h

Command output:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
OVERVIEW
    Run this command to analyze the POSIX call information collected by librecord.so, generate a sequence diagram or display compatibility.

USAGE
    devkit advisor knet [POSITIONAL ARGUMENTS] [OPTIONS]

POSITIONAL ARGUMENTS
      {seq-diag,compat}     Modes of KNet
        seq-diag            Analyze and Display the Sequence Diagram
        compat              Analyze and Display the Compatibility

OPTIONS
      -l {0,1,2,3}, --log-level {0,1,2,3}
                            Specifies the log level of the current task. The default value is INFO.
      --set-timeout TIMEOUT
                            Specifies the timeout period of a task. By default, the timeout period is not set.