缓存运行监控- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：Manto

历史版本：13

最近更新：HeroZ 于 2023-02-23

1. 概述

在抽数缓存功能的使用过程中，用户如果对缓存的使用状况有了解诉求，或想手动处理部分异常缓存时，可进入「管理系统>抽数缓存」目录的「运行监控」界面进行了解。

普通模式界面仅显示部分关键信息，主要适用于用户正常使用缓存及观察缓存运行情况。如下图所示：

注：用户点击「进入开发模式」按钮，将进入开发模式界面。

如下表所示：

参数	说明	可选范围
模板	用于筛选指定模板的缓存使用情况	所有生成过缓存的模板，为空查询全部
数据连接	用于筛选指定数据连接对应的缓存使用情况	所有生成过缓存的数据连接，为空查询全部
缓存状态	用于筛选对应缓存方式的缓存使用情况	内存：表示此缓存存储于内存中已失效：表示此缓存当前已失效，未存储为空查询全部
排序列	用于筛选缓存结果数据量（行*列）在指定范围内的缓存使用情况	为空查询全部
仅显示自动抽数缓存	勾选后，仅显示自动抽数缓存	-

按钮名称	说明
全部失效	点击后所有内存中的缓存将都被失效，缓存历史及规则依旧保留，下次被访问将重新生成缓存内容
全部删除	点击后所有缓存记录将被清空，初始化至未生成缓存的状态，此时开启了缓存的数据集被访问时将重新生成缓存及缓存记录
暂停/恢复缓存	两个按钮分别用于缓存的暂停或恢复
进入开发模式	详情请参见本文第三章内容

整体概况中各指标说明如下表所示：

表格中各个字段含义如下表所示：

字段	说明
id	生成缓存对象的 UUID ，通常一个 id 对应一个 sql 点击缓存 id 可超链至缓存使用趋势图表，按时间线展示缓存的使用情况
模板	使用到此缓存对象的模板，如有多个模板使用，则显示多个来源
数据集	缓存所使用的数据集名称
数据连接	缓存所使用的服务器数据连接名称
行数	缓存结果的数据量
列数	缓存结果的数据量
状态	缓存状态
命中/尝试次数	尝试次数代表缓存同样的 sql 被尝试访问了多少次，命中次数代表其中有多少次是使用缓存的，由于首次生成缓存不可能为命中状态，因此命中次数至少比缓存次数少 1
更新/添加次数	缓存数据被更新或添加过多少次
失效次数	缓存数据被失效过多少次
上次更新时间	上一次缓存数据更新的时间
耗时	上次更新对应的取数耗时
下次更新时间	预计下次进行数据更新的时间，如不会进行自动更新则显示暂无计划
缓存操作	刷新：立即连接数据库进行更新，获取指定缓存的最新数据失效：点击后指定缓存将被失效，缓存历史及规则依旧保留，下次被访问将重新生成缓存内容删除：点击后指定缓存记录将被清除，后续开启了缓存的数据集被访问时将重新生成缓存及缓存记录

点击「下次更新时间」可查看当前缓存的计划明细，如下图所示：

各字段介绍如下表所示：

字段	说明
使用全局配置	是：缓存设置选择「采用服务器设置」否：缓存设置选择「为该数据集单独设置」具体可参见：抽数缓存功能介绍的 3.4 节内容
终止时间	缓存及其策略被终止的时间，如果 SQL 包含某些关键字认为不适合缓存，将会被设置终止时间
是否自动调整	表示更新间隔，是否自动更新都会根据访问情况自动调整
终止前空闲时长	缓存超过这个时长没有被访问，就会被终止（终止表示清除此缓存、访问数据以及策略），默认 72 小时
更新间隔	缓存自动更新的间隔
上次更新时间	缓存的上次更新时间
最近执行时间	最近一次取数的时间
连续更新失败次数	连续自动更新失败的累计次数
上次调度时间	指调度器对该模板上次取数任务的排查时间调度指调度器，调度器对所有取数的任务进行排查

该界面显示详细信息，用于期望了解更多缓存信息的管理员或开发辅助定位问题。如下图所示：

注：部分参数及按钮的介绍已在本文第二章说明。

如下表所示：

参数	说明	可选范围
取数耗时	用于筛选sql耗时在指定范围内的缓存使用情况	0 或正整数，为空查询全部
预计更新时间	用于筛选指定时间范围内即将进行数据更新的缓存使用情况	0 或正整数，为空查询全部
仅自动	用于筛选将进行自动更新的缓存使用情况自动更新：进行自动更新的缓存将定时或定频率进行数据更新，保持持续有效，非自动更新的缓存将在超出存活时间后失效	-
来源	模板访问：正常预览模板生成的缓存推荐预测：开启了「参数预测」功能自动生成的缓存	-

输出 Jstack：点击此按钮可生成 Jstack ，便于出现异常情况时开发人员进行排查。

按钮名称	说明
查看能效值	用于评价已开缓存模板使用好坏的指标，数值为 0～1，效能越高，已开缓存模板的使用效果越好点击后界面如下图所示：
查看缓存更新趋势	点击后超链显示缓存更新的趋势变化，用于确认缓存排队压力情况
已缓存模板	显示已缓存的模板数，点击后超链显示具体缓存的模板及其明细数据点击后界面如下图所示：
查看效能细分指数	展示效能各个维度的分数，辅助确认缓存效果好坏的原因及改进方向点击后界面如下图所示：
调度器监控	点击后超链查看缓存调度器的运作情况
查看 sql	点击后超链显示缓存对应的 sql
查看参数	点击后超链显示缓存对应使用的参数