Java / 系统课时

开启统一 GC 日志

开启统一 GC 日志

JDK 21 的 GC 排查应先把证据稳定记录下来,而不是等停顿发生后再猜原因。本篇给出一套可直接放入启动参数的 Unified Logging 配置,同时记录 GC、堆变化与 Safepoint,并说明如何验证日志确实可用。

学习目标

  • 使用 JDK 21 的 -Xlog 同时记录 GC 与 Safepoint 事件。
  • 从日志中识别 GC 前后堆占用、停顿时长和 Safepoint 总耗时。
  • 配置日志滚动,并能处理路径权限、日志过量和容器落盘等常见问题。

先确定基线要记录哪些事件

JDK 21 使用统一日志框架。对 GC 基线而言,gc* 比单独的 gc 更合适:星号会匹配带有 gc 的复合标签,因此能同时拿到 [gc,start]、[gc,heap] 等信息。safepoint=info 则记录 JVM 进入安全点时的总体耗时,可发现并非由 GC 引起的停顿。

建议保留 time、uptime、level、tags 四类装饰字段。绝对时间便于和应用、网关、监控告警对齐;JVM uptime 便于比较进程生命周期;level 与 tags 则用于后续过滤。基线阶段先用 info,只有现有信息不足时才临时提高到 debug 或 trace。

配置带滚动的 GC 与 Safepoint 日志

下面以 Linux 服务为例。将两个 <PATH> 替换为实际目录和 JAR 路径;日志目录必须在启动 JVM 之前存在并可写。

bash
LOG_DIR="<PATH>/jvm-logs"
APP_JAR="<PATH>/app.jar"

mkdir -p "$LOG_DIR"
java "-Xlog:gc*=info,safepoint=info:file=${LOG_DIR}/gc-%p.log:time,uptime,level,tags:filecount=5,filesize=20M" -jar "$APP_JAR"

预期结果:应用正常启动后,<PATH>/jvm-logs 下会出现以 JVM PID 命名的 gc-<PID>.log,GC 初始化、回收和 Safepoint 事件持续写入该文件。业务应用自身的标准输出内容与本参数无关。

这里 filesize=20M 是单个滚动文件的目标大小,filecount=5 表示除当前活动文件外最多保留 5 个轮转文件。由于文件名包含 %p,不同 JVM 进程不会互相写同一个活动文件,但服务多次重启后的旧 PID 文件仍需要由日志系统或定期清理策略统一保留。

验证日志不是“开了但没法用”

启动后不要只检查文件存在,还要确认标签和时间字段齐全。下面从目标日志抽取前 20 条 GC 或 Safepoint 记录;<PID> 替换为实际 PID。

bash
LOG_FILE="<PATH>/jvm-logs/gc-<PID>.log"
grep -E '\[gc|\[safepoint' "$LOG_FILE" | head -n 20

预期输出会因 GC 算法和负载不同而变化,但格式应包含时间、uptime、级别与标签,并能看到类似下面的 JDK 21 统一日志结构。

text
[<TIME>][<VALUE>s][info][gc,init] ...
[<TIME>][<VALUE>s][info][gc] GC(<ID>) Pause Young ... <VALUE>M-><VALUE>M(<VALUE>M) <VALUE>ms
[<TIME>][<VALUE>s][info][safepoint] Safepoint "<VALUE>", Time since last: <VALUE> ns, Reaching safepoint: <VALUE> ns, Cleanup: <VALUE> ns, At safepoint: <VALUE> ns, Leaving safepoint: <VALUE> ns, Total: <VALUE> ns

GC 汇总行中的 A->B(C) 可以读成“回收前已用堆约 A,回收后约 B,当时堆容量约 C”;最后的毫秒值是该 GC 停顿行记录的持续时间。[safepoint] 行则把到达安全点、清理、在安全点执行以及离开安全点拆开,因此它能帮助区分“GC 本身慢”与“线程迟迟到不了 Safepoint”等问题。

把 GC 行和 Safepoint 行关联起来

一次 Stop-The-World GC 通常会对应 Safepoint,但两者不能简单当作同一个指标。GC 日志关注回收器做了什么、回收前后内存怎样变化;Safepoint 日志关注所有 Java 线程为了进入 JVM 安全状态付出了多少时间。类重定义等 VM 操作也可能产生非 GC Safepoint。

分析停顿时应按同一时间窗口对齐两类记录:先找到延迟尖峰对应的 [safepoint] Total,再查看附近是否有 GC(<ID>) Pause,最后用 [gc,heap] 等复合标签确认堆区域变化。如果 Safepoint 很长但附近没有匹配的 GC Pause,就不应把根因直接归给垃圾回收。

典型失败先查配置而不是调 GC

启动时报 Invalid -Xlog option 时,先运行行内命令 java -Xlog:help 核对当前 JDK 支持的 tags、levels、decorators 与输出选项;不要照搬旧版本参数。若日志文件无法创建,优先检查目录是否存在、运行用户是否有写权限以及磁盘是否只读。

日志量过大时,先保持 info 基线并缩小选择器,而不是长期打开 gc*=trace。只有定位某个阶段需要更多细节时才临时提高对应 tag 的级别。相反,如果只有 [gc] 汇总而看不到堆区域变化,应检查是不是误写成了不带星号的 gc=info。

统一 GC 日志的价值不是“多打一份日志”,而是建立可以和应用延迟、系统指标、线程现场按时间对齐的原始证据。基线配置一旦确定,生产、压测和故障复现环境应尽量保持相同的 tags、级别与时间装饰字段,这样不同时间段的停顿才具有可比性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

开启统一 GC 日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通