整体压缩包或RPM包使用方式
链路时延检测工具支持通过Attach模式采集运行时数据的能力，用于挂载用户态函数耗时采集库到运行中的进程。对采集的数据进行分析，通过分析应用网络I/O特征展示网络总览数据，定位网络问题；针对K-NET提供分析并展示兼容性信息的功能。
前提条件
- 已参照安装工具安装亲和分析工具。
- 使用压缩包安装工具时，请解压后切换至工具目录使用，采用./方式执行命令，例如./devkit advisor knet -h。使用RPM包安装工具时，可直接执行命令，例如devkit advisor knet -h。本章示例均为RPM包安装使用。
命令功能
- attach命令：提供以Attach模式的方式采集数据的能力，启动应用后指定应用的PID，在应用运行过程中采集数据。
- compat命令：针对K-NET分析采集的数据并展示兼容性信息。
命令格式
- 查看帮助信息：
1devkit advisor knet [-h | --help]
- 采集数据：
1devkit advisor knet {attach} {-p PROCESS_ID} {-o OUTPUT_DIR_PATH} [-i CONF_FILE_PATH] [--hotspot] [-d <duration>] [-n <top_n>] [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]
- 分析并展示兼容性信息：
1devkit advisor knet {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]
参数说明
参数 |
参数选项 |
参数说明 |
|---|---|---|
-h/--help |
- |
可选参数，获取帮助信息。 |
-l/--log-level |
0/1/2/3 |
可选参数，设置日志级别，默认为1。
|
--set-timeout |
- |
可选参数，任务超时时间，单位为分钟，若执行时间超过超时时间则退出执行。默认无超时时间，任务将持续执行直到结束。 |
参数 |
参数说明 |
|---|---|
-p |
必选参数，指定应用的PID号。 |
-i |
可选参数，指定配置文件，指定需要记录的函数的配置文件路径。配置文件格式请参见配置文件（RECORD_CONF）。 说明：
-i参数和--hotspot参数至少使用一个，如果配置文件中指定函数和自动采集的热点函数重复，将在输出结果中去重。 |
-o |
必选参数，指定数据文件的输出目录。生成的数据文件格式说明请参见5。 |
--hotspot |
可选参数，自动识别并采集应用的热点函数信息。 说明：
-i参数和--hotspot参数至少使用一个，如果配置文件中指定函数和自动采集的热点函数重复，将在输出结果中去重。 |
-d |
可选参数，热点采集时间，默认5秒。 说明：
使用--hotspot参数时生效。 |
-n |
可选参数，采集的热点函数信息的top N个，默认值为5（若采集时超过5个热点函数信息，只显示占用最高的前5个信息，若不满5个，则按实际数量显示）。 说明：
使用--hotspot参数时生效。 |
参数 |
参数说明 |
|---|---|
-d |
必选参数，指定存放数据文件的目录。 |
-c |
必选参数，指定JSON格式的兼容性配置文件的路径。 说明：
工具提供配置文件模板compat_conf.json，配置文件模板路径为“/path/to/DevKit-CLI/advisor/devkitplugins/affinity/tools/compileopt/templates/compat_conf.json”。 “/path/to/DevKit-CLI/”为命令行工具安装路径。 |
使用示例
- 根据PID采集数据。
1devkit advisor knet attach -p 17979 -i /home/my_app.conf -o /home/data
-p参数指定待采集进程的PID，-i参数指定配置文件路径，-o参数指定采集的数据文件保存目录。
- 分析并展示兼容性信息。
1devkit advisor knet compat -d /home/data -c /home/demo/compat_conf.json
compat_conf.json文件模板可在工具安装路径下的“advisor/devkitplugins/affinity/tools/compileopt/templates/compat_conf.json”获取。