采集msproftx数据

前提条件

在用户程序代码内调用mstx API或msproftx API，记录应用程序执行期间特定事件发生的时间跨度。

命令格式

登录运行环境，执行如下命令。

msprof [options] <app>
或msprof [options] --application=<app> 

采集mstx数据必须传入用户程序，app参数说明请参见app参数说明，options参数说明请参见参数说明。

参数说明

• --msproftx：必选，控制msproftx用户应用程序和上层框架输出性能数据的开关，可选on或off，默认值为off。
• --mstx-domain-include：可选，输出需要的domain数据。用户程序调用前缀为“mstxDomain”的接口，指定domain进行打点时，可选择只输出本参数配置的domain数据。

  开关内容填写mstxDomainCreateA接口的“name”。可指定多个domain，使用逗号隔开，default表示默认domain。需配置--msproftx=on。

  与--mstx-domain-exclude参数互斥，不可同时配置。和--mstx-domain-exclude参数都不配置时，会采集所有domain数据。若配置了程序中不存在的domain，则采集结果无该数据。

• --mstx-domain-exclude：可选，过滤不需要的domain数据。用户程序调用前缀为“mstxDomain”的接口，指定domain进行打点时，可选择不输出本参数配置的domain数据。

  开关内容填写mstxDomainCreateA接口的“name”。可指定多个domain，使用逗号隔开，default表示默认domain。需配置--msproftx=on。

  与--mstx-domain-include参数互斥，不可同时配置。和--mstx-domain-include参数都不配置时，会采集所有domain数据。

使用示例

msprof --msproftx=on /home/projects/MyApp/out/main

在--output指定的目录下生成PROF_XXX目录，存放自动解析后的性能数据，相关结果文件请参见msproftx数据说明和db文件的MSTX_EVENTS表。