【Spring Insight 技术分享】runtime-settings.json 的妙用

作者:苏渡苇

项目地址 :github.com/iweidujiang...(欢迎 Star)

设置页的配置,保存到哪了?

上一篇讲 AI 过不了门就降级:没开开关、没填 key,解释接口仍是 200。人下一步通常会打开侧栏 设置,填 webhook、SMTP、模型地址。

这些值如果写回 application.yml,Docker 镜像和挂载的配置文件会被改脏,重启还得和启动参数抢优先级。

我现在的做法是:yml 只负责第一次启动,控制台保存另落一份 runtime-settings.json,内存用 AtomicReference 指着当前这份。

告警扫描和 AI 解释每次都从这份生效配置读,不必重启 Server。

代码在此:InsightRuntimeSettingsService、InsightRuntimeSettingsStore、InsightSettingsController

yml 只拍一张启动快照

InsightServerAlertProperties / InsightServerAiProperties 还是普通的 @ConfigurationProperties,启动时从 application.yml 或环境变量灌进来。InsightRuntimeSettingsService 在 @PostConstruct 里看数据目录有没有文件:

java 复制代码
@PostConstruct
void init() {
    InsightRuntimeSettings fromFile = store.loadOrNull();
    if (fromFile != null) {
        current.set(fromFile);
    } else {
        current.set(fromBoot());
    }
}

有文件就以文件为准,没有才把 boot 属性抄进内存。

之后告警、AI 不再去读那两个 Properties Bean,而是走 effectiveAlert() / effectiveAi(),内部把 current 转回同一套属性对象。

上一篇的 gateOrNull、status() 灰掉解释按钮,读的都是 effectiveAi()。设置页刚保存完,下一次点解释就能看到新 key,不用重启。

AtomicReference 从 JDK 5 就有:get / set 对引用本身是原子的。

这里没有复杂的 CAS 重试,要的是扫描线程和 HTTP 线程同时看到同一份对象,改完 set 一次,后面读到的就是新图。

磁盘上那份 JSON 和 Span 放在一起

文件名写死为 runtime-settings.json,目录跟存储模式走:sqlite 用库文件的父目录,file 模式用 spans 文件的父目录,内存模式落到 ./data。

和链路数据同级,备份数据目录时设置一起走,换机器不用再翻一遍环境变量。

写入故意拆成两步,避免写到一半进程挂了、下次启动读到半截 JSON:

java 复制代码
Path tmp = path.resolveSibling(FILE_NAME + ".tmp");
objectMapper.writerWithDefaultPrettyPrinter().writeValue(tmp.toFile(), settings);
Files.move(tmp, path, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);

先写旁边的 .tmp,再 Files.move 盖过去。ATOMIC_MOVE 是 NIO2(Java 7)给的语义:同一文件系统上,目标路径要么还是旧文件,要么已经是完整新文件。读失败或文件损坏时 loadOrNull 返回 null,启动退回 yml 默认,不会把 Server 起不来。

控制台接口很薄:GET /api/v1/ui/settings 出脱敏视图,PUT 调 updateAndApply。

空密钥表示别覆盖,回传也不给明文

设置页再次打开时,密码框、API Key 框是空的,这是故意的。publicView 只给 passwordConfigured / apiKeyConfigured 两个布尔,webhook URL、模型名可以回显,密钥不行。

保存时走 merge,不是整对象替换:

java 复制代码
// 空密码:保留原授权码
if (StringUtils.hasText(p.getPassword())) {
    e.setPassword(p.getPassword());
}
if (StringUtils.hasText(patch.getApiKey())) {
    out.setApiKey(patch.getApiKey());
}

人只改了阈值或模型名,空着的 key 不会把磁盘上已有的密钥冲掉。

current 先 deepCopy 再改,避免扫描线程读到改到一半的对象。

告警调度也吃这套:线程约 60 秒扫一轮,每一轮 scan() 开头重新 effectiveAlert()。

yml 里 enabled: false 也能先把 Server 拉起来,进控制台再开 webhook,下一轮扫描就推,不用为了改一个 URL 重启进程。

热配置要的是覆盖关系,不是再造一套 Spring

很多人会想到 @RefreshScope、Spring Cloud Config。

Insight Server 就一个进程、两块可改配置(告警和 AI),为这两项拉配置中心不划算。

yml 当出厂默认,JSON 当用户覆盖,AtomicReference 当当前指针,写文件用临时文件改名。

调用方约定也很简单:要生效值就问 Service,不要缓存一份 Properties 放到自己的字段里。解释服务、告警调度都是每次调用再取,设置页才能「保存即生效」。

最后:欢迎围观 Spring Insight

Spring Insight 是给 Spring Boot / Spring Cloud 用的轻量监测工具:业务服务加 spring-insight-agent-starter 上报,旁边跑一个 insight-server,控制台就能看服务拓扑和链路详情。

仓库在这:

🔗 GitHub :github.com/iweidujiang...

跪求 Star,遇到问题直接开 Issue。

相关推荐
databook1 小时前
处理一批 PDF,怎么算真的处理完了
后端·python
苏三说技术2 小时前
为什么越来越多人用 Docling ? - 苏三说技术
后端
nice_lcj5202 小时前
【从零理解计算机网络 · 12】登录态的载体:Cookie、Session、Token 在网络层怎么走
后端·计算机网络·面试·jwt·token·cookie·session
Qiuner3 小时前
用 SoduWork 跑通浏览器截图:派活、验货与顺手修 Bug
ai·开源·soduwork
考虑考虑3 小时前
JDK27中的加密对象的 PEM 编码
java·后端·java ee
Coder_shen4 小时前
汇川 EVO 系列 PLC EtherNet/IP(CIP)协议通信驱动的 C# 实现
后端
行百里er4 小时前
【Spring Insight 技术分享】如何让 AI 解释失败也不拖垮控制台
后端·spring cloud·开源
行者-全栈开发4 小时前
SpringBoot + GraalVM 原生编译实战:启动时间从8秒到0.5秒的极致优化
java·spring boot·后端
CoderYanger4 小时前
Java EE 进阶:10. MyBatis-Plus使用(第一弹)
java·spring boot·后端·sql·spring·java-ee·mybatis