定制化API日志记录，要什么你来定

接下来，就让小编带你一起了解如何定制API日志吧！

适用版本

该功能适用版本为苍穹V6.0.4以上。

API日志用于记录OpenAPI调用过程中的请求参数、执行过程、响应结果、错误码等信息，便于开发与运维人员根据实时日志查询，分析接口调用结果，进行接口故障定位和日志审计等操作。

用户可以根据项目实际使用情况，配置API日志记录的详细程度，同时还可以单独记录请求出入参中的关键业务字段，方便快速定位到对应的API日志记录。

用户（管理员）可以通过OpenAPI系统参数配置，来定义不同级别的API日志和日志保留天数。

1）配置API日志级别

路径：【基础服务云】→【公共设置】→【参数配置】→【系统参数】，在OpenAPI参数中，可以配置API日志级别：摘要日志、详细日志和大文本日志。用户可以按需勾选日志级别，并维护日志保存天数。

备注：从苍穹版本V6.0.3开始，只有管理员账号有权限在公共设置中维护OpenAPI参数。

图1 配置OpenAPI参数 - API日志级别

2）查看API调用日志

路径：【开放服务云】→【OpenAPI】→【监控统计】→【API日志】，打开API调用日志列表界面，在这里我们可以看到API日志调用记录，包含日志基本信息、请求参数、错误消息、调用状态、调用时间、调用方、API耗时、traceid等信息。

备注：日志默认保留30天，到期自动清理。

图2 查看API调用日志

图3 查看API调用详细日志

3）查看API大文本日志

若在OpenAPI参数中，配置了记录“大文本日志”，那么在调用接口（特别是批量保存或列表查询API）后，在API日志详情中，用户可以点击“导出详细日志”，系统会生成一个txt文件，展示完整的请求参数和响应结果。

图4 查看API调用大文本日志

用户可以通过对API进行简单配置，即可在API日志中单独记录请求出入参中的关键字段，如单据编码、创建组织等，从而快速过滤对应的日志记录，进行日志审计或问题定位。

1）配置日志记录模板

路径：【开放服务云】→【OpenAPI】→【API管理】→【API开发】，这里以供应链管理中常用的采购订单保存接口为例，首先通过零代码配置快速开发一个API，在配置项中维护入参日志记录模板和出参日志记录模板。

图5 开发API接口

这里参考示例，通过脚本维护关键字段，下面我们将采购订单编码和分录中物料编码作为入参关键字段，单据id作为出参关键字段。

图6 维护入参