1.1 版本

1.2 功能简介

针对常见的运维监控诉求场景，给出现有的健康诊断修复方式，帮助客户快速实现对于 FineReport 和 FineBI 应用的运维监控。

1.3 功能简介

帆软应用对系统有一定的配置要求，如果配置不符合要求可能出现使用异常、宕机等风险，因此需要定期对环境及应用的配置情况进行检测，以确保应用的健康运行。

同时管理员需要关注应用的运行状况，及时通过运维手段规避风险或在问题发生后定位并进行排除，实现应用的持续高可用。

系统检查的检测项包括：

系统运行状态的检测项包括：

端口检查的检测项包括：

4.1 检查宕机检测端口

管理员登录工程，点击「管理系统>智能运维>宕机处理」。

• 可查看宕机自动处理工具使用的端口。默认端口为12100。

• 可修改端口，点击「保存」即可。

• 可点击「测试」，测试端口可用性。

4.2 检查集群端口

管理员登录运维平台，点击「管理系统>运维工具>集群节点管理」。

可查看集群各个节点的端口，无法使用的节点飘红。

可编辑节点端口，鼠标悬浮即可出现编辑按钮。

4.3 检查websocket端口

WebSocket 主要用于刷新 token、用户被踢出、平台消息、内存和 CPU 显示、平台日志处当前系统在线人数、数据连接编辑状态的确定。

WebSocket 不开放影响 socket 通信，访问可能异常断开。

用户可根据自己的工程情况选择合适的 WebSocket 端口配置方法，详情请参见下表：

检查文件服务器、外接数据库、状态服务器和应用之间通信是否正常，是否能够ping通，是否存在丢包情况。

服务联通性检查的检测项包括：

业务检查的检测项包括：

环境检查的检测项包括：

磁盘检查的检测项包括：

非容器化部署的检测项包括：

Java虚拟机的检测项包括：

11.1 物理内存、堆内内存、xms配置

1）建议值

说明：

• 注册用户数：系统注册了的用户。

• 在线用户数：用户同时在一定时间段的在线数量（一般注册人数的 5％ - 20％ 之间）。

• 并发用户数：同时向服务器发送请求的用户数（一般是在线人数的 10% - 25% 左右)。
  

• 推荐配置时：70% 场景的平均响应时间低于 3s。

• 最低配置时：70% 场景的平均响应时间低于 5s。

2）修改方式

堆内内存的修改方法，请参见下方表格文档：

11.2 堆外fineIO读内存

1）建议值

建议JVM fineIO读内存使用堆外内存设置为2G。

2）修改方式

fineIO 读内存由-Dfineio.read_mem_limit这个参数来设置。请根据自身工程部署情况选择修改方法。本节展示 Tomcat 环境下设置 fineIO读内存 的步骤。

读内存的默认单位为 GB，支持小数，但不支持使用 g、m 等。建议读内存为写内存的2-3倍，缓存大小建议与写内存大小一致。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.read_mem_limit=2

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dfineio.read_mem_limit=2"

11.3 堆外fineIO写内存

1）建议值

建议JVM fineIO写内存使用堆外内存设置为1G。

2）修改方式

fineIO 写内存由-Dfineio.write_mem_limit这个参数来设置。请根据自身工程部署情况选择修改方法。本节展示 Tomcat 环境下设置 fineIO写内存 的步骤。

写内存的默认单位为 GB，支持小数，但不支持使用 g、m 等。建议读内存为写内存的2-3倍，缓存大小建议与写内存大小一致。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.write_mem_limit=1

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dfineio.write_mem_limit=1"

11.4 headless 模式

1）建议值

建议配置 -Djava.awt.headless=true 以启用 headless 模式

2）修改方式

headless 模式是系统的一种工作模式，如果系统属性 java.awt.headless被设置true，那么headless工具包就会被使用。

本节展示 Tomcat 环境下启用 headless 模式的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true

11.5 dump导出

1）建议值

建议配置HeapDumpOnOutOfMemoryError 及 HeapDumpPath以保证正常导出dump

2）修改方式

1）-XX:+HeapDumpOnOutOfMemoryError参数表示当JVM发生OOM时，自动生成DUMP文件。

2）-XX:HeapDumpPath=${目录}参数表示生成dump文件的路径，也可以指定文件名称，例如：-XX:HeapDumpPath=${目录}/java_heapdump.hprof。

如果不指定文件名，默认为：java_<pid>_<date>_<time>_heapDump.hprof。

本节展示 Tomcat 环境下设置dump导出的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:+HeapDumpOnOutOfMemoryError  -XX:HeapDumpPath=${目录}

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError  -XX:HeapDumpPath=${目录}"

