作者:苏渡苇
项目地址: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 里看数据目录有没有文件:
@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:
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,不是整对象替换:
// 空密码:保留原授权码
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。