历史版本81 :报表日志 LogDB 数据库 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

为了加强对报表工程的管理,随时监控其运行状态,可以在平台中设置开启日志查看。

以管理员身份进入数据决策系统,点击管理系统>智能运维>平台日志>全局设置,如下图所示:

1574865209846049.png

注:仅影响系统日志的输出,不影响操作日志。

2. LogDB编辑

LogDB 是 FineReport 日志监控开启之后保存日志的内置数据库,那么 FineReport 日志都包含哪些内容呢?

下面来介绍一下,LogDB 数据库中各个数据表的含义以及字段的含义。

2.1 连接 LogDB 数据库

在 FineReport 设计器中点击服务器>定义数据连接,新增一个 JDBC 数据连接,设置信息如下表所示:

选项内容
数据库Others
驱动器com.fr.swift.jdbc.Driver
URLjdbc:swift:emb://default (Mac、Windows、Linux通用)
用户名和密码

FineReport 设计器设置页面如下图所示:

1574865574791448.png

2.2 查看数据表

测试连接成功之后,我们新建一个 数据库查询 ,选择上面创建的数据连接 LogDB,即可看到日志数据库下面的所有数据表,如下图所示:

1574865798812434.png

注1:如果是服务器添加了 LogDB 这个数据连接务必控制这个 数据连接的权限,否则存在被越权访问并修改配置数据库的风险。

注2:查询语法可参考本文第三章。

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

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

2.3.1 报表(BI)执行表——fine_record_execute

报表访问/导出/打印日志,即如果报表访问/导出/打印的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段  含义
id主键
tname物理模板名字(reportlet 下的完整路径)
displayName挂载到平台的目录名称(全路径),如果直接访问链接则为空
type报表访问方式,具体列举在下面的表格中(范围 0~103,目前已使用 33 个编码)
param参数
ip执行报表的 IP 地址
username执行报表的用户
userrole执行报表的用户角色
consume执行耗时,包括 SQL 执行时间,报表计算时间
time日志开始时间
sqlSQL 语句
sqlTimeSQL 执行的总时间
browser客户端访问报表所用的浏览器版本
memory

报表占用内存,单位 B

①若因宕机等情况计算中断,记录的是报表开始计算到计算中断所占用的内存(根据格子数估算。一格子占用 0.2KB)

同时很多时候当模板 complete 字段值为 0 时,这个里记录的是 0

②若计算完成,记录的数据除以 250 之后返回是报表开始计算到计算完成所生成的格子数

reportId模板编号
userId用户 ID
complete

是否计算完成

①若因宕机等情况计算中断,记录为「0」

②若计算完成,记录为「1」

source访问方式( integration 是通过 URL 访问,single 是平台访问的 )

注:userId、complete、visitType、resource 字段需要更新 2019-5-20 以后的 JAR 。

字段 type 具体含义:

编码  类型  markString 
  0分页预览page
  1在线分析view
  2填报预览  write
  3决策报表预览form
  4行式引擎layer
  5在线编辑edit
  6新填报write_plus
 10Excel 分页导出excel
 11Excel 原样导出excelO
 12Excel 整页导出excelL
 13Excel 分页分 sheet 导出excelS
 14PDF 导出pdf
 15Word 导出word
 16SVG 导出svg
 17CSV 导出csv
 18文本导出text
 19JPG 图片导出 jpg
 20PNG 图片导出png
 21GIF 图片导出gif
 22BMP 图片导出bmp
 23WBMP 图片导出 wbmp
 24内置数据集导出模板cpt
 25HTML 导出html
 26填报 HTML 导出write_html
 27BI 导出 Excel
 30Flash 打印flash
 31PDF 打印
 32 Applet 打印applet 
 33零客户端打印
 34本地软件打印
101BI 模板预览
102BI 模板编辑
103BI 模板分享

2.3.2 登录表——fine_record_login

