1. 概述编辑
1.1 版本
BI 服务器版本 |
---|
5.1 |
1.2 功能简介
FineBI 工程运行时,会生成相关日志文件进行记录。
日志类型 | 日志存储 | 日志内容 |
---|---|---|
系统日志 | 默认存储在%BI_HOME%\logs\fanruan.log 不允许修改日志存储位置 | 记录系统运行过程中的一些信息 记录自助数据集/仪表板中的数据计算执行日志 |
操作日志 | 存储在%BI_HOME%\webapps\webroot\logs\cubes 允许修改日志存储位置 | 记录普通用户和管理员的使用动作 记录数据决策系统使用情况、用户行为、模板访问情况等统计日志 |
2. 系统日志编辑
系统日志记录系统运行过程中的一些信息。
日志存储在%BI_HOME%\logs\fanruan.log文件里,Tomcat服务器的日志文件catalina.out里也会生成。不支持修改服务器工程日志存储位置。
2.1 日志级别简介
系统日志输出级别分为五种:DEBUG、INFO、WARN、ERROR、FATAL。
日志级别大小排序(严重程度):FATAL>ERROR>WARN>INFO>DEBUG
日志详细程度排序:FATAL<ERROR<WARN<INFO<DEBUG
Log级别 | 简介 |
---|---|
DEBUG(调试) | 指出细粒度信息事件对调试应用程序是非常有帮助的,主要用于开发过程中打印一些运行信息。 注:若将日志输出级别设置为 DEBUG 模式,可能会由于日志打印过多而导致 BI 启动后没有控制台显示或者控制台黑屏。若需要使用 DEBUG 模式,建议将 BI 部署在 tomcat 上。 |
INFO(信息) | 在粗粒度级别上突出强调应用程序的运行过程,打印一些感兴趣的或者重要的信息。 可以用于生产环境中输出程序运行的一些重要信息,但是不能滥用,避免打印过多的日志。 |
WARN(警告) | 表明会出现潜在错误的情形,有些信息不是错误信息,但是也要给程序员的一些提示。 |
ERROR(错误) | 指出虽然发生错误事件,但仍然不影响系统的继续运行。打印错误和异常信息。 如果不想输出太多的日志,可以使用这个级别。 |
FATAL(致命) | 指出每个严重的错误事件将会导致应用程序的退出。 这个级别比较高,属于重大错误,可以直接停止程序了。 |
2.2 设置日志级别
系统日志默认级别为「ERROR」。
超级管理员登录数据决策系统,点击「管理系统>智能运维>平台日志」,点击「全局设置」,可根据需求自行调整日志级别。如下图所示:
注:调节日志级别,仅影响系统日志的输出,不影响操作日志。
2.3 清理系统日志
1)版本 5.1.11 之前
系统不自动清理%BI_HOME%\logs\fanruan.log文件。
若安装「BI日志自动清理」插件,则系统日志默认级别修改为「INFO」,每日凌晨系统自动检测%BI_HOME%\logs\fanruan.log文件,仅保留最近1个月的logs文件。
2)版本 5.1.11 及之后
产品内置「BI日志自动清理」插件,系统日志默认级别为「INFO」。每日凌晨系统自动检测%BI_HOME%\logs\fanruan.log文件,仅保留最近1个月的logs文件。
如需取消自动清理系统日志,请卸载「系统管理>插件管理」中的「BI日志自动清理」插件。
3. 操作日志编辑
3.1 查看操作日志
操作日志默认存储在%BI_HOME%\webapps\webroot\logs\cubes文件夹中,不支持修改存储位置。
常用的系统日志,系统已主动为您分析,详情请参见:平台日志 。
全部的系统日志,存储在cubes文件夹中,可通过数据连接进行查询分析。详情请参见:报表日志 LogDB 数据库 。
3.2 修改存储位置
操作日志默认存储在%BI_HOME%\webapps\webroot\logs\cubes文件夹中,5.1.7 及之后版本的工程支持修改存储位置。
1)Windows 修改%Tomcat%/bin目录下的 catalina.bat 文件,增加配置,配置完成后重启工程。
等于号“=”后面指定路径,相对路径会自动在bin目录下生成logs文件夹,也可使用绝对路径。
SET JAVA_OPTS="$JAVA_OPTS -DSWIFT_HOME=logs”"
2)Linux/Unix 修改%Tomcat%/bin目录下的 catalina.sh 文件,增加配置,配置完成后重启工程。
等于号“=”后面指定路径,相对路径会自动在bin目录下生成logs文件夹,也可使用绝对路径。
JAVA_OPTS="$JAVA_OPTS -DSWIFT_HOME=logs"
3.3 清理操作日志
超级管理员登录数据决策系统,点击「管理系统>智能运维>平台日志」,点击「全局设置」,可对操作日志文件进行清理,可以设置「自动清理」和「手动清理」。
1)自动清理:每隔 3 个月自动清理一次,保留近 3 个月的数据。最少会保留3个月,最多实际上会有6个月。
2)手动清理:默认保留近 3 个月的数据,可选择 0天、1天、1周、1个月、3个月、6个月、12个月。
注1:近 3 个月是指当前日期往前 3 个月的数据,例如 2019-8-19 日手动清理,默认保留 2019-5-19 ~ 2019-8-19 日的数据。
注2:清理日志后发现 cubes 文件夹占用空间仍然很大,原因在于只是清理文件夹里面的文件,不会清理文件夹,该目录下文件夹特别多,而且占用比较大的空间。
注3:清理后显示的「当前日志大小」不是磁盘占用空间的概念,而是实际所有文件的大小。详情参见:
Windows:windows系统中文件大小和占用空间不同的原因解析
Linux:du和ls查看文件大小的区别
如下图所示:
3)清理预警
日志文件过大时通知相关用户,相关用户可对日志进行手动清理,减小日志文件大小。
开启预警功能,设置触发条件,例如日志文件大于 xxxM。
短信提醒需要「开启短信功能」,详细设置请查看 短信 ,同时邮件提醒也需要配置发件人,详细设置请查看 邮箱 。
然后勾选「短信提醒、平台消息、邮件提醒」,再分别设置设置收件人,设置完成后点击「保存」,如下图所示:
短信提醒效果如下图所示:
平台消息效果如下图所示:
邮件提醒效果如下图所示: