1.1 版本

1.2 功能简介

为了加强对 FineBI 工程的管理，随时监控其运行状态，可在平台中开启日志记录，如下图所示：

注：平台日志的设置仅影响系统日志的输出，不影响操作日志。

LogDB 是 FineBI 日志监控开启之后，用于保存日志的内置数据库，那么 FineBI 日志都包含哪些内容呢？

下面来介绍一下，LogDB 中各个数据表的含义以及字段的含义。数据库 LogDB 中表的实际应用可以参考：LogDB 的实际应用场景

2.1 连接 LogDB 数据库

1）以管理员身份进入数据决策系统，点击管理系统>数据连接>数据连接管理>新建数据连接，如下图所示：

2）数据连接方式选择其他>其他 JDBC，如下图所示：

3）如下图配置好数据连接信息，点击保存即可。

2.2 查询 LogDB 数据表

注：使用 SQL 语句查询 LogDB 数据表时，不支持 实时数据

1）以管理员身份进入数据决策系统，点击管理系统>数据连接>服务器数据集>创建数据集>SQL 数据集，如下图所示：

2）输入数据库查询语句，点击预览按钮即可查询 LogDB 中的数据表。如下图所示：

2.3 数据表和字段对应的含义

那么 LogDB 数据库中各个数据表和表字段其含义到底是怎么样的呢？

2.3.1 fine_record_execute

BI 执行表：报表访问/导出/打印日志，即如果报表访问/导出/打印的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录。

其各个字段对应的含义如下表所示：

字段 type 具体含义：

2.3.2 fine_record_login

登录表：用户登录日志，用于记录用户的登录信息。

其各个字段对应的含义如下表所示：

2.3.3 fine_record_logout

登出表：用户登出日志，用于记录用户的登出信息。

其各个字段对应的含义如下表所示：

2.3.4 fine_record_email

邮件表：邮件发送日志（只包含工具栏中的“邮件”），即如果报表发送邮件的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录。

其各个字段对应的含义如下表所示：

2.3.5 fine_record_write

填报表：记录填报日志信息，即如果报表进行填报的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录。

其各个字段对应的含义如下表所示：

2.3.6 fine_record_error

执行出错日志表：即如果报表执行的过程中报错的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录，记录全部 error 和 fatal 级别的报错信息。

其各个字段对应的含义如下表所示：

注1：在平台日志的错误日志中过滤展示，只展示 platformDisplay=1 的记录。

注2：如果不是模板出错，则 tname 记录为“非模板触发错误”。

2.3.7 fine_record_param

常用参数组合表：记录常用参数组合日志信息。

其各个字段对应的含义如下表所示：

2.3.8 fine_record_sms

短信发送表：记录短信发送日志信息，即如果发送短信的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录.。

其各个字段对应的含义如下表所示：

2.3.9 fine_record_operate

管理日志表：即用户对模块进行操作的时候，将会在该表中添加一条记录，并在相应字段中填写其对应的信息记录。

其各个字段对应的含义如下表所示：

2.3.10 fine_record_sql

SQL 执行表：记录 SQL 的执行情况。

其各个字段对应的含义如下表所示：

2.3.11 fine_intelli_focus_point

功能埋点表：用来保存所有公共的埋点信息。

其各个字段对应的含义如下表所示：

字段 id 格式说明：

例如：FR-F1001

FR前缀，表示是FR的埋点。

第一位字母表示功能/性能：F-功能、P-性能。

第二位数字表示分类：1-数据源、2-前台、3-报错、4-智能运维、5-设计器。

2.3.12 fine_real_time_usage

应用实时情况表：记录应用实时情况。

其各个字段对应的含义如下表所示：

2.3.13 fine_intelli_consume_point

性能信息表：记录性能相关信息。

其各个字段对应的含义如下表所示：

2.3.14 fine_record_gc

GC 记录表：记录系统的 GC 信息。

其各个字段对应的含义如下表所示：

3.1 明细查询

SQL 语句示例：

1）select * from fine_record_execute

2）select tname, displayName, consume from fine_record_execute

3.2 group by 查询

GROUP BY 查询，有 SUM，COUNT， MAX， MIN， AVG 这五种聚合方式，如果什么都不写，会默认 COUNT

SQL 语句示例：

1）select sum(consume) from fine_record_execute group by tname, displayName

2）select consume from fine_record_execute group by tname, displayName

3）select min(consume), max(consume) from fine_record_execute group by tname, displayName

3.3 where 过滤条件

简单的 WHERE 过滤条件，支持 AND， OR， =，<>，>，>=， <，<=， in， isnull 

SQL 语句示例：

1）select * from fine_record_execute where consume > 10

2）select sum(consume) from fine_record_execute where consume > 10 and consume < 100 group by tname, displayName

3）select consume from fine_record_execute where tname = `doc/Advanced/Chart/GraphSwitching/多图表实现统一切换.frm`

4）select sum(consume) from fine_record_execute where tname in (`doc/Advanced/Chart/GraphSwitching/多图表实现统一切换.frm`, `doc/Advanced/Chart/Combination/柱形-面积组合图.cpt`) group by tname, displayName

3.4 todate() 将时间戳转换为普通的日期类型

todate() 结果的日期格式为：2018-12-18 10:15:26

SQL 语句示例：

1)  select todate(time) from fine_record_execute

2) select * from fine_record_execute where todate(time)<'2018-12-18 10:15:26' and todate(time)>'2018-12-17 10:15:26'

3.5 like 模糊查询

只支持前后‘%’的用法

注1：支持使用 like 进行模糊查询，不支持 not like 用法 。

注2：目前只支持 '%'，暂不支持通配符 ‘_’，需要更新 2019-06-14 以后的 JAR。

SQL 语句示例：

1）select * from fine_record_execute where tname like '%demo%'

4.1 LogDB 中添加表后更新失败

问题描述：

在 LogDB 数据库中添加表后，更新失败。平台报错：更新失败，请联系管理员查看报错信息。如下图所示：

原因分析：

编辑过的 基础表 更新会嵌套，但目前 swift 不支持嵌套。

所以，FineBI 目前暂不支持本节「问题描述」中的操作。

4.2 browser 字段说明

LogDB 数据库fine_record_execute表中 browser 字段一般记录客户端访问报表所用的浏览器版本，例如：CHROME/83.0.，当 browser 字段值如下所示时：

{'Browser':'webkit','Version':'537.36','Agent':'mozilla/5.0 (windows nt 10.0; win64; x64) applewebkit/537.36 (khtml, like gecko) chrome/81.0.4044.138 safari/537.36','BoxModel':true,'terminal':'null'}

记录的是浏览器请求头user agent（用户代理字符串）的值，user agent相当于浏览器的唯一标识。

4.3 一个模板编号对应多个模板名称

问题描述：

LogDB 数据库fine_record_execute表中，一个 reportId 对应多个 tname ，如下图所示：

原因分析：

仪表板被多次重命名，每次重命名后都对仪表板进行访问/导出/打印操作，所以 fine_record_execute 表中一个模板编号会对应多个模板名称。