手动触发文件分割 - LogRotateFile

函数简介

手动触发日志文件分割，立即关闭当前文件并创建新文件。

接口名称

LogRotateFile

DLL调用

int32_t LogRotateFile(int64_t instance, int64_t loggerHandle)

参数说明

参数名	类型	说明
instance	int64_t	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
loggerHandle	int64_t	日志实例句柄（0 表示默认实例）

示例

// 手动触发文件分割
int result = LogRotateFile(instance, 0);

// 在特定时机触发分割
// 场景1：程序进入新阶段
LogInfo(instance, "========== 初始化阶段完成 ==========");
LogRotateFile(instance, 0);
LogInfo(instance, "========== 开始运行阶段 ==========");

// 场景2：定期分割
// 每小时手动分割一次
LogRotateFile(instance, 0);

// 场景3：多实例分别分割
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
int64_t dbLogger = LogCreateInstance(instance, "DatabaseLogger");

LogRotateFile(instance, networkLogger);  // 只分割网络日志
LogRotateFile(instance, dbLogger);       // 只分割数据库日志

返回值

返回值	说明
0	失败
1	成功

注意事项

• 立即关闭当前文件并创建新文件
• 不受 LogSetRotationMode 设置的影响，可以随时手动触发
• 新文件名会根据 LogSetFileNamePattern 的设置生成
• 如果使用了 {index} 占位符，序号会自动递增
• 适用于需要在特定时机分割日志的场景
• 分割后会自动清理超过保留数量的旧文件（根据 LogSetMaxFiles 设置）