平台日志

1.1 版本

1.2 功能简介

系统情况是对系统运行的各项情况进行监控分析，通过此功能可以查看到系统运行状态的各种指标。

包括：访问统计、用户行为、模板热度、性能监控、管理日志、模板报错、下载日志。如下图所示：

详细查看仪表板的访问时间，访问次数，访问方式，访问用户，帮助管理员了解每个仪表板的使用率。

统计查看包括系统访问次数的统计和报表访问明细两个方面的信息查看。

2.1 系统访问次数

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

• 访问时间：可按照月份筛选访问时间。

• 统计对象：可选择报表模板、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：支持筛选操作用户名为空的日志。

点击用户名超链，点击用户名后跳转到该用户操作行为明细，如下图所示：

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

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

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

3.2 登录登出

2023-02-21 及之后的 JAR 新增「登录登出」日志记录功能。

「登录登出」记录用户的每个登录、登出请求，记录范围包括：默认登录、跨域登录、远程设计、第三方和移动端。

支持用户登录行为分析，可对操作日期、操作结果、操作用户和操作类型进行筛选，便于用户审查系统的登录情况。

3.2.1 查询方法

选择某个时间段，默认为「前一日」到「当日」，点击「查询」，即可查询该时间段下的登录登出记录。

在复选框内选择需要查询的内容，再点击查询，即可查询出特定设置条件下的登录登出记录。

如下图所示：

3.2.2 导出登录登出日志

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

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

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

3.2.3 日志查看说明

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

支持模板访问量分析，以便管理员了解业务热点。统计指定时间段内的模板被访问频次，包括查看、导出、打印等访问操作。

展现时以总操作次数降序展现，模板名称以平台中配置的名称显示，路径为模板的路径，如下图所示：

1）如果通过非平台目录（模板 URL 或钻取）查看模板，模板名称为空。

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

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

注1：支持筛选模板名称为空的模板。

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

点击模板路径超链，点击后展示该模板的明细访问情况，按时间先后展示明细数据。如下图所示：

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

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

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

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

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

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

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

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

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

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

操作类型包含：

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

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

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

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

7.1 模板报错功能

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

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

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

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

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

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

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

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

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

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

7.2 模板报错通知

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

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

注：

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

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

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