traceFmt()

名称

traceFmt - 解析 trace 日志

语法

traceFmt(<formatType>, <input>, <output>)

类别

Global

描述

该函数用于解析 trace 日志，并根据用户指定的格式化类型将结果输出至对应文件。

参数

• formatType（ number，必填 ）

  格式化类型，取值如下：

  • 0：输出 trace 日志的分析文件，包含线程的执行序列（flw 文件）、函数的执行时间分析（CSV 文件）、执行时间峰值（except 文件）和 trace 记录错误信息（error 文件）
  • 1：输出解析后的 trace 日志（fmt 文件）

• input（ string，必填 ）

  trace 日志所在路径

• output（ string，必填 ）

  输出文件所在路径

返回值

函数执行成功时，无返回值。

函数执行失败时，将抛异常并输出错误信息。

错误

traceFmt() 函数常见异常如下：

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v1.0 及以上版本

示例

解析 trace 日志 trace.dump

> traceFmt(0, "/opt/sequoiadb/trace.dump", "/opt/sequoiadb/trace_output")

Note:

如果需要查看当前程序的跟踪状态，可参考 traceStatus()。