就像手机存储会因为照片太多而告警一样，系统的API调用日志也可能成为“占地盘”太多的文件。这些日志不仅在悄悄消耗着我们服务器的空间，还可能让系统有点“吃不消”。所以，为了释放存储空间、确保系统一切正常运转，我们需要定期进行日志清理。

在本篇文档里，我们会手把手地教你如何做这个简单而又重要的API日志清理工作。就像你定期清理手机内存一样，给系统“腾地方”，让它轻装上阵！

适用版本

该功能适用版本为苍穹V5.0.011以上。

功能速览

配置可归档单据范围

路径：【系统服务云】->【配置工具】->【数据归档】->【可归档单据范围】，配置需要清理的日志。

注意事项：苍穹V6.0版本后，数据归档转到应用“分布式管理”下。

图1 配置可归档单据范围-1

表单选择API调用日志（openapi_log_data）和API调用详细日志（openapi_log_detail），打开 “允许被归档清除”选项。

图2 配置可归档单据范围-2

配置单据清除规则

以API调用日志（openapi_log_data）为例，路径：系统服务云->配置工具->数据归档->可归档单据范围，配置单据清除规则。

图3 配置单据清除规则-1

1） 新增单据清除规则：选择被清除的归档单据API调用日志 （openapi_log_data）。

图4 配置单据清除规则-2

2）添加清除条件：这里根据实际需求，可以配置N天前（建议30天以内，不要超过90天以避免日志过多，影响性能）。

图5 配置单据清除规则-3

3）启用单据清除规则：配置完成后，点击保存并启用规则。

图6 配置单据清除规则-4

配置清除调度计划

路径：【系统服务云】->【配置工具】->【数据归档】->【清除调度计划】，配置日志清除调度计划。

图7 配置清除调度计划-1

选择清除规则，自动带出清除条件，再次检查并配置执行计划，推荐按天。执行时间建议设为：每天凌晨2点或3点，系统非繁忙时段。

图8 配置执行计划

图9 选择清除规则

保存并启用后，API调用日志清理计划自动生效，同样的方法，为API调用详细日志（openapi_log_detail）也配置可归档单据、单据清除规则和调度计划，开放平台的日志表就都会自动清理。

注意：大文本日志建议保存一周左右自动清理。

检查任务是否执行成功

1）查看任务日志 是否执行成功。

图10 查看归档任务日志

2）使用SQL查询分析器，切换到 日志库，查看日志条数：

select min(fopdate) from t_openapi_log_data  --最早调用日志时间
select count(1) from t_openapi_log_data      --调用日志条数
select min(fopdate) from t_openapi_logitem    --最早大文本日志时间
select count(1) from t_openapi_logitem        --大文本日志条数

亮点价值

亮点一：效率提升

自动化定期清理日志能够高效地处理庞大的日志数据，避免了手动清理的繁琐过程。通过预定任务，系统能够在指定时间执行清理操作，释放存储空间，不需要用户干预，提高了整体操作的效率。

亮点二：保障系统性能

通过定期清理，可以确保系统保持高可用性，为用户提供更流畅的体验。

划重点

• API调用日志（openapi_log_data）和API调用详细日志（openapi_log_detail），都需要配置对应的规则和调度计划。

• 苍穹版本高于5.0.020，系统会自动清理30天之前的api调用日志，用户也可自行配置周期更短的清理计划；若版本低于5.0.020，则需手工配置”可归档单据”、“清除规则”和“清除调度计划”。