11.6 DisableExplicitGC 参数

1）建议值

建议不对 DisableExplicitGC 参数进行配置，此项配置会导致 System.gc()被禁用，影响系统稳定性。

2）修改方式

-XX:+DisableExplicitGC参数的作用是禁用 System.gc()。System.gc() 是一种保护机制，例如堆外内存满时清理它的堆内引用对象.

用户需要根据实际情况选择是否使用该参数，建议删除该参数（删除下文设置的配置即可）。

本节展示 Tomcat 环境下设置 DisableExplicitGC 参数的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:+DisableExplicitGC

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"

11.7 JDK版本

1）建议值

建议使用「JDK8」中 1.8.0_181 及以上版本

2）检查方式

cmd 命令行进入%Tomcat_home%\bin路径下，输入version，即可查看 JDK 版本。如下图所示：

11.8 栈空间

1）建议值

建议单线程使用栈空间不超过1024KB

2）修改方式

建议单线程使用栈空间不超过1024KB，即 -Xss 的值不超过 1024 。

在设置-Xmx、-Xms参数的位置，添加 -Xss 的值即可，本节展示 Tomcat 环境下设置 -Xss 的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS= -Xms512M -Xmx1024M -Xss1024K

• Linux 系统：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -Xss1024K"

11.9 垃圾回收器

1）建议值

建议 JVM 使用垃圾回收器类型为 ParallelScavenge

2）修改方式

本节以工程部署在 Tomcat 上为例， 介绍设置垃圾收集器为Parallel Scavenge（并行收集器）的方法。

• Windows 系统：打开%Tomcat%/bin目录下的catalina.bat文件进行配置，配置完成后重启工程即可生效。

set JAVA_OPTS= -XX:+UseParallelGC

• Linux：打开%Tomcat%/bin目录下的catalina.sh文件进行配置，配置完成后重启工程即可生效。

JAVA_OPTS="$JAVA_OPTS -XX:+UseParallelGC"

11.10 老年代与新生代大小比例

1）建议值

建议 JVM 老年代与新生代大小比例设置为 2

2）修改方式

堆内老年代与新生代大小比例建议为 2（-XX:NewRatio=2，JVM的默认值）；NewRatio 大小正常生效需要用户不限制新生代大小。

在设置-Xmx、-Xms参数的位置，添加 NewRatio 的值即可，本节展示 Tomcat 环境下设置 NewRatio 的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS= -Xms512M -Xmx1024M -XX:NewRatio=2

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -XX:NewRatio=2"

11.11 recompilationCutoff

1）建议值

建议recompilationCutoff相关参数配置值为-1

2）修改方式

没有配置 RecompilationCutoff 参数/配置的 RecompilationCutoff 参数太小，可能会导致 spider 引擎数据更新缓慢。

本节展示 Tomcat 环境下设置 recompilationCutoff 参数的步骤。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:PerMethodRecompilationCutoff=-1 -XX:PerBytecodeRecompilationCutoff=-1

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:PerMethodRecompilationCutoff=-1 -XX:PerBytecodeRecompilationCutoff=-1"

11.12 debug模式

1）建议值

建议取消debug模式

2）修改方式

debug模式由两个参数控制：-agentlib:jdwp 和 -Xrunjdwp，删除这两个参数即可取消debug模式

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中删除-agentlib:jdwp 和 -Xrunjdwp参数，配置完成后重启工程。

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中删除-agentlib:jdwp 和 -Xrunjdwp参数，配置完成后重启工程。

11.13 zip相关配置-Dsun.zip.disableMemoryMapping

1）建议值

建议配置-Dsun.zip.disableMemoryMapping=true

2）修改方式

配置该参数，可预防 jvm crash

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dsun.zip.disableMemoryMapping=true

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dsun.zip.disableMemoryMapping=true"

11.14 语言配置

1）建议值

建议配置-Duser.country=CN、-Duser.language=zh

2）修改方式

为了防止中文出现乱码现象，要配置好Tomcat 的语言编码

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Duser.country=CN -Duser.language=zh

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Duser.country=CN -Duser.language=zh"

11.15 codecache配置

1）建议值

建议配置-XX:ReservedCodeCacheSize=250m

2）修改方式

ReservedCodeCacheSize参数是调整内存大小的一个设置参数，值的大小设置直接影响到Code Cache的大小。

如果Code Cache的空间不足，可能会导致JVM无法正常运行，导致性能持续降低。

• Windows：在%Tomcat%/bin目录下的catalina.bat文件中新增配置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:ReservedCodeCacheSize=250m

• Linux：在%Tomcat%/bin目录下的catalina.sh文件中新增配置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:ReservedCodeCacheSize=250m"