1 # Welcome to the JDK!
2
3 For build instructions please see the
4 [online documentation](https://openjdk.org/groups/build/doc/building.html),
5 or either of these files:
6
7 - [doc/building.html](doc/building.html) (html version)
8 - [doc/building.md](doc/building.md) (markdown version)
9
10 See <https://openjdk.org/> for more information about the OpenJDK
11 Community and the JDK and see <https://bugs.openjdk.org> for JDK issue
12 tracking.
|
1 # Welcome to the Leyden Prototype Repository!
2
3 The purpose of the Leyden repository is to prototype improvements to the
4 startup time, time to peak performance, and footprint of Java programs, as a part of
5 [Project Leyden](https://openjdk.org/projects/leyden). We solicit feedback from
6 the Java community, with the hope that some of these improvements can be eventually
7 incoporated in future JDK releases.
8
9 ## 0. Disclaimers
10
11 - *This repository contains experimental and unstable code. It is not intended to be used
12 in a production environment.*
13 - *This repository is intended for developers of the JDK, and advanced Java developers who
14 are familiar with building the JDK.*
15 - *The experimental features in this repository may be changed or removed without notice.
16 Command line flags and workflows will change.*
17 - *The benchmarks results reported on this page are for illustrative purposes only. Your
18 applications may get better or worse results.*
19
20 ## 1. Overview
21
22 The Leyden "[premain](https://github.com/openjdk/leyden/blob/premain/)" prototype
23 includes many optimizations that shift work from run time to earlier
24 executions of the application, which are
25 called _training runs_. In a training run, we pre-compute various kinds of information.
26 Importantly, we pre-compile
27 bytecode to native code, guided by observations of the application's actual behavior
28 during the training run.
29
30 The Leyden repository closely tracks the JDK main line. We are typically only a few weeks behind
31 the [main-line JDK repo](https://github.com/openjdk/jdk).
32
33 We have implemented the following improvements:
34
35 - **[Ahead-of-Time Class Loading & Linking (JEP 483)](https://openjdk.org/jeps/483)**:
36 This gives
37 the JVM the ability to put classes in the _linked_ state as soon the application starts up. As a result,
38 we can implement many other time shifting optimizations with considerably simplified assumptions.
39 - Please refer to the [JEP 483 document](https://openjdk.org/jeps/483) for more details.
40
41 - **[Ahead-of-Time Method Profiling (JEP draft 8325147)](https://openjdk.org/jeps/8325147)**: We store method profiles
42 from training runs in the CDS archive, thereby enabling the JIT to begin compiling earlier during warmup.
43 As a result, Java applications can reach peak performance faster.
44 - This feature is enabled by the new diagnostic (`-XX:+UnlockDiagnosticVMOptions`) VM flags `-XX:+RecordTraining` and `-XX:+ReplayTraining`.
45
46 - **[Ahead-of-Time Code Compilation (JEP draft 8335368)](https://openjdk.org/jeps/8335368)**: Methods that are frequently used during the training run can be
47 compiled and stored along with the CDS archive. As a result, as soon as the application starts up
48 in the production run, its methods can be can be natively executed.
49 - This feature is enabled by the new VM flags `-XX:+StoreCachedCode`, `-XX:+LoadCachedCode`, and `-XX:CachedCodeFile`.
50 - Currently, the native code is stored in a separate file, but our plans is to eventually store the native code
51 inside the CDS archive file.
52
53 - **Ahead-of-time resolution of constant pool entries**: many
54 constant pool entries are resolved during the assembly phase. This allows the application to start up faster. Also,
55 the existence of resolved constant pool entries allows the AOT compiler to generate better code.
56 For diagnostic purposes, you can use `-XX:+UnlockDiagnosticVMOptions -XX:-AOTInvokeDynamicLinking`
57 to disable the AOT linking of constant pool entries for the `invokedynamic` bytecode.
58
59 - **Ahead-of-time generation of [Dynamic Proxies](https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/reflect/Proxy.html)**:
60 Dynamic proxies are frequently used by popular application frameworks. We can improve start-up time by generating these proxies ahead of time.
61 - This feature is enabled by the new VM flag `-XX:+ArchiveDynamicProxies`.
62
63 - **Ahead-of-time generation of reflection data**: Reflection data (such as instances of
64 `java.lang.reflect.Method`) are generated by the JVM to support `java.lang.reflect` operations. We can
65 generate these ahead of time to improve start-up.
66 - This feature is enabled by the new VM flag `-XX:+ArchiveReflectionData`.
67
68 - **Class Not Found Cache**: Sometimes application frameworks repeatedly try to load classes that do not exist. This optimization allows such failing lookups to be done quickly without repeatedly scanning the class path.
69 - This feature is enabled by the new VM flag `-XX:+ArchiveLoaderLookupCache`.
70
71 By default, all optimizations listed above are enabled. This simplifies testing of the whole
72 prototype. If necessary for more detailed testing, each feature can
73 be individually disabled by negating its associated flag.
74
75 The names of all of these VM flags will change in a future EA build as we transition from the old “CDS” terminology to the new “AOT” terminology, as discussed [here](https://openjdk.org/jeps/483#History).
76
77 [CDS]: <https://docs.oracle.com/en/java/javase/22/vm/class-data-sharing.html>
78
79 ## 2. Building the Leyden Repository
80
81 The Leyden Repository can be built in the same way as the main-line JDK repository.
82 Please use the "premain" branch. I.e., [https://github.com/openjdk/leyden/tree/premain](https://github.com/openjdk/leyden/tree/premain).
83
84 For build instructions please see the
85 [online documentation](https://openjdk.org/groups/build/doc/building.html),
86 or either of these files:
87
88 - [doc/building.html](doc/building.html) (html version)
89 - [doc/building.md](doc/building.md) (markdown version)
90
91 See <https://openjdk.org/> for more information about the OpenJDK
92 Community and the JDK and see <https://bugs.openjdk.org> for JDK issue
93 tracking.
94
95 ## 3. Trying out Leyden Features
96
97 The easiest way to try out the Leyden optimizations is to build a JVM from the Leyden repository, and use it with your application with the `-XX:AOTCache` flag.
98
99 > Note: in an earlier version of the Leyden prototype, the optimizations were controlled by an experimental flag `-XX:CacheDataStore`. This flag has been deprecated and will be removed. For a reference to this flag, please see an [older version of this document](https://github.com/openjdk/leyden/blob/076c71f7cb9887ef3d64b752976610d19792203b/README.md).
100
101
102 Here's a small benchmark that uses the JDK's built-in
103 [`JavaCompiler`](https://docs.oracle.com/en/java/javase/21/docs/api/java.compiler/javax/tools/JavaCompiler.html)
104 class to compile some Java source files. This benchmark spends a significant amount of start-up time
105 setting up the classes used by `JavaCompiler`, so it will benefit from the Leyden features.
106
107 First, download [JavacBenchApp.java](https://github.com/iklam/jdk/raw/f95f851aed3d2bf06edabab1e7c24e15f4145d0d/test/hotspot/jtreg/runtime/cds/appcds/applications/JavacBenchApp.java)
108 and compile it into a JAR file.
109
110 (Remember to use the `java` program that you built from the Leyden repository.)
111
112 ```
113 $ javac JavacBenchApp.java
114 $ jar cvf JavacBenchApp.jar JavacBenchApp*.class
115 added manifest
116 adding: JavacBenchApp$ClassFile.class(in = 1608) (out= 787)(deflated 51%)
117 adding: JavacBenchApp$FileManager.class(in = 2090) (out= 979)(deflated 53%)
118 adding: JavacBenchApp$SourceFile.class(in = 1351) (out= 671)(deflated 50%)
119 adding: JavacBenchApp.class(in = 7571) (out= 3302)(deflated 56%)
120 ```
121
122 We can run this benchmark without any Leyden features. It takes 893 ms:
123
124 ```
125 $ java -cp JavacBenchApp.jar JavacBenchApp 50
126 Generated source code for 51 classes and compiled them in 893 ms
127 ```
128
129 To use AOT optimizations for JavacBenchApp, we should first perform a _training run_ and
130 capture the profiling information into `JavacBenchApp.aotconfig`
131
132 ```
133 $ java -XX:AOTMode=record -XX:AOTConfiguration=JavacBenchApp.aotconfig \
134 -cp JavacBenchApp.jar JavacBenchApp 50
135 $ ls -l JavacBenchApp.aotconfig
136 -rw-rw-r-- 1 iklam iklam 27652096 Mar 3 16:23 JavacBenchApp.aotconfig
137 ```
138
139 With the `JavacBenchApp.aotconfig` file, we can create the AOT cache. This is called the _assembly phase_:
140
141 ```
142 $ java -XX:AOTMode=create -XX:AOTConfiguration=JavacBenchApp.aotconfig \
143 -cp JavacBenchApp.jar -XX:AOTCache=JavacBenchApp.aot
144 $ ls -l JavacBenchApp.aot
145 -r--r--r-- 1 iklam iklam 42332160 Mar 3 16:58 JavacBenchApp.aot
146 ```
147
148 Now, we can make a _production run_ of the program using the AOT cache `JavacBenchApp.aot`. It finishes in 423 ms, or more than twice as fast as
149 before.
150
151 ```
152 $ java -XX:AOTCache=JavacBenchApp.aot -cp JavacBenchApp.jar JavacBenchApp 50
153 Generated source code for 51 classes and compiled them in 423 ms
154 ```
155
156 By default, training runs end when the application terminates. You have two other options to end training runs:
157
158 - `-XX:AOTEndTrainingOnMethodEntry=<method1,method2,...>[,count=100]`
159 - `jcmd <pid> AOT.end_training`
160
161 Note that `-XX:AOTEndTrainingOnMethodEntry` uses the same format as `-XX:CompileOnly` and the default count is 1.
162
163 See [EndTrainingOnMethodEntry.java](test/hotspot/jtreg/runtime/cds/appcds/leyden/EndTrainingOnMethodEntry.java) for a test case.
164
165 ### Prototype for JEP Draft 8350022: Ahead-of-time Command Line Ergonomics
166
167 We have implemented part of the JEP draft [8350022: Ahead-of-time Command Line Ergonomics](https://openjdk.org/jeps/8350022).
168 This simplifies the training process, so that an AOT cache can be created with a single command-line:
169
170 ```
171 $ java -XX:AOTCacheOutput=JavacBenchApp.aot -cp JavacBenchApp.jar \
172 JavacBenchApp 50
173 Generated source code for 51 classes and compiled them in 2212 ms
174 [3.720s][warning][cds] Skipping Sanity: Unsupported location
175 Temporary AOTConfiguration recorded: JavacBenchApp.aot.config
176 Launching child process /bld/images/jdk/bin/java to assemble AOT cache JavacBenchApp.aot
177 using configuration JavacBenchApp.aot.config
178 Picked up JAVA_TOOL_OPTIONS: -Djava.class.path=JavacBenchApp.jar
179 -XX:AOTCacheOutput=JavacBenchApp.aot
180 -XX:AOTConfiguration=JavacBenchApp.aot.config -XX:AOTMode=create
181 Reading AOTConfiguration JavacBenchApp.aot.config and writing AOTCache JavacBenchApp.aot
182 AOTCache creation is complete: JavacBenchApp.aot 39956480 bytes
183 Removed temporary AOT configuration file JavacBenchApp.aot.config
184 ```
185
186 As seen in the log messages, when the application is about to exit, the JVM writes a temporary AOT configuration file
187 and spawns a child process to create an AOT cache using this configuration file.
188
189 In the above example, the configuration file's name `JavacBenchApp.aot.config` is automatically picked by the JVM. This is a temporary
190 file written into the same directory as the file specified by `-XX:AOTCacheOutput`, so you must make sure this directory is writable.
191 After the cache is created, this temporary is automatically removed.
192
193 If you want to persist the configuration file (for debugging purposes, or for manual cache creation at a later time), you can explicitly
194 set the `AOTConfiguration` option:
195
196 ```
197 $ java -XX:AOTCacheOutput=JavacBenchApp.aot -XX:AOTConfiguration=myconfig.aotconfig \
198 -cp JavacBenchApp.jar JavacBenchApp 50
199 ```
200
201 When `-XX:AOTCacheOutput` is specified, the JVM automatically runs with `-XX:AOTMode=record`, although you can also specify this explicitly:
202
203 ```
204 $ java -XX:AOTMode=record -XX:AOTCacheOutput=JavacBenchApp.aot \
205 -cp JavacBenchApp.jar JavacBenchApp 50
206 ```
207
208 An alternative way for single-command cache creation is to specify `-XX:AOTCache=<file>` along with `-XX:AOTMode=record`. This essentially says:
209 I want to record my training run directly into the specified AOT cache:
210
211 ```
212 $ java -XX:AOTMode=record -XX:AOTCache=JavacBenchApp.aot \
213 -cp JavacBenchApp.jar JavacBenchApp 50
214
215 ```
216
217 Note that in all the examples in this section, `-XX:AOTCache` and `-XX:AOTCacheOutput` are allowed to be specified at the same time, but in that case they are required to have the same value.
218
219 ### AOT_TOOL_OPTIONS
220
221 When creating a AOT cache with a single command, the environment variable `AOT_TOOL_OPTIONS` can be used to pass extra VM options to
222 the child JVM process that performs the assembly step. For example:
223
224 ```
225 $ export AOT_TOOL_OPTIONS=-Xmx128m
226 $ java -XX:AOTCacheOutput=JavacBenchApp.aot -cp JavacBenchApp.jar JavacBenchApp 50
227 Generated source code for 51 classes and compiled them in 2242 ms
228 [3.732s][warning][cds] Skipping Sanity: Unsupported location
229 Temporary AOTConfiguration recorded: JavacBenchApp.aot.config
230 Launching child process /jdk3/bld/le4-fastdebug/images/jdk/bin/java to assemble AOT
231 cache JavacBenchApp.aot using configuration JavacBenchApp.aot.config
232 Picked up AOT_TOOL_OPTIONS: -Xmx128m
233 Picked up JAVA_TOOL_OPTIONS: -Djava.class.path=JavacBenchApp.jar -XX:AOTCacheOutput=JavacBenchApp.aot
234 -XX:AOTConfiguration=JavacBenchApp.aot.config -XX:AOTMode=create -Xmx128m
235 Reading AOTConfiguration JavacBenchApp.aot.config and writing AOTCache JavacBenchApp.aot
236 AOTCache creation is complete: JavacBenchApp.aot 51937280 bytes
237 Removed temporary AOT configuration file JavacBenchApp.aot.config
238 ```
239
240
241 ### Diagnostic VM Flags
242
243 By default, all of the optimizations described
244 in the [Overview](#1-overview) section above are enabled by default. This ensures that you can get all the optimizations
245 without specifying them individually.
246
247 For diagnostic purposes, you can selectively disable some of the options:
248
249 - The `-XX:+LoadCachedCode` and `-XX:+ReplayTraining` flags affect only the production run.
250 - The `-XX:+RecordTraining` option affects only the training run and the assembly phase.
251 - All other options affect only the assembly phase.
252
253 For example, you can disable the loading of AOT-compiled methods during the production run. Notice that the benchmark now
254 starts more slowly than it did when AOT-compiled methods was loaded.
255
256 ```
257 $ java -XX:AOTCache=JavacBenchApp.aot -Xlog:cds=error -XX:-LoadCachedCode \
258 -cp JavacBenchApp.jar JavacBenchApp 50
259 Generated source code for 51 classes and compiled them in 647 ms
260 ```
261
262 You can also disable AOT compilation in the assembly phase. Note that the size of the AOT
263 cache is smaller because it no longer has AOT-compiled methods.
264
265 ```
266 $ java -XX:AOTMode=create -XX:AOTConfiguration=JavacBenchApp.aotconfig \
267 -cp JavacBenchApp.jar \
268 -XX:AOTCache=JavacBenchApp.aot -XX:-StoreCachedCode
269 $ ls -l JavacBenchApp.aot
270 -r--r--r-- 1 iklam iklam 29990912 Mar 3 16:34 JavacBenchApp.aot
271 ```
272
273
274 ## 4. Limitations of the Leyden Prototype
275
276 When trying out the Leyden, please pay attention to the following limitations.
277
278 ### The Same Garbage Collector Must be Used between Assembly Phase and Production Runs
279
280 The CDS archive generated by the Leyden prototype includes machine instructions that are specific to
281 the garbage collector. We recommend that you explicitly specify the same collector during both
282 training and production runs. For example:
283
284 ```
285 # assembly phase.
286 $ java -XX:AOTMode=create -XX:AOTConfiguration=JavacBenchApp.aotconfig \
287 -cp JavacBenchApp.jar \
288 -XX:AOTCache=JavacBenchApp.aot -XX:+UseSerialGC
289
290 # production run
291 $ java -XX:AOTCache=JavacBenchApp.aot -XX:+UseSerialGC -cp JavacBenchApp.jar \
292 JavacBenchApp 50
293 ```
294
295 Otherwise, the CDS archive may not be useable for the production run, leading to suboptimal performance.
296 For example, sometimes you may perform the assembly phase run on a large development host, and then use
297 a container to run the application in a small production node. In the following scenario, as the collector
298 is not explicitly specified, the VM will automatically pick G1 for the assembly phase, and SerialGC for the
299 production run (due to its limited amount of memory):
300
301 ```
302 # Assembly phase (uses G1 by default)
303 $ java -XX:AOTMode=create -XX:AOTConfiguration=JavacBenchApp.aotconfig \
304 -cp JavacBenchApp.jar -XX:AOTCache=JavacBenchApp.aot
305
306 # Production run (uses SerialGC)
307 $ docker run --rm -v /repos/leyden/build/linux-x64/images/jdk:/jdk -v $(pwd):/test \
308 --memory=1024m \
309 container-registry.oracle.com/java/openjdk \
310 bash -c 'cd /test; ' \
311 '/jdk/bin/java -XX:AOTCache=JavacBenchApp.aot ' \
312 ' -cp JavacBenchApp.jar JavacBenchApp 50'
313 [0.001s][error][cds] CDS archive has aot-linked classes. It cannot be used because
314 GC used during dump time (G1) is not the same as runtime (Serial)
315 [0.001s][error][cds] An error has occurred while processing the AOT cache.
316 [0.001s][error][cds] Unable to map shared spaces
317 Error occurred during initialization of VM
318 Unable to use AOT cache.
319 ```
320
321 ### Only G1GC, SerialGC, ParallelGC, EpsilonGC, ShenandoahGC are Supported
322
323 Currently, if you use any other garbage collector in combination with `-XX:AOTMode` or `-XX:AOTCache`, the VM will
324 exit with an error.
325
326 ```
327 $ java -XX:AOTMode=record -XX:AOTConfiguration=JavacBenchApp.aotconfig \
328 -cp JavacBenchApp.jar -XX:+UseZGC JavacBenchApp 50
329 Error occurred during initialization of VM
330 Cannot create the AOT configuration file: UseCompressedClassPointers must be enabled,
331 and collector must be G1, Parallel, Serial, Epsilon, or Shenandoah
332 ```
333
334 ### -XX:AOTMode=on is Enabled by default
335
336 As seen in the example immediately above, in the production run, if the CDS archive cannot be
337 used for any reason, the JVM will report an error and exit. This happens as if `-XX:AOTMode=on` was
338 specified in the command-line.
339
340 In the standard JDK, when the CDS archive cannot be used for any reason (for example, the
341 archive was created for a different version of the JDK), the application will
342 continue to run without using CDS.
343 This fall-back strategy ensures that the application will function correctly, though at a lower level of performance.
344
345 With the Leyden prototype, we have changed this fall-back behavior to make it easier to diagnose
346 performance issues. For example, when the start-up time is not as good as one would expect, we
347 want know whether it's caused by a misconfiguration that prevents the CDS archive
348 from being used, or it's caused by a deficiency in the implementation of the Leyden optimizations.
349
350 To revert to the behavior of the standard JDK, you can explicitly add `-XX:AOTMode=auto` to the command-line.
351
352 ```
353 $ docker run --rm -v /repos/leyden/build/linux-x64/images/jdk:/jdk -v $(pwd):/test \
354 --memory=1024m \
355 container-registry.oracle.com/java/openjdk \
356 bash -c 'cd /test; ' \
357 '/jdk/bin/java -XX:AOTMode=auto -XX:AOTCache=JavacBenchApp.aot ' \
358 ' -cp JavacBenchApp.jar JavacBenchApp 50'
359 [0.001s][error][cds] CDS archive has aot-linked classes. It cannot be used because
360 GC used during dump time (G1) is not the same as runtime (Serial)
361 Generated source code for 51 classes and compiled them in 831 ms
362 ```
363
364 See [JEP 483](https://openjdk.org/jeps/483) for a discussion of `-XX:AOTMode=on` vs `-XX:AOTMode=auto`.
365
366
367 ## 5. Benchmarking
368
369 We use a small set of benchmarks to demonstrate the performance of the optimizations in the Leyden repo.
370
371 | Benchmark | Source |
372 | ------------- | ------------- |
373 |[helidon-quickstart-se](test/hotspot/jtreg/premain/helidon-quickstart-se) | https://helidon.io/docs/v4/se/guides/quickstart|
374 |[micronaut-first-app](test/hotspot/jtreg/premain/micronaut-first-app) | https://guides.micronaut.io/latest/creating-your-first-micronaut-app-maven-java.html|
375 |[quarkus-getting-started](test/hotspot/jtreg/premain/quarkus-getting-started) | https://quarkus.io/guides/getting-started|
376 |[spring-boot-getting-started](test/hotspot/jtreg/premain/spring-boot-getting-started) | https://spring.io/guides/gs/spring-boot|
377 |[spring-petclinic](test/hotspot/jtreg/premain/spring-petclinic) | https://github.com/spring-projects/spring-petclinic|
378
379 *(FIXME: add a benchmark for javac)*
380
381 ### Benchmarking Against JDK Main-line
382
383 To can compare the performance of Leyden vs the main-line JDK, you need:
384
385 - An official build of JDK 21
386 - An up-to-date build of the JDK main-line
387 - The latest Leyden build
388 - Maven (ideally 3.8 or later, as required by some of the demos). Note: if you are behind
389 a firewall, you may need to [set up proxies for Maven](https://maven.apache.org/guides/mini/guide-proxies.html)
390
391 The same steps are used for benchmarking all of the above demos. For example:
392
393 ```
394 $ cd helidon-quickstart-se
395 $ make PREMAIN_HOME=/repos/leyden/build/linux-x64/images/jdk \
396 MAINLINE_HOME=/repos/jdk/build/linux-x64/images/jdk \
397 BLDJDK_HOME=/usr/local/jdk21 \
398 bench
399 run,mainline default,mainline custom static cds,mainline aot cache,premain aot cache
400 1,456,229,156,117
401 2,453,227,157,117
402 3,455,232,155,116
403 4,448,230,154,114
404 5,440,228,156,114
405 6,446,228,156,114
406 7,448,232,156,114
407 8,465,261,159,114
408 9,448,226,157,113
409 10,442,233,154,114
410 Geomean,450.05,232.41,155.99,114.69
411 Stdev,6.98,9.72,1.41,1.35
412 Markdown snippets in mainline_vs_premain.md
413 ```
414
415 The above command runs each configuration 10 times, in an interleaving order. This way
416 the noise of the system (background processes, thermo throttling, etc) is more likely to
417 be spread across the different runs.
418
419 As is typical for benchmarking start-up performance, the numbers are not very steady.
420 It is best to plot
421 the results (as saved in the file `mainline_vs_premain.csv`) in a spreadsheet to check for
422 noise and other artifacts.
423
424 The "make bench" target also generates GitHub markdown snippets (in the file `mainline_vs_premain.md`) for creating the
425 graphs below.
426
427 ### Benchmarking Between Two Leyden Builds
428
429 This is useful for Leyden developers to measure the benefits of a particular optimization.
430 The steps are similar to above, but we use the "make compare_premain_builds" target:
431
432 ```
433 $ cd helidon-quickstart-se
434 $ make PM_OLD=/repos/leyden_old/build/linux-x64/images/jdk \
435 PM_NEW=/repos/leyden_new/build/linux-x64/images/jdk \
436 BLDJDK_HOME=/usr/local/jdk21 \
437 compare_premain_builds
438 Old build = /repos/leyden_old/build/linux-x64/images/jdk with options
439 New build = /repos/leyden_new/build/linux-x64/images/jdk with options
440 Run,Old CDS + AOT,New CDS + AOT
441 1,110,109
442 2,131,111
443 3,118,115
444 4,110,108
445 5,117,110
446 6,114,109
447 7,110,109
448 8,118,110
449 9,110,110
450 10,113,114
451 Geomean,114.94,110.48
452 Stdev,6.19,2.16
453 Markdown snippets in compare_premain_builds.md
454 ```
455
456 Please see [test/hotspot/jtreg/premain/lib/Bench.gmk](test/hotspot/jtreg/premain/lib/Bench.gmk) for more details.
457
458 Note: due to the variability of start-up time, the benefit of minor improvements may
459 be difficult to measure.
460
461 ### Preliminary Benchmark Results
462
463 The following charts show the relative start-up performance of the Leyden/Premain branch vs
464 the JDK main-line.
465
466 For example, a number of "premain aot cache: 255" indicates that if the application takes
467 1000 ms to start-up with the JDK main-line, it takes only 255 ms to start up when all the
468 current set of Leyden optimizations are enabled.
469
470 The benchmark results are collected with `make bench` in the following directories:
471
472 - `helidon-quickstart-se`
473 - `micronaut-first-app`
474 - `quarkus-getting-started`
475 - `spring-boot-getting-started`
476 - `spring-petclinic`
477
478 The meaning of the four rows in the following the charts:
479
480 | Row | Meaning |
481 | ------------- | ------------- |
482 | **mainline default** |Run benchmark with no optimizations|
483 | **mainline custom static cds** |Run benchmark with a custom static CDS archive|
484 | **mainline aot cache** |Run benchmark with a custom AOT cache (JEP 483)|
485 | **premain aot cache** |Run benchmark with a custom AOT cache, plus all Leyden optimizations such as AOT profiles and AOT-compiled methods|
486
487 These JDK versions were used in the comparisons:
488
489 - JDK main-line: JDK 24, build 24+36-3646
490 - Leyden: https://github.com/openjdk/leyden/tree/bbac8f2d845aa6408182ca3ff9ce60b5ca6e0390
491
492 For details information about the hardware and raw numbers, see [bench.20250307.txt](test/hotspot/jtreg/premain/bench_data/bench.20250307.txt)
493
494 ### Helidon Quick Start (SE) Demo (3.92x improvement)
495
496 ```mermaid
497 ---
498 config:
499 xyChart:
500 chartOrientation: horizontal
501 height: 300
502 ---
503 xychart-beta
504 x-axis "variant" ["mainline default", "mainline custom static cds", "mainline aot cache", "premain aot cache"]
505 y-axis "Elapsed time (normalized, smaller is better)" 0 --> 1000
506 bar [1000, 516, 347, 255]
507 ```
508
509 ### Micronaut First App Demo (3.12x improvement)
510
511 ```mermaid
512 ---
513 config:
514 xyChart:
515 chartOrientation: horizontal
516 height: 300
517 ---
518 xychart-beta
519 x-axis "variant" ["mainline default", "mainline custom static cds", "mainline aot cache", "premain aot cache"]
520 y-axis "Elapsed time (normalized, smaller is better)" 0 --> 1000
521 bar [1000, 475, 366, 321]
522 ```
523
524 ### Quarkus Getting Started Demo (3.52x improvement)
525
526 ```mermaid
527 ---
528 config:
529 xyChart:
530 chartOrientation: horizontal
531 height: 300
532 ---
533 xychart-beta
534 x-axis "variant" ["mainline default", "mainline custom static cds", "mainline aot cache", "premain aot cache"]
535 y-axis "Elapsed time (normalized, smaller is better)" 0 --> 1000
536 bar [1000, 437, 380, 284]
537 ```
538
539 ### Spring-boot Getting Started Demo (3.48x improvement)
540
541 ```mermaid
542 ---
543 config:
544 xyChart:
545 chartOrientation: horizontal
546 height: 300
547 ---
548 xychart-beta
549 x-axis "variant" ["mainline default", "mainline custom static cds", "mainline aot cache", "premain aot cache"]
550 y-axis "Elapsed time (normalized, smaller is better)" 0 --> 1000
551 bar [1000, 502, 382, 287]
552 ```
553
554 ### Spring PetClinic Demo (2.65x improvement)
555
556 ```mermaid
557 ---
558 config:
559 xyChart:
560 chartOrientation: horizontal
561 height: 300
562 ---
563 xychart-beta
564 x-axis "variant" ["mainline default", "mainline custom static cds", "mainline aot cache", "premain aot cache"]
565 y-axis "Elapsed time (normalized, smaller is better)" 0 --> 1000
566 bar [1000, 625, 586, 376]
567 ```
568
569 ## 6. More Documentation
570
571 Please see [test/hotspot/jtreg/premain/](test/hotspot/jtreg/premain) for more information.
|