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

指定哪些模块、函数需要追踪。参数不得为空。

格式： <COMP_FUNC_PAIR> [,<COMP_FUNC_PAIR>]*

描述：

• <COMP_FUNC_PAIR> -> <COMP_NAME>.<FUNC_NAME>
  COMP_FUNC_PAIR 代表一组模块与函数组合。
  
• COMP_NAME 代表一个模块名。
  
• <FUNC_NAMES> -> ALL|[<FUNC_NAME>[&<FUNC_NAME>]*]
  FUNC_NAMES 可由用户指定为ALL 或者一个及以上的函数名。由于FUNC_NAMES一定是与COMP_NAME组合，因此，ALL代表追踪以COMP_NAME为名的模块的所有函数；而如果用户指定的是一个及以上的函数名，则是追踪以COMP_NAME为名的模块中的这几个指定FUNC_NAME对应的函数名。
  

示例：

• access.StartTransaction: 追踪一个模块access中的函数StartTransaction。
• executer.ExecutorStart&ExecInitExpr: 追踪一个模块executer中的函数ExecutorStart和ExecInitExpr。
• executer.ExecutorStart,tcop.PortalStart&PortalRun: 追踪模块executer中的ExecutorStart函数和模块tcop中的函数 PortalStart和PortalRun。
• executer.ALL,access.ALL: 追踪模块executer和access中的所有函数。

-s BUFFER_SIZE

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