设置文件分割模式 - LogSetRotationMode

函数简介

设置日志文件的分割模式，支持按大小、按日期、按小时等多种方式分割日志文件。

接口名称

LogSetRotationMode

DLL调用

int32_t LogSetRotationMode(int64_t instance, int64_t loggerHandle, int32_t rotationMode)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
loggerHandleint64_t日志实例句柄（0 表示默认实例）
rotationModeint32_t分割模式（可位或组合），见 LogRotationMode 枚举

LogRotationMode 枚举值

枚举值值说明
OLA_LOG_ROTATION_NONE0不分割（单文件，不推荐）
OLA_LOG_ROTATION_SIZE1<<0按大小分割（默认启用）
OLA_LOG_ROTATION_DAILY1<<1每日分割
OLA_LOG_ROTATION_HOURLY1<<2每小时分割

示例

// 不分割（不推荐，文件会无限增长）
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_NONE);

// 仅按大小分割（默认）
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE);
// 当文件达到 maxFileSizeMb 时自动创建新文件

// 每日分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_DAILY);
// 每天 00:00 自动创建新文件

// 每小时分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_HOURLY);
// 每小时整点自动创建新文件

// 组合使用：按大小和日期分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE | OLA_LOG_ROTATION_DAILY);
// 每天创建新文件，且当文件达到大小限制时也会分割

// 组合使用：按大小和小时分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE | OLA_LOG_ROTATION_HOURLY);
// 每小时创建新文件，且当文件达到大小限制时也会分割

// 配合文件名模式使用
LogSetFileNamePattern(instance, 0, "app_{date}_{index}.log");
LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE | OLA_LOG_ROTATION_DAILY);
// 结果：app_2026-03-02_1.log, app_2026-03-02_2.log, app_2026-03-03_1.log...

返回值

返回值说明
0失败
1成功

注意事项

  • 默认值：OLA_LOG_ROTATION_SIZE (1) - 仅按大小分割
  • 可以使用位或运算（|）组合多种模式
  • 按大小分割的阈值通过 LogSetMaxFileSize 设置（默认 100MB）
  • 分割后的旧文件数量通过 LogSetMaxFiles 控制（默认保留 10 个）
  • 修改后立即生效，如果日志系统已初始化，会自动重新初始化
  • 不推荐使用 OLA_LOG_ROTATION_NONE，可能导致日志文件过大
  • 组合使用时，满足任一条件都会触发分割
Last Updated: