获取日志文件总数 - LogGetTotalFilesCount

函数简介

获取日志实例的日志文件总数。

接口名称

LogGetTotalFilesCount

DLL调用

int32_t LogGetTotalFilesCount(int64_t instance, int64_t loggerHandle)

参数说明

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

示例

// 获取日志文件总数
int32_t fileCount = LogGetTotalFilesCount(instance, 0);
if (fileCount >= 0) {
    printf("当前共有 %d 个日志文件\n", fileCount);
}

// 检查是否需要清理
int32_t maxFiles = 10;
int32_t currentFiles = LogGetTotalFilesCount(instance, 0);
if (currentFiles > maxFiles) {
    printf("日志文件过多，正在清理...\n");
    LogCleanupOldFiles(instance, 0, maxFiles);
}

// 多实例场景
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
int64_t dbLogger = LogCreateInstance(instance, "DatabaseLogger");

int32_t networkFiles = LogGetTotalFilesCount(instance, networkLogger);
int32_t dbFiles = LogGetTotalFilesCount(instance, dbLogger);

printf("网络日志文件数：%d\n", networkFiles);
printf("数据库日志文件数：%d\n", dbFiles);

// 实际应用场景
// 场景1：监控日志文件数量
int32_t count = LogGetTotalFilesCount(instance, 0);
if (count > 50) {
    printf("警告：日志文件过多，建议清理\n");
}

// 场景2：统计信息
int32_t totalFiles = LogGetTotalFilesCount(instance, 0);
int64_t currentSize = LogGetCurrentFileSize(instance, 0);
printf("日志统计：共 %d 个文件，当前文件 %.2f MB\n", 
       totalFiles, currentSize / 1024.0 / 1024.0);

返回值

返回值类型说明
int32_t文件数量，失败返回 -1

注意事项

  • 返回的是与当前日志实例相关的所有日志文件数量
  • 包括当前正在使用的文件和历史文件
  • 如果日志系统未初始化，返回 -1
  • 文件数量会随着日志分割而增加
  • 超过 LogSetMaxFiles 设置的数量时，旧文件会被自动删除
  • 可以用于监控日志文件数量，实现自定义的清理策略
Last Updated: