平台日志

1.1 版本

1.2 功能简介

管理员登录FineReport系统，点击「管理系统>智能运维>平台日志」，可看到多项日志记录。

平台日志是对系统运行的各项情况进行监控分析，通过此功能可以查看到系统运行状态的各种指标。如下图所示：

1.3 使用前提

非超管用户如需查看平台日志，需要拥有「智能运维」模块和「平台日志」子模块的使用权限。

超管登录FineBI系统，点击「管理系统>权限管理>普通权限配置」，选中对应用户。

1）为用户开通「管理系统>智能运维」模块的使用权限。

1）为用户开通「管理系统>智能运维>平台日志」子模块的使用权限。

访问统计分为三个方面：系统访问次数、服务器使用情况、模板访问明细，可简单分析仪表板的使用率。

2.1 系统访问次数

「系统访问次数」以折线图的方式介绍系统访问次数、被访问模板数、活跃客户数。

• 支持按照月份筛选访问时间

• 对于多节点集群工程，从任一节点访问，均可查看整个集群的日志信息

• 如为FineBI和FineReport集成工程，支持筛选统计对象：报表模板、BI模板

2.1.1 数据来源

「系统访问次数」中的数据是过滤 LogDB 数据库 fine_record_execute 表中的数据。

当「统计对象」选择「报表模板、BI模板」时，过滤出 fine_record_execute 表中 type 在下表范围内的数据进行图表中的指标统计。

提示:

1）fine_record_execute 表字段具体介绍请参见：LogDB 表结构 。

2）当「统计对象」选择「报表模板+BI模板」时，过滤出下表所示的全部数据。

3）「统计对象」按照模板名称进行统计。若一张仪表板修改名称后，改名前和改名后会分为两个「统计对象」。

4）FineBI 6.0.13 及之后版本，支持统计移动端访问模板的记录。

2.1.2 计算逻辑

各数值计算逻辑如下表所示：

2.2 服务器使用情况

2.2.1 当前系统在线人数

• 没有连上 Websocket ，当前系统在线人数无法正确显示，用户登录不计算在当前系统在线人数中，具体请参见：Websocket 端口被占用/无法使用

• 同一个浏览器登录两个账号，后一个用户信息会覆盖前一个用户信息，只算一个用户。

• 必须要通过登录页进入平台，才会被算入当前系统在线人数（单点登录同样适用），只访问模板，不访问平台，不会计入。

• 有新用户登录查看当前系统在线人数时，记得刷新页面再查看。

2.2.2 具体列表说明

「服务器使用情况」列表中介绍「XX用户在XX时间XX地点访问了平台中的XX模板」。

• 这个明细列表中显示的是当前正在被预览的报表模板。

• 普通用户登录查看模板，该模板的访问信息会实时显示在这个明细列表中。

• 普通用户关闭正在访问的模板，刷新平台，明细列表中该模板的访问信息消失。

2.3 模板访问明细

「模板访问明细」记录「XX用户在XX时间XX地点以XX方式访问了系统中的XX模板」，工程下所有模板的访问记录都会展示在此处。

「模板访问明细」详细介绍哪个目录下面的报表被访问，访问时间，访问的 IP，操作（什么方式访问的 BI 如：分页预览、BI 查看、BI 编辑、EXCEL分页导出等），角色（登录用户名的角色），用户名等。

2.3.1 查询方法

管理员可选择某个时间段，默认为「前一日」到「当日」，点击「查询」，即可查询该时间段下的明细。

管理员可勾选「高级查询条件」，选择需要查询的内容，再点击查询，即可查询出特定设置条件下的明细。

支持筛选操作用户为空的日志，支持筛选模板名称为空的模板。

仅对用户访问直接挂载到目录的模板名称进行记录。如使用超链挂载，或使用公共链接等形式访问，不确保记录。

2.3.2 导出访问明细

查询后，管理员可导出日志文件，如下图所示：

点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

注：最多只可导出1W条日志数据。

2.3.3 操作类型

部分操作字段在 log 里为数字，对应的日志信息类型如下表所示：

注1：部分操作类型后显示「？」，悬停可查看具体操作信息。

用户行为分为模板业务和登录登出两个方面，可获取用户具体的操作信息并进行简单分析。

3.1 模板业务

1）在「用户行为>模板业务」界面，支持筛选：操作时间、操作用户

2）查询后，以明细表展示指定时间段内用户对模板的查看次数、导出次数、打印次数和总操作次数

3）点击用户名超链，可跳转到该用户行为明细表

