Skip to content
Klag Klag

Native Image

Klag publishes a GraalVM native image alongside the JVM image. It starts in ~70–100 ms using ~44 MB RSS, versus ~500 ms / ~119 MB for the JVM image, with the same config, endpoints, and metrics.

Run the published image

Section titled “Run the published image”

The native image is tagged :native and :<version>-native:

Terminal window
docker run -e KAFKA_BOOTSTRAP_SERVERS=kafka:9092 \
           -e METRICS_REPORTER=prometheus \
           -p 8888:8888 \
           themoah/klag:native

Build it yourself

Section titled “Build it yourself”

Requires a GraalVM JDK 21 (LTS) with native-image (e.g. sdk install java 21.0.2-graalce). Run Gradle with that JDK as JAVA_HOME/GRAALVM_HOME.

Terminal window
gradle nativeCompile          # -> build/native/nativeCompile/klag (standalone binary)
docker build -f Dockerfile.native -t klag:native .   # distroless runtime image

Benchmark startup and memory:

Terminal window
scripts/benchmark-startup.sh native - build/native/nativeCompile/klag

How it’s configured

Section titled “How it’s configured”

Native config lives in build.gradle.kts (the graalvmNative block) plus reachability hints in src/main/resources/META-INF/native-image/. Reflection metadata for Netty, kafka-clients, logback, and Micrometer comes from the GraalVM Reachability Metadata Repository (auto-enabled). The entry point is KlagLauncher (direct new MainVerticle(), no reflective Vert.x launcher).