登录日志,记录用户登录信息:时间、IP 地址、用户名及角色,其各个字段对应的含义如下表所示:

  字段  含义
time登录时间
ip登录 ip 地址
username  登录的用户
userrole登陆的用户角色

2.3.3 邮件表——fine_record_email

邮件发送日志(只包含工具栏中的「邮件」),即如果报表发送邮件的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段含义  
receiver收件人用户名
mail收件人邮箱
ip发送邮件的IP地址
username发送邮件的用户
tname物理模板名字(reportlet 下的完整路径)
displayName挂载到平台的目录名称(全路径),如果直接访问链接则为空
content邮件内容
time发送时间
result是否发送成功
detail详情

2.3.4 填报表——fine_record_write

填报日志,即如果报表进行填报的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

字段  含义  
username填报报表的用户
tname  物理模板名字( reportlet 下的完整路径)
time填报时间
sqlSQL 语句
sqlTimeSQL 执行的总时间
result是否填报成功
ip填报报表的 IP 地址
displayName挂载到平台的目录名称(全路径),如果直接访问链接则为空
detail详情
browser客户端访问报表所用的浏览器版本
consume执行耗时,包括 SQL 执行时间,报表计算时间

2.3.5 执行出错日志表——fine_record_error

执行出错日志,即如果报表执行的过程中报错的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段  含义
displayName挂载到平台的目录名称(全路径),如果直接访问链接则为空
ip执行报表的 IP 地址
msg错误信息
time出错记录时间
tname出错的物理模板名字( reportlet 下的完整路径)
trace错误路径
username执行报表的用户
userrole执行报表的用户角色

注:如果不是模板出错,则 tname 记录为「非模板触发错误」。

2.3.6 fine_function_process

功能点使用日志,即使报表用功能点的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段 含义 
func功能点(值以数组展示:功能:次数,功能:次数)
time记录时间

2.3.7 常用参数组合表——fine_record_param

常用参数组合日志,其各个字段对应的含义如下表:

  字段  含义
templateid模板 ID
username  用户
pgroup参数(值以数组展示:参数 1:参数值,参数 2:参数值)
time记录时间

2.3.8 短信发送表——fine_record_sms

短信发送日志,即如果发送短信的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段  含义
receiver收件人用户名
mobile接收人手机号
content邮件内容
time发送时间
result是否发送成功
detail详情
sender发件人用户名

2.3.9 管理日志表——fine_record_operate

管理日志,即用户对模块进行操作的时候,将会在该表中添加一条记录,并在相应字段中填写其对应的信息记录,其各个字段对应的含义如下表所示:

  字段含义  
type模块(存国际化的 key)
item设置项
resource被访问资源
operation操作
username  用户名
ip用户 IP 地址
time用户操作时间
detail详情
requestParam请求参数

2.3.10 SQL 执行表——fine_record_sql

SQL 执行情况如下表所示:

  字段  含义
columns数据集规模,列
dsname数据集的名称
executeid执行表 ID
rows数据集规模,行
sqltimeSQL 执行时间,单位毫秒

2.3.11 功能信息表——fine_intelli_focus_point

设计器功能点使用信息如下表所示:

字段  含义  
id功能点 ID
text国际化
source功能点的类型,1 是内置 JAR 包的功能点,2 是插件功能点,-1 表示没有定义来源
time用户操作时间
username用户名
ip用户IP地址
title平台模板名

2.3.12 应用实时情况表——fine_real_time_usage

应用实时情况如下表所示:

  字段含义  
node节点名
cpuCPU 利用率
memory当前 JVM 内存情况
time记录时间,每分钟一条
sessionNum存活会话数
onlineNum系统在线人数
pid进程 PID

注:node、sessionNum、onlineNum、pid 字段需要更新 2019-5-20 以后的 JAR 。

2.3.13 模板属性表——fine_tpl_info

模板属性,每周执行一次,记录一次。

  字段  含义
