1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.2 | 插件功能转内置 新增日志存储位置查看功能 支持集群跨节点下载日志 |
1.2 应用场景
1）当用户遇到需要使用日志的场景时，部分公司对机房管控较严格，申请进机房流程繁琐，日志获取费时费力。
2）遇到较紧急且又需要日志定位的问题时，日志获取困难可能会影响用户的使用。
3）用户向帆软提产品bug时，需要提供一些必要的客户环境信息，但是客户系统环境信息因为种种原因获取耗费时间较大。
1.3 功能简介
通过「系统日志」插件：
1）管理员可以按照「操作时间」和「日志类型」筛选导出日志文件。
2）管理员可以一键查看日志文件存储位置。
3）管理员可以一键获取并导出报表工程环境信息。
2. 插件简介
2.1 插件安装
注：11.0.2 及之后版本，「系统日志」功能已直接内置，无需安装插件。
旧版本升级后，已安装的插件自动禁用，启用内置功能。
点击下载插件：下载日志插件
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
2.2 界面介绍
插件安装完成后，管理员登录数据决策系统，点击「管理系统>智能运维>平台日志」，新增「系统日志」Tab，如下图所示：
3. 下载日志
注：集群环境下，页面右上角有集群选择框，管理员可以直接选择集群节点进行下载相应节点日志。
3.1 操作时间
管理员可选择需要下载的日志内容的操作时间范围。支持「年月日」和「动态时间」。若日期超出当前存在的日志文件范围，则仅下载现有文件。
年月日：支持直接选择具体的年月日，例如 2020-01-01。
动态时间：支持根据当前时间推算一个日期，例如今天之前一季度的季初。
3.2 日志类型
支持导出多种类型的debug日志：
注：根据服务器操作系统和部署方式的不同，可获取的日志类型可能不完全相同。
| 日志 | 说明 |
|---|---|
fanruan.log | 帆软应用运行日志 |
| fanruan.gc.log | 帆软宕机日志 |
| BIEvent.log | 仅 FineBI 项目支持查看和下载该日志 FineBI 配置操作记录 |
| access.log | Nginx 访问日志的访问日志文件，用于记录用户访问网站的请求信息，如访问时间、IP 地址、请求方法、访问路径、HTTP 状态码等 |
| catalina.log | Tomcat 自己运行的一些日志，主要记录 Tomcat 在启动和暂停时的运行内容 |
| catalina.out | Tomcat 的标准输出和标准出错，所有输出到这两个位置的都会进入 catalina.out，这里包含 Tomcat 运行自己输出的日志以及应用里向 console 输出的日志 |
| localhost_access_log.txt | Tomcat 的请求访问日志，请求的时间，请求的类型，请求的资源和返回的状态码都有记录 |
3.3 效果预览
点击「一键下载」，解压下载的压缩包，例如导出的fanruan.Log日志内容如下图所示：
4. 查看存储位置
点击「查看存储位置」按钮，可查看各种日志的存储位置，如下图所示：
5. 导出环境信息
点击「一键导出」按钮，即可导出环境信息。如下图所示：
注：集群环境下，页面右上角有集群选择框，管理员可以自行选择需要下载日志的具体节点。
导出的文件格式为xml，内容如下表所示：
| 类别 | 说明 | 示例 |
|---|---|---|
| jar版本 | 当前客户服务器系统使用的jar包版本 | 20200608 |
| 操作系统 | 当前客户服务器所用操作系统及其版本 | centos7.0 |
| 分配内存 | 当前配置的最大堆内内存 | 16G |
| 部署方式 | 当前部署的web容器类型及其版本 | Tomcat8.0/Jboss7.0 压缩部署/非压缩部署 |
| 是否FRBI集成 | 是否为FRBI集成环境 | 是/否 |
| JDK版本 | 当前应用所使用的JDK版本 | 1.8.0_181 |
| 内置库是否迁移 | 判断当前内置库是否迁移外置库 | 是/否 |
| 迁移数据库类型 | 外置数据库迁移类型 | oracle 11g |
注1：Mac设计器无法获取部署方式，显示为unkown。
Windows/Linux设计器获取的部署方式是tomcat。
注2：支持获取的部署容器种类如下，其他不支持的均返回unknown
GERONIMO("geronimo")
GLASSFISH("glassfish")
JBOSS("jboss")
JETTY("jetty")
JONAS("jonas")
OC4J("oc4j")
RESIN("resin")
TOMCAT("tomcat")
WEBLOGIC("weblogic")
WEBSPHERE("websphere")
WILDFLY("wildfly")
UNKNOWN("unknown")
