如何在Keycloak-18.0.0中配置日志保留与应用级日志轮转？

Keycloak 18.0.0基于Quarkus架构，不再沿用Wildfly的日志配置体系，需通过Quarkus的配置文件实现日志轮转，具体步骤如下：

1. 定位配置文件 #

在Keycloak安装目录下找到conf/quarkus.properties，若文件不存在则直接新建。

2. 添加日志轮转配置 #

将以下配置写入quarkus.properties，按需调整参数值：

# 定义按大小轮转的文件处理器
quarkus.log.handler.file.type = size-rotating-file
quarkus.log.handler.file.name = keycloak.log
quarkus.log.handler.file.path = ${kc.log.dir:../logs}/keycloak.log
quarkus.log.handler.file.max-file-size = 100M
quarkus.log.handler.file.max-backup-index = 10
quarkus.log.handler.file.formatter = "%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n"

# 关联日志处理器到目标日志类别
quarkus.log.root.handlers = FILE, console
quarkus.log.category."org.keycloak".level = INFO
quarkus.log.category."org.keycloak".handlers = FILE

参数说明 #

• max-file-size：单个日志文件的最大容量，支持M(兆)、G(吉)等单位，示例为100M
• max-backup-index：保留的历史轮转日志文件数量，示例保留最近10份
• path：日志文件存储路径，${kc.log.dir}是Keycloak内置环境变量，默认指向安装目录下的../logs
• formatter：日志输出格式，可根据需求自定义时间、日志级别、类名等字段

3. 生效配置 #

保存配置文件后，重启Keycloak服务，日志将自动按设定规则进行大小轮转。

内容的提问来源于stack exchange，提问作者Jaise George