4）支持导出日志，最多只可导出1W条日志数据。

点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

注：若使用公共链接访问，操作用户为空。

3.2 登录登出

6.0.8 及之后版本新增「登录登出」日志记录功能，记录用户的每个登录、登出请求，便于审查用户登录情况。

记录范围包括：默认登录、跨域登录、远程设计、第三方和移动端。

3.2.1 查询方法

1）在「用户行为>登录登出」界面，支持筛选：

• 操作时间：某个时间段，默认为「前一日」到「当日」

• 操作用户：执行登录登出操作的平台用户名，默认全选

• 操作类型：登录、注销、超时登出、保持登录，默认全选

• 操作结果：成功、失败，默认全选

2）点击「查询」，即可查询该时间段下用户的登录登出记录

3）查询后，管理员可导出日志文件，最多只可导出1W条日志数据。

• 点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

3.2.2 日志查看说明

登录登出日志存储在 logdb 的 fine_record_login 表中，对应的说明如下表所示，详情请参见：LogDB 表结构 。

支持模板访问量分析，以便管理员了解业务热点。

1）在「模板热度」界面，支持筛选：操作时间、模板名称

2）点击「查询」，以明细表形式展示指定时间段内，各个模板的查看次数、导出次数、打印次数和总操作次数。

• 明细表以总操作次数降序展示。

• 模板名称是目录管理中配置的目录名称。如果通过非平台目录（公共链接或钻取）查看模板，模板名称为空。

• 被访问资源，为仪表板在用户的分析中的存放路径

• 同一张模板，如果挂载在平台多个目录中，将分为多条记录进行统计。

• 同一张模板，如果通过公共链接查看，或者通过钻取查看，将分为多条记录进行统计。

• 查看次数包括查看BI模板、编辑BI模板、查看BI公共链接三种的操作次数
  

3）点击被访问资源超链，跳转展示该模板的明细访问情况，按时间先后展示明细数据。

4）查询后，管理员可导出日志文件，最多只可导出1W条日志数据。

点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

支持模板的响应性能分析，为管理员优化系统提供参考。

展示已完成用户请求的模板，最长响应时间，最短响应时间，平均耗时，内存占用。设置日期参数，同时设置操作行为类别参数，如下图所示：

勾选「详细信息」，效果如下图所示：

查询后，管理员可导出日志文件，如下图所示：

点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

注：最多只可导出1W条日志数据。

1）在「操作日志」界面

• 支持筛选：操作时间

• 支持勾选高级查询条件，筛选操作用户、操作IP、模块、操作对象、操作类型

2）点击查询，显示出日志信息

• 包括：模块：操作对象、操作用户、操作IP、操作时间、被访问资源、操作类型

3）查询后，管理员可导出日志文件，最多只可导出1W条日志数据。

• 点击「导出为log」按钮可导出 .txt 格式

• 点击「导出为excel」可导出 .xls 格式

4）操作类型包含：

7.1 模板报错功能

点击查询，汇总统计模板使用中的错误，包括：模板名称、被访问资源，错误代码、错误内容、出现次数、总访问次数，如下图所示：

1）如果通过非平台目录（模板 URL 或钻取）查看模板，模板名称显示为非挂载访问。

2）同一张模板，如果挂载在平台多个目录中，将分为多条记录进行统计。

     同一张模板，如果通过URL 查看，或者通过钻取查看，将分为多条记录进行统计。

3）筛选栏中仅显示有报错记录的模板。

点击「错误详情」，显示对应模板对应报错类别下的详细报错及查询情况，包括：用户名称、错误详情、查询参数、报错时间、模板预览结果。

注：为避免报错信息冗余，单次访问仅会记录出现的前5次报错

查询后，管理员可导出模板报错日志文件，如下图所示：

支持导出日志，点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

注：最多只可导出1W条日志数据。

7.2 模板报错通知

管理员登录数据决策系统，点击「管理系统>智能运维>平台日志」，点击「全局设置」，支持开启「模板报错通知」，如下图所示：

若开启了「模板报错通知」，系统将在每日凌晨 2 点检查前一天的报错模板，存在报错模板时可通过短信提醒、平台消息、邮件提醒三种形式通知管理员。

注：

1）短信提醒：需要开启短信平台，详细点击 短信

2）邮件提醒：需要配置邮件服务器，详细点击 邮箱

3）平台消息：需要在负载均衡层面配置websocket端口并且开放，相关文档：Websocket端口被占用/无法使用