工具概述

msTraceKit工具可协助开发者深入理解程序的行为，从而进行有效的性能优化。在实际应用中，开发者可以根据需要选择合适的功能，以解决具体的性能问题。

msTraceKit主要有以下功能：

msTracekit工具的使用请参考工具使用，通过MindStudio Insight展示内存读写时序图、Cache热力图等单算子调优能力，具体请参考表1。

表1 msTracekit工具功能特性
功能	链接
内存读写时序图	内存读写时序图
Cache热力图	Cache热力图

可以通过执行以下命令来调用msTracekit工具。

mstracekit <options> <user_program> <user_options>

options为检测工具的命令行选项，详细的参数选项及其默认值，请参考表2和表3，user_program为用户算子程序，user_options为用户程序的命令行选项。
使用msTracekit工具之前，用户需保证user_program功能正常。

表2 通用参数说明
参数名称	参数描述	参数取值	是否必选
-v，--version	查询msTracekit工具版本。	-	否
--type	指定轨迹分析工具类型。	instr：指令级轨迹分析（默认） kernel：kernel级轨迹分析	否
--output	指定轨迹分析文件的生成路径。	{directory}：默认在当前目录下保存轨迹分析文件，若指定的目录不存在，则会自动创建。	否
-h，--help	输出帮助信息。	-	否

表3 指令级轨迹分析子参数说明
参数名称	参数描述	参数取值	是否必选
--task	--type为指令级轨迹分析时，用于指定需要启用的分析任务。	memtrace：内存分析。	否

支持如下调用算子的场景：

结果件名称	说明
mstracekit_TIMESTAMP.log	msTracekit工具运行过程中，在当前路径下生成工具日志，TIMESTAMP由当前时间戳和当前使用的轨迹分析工具的PID组成。
kernel.PID.o	msTracekit工具运行过程中，在当前路径下生成的算子缓存文件，PID为当前使用的检测工具的PID，该算子缓存文件用于解析异常调用栈。正常情况下，msTracekit工具退出时会自动清理该算子缓存文件。当msTracekit工具异常退出（如被用户“CTRL+C” 中止）时，该算子缓存文件会保留在文件系统中。因为该算子缓存文件包含算子的调试信息，建议限制其他用户对此文件的访问权限，并在轨迹分析工具运行完成后及时删除。

结果件名称

说明

mstracekit_TIMESTAMP.log

msTracekit工具运行过程中，在当前路径下生成工具日志，TIMESTAMP由当前时间戳和当前使用的轨迹分析工具的PID组成。

kernel.PID.o

msTracekit工具运行过程中，在当前路径下生成的算子缓存文件，PID为当前使用的检测工具的PID，该算子缓存文件用于解析异常调用栈。

正常情况下，msTracekit工具退出时会自动清理该算子缓存文件。
当msTracekit工具异常退出（如被用户“CTRL+C” 中止）时，该算子缓存文件会保留在文件系统中。因为该算子缓存文件包含算子的调试信息，建议限制其他用户对此文件的访问权限，并在轨迹分析工具运行完成后及时删除。

父主题： msTracekit