Cheat Sheet — JVM Flags cho Java 21 trong Container

Các flag JVM quan trọng khi chạy Spring Boot trên Java 21 trong container: sizing heap theo RAM limit, chọn GC (G1/ZGC), log GC, heap dump, JFR và truyền cấu hình qua biến môi trường.

Module 08

Heap & nhận diện container

Heap & nhận diện container
MụcÝ nghĩa & cách dùng
-Xms512mKích thước heap ban đầu. Trong container thường đặt bằng -Xmx (ví dụ qua tỉ lệ RAM) để JVM không phải co giãn heap và tránh bị OOM kill bất ngờ khi heap phình muộn.
-Xmx2gKích thước heap tối đa tuyệt đối. Trong container nên ưu tiên cách tính theo tỉ lệ RAM (Initial/MaxRAMPercentage) hơn là ghim cứng -Xmx, vì limit thay đổi theo môi trường deploy.
-XX:InitialRAMPercentage=50Heap ban đầu bằng 50% RAM mà JVM nhìn thấy (trong container là memory limit nếu UseContainerSupport bật). Thay cho -Xms khi sizing theo tỉ lệ.
-XX:MaxRAMPercentage=75Heap tối đa bằng 75% RAM limit — chừa phần còn lại cho metaspace, thread stack, direct buffer và bộ nhớ native khác. Đây là cách sizing heap phổ biến cho Spring Boot trong container.
-XX:+UseContainerSupportJVM đọc CPU/memory limit của container (cgroup) để tính heap và số thread GC/JIT. Flag này bật mặc định từ JDK 10+ trên Linux, chỉ cần ghi rõ để tài liệu hóa khi cần.

Chọn & tinh chỉnh Garbage Collector

Chọn & tinh chỉnh Garbage Collector
MụcÝ nghĩa & cách dùng
-XX:+UseG1GCChọn G1 GC — GC mặc định của JVM trên máy nhiều nhân/heap lớn, cân bằng throughput và pause. Là lựa chọn an toàn mặc định cho đa số service Spring.
-XX:+UseZGCChọn ZGC — GC có pause rất thấp (dưới mili-giây) và gần như không tăng theo kích thước heap; trên Java 21, ZGC thế hệ mới (generational) dùng thêm -XX:+ZGenerational. Phù hợp khi độ trễ đuôi (p99) là ưu tiên số một.
-XX:MaxGCPauseMillis=200Mục tiêu mềm cho thời gian pause tối đa của G1: GC tự điều chỉnh vùng nhớ/chu kỳ để hướng tới mục tiêu này — đây là mục tiêu phấn đấu, không phải giới hạn cứng.

Log, dump & sống còn khi OutOfMemory

Log, dump & sống còn khi OutOfMemory
MụcÝ nghĩa & cách dùng
-Xlog:gc*:file=/var/log/app/gc.log:time,uptime:filecount=5,filesize=10mUnified logging của Java 21: ghi log GC (mọi tag bắt đầu bằng gc) ra file có xoay vòng. Dùng để phân tích pause và hành vi GC sau sự cố thay vì đoán.
-XX:+HeapDumpOnOutOfMemoryErrorTự chụp heap dump khi JVM gặp OutOfMemoryError để phân tích offline bằng công cụ như Eclipse MAT/jhat.
-XX:HeapDumpPath=/var/log/app/heapdump.hprofNơi ghi file heap dump. Trong container, trỏ tới volume/PVC còn trống đủ lớn — heap dump có kích thước xấp xỉ heap.
-XX:+ExitOnOutOfMemoryErrorThoát tiến trình ngay khi OutOfMemoryError xảy ra thay vì để ứng dụng chạy tiếp trong trạng thái hỏng; orchestrator (Kubernetes) sẽ khởi động lại pod sạch.

Profiling: JFR & bộ nhớ native

Profiling: JFR & bộ nhớ native
MụcÝ nghĩa & cách dùng
-XX:StartFlightRecording=duration=120s,filename=/tmp/recording.jfrBật Java Flight Recorder ngay từ lúc khởi động, ghi ra file .jfr để mở bằng JDK Mission Control. JFR tích hợp sẵn trong JDK 21, overhead thấp, dùng được trên production.
jcmd <pid> JFR.start duration=120s filename=/tmp/recording.jfrKích hoạt JFR trên tiến trình JVM đang chạy mà không cần khởi động lại — cách lấy dữ liệu profiling ngay giữa sự cố.
jcmd <pid> VM.native_memory summaryXem phân bổ bộ nhớ native (metaspace, thread, code cache, direct...) — điều kiện tiên quyết là JVM được khởi động với -XX:NativeMemoryTracking=summary.
-XX:NativeMemoryTracking=summaryBật theo dõi bộ nhớ native ở mức summary (overhead nhỏ) để khi RSS vượt heap vẫn truy được phần native nào đang phình.

Truyền flag & cấu hình qua môi trường

Truyền flag & cấu hình qua môi trường
MụcÝ nghĩa & cách dùng
JDK_JAVA_OPTIONSBiến môi trường được launcher java của JDK 9+ tự đọc và tiền tố vào dòng lệnh — tiện để tiêm flag JVM trong container mà không sửa ENTRYPOINT. Giá trị của nó được áp dụng trước các đối số dòng lệnh.
JAVA_TOOL_OPTIONSBiến môi trường được mọi tiến trình JVM tự đọc khi khởi động (kể cả khi chạy qua công cụ khác). Mạnh nhưng dễ gây bất ngờ vì áp dụng cho mọi JVM trong container; chỉ dùng khi thật cần và ghi chú rõ.
-Dspring.profiles.active=prodSystem property kích hoạt profile Spring khi khởi động (tương đương --spring.profiles.active=prod hoặc biến SPRING_PROFILES_ACTIVE). Quyết định bean @Profile và file cấu hình application-prod.yml nào được nạp.
--add-opens java.base/java.util=ALL-UNNAMEDMở một package của module JDK cho code không module truy cập reflective — chỉ cần khi thư viện cũ dùng reflection sâu vào nội bộ JDK và bị InaccessibleObjectException trên Java 21. Thêm từng gói cụ thể theo lỗi thực tế, không mở tràn lan.