1. 概述编辑
1.1 版本
| 报表服务器版本 | 系统运维插件版本 | 功能变更 |
|---|---|---|
| 11.0 | V1.0 | - |
| 11.0.3 | V1.0 | 新增支持一键配置检测项的值 |
| 11.0.7 | V1.3.1 | 新增部分系统检查内容 支持生成并下载巡检报告 |
1.2 应用场景
如果内存环境配置不合理，非常容易导致报表系统宕机，且此类宕机情况很难复现，排查困难。
1.3 功能简介
FineReport11.0中内置了系统运维插件，直接拥有此功能。
「系统检查」，可帮助用户检查系统中的各项配置是否合理，以辅助用户优化环境配置，更好地防止宕机情况的发生。
用户手动检查/平台定期检测报表系统各项环境配置是否合理
当系统环境配置不合理时，推送消息给用户
为用户提供系统环境配置的合理改进指导
本文将简单介绍系统检查功能的检查逻辑和检查项。
2. 系统检查项编辑
V1.3.1之前版本的插件，仅支持环境配置检查。
V1.3.1及之后版本的插件，支持进行的巡检内容，包括系统检查、系统运行状态、端口检查、网络检查、服务联通性检查、业务检查、环境检查、磁盘检查、非容器化部署检查、虚拟机检查。如下表所示：
详情请参见：运维监控指导手册 第三章。
| 巡检内容 | 检测项 |
|---|---|
| 系统检查 | 仅输出信息，不进行配置推荐，检测项包括： 操作系统信息、glibc/gcc版本、hostname、时区信息、CPU主频、核心数、内存大小、已使用内存、空闲内存、交换分区、检测时间、根目录磁盘、根目录磁盘剩余 |
| 系统运行状态 |
|
| 端口检查 |
|
| 网络检查 | 检查文件服务器、外接数据库、状态服务器和应用之间通信是否正常，是否能够ping通，是否存在丢包情况 |
| 服务联通性检查 | 检查工程与Redis组件、Sftp组件、FineDB数据库之间是否联通 |
| 业务检查 |
|
| 环境检查 |
|
| 磁盘检查 | 仅输出信息，不进行配置推荐，检测项包括： 磁盘空间、已使用磁盘空间、空闲磁盘空间、顺序读取、顺序写、随机读、小文件创建、小文件删除 |
| 非容器化部署 | 仅输出信息，不进行配置推荐，检测项包括： 进程用户、服务器主要文件夹权限 |
| 虚拟机检查 |
|
检查后存在问题的检查项，会在页面中展示，如下图所示：
3. 一键配置编辑
11.0.3 及之后版本，支持一键配置系统检查建议值。
3.1 不支持的环境
对于以下环境，不支持一键配置功能：
1）非 Tomcat 部署环境，不支持一键配置系统检查建议值，例如was部署、weblogic部署等。
2）FineReport 和FineBI 集成的环境，不支持一键配置系统检查建议值。
3）工程系统中若存在自行设置的 setenv 文件，不支持一键配置系统检查建议值。
4）服务形式启动的 Tomcat 工程，不支持一键配置系统检查建议值。
5）Windows环境下 exe 启动的 Tomcat 工程，不支持一键配置系统检查建议值。
6）设计器环境下的 FineReport 工程，不支持一键配置系统检查建议值。
7）系统物理内存为 16 GB及以下的环境，不支持一键配置系统检查建议值。
8）集群工程环境，不支持一键配置系统检查建议值。
3.2 配置方法
若当前工程环境满足一键配置的要求，且存在需要一键配置的检查项，在「系统检查」页面左上角出现按钮「查看建议配置」。
点击「查看建议配置」，即可勾选需要配置的检查项，点击「应用配置」，即可一键配置异常项的值。配置成功后，跳出提示「应用配置成功，重启服务器后生效」。
报表工程重启后，可以发现刚刚的异常项均已成功配置。
注1：支持一键配置的检查项为：堆内内存、堆外NIO内存、堆外FineIO内存、垃圾回收器类型、老年代与新生代比例、栈空间。
注2：若没有文件读写权限或者无法修改配置文件时，提示「应用配置失败：没有配置文件读写权限」，点击「确定」，则修改失败，返回系统检查界面。
4. 巡检报告编辑
每一次系统检查结束后，会生成一个巡检报告。用户可将报告下载到本地，或在线预览。如下图所示：
报告内容包括上述所有检查项。报告示例如下图所示：
5. 触发检查编辑
5.1 手动检查
系统重启后，每小时获取一次系统的配置情况。
第一次进行系统检查时，需要点击「开始诊断」按钮，系统自动进行检查，获取最近一次的系统配置，更新检查结果。
再次进行进行系统检查时，点击「重新诊断」按钮，系统自动进行检查，获取最近一次的系统配置，更新检查结果。
5.2 自动检查
在「系统检查」页面，管理员可开启「系统自动检查」并保存。
开启后，系统在每日凌晨 1 点进行自动检查，存在不合理配置时可通过短信提醒、平台消息、邮件提醒三种形式通知管理员。
注：
1）短信提醒：需要开启短信平台，详细点击 短信
2）邮件提醒：需要配置邮件服务器，详细点击 邮箱
3）平台消息：需要在负载均衡层面配置websocket端口并且开放，相关文档：Websocket端口被占用/无法使用
6. 运维工具编辑
运维接口密钥，是在「运维平台」中绑定当前工程的接口密钥，详情请参见：运维平台产品简介