id主键
tid模板 id
tname物理模板名字(reportlets 下的完整路径)
cnums条件属性个数
formnums公式个数
sheetnums多 sheet 个数
dsnums数据集个数
compformnums复杂公式的个数(包括层次坐标、SQL、value 公式)
submitnums内置提交的个数
isfrozen是否使用了冻结
isfoldtree是否使用了折叠树
widgetnums 控件个数
filterNums过滤个数
injectNums参数注入个数
formula模板内公式使用情况
JSAPI模板内 JS API 使用情况
tsize模板总大小
imgsize模板里图片的大小
execute0-execute4执行时间的 5 级的分段记录
mem0-mem4内存使用量的 5 级的分段记录
sql0-sql4SQL 执行时间的 5 级的分段记录
recordtime记录时间

注:filterNums、injectNums、formula、JSAPI 字段需要更新 2019-5-20 以后的 JAR 。

2.3.14 系统关闭记录——fine_operation_shutdown_record

描述:记录系统关闭前后的进程信息以及关闭类型。

字段

备注

node节点名
time当前时间
pid进程 PID
startTime进程开始时间
upTime进程持续时间
signalName信号量

2.3.15 容器配置情况(fine_container_entity)

描述:应用所在容器、服务器的配置信息。每日记录一次。

字段

备注

node节点名
time时间,到日
item配置项
value

其中 itme 包括:

item

说明

containerMem容器设置的内存大小
cpuCPU 核数
disk磁盘情况
jdkVersionJDK 版本
containerVersionWeb 容器版本
machineMem物理机内存
system服务器操作系统
systemNum服务器操作系统位数
cpuModel处理器型号
diskSpeed磁盘存取速度
jarVersionJAR 包版本
licType注册类型(正式/临时)
expireTime注册到期时间

2.3.16 配置信息——fine_record_conf

描述:每日将 FineDB 中的 fine_conf_entity 表记录一次。去除了 fine_conf_entity 表中的敏感信息,包括:FineBI 业务包相关配置、数据连接的密码&用户名&URL、服务器数据集相关信息、连接池中的 SQL 验证查询、集群配置中状态服务器与文件服务器的地址&用户名&密码、邮件服务器配置的用户名&密码(原则是去除任何 SQL 语句、用户名、密码、服务器地址信息)。

字段

  含义

id数据在配置中的位置
value数据值
time时间,到日

2.3.17 插件使用情况——fine_plugin_usage

描述:插件的使用情况,每个插件每日记录一次。

字段

备注

time时间,到日
plugin插件名
version插件版本
API插件中所用接口情况
opration插件运行情况
register插件注册情况
enable插件是否启用

2.3.18——功能点购买情况——fine_function_possess

描述:功能点购买情况,每日记录一次。

字段

备注

time时间,到日
function功能点购买情况

2.3.19 性能信息表——fine_intelli_consume_point

描述:性能相关信息

字段

说明

备注

id埋点 id 编号
source埋点来源Original 类里面 embed 表示当前系统的,plugin 表示插件的埋点,undefined 表示没有定义来源
time时间开始时间
endTime结束时间

consume

耗时 单位 ms
memory内存大小 单位 byte
username操作者
ip操作 IP
title资源 ID可以是模板 ID,分析表 ID,表 ID 等
text资源内容可以是模板名字,分析表名字,等,可以根据
type操作类型可以表明是进行了哪种操作
comment资源备注可以是可以是更具体一些的信息,需要直接分析的数据。
body埋点具体信息一个 JSON 数据结构,根据不同的埋点里面存放不同的信息

3. 查询语法编辑

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'

注: 需要更新 2019-5-20 以后的 JAR 。

3.5 like 模糊查询

只支持前后「%」的用法

SQL 语句示例:

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

注:目前只支持 「%」,暂不支持通配符 「_」,需要更新 2019-5-20 以后的 JAR 。