gstrace ​

start

开始记录trace。

stop

停止trace，释放存储信息的共享内存trace buffer。注意：trace buffer中已捕获trace信息会丢失。

config

显示trace的配置信息。

dump

将共享内存中的trace信息写入指定文件。若没有启动trace将报错。

detail

将dump出来的二进制文件解析成文本文件，显示trace点的线程、时间信息。

codepath

提取dump文件中的函数调用信息，按照调用栈的方式显示。

analyze

统计各个函数的执行次数、总耗时、平均耗时、最长耗时、最短耗时。

-p PORT

指定启动trace功能的实例侦听的端口号。

-f DUMP_FILE

指定dump导出的trace文件。

-o OUTPUT_FILE

指定写入的文件。

-t STEP_SIZE

指定分片分析的时间跨度（秒）,可选。将生成单独的{OUTPUT_FILE}.step文件。

-m MASK

指定哪些模块、函数需要追踪，如果参数为空，则追踪添加trace接口的所有模块的所有函数。

格式:：[comp…][ALL].[func…][ALL]

描述：

1. comp是模块列表，使用‘,’分隔，例如：executer,kernel。也可以使用序号，例如：executer,2。
2. func是function列表，使用‘,’分隔。例如：sql_execute_ddl, sql_execute_dcl。也可以使用序号指代模块中第几个function，例如：2。
3. 设置成ALL表示所有模块或所有function被trace。

示例：

1. executer,kernel.ALL：所有定义定义在executer和kernel模块下的function被trace。
2. executer,kernel.sql_execute_ddl：定义在executer 下的Function sql_execute_ddl被trace. kernel模块被忽略，因为下面没有该function。
3. executer,kernel.1：定义在模块executer和 kernel 下的第一个function被trace。

ALL.1,2：定义在所有模块下的第一，二个function被trace。

-s BUFFER_SIZE

指定用于trace功能的共享内存大小，默认为1G。如果指定的BUFFER_SIZE小于最小值2048，系统将自动调整为最小值。如果指定的BUFFER_SIZE不是2^N（二的N次方），则向下对齐2^N；例如：指定BUFFER_SIZE=3072，由于2^11<3072<2^12，系统将调整为2048。