文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

traceStatus()

名称

traceStatus - 查看当前程序跟踪的状态

语法

db.traceStatus()

类别

Sdb

描述

开启数据库引擎跟踪功能后,用户可使用该函数查看当前程序跟踪的状态。

参数

返回值

函数执行成功时,将通过游标(cursor)方式返回当前程序跟踪状态,返回的字段信息如下:

参数名 类型 描述
TraceStarted boolean 跟踪是否开始
"true":跟踪开始
"false":跟踪未开始
Wrapped boolean 跟踪文件是否翻转
"true":已翻转
"false":未翻转
Size int64 跟踪文件大小
FreeSize int64 可用内存大小
Mask string 所跟踪的模块,模块说明可参考 SdbTraceOption 的 conponent 参数
BreakPoint string 所跟踪的函数断点
Threads int32 线程号
ThreadTypes string 线程类型,类型说明可参考 SdbTraceOption 的 threadTypes 参数
FunctionNames string 所跟踪的函数名

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

错误

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

版本

v2.0 及以上版本

示例

  • 开启数据库引擎程序跟踪的功能

    > db.traceOn( 100, new SdbTraceOption().components( "dms" ).functionNames( "_dmsStorageUnit::insertRecord" ).threadTypes( "RestListener" ) )
  • 查看当前程序跟踪的状态:

    > db.traceStatus()
    {
      "TraceStarted": true,
      "Wrapped": false,
      "Size": 104857600,
      "FreeSize": 104857600,
      "PadSize": 0,
      "Mask": [
        "dms"
      ],
      "BreakPoint": [],
      "Threads": [],
      "ThreadTypes": [
        "RestListener"
      ],
      "FunctionNames": [
        "_dmsStorageUnit::insertRecord"
      ]
    }
回到顶部