平台日志

1.1 版本

1.2 功能简介

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

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

1.3 使用前提

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

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

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：「统计对象」按照模板名称进行统计。若一张仪表板修改名称后，改名前和改名后会分为两个「统计对象」。

2.1.2 计算逻辑

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

2.2 服务器使用情况

2.2.1 当前系统在线人数

• 没有连上 Websocket ，当前系统在线人数无法正确显示，用户登录不计算在当前系统在线人数中，具体请参见：WebSocket 端口未开放提醒

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

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

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

2.2.2 具体列表说明

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

• 这个明细列表中显示的是当前正在被预览的报表模板，不考虑是否连上 Websocket ，因此可能与当前系统在线人数不一致。

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

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

2.3 模板访问明细

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

详细介绍报表被访问时间，访问的 IP，操作（什么方式访问的报表如：分页预览、填报预览、数据分析等），角色（登录用户名的角色），用户名。

2.3.1 查询方法

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

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

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

2.3.2 导出访问明细

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

支持导出模板访问明细，点击「导出为log」按钮可导出 .txt 格式，点击「导出为excel」可导出 .xls 格式。

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

2.3.3 操作类型

日志存储在 logdb 的 fine_record_execute 表中，详情请参见：LogDB 表结构 。

操作字段在 log 里为数字，对应报表访问方式，已定义的日志信息类型如下表所示：

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

3.1 模板业务

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

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

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

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

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

3.2 登录登出

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

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

3.2.1 查询方法

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

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

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

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

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

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

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

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

3.2.2 计算逻辑

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

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

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

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

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

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

• 被访问资源，为模板在工程中的存放路径。

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

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

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

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

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

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

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

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

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

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

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

同访问统计，点击查询，显示出日志信息：平台模块、平台设置项，操作用户、操作IP、操作时间、被访问资源、操作类型，如下图所示：

操作类型包含：

勾选「高级查询条件」，如下图所示：

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

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

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

11.0.1 及之后版本的报表工程，新增「模板报错」功能。

7.1 模板报错功能

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

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

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

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

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

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

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

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

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

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

7.2 模板报错通知

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

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

注：

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

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

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