---
order: 5
---
# 日志管理

在系统运行过程中，日志作为记录系统行为的载体，承载着调度跟踪、操作审计和文件追溯等关键用途。随着业务持续运行，日志文件的积累不仅会占用大量存储资源，更会影响系统检索效率。

SuccBI在系统设置中提供了日志管理的功能，通过简单的配置，可以实现对**系统日志**、**调度日志**、**文件历史**的手动清理和定时自动清理。

![日志管理](./images/2025-03-19-15-04.png)

## 系统日志{#log-system}

系统日志会记录系统的所有操作日志，包括用户访问、调用接口、上传下载等，日志存放在[系统日志表](/sys-tables/sys/LOG_SYS)中。

系统日志模块提供`日志记录级别配置`功能，并支持`立即清理`和`定时调度`两种日志清理机制，实现对用户操作轨迹的全周期管控。

![自动清理日志](./images/2025-03-25-14-42.png)

- **日志记录级别**：设定系统日志记录的日志信息级别，分为`OFF`、`FATAL`、`ERROR`、`IMPT`、`INFO`、`VERB`和`ALL`，日志记录越详细，用户操作时产生的日志越多，日常生产环境建议使用`INFO`级别的日志记录，日志级别描述如下：

  |日志级别|级别描述|
  |:-:|:-:|
  |OFF|关闭|
  |FATAL|严重|
  |ERROR|错误|
  |IMPT|重要|
  |INFO|信息|
  |VERB|详细|
  |ALL|所有|

- **当前日志表大小**：记录[系统日志表](/sys-tables/sys/LOG_SYS)当前行数。
  - **刷新**：手动更新当前系统日志的行数。
  - **立即清理**：点击立即清理会弹出策略窗口，在输入框设置`保留最近天数`后，点击确认就会删除早于设定天数的历史系统日志，然后自动刷新系统日志数据。

- **自动清理日志**：启用自动清理日志功能后，通过设置`日志保留周期`及`清理计划`，系统将定期执行自动化清理任务，实现日志数据的策略化维护与系统资源优化。
  - **保留最近天数**：设置系统日志保留的最大天数。
  - **清理计划**：设置执行自动清理的计划任务，通过调整计划的执行频次可以控制系统日志的清理周期，详细设置参考[调度管理](../../schedule/README.md)。

## 调度日志{#dispatching-log}

调度日志会记录计划和任务的全部执行情况，日志存放在[任务运行详细日志表](/sys-tables/sys/TASK_RUNLOGS)、[任务运行记录表](/sys-tables/sys/TASK_RUNS)、[计划运行详细日志表](/sys-tables/sys/SCHEDULE_RUNLOGS)以及[计划运行记录表](/sys-tables/sys/SCHEDULE_RUNS)中；

调度日志模块支持独立管理不同执行频率的计划任务日志，结合`立即清理`和`定时调度`清理机制，统一管控分散在多个日志表中的调度执行记录。
![调度日志](./images/2025-03-26-15-27.png)

- **当前日志表大小**：所有调度日志行数总和。
  - **刷新**：手动更新当前调度日志的总行数。
  - **立即清理**：点击立即清理会弹出策略窗口，设置`清理策略`后，系统将定向清除历史调度日志，然后自动刷新统计数据。
- **自动清理日志**：自动清理日志启用后，可以通过`清理策略`定义清理规则，配合`清理计划`，实现自动清理调度日志。
- **清理策略**：系统会根据[计划任务](../../schedule/README.md)设置的定时执行频率自动划分执行频率等级，高频任务（如每分钟执行一次）和低频任务（如每月执行一次）产生的日志量不一样，通常会有不同的日志清理策略，在这里可以根据执行频率分级分别配置保留策略，具体分级如下：
  |分级策略|清理对象|
  |:-:|:-:|
  |年级别|年度或者跨年执行的调度日志|
  |月级别|月度周期执行的调度日志|
  |日级别|每日或每周固定执行的调度日志|
  |小时级别|小时级高频调度日志|
  |分钟级别|分钟、秒级实时调度日志|

## 文件历史{#file-history}

文件历史中记录着元数据文件的每个版本信息，每次文件存在修改都会多一条文件历史信息，记录存放于[历史版本表](/sys-tables/meta/META_REVISIONS)。

文件历史模块通过`保留最近天数`和`自动压缩版本`两种清理规则，结合`立即清理`和`定时调度`清理机制，实现对历史版本的精准管控，有效避免多版本迭代产生的存储冗余问题。
![文件历史](./images/2025-03-26-17-52.png)

- **当前日志表大小**：记录[历史版本表](/sys-tables/meta/META_REVISIONS)当前行数。
  - **刷新**：手动更新当前历史版本数据行数。
  - **立即清理**：点击立即清理会弹出策略弹窗，设置`保留最近天数`和`自动压缩版本`后，系统将定向清除历史版本数据，然后自动刷新统计数据。
- **自动清理日志**：自动清理日志启用后，通过预设保留最近天数和自动压缩版本两项清理策略，配合`清理计划`，实现文件历史版本的智能化管理，在保障必要数据留存的同时有效释放存储空间。
- **清理策略**：设置文件历史清理规则，当`保留最近天数`和`自动压缩版本`同时启用时，会依据两种规则复合清理，日常生产环境建议只启动`自动压缩版本`。
  - **保留最近天数**：设置文件历史版本保留的最大天数。
  - **自动压缩版本**：勾选后会保留最近七天的所有文件历史版本，超过七天且小于三十天之内的一个小时保留一个版本，超过三十天的一天保留一个版本。
