In this section you will be creating a study by using the creation wizard provided by Akamas.

The target application to optimize is Renaissance, a sample Java benchmark that comes already shipped with the Akamas-in-a-box installation. Your goal will be to make Renaissance consume less CPU and memory, a common optimization need for Java applications.

What you will learn

What you will need

The study you will create needs to have the following properties:

The following picture represents the high-level architecture of how Akamas operates in this scenario.


To create the study, go to the Study menu in the UI and click on the Create button, then select Study:

Create study

The study creation wizard will now walk you through the different steps required to create the study.

First of all, choose a name and description for your study, then select the renaissance system and the renaissance-optimize workflow:

System page

The next step is to define your optimization goal.

Leave the MINIMIZE option and select mem_used (or cpu_used) metric from the renaissance component for the goal of reducing memory usage (or CPU consumption). Make sure that the metric you are selecting belongs to the proper (i.e. renaissance) component of your system.

Goal page

It's now time to select which parameters Akamas needs to tune in this study.

To start, you can include the following JVM parameters (by also setting the range for some of them):

Akamas supports constraints among parameters to avoid incorrect combinations of values. In this example, the JVM newSize parameter needs to be lower or equal to maxHeapSize. You can add a new constraint to tell Akamas to keep this relation into consideration during the optimization:


newSize constraint

Now, you can select the metrics of interest among all the metrics provided by your components. You can do that by expanding the Choose metrics section and select all the metrics of the renaissance component.


Finally, you can define the steps the study will go through.

Typically, an Akamas study is composed of:

The Akamas study wizard already creates these two steps for you, so unless you want to add additional steps you just need to configure these two steps.

In this study, we simply configure the baseline configuration by setting jvm_maxHeapSize to 1024M:


Baseline preset

Then click on the Optimize step in the left panel to specify the optimization configuration.

For now, simply set the number of experiments to execute to 30:


Now click on Create Study.

You have now created your first study and you ready to start the optimziation!

You can review your study in the Definition tab or go and launch the study by pressing the Start button:


After running the study, you can explore the results your AI-driven performance optimization study.

Select your study from the UI Study menu.

The Summary tab displays high-level study information at a glance, including the best score obtained so far, a summary of the tuned parameters and their values for the optimal configuration (so far if the study is still running).


The Progress tab allows to follow the experiments and their workflow tasks execution (including logs for troubleshooting).


The Analysis tab shows the experiments score over time, plus a detailed table with key parameters and metrics for each experiment.


The Configuration Analysis tab lets you explore the additional insights and benefits of the configurations Akamas explored with respect to other key metrics besides the goal. Configuration

The Metrics tab allows you to check the metrics that the telemetry modules collected over time for each experiment.


You have just learned how to create a study using the Akamas wizard!

As a following step you may want:

© Akamas Spa 2018-present. Akamas and the Akamas logo are registered trademarks of Akamas Spa.