写入TRACE日志Ex - LogTraceEx

函数简介

写入 TRACE 级别日志（扩展版本），支持指定日志实例。

接口名称

LogTraceEx

DLL调用

int32_t LogTraceEx(int64_t instance, int64_t loggerHandle, const char* message)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
loggerHandleint64_t日志实例句柄（0 表示默认实例）
messagestring日志消息

示例

// 使用默认实例
int result = LogTraceEx(instance, 0, "这是一条 TRACE 级别的日志");

// 使用自定义实例
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
LogSetModuleName(instance, networkLogger, "network");
LogTraceEx(instance, networkLogger, "网络连接建立");

// 多实例场景
int64_t dbLogger = LogCreateInstance(instance, "DatabaseLogger");
LogSetModuleName(instance, dbLogger, "database");
LogSetLevel(instance, dbLogger, OLA_LOG_LEVEL_DEBUG);

LogTraceEx(instance, networkLogger, "发送数据包");
LogTraceEx(instance, dbLogger, "执行SQL查询");  // 不会输出，因为级别低于 DEBUG

返回值

返回值说明
0失败
1成功

注意事项

  • TRACE 是最低级别的日志，用于详细的程序执行跟踪
  • 只有当日志级别设置为 OLA_LOG_LEVEL_TRACE (0) 时才会输出
  • 与 LogTrace 的区别：支持指定日志实例，适合多实例场景
  • 建议在开发和调试阶段使用，生产环境建议使用更高级别
  • 如果日志系统未初始化，第一次调用时会自动初始化
Last Updated: