1. 概述编辑
1.1 版本
| 报表服务器版本 | JAR包版本 | 功能变动 |
|---|---|---|
| 10.0.15 | 2021-04-09 | 新增宕机处理功能 |
1.2 应用场景
报表工程部署在服务器上后，会因为各种原因导致宕机。宕机后若直接重启没有抓取 DUMP LOG ，就很难定位到真实原因，从而无法快速解决问题和做一些防止再发生的预防措施，造成的时间和精力损失无法估计，对服务器运维非常不友好。
JAR 包版本在 2021-04-09 之后报表工程，FineReport 数据决策系统中新增了「宕机处理」的功能，通过此功能，报表工程可以自动生成 DUMP LOG 和重启。发生宕机后，通过分析生成的 DUMP LOG 文件，可以快速定位宕机原因，及时处理宕机问题和做一些有效的预防措施，为所有用户增加一道保险。
1.3 功能简介
注：报表与 BI 集成的用户在使用此功能时，优先调用 BI 工程的「宕机处理」功能，禁用报表工程的「宕机处理」功能，以保证不影响 BI 工程的运行。
「宕机」处理配置，分平台端和客户端。
1）超管登录数据决策系统，点击「管理系统>智能运维>宕机处理」，就可以看到平台端对应的功能模块。如下图所示：
模块下功能主要分四部分，分别为运行监测、宕机处理、内存堆栈导出记录、服务器重启记录。
2）工程启动后，浏览器输入 http://IP:端口（默认为12100）/operation/tool，超管使用账号密码登录后便可以进入用户端配置界面，看到用户端对应的功能模块。如下图所示：
2. 平台端编辑
2.1 运行监测
工程启动后，会先对端口状态、JDK环境、堆外内存、部署情况进行检测。检测有问题则提醒用户做相应修改或者禁用功能，无问题则持续稳定运行，如下图所示：
每项对应的检查内容如下表所示：
| 序号 | 检查项 | 检查逻辑 | 当前状态 | 修改建议 |
|---|---|---|---|---|
| 1 | 端口 | 宕机自动处理工具默认的端口为 12100，若端口被占用或未开启，会导致宕机自动处理工具无法使用，所以首先需要检测 12100 端口是否可用。 | 12100端口可用（端口开启且未被占用） | 此项配置良好，无需调整 |
| 12100端口状态异常（端口未被开启或被占用） | 建议开放12100端口或设置其他端口以保证系统正常运行 | |||
| 2 | JDK | 用户系统内无 JDK 环境或 JDK 环境异常时，宕机自动处理功能无法正常实现打 DUMP 和打堆栈，所以需要检测用户是否配置了 JDK 环境。 | 已配置（系统已配置好JDK） | 此项配置良好，无需调整 |
| 未配置（系统配置JDK有问题） | 建议增加系统JDK配置以保证系统正常运行 | |||
| 3 | 堆外内存 | 宕机自动处理工具运行时需要一些内存，堆外内存不足说明内存配置极度不合理，不仅无法使用宕机自动处理功能，还有严重的宕机风险和隐患，所以需要检测内存配置。 | 显示堆外内存大小 | 此项配置良好，无需调整（堆外内存大于300M） |
| 强烈建议物理机总内存减去系统所在容器使用内存不小于10GB | ||||
| 4 | 部署方式 | 检测是否为 Tomcat 部署、是否为设计器部署，对于非 Tomcat 容器部署以及设计器部署的用户，不支持此功能。 | Tomcat | 此项配置良好，无需调整 |
| 非Tomcat | 建议使用Tomcat容器部署 |
当监测到端口、JDK、堆外内存影响功能使用时，除在「修改意见」处显示提示外，还会通过平台消息和系统右下角弹窗消息提醒用户。如下图所示：
消息提醒内容为：当前宕机自动处理工具不可用，为保证功能正常运行，建议你点击处理查看详情
点击「处理」即可跳转到跳转到「宕机处理」平台配置页面，从而对其进行相应的处理。
2.2 宕机处理
用户可以在「宕机处理」页面做一些配置设置，可设置的为宕机自动处理、自动导出内存堆栈、宕机自动重启、宕机通知、端口设置。如下图所示：
2.2.1 宕机自动处理
当系统配置满足「运行监测」中的运行条件时，工具自动运行，此开关默认开启；当系统配置不满足运行条件时，开关图标灰化，不能编辑修改。
2.2.2 自动导出内存堆栈
若「宕机自动处理」未开启，此项灰化处理，不能编辑修改；若「宕机自动处理」开启，此项默认关闭，开启后当发生宕机时，会自动导出宕机日志，导出位置为：%Tomcat%\logs\FineLog\日期
2.2.3 宕机自动重启
若「宕机自动处理」未开启，此项灰化处理，不能编辑修改；若「宕机自动处理」开启，此项默认关闭，开启后当发生宕机时会自动重启工程。
2.2.4 宕机通知
若「宕机自动处理」未开启，此项灰化处理，不能编辑修改；若「宕机自动处理」开启，此项默认关闭，开启后，可配置短信提醒、平台消息提醒、邮箱提醒，当发生宕机时会按配置的通知方式通知到用户。
2.2.5 端口设置
「宕机处理工具」默认的端口为 12100，当 12100 端口异常时，可以在此配置其他端口号。输入新的端口号后，点击测试，若新配置端口号存在异常，则弹窗提示：端口异常，请重新设置；若端口无异常，则弹窗提示：端口可用，保存后宕机自动处理工具将在新端口重启。
2.3. 处理记录
「内存堆栈导出记录」和「服务器重启记录」分别记录了自动生成 DUMP LOG 记录和服务器重启的记录。如下图所示：
其中包括导出（重启）的开始时间、时长、是否成功、如果失败，失败的原因等。
3. 客户端编辑
工程启动后，浏览器输入 http://IP:端口（默认为12100）/operation/tool，超管使用账号密码登录后便可以进入用户端配置界面。
服务器正常运行时，画面显示：正常运行中，如下图所示：
发生宕机时，画面显示：已宕机，正在处理中，如下图所示：
用户可手动终止工具对于宕机问题的处理，进行终止后，页面显示：已终止宕机自动处理，请及时手动重启系统，如下图所示：
若小工具重启工程失败，页面显示：宕机自动重启失败，请及时手动重启系统，如下图所示：
3.1 宕机处理
「宕机处理」部分可以设置是否开启「宕机自动处理」和宕机消息通知。如下图所示：
宕机自动处理：当系统配置满足宕机工具运行条件时，工具自动运行，此开关默认开启，当系统配置不满足运行条件时，图标灰化，不能编辑修改。
宕机通知：若「宕机自动处理」未开启，此项灰化处理，不能编辑修改；若「宕机自动处理」开启，此项默认关闭，开启后，可配置短信提醒、邮箱提醒，当发生宕机时会按配置的通知方式通知到用户。
3.2 输出堆栈
用户可以在「输出堆栈」处，输出线程堆栈和内存堆栈文件，点击相应位置导出即可。如下图所示：
成功后提示：输出成功，否则提示输出失败，输出的堆栈文件位置为：%Tomcat%\logs\FineLog\日期