发布版本：BOS V 4.0.012

新特性介绍

• 功能特性：为苍穹提供统一日志框架，单独建立log日志库，减小日志存储对业务运行性能影响
• 功能特性：支持ES数据库（Elasticsearch）存储与查询日志，提高大数据下的日志搜索性能
• 功能特性：提供统一的归档等日志功能，减少重复开发工作
• 页面元素特性：数据中心设置【启用ES存储日志】开关，用来日志库类型决定
• 页面元素特性：设计器中增加"日志表单"页面类型。日志表单中的字段是日志数据库表的字段。可以通过插件调用等方法绑定业务单据字段和日志表单字段，将业务单据字段的数据写入日志。
• 页面元素特性："日志表单"页面可切换至列表（日志列表），用于日志的查看和过滤。

操作指引

1前往数据中心，根据业务需求开启或关闭【启用ES存储日志】并重启发布

2前往开发平台设计器，创建"日志表单"类型页面

3在日志表单中添加字段，配置属性，用于记录要写入库的字段

4撰写API插件，将写入日志的字段逐一绑定日志表单字段

5点击日志表单的【列表】页签，配置显示的字段，查看和过滤日志列表

特性效果展示

注意

• 统一日志框架依赖MC补丁，版本号为4.0.006。请务必在使用统一日志框架之前，更新MC补丁版本。
  

• 统一日志框架下，同一时间，所有日志的存储只能统一选择使用ES或DB中一种时。选定后，写入接口和后续配置步骤是统一的；

• 日志库不应随意切换，目前不提供升级切换日志库时原有日志表的自动转储；
  

• 日志表单模板中的预置字段均是必录。

• 使用统一的log日志库管理日志：日志表单数据库方式使用的表，即使开发者在不同云上开发，也应强制路由到日志库上，所以开发者需要把日志表单对应的建表语句指定到日志库上，如下图所示。

• 日志表单模型因为es不支持排序和合计所以运行期会屏蔽。

日志开发步骤和效果

• 开启ES数据库记录日志库；

• 创建日志表单，用于记录操作日志；

• 配置操作日志表单，表单中包括3个文本和1个长日期，分别命名"操作人"，"操作名称"，"操作描述"和"操作时间"；

• 撰写API插件，逐一将绑定业务字段绑定给日志表单字段。点击按钮时（比如保存），将业务字段数据写入日志；

• 在日志列表中配置显示字段；

• 在日志列表中查看日志和过滤。

重要参考资料

统一日志框架基本介绍

统一日志框架API开发指南