Optimizer Hub API

Table of Contents

ReadyNow Orchestrator Admin API
- Configure the API Endpoint
- Overview of the API Methods

Need help?

Schedule a consultation with an Azul performance expert.

Optimizer Hub provides an administration API with the following methods.

ReadyNow Orchestrator Admin API

These methods are available on {GATEWAY_IP}:{SERVICE_PORT}/rno/… and can be accessed without authentication. The service port typically is 8080, but can be different based on the used configuration. For security reasons, by default, the API is not exposed outside the cluster.

Configure the API Endpoint

Apply the required changes in this section of the cluster configuration.

 $ gateway:
$   service:
$     type: "NodePort"
$     httpEndpoint:
$       enabled: false
$       port: 8080

Overview of the API Methods

Method Url Description

GET

/rno/names

Returns a list of all profile names with summary information.

GET

/rno/names/{name}

Returns summary information for the requested profile name.

DELETE

/rno/names/{name}

Deletes given profile name and all profiles belonging to it.

GET

/rno/names/{name}/profiles

Returns summary information for all of the profiles within a given profile name. Use the ?status=promoted query parameter to see only the promoted profile.

GET

/rno/names/{name}/profiles/{Id}

Returns summary information for a specific profile.

DELETE

/rno/names/{name}/profiles/{Id}

Deletes a specific profile.

GET

/rno/names/{name}/export

Exports all of the profiles in a specific profile name. Each profile’s directory has the Id of the VM that created it. The promoted profile, meaning the profile that PLS sends to new clients requesting the profile name, is stored in profilePromoted.json. The README has instructions for unifying the profile chunks into a single profile file that can be used as a local input to ReadyNow. You can see the iteration of a given profile in the profileIteration property in the profile’s profileInfo.json file.

Note	The profile export fails if the resulting data stream is larger than 2GB. If this happens, consider just exporting the promoted profile using the `?status=promoted` query parameter.

POST

/rno/names/{name}/import

Imports a profile log to this instance of Optimizer Hub. This API is mostly used for moving a promoted profile from one Optimizer Hub instance to another. The uploaded file should be a zip archive in the format produced by the /profile/export API. Do not rename directories in the profile structure or edit the profile metadata.

Note	If the profile name already exists, the import fails.

GET

/rno/profiles/{id}/content

Returns a profile by the specified id. You can use the returned profile as an input for Prime JVM for the ReadyNow ProfileLogIn flag value.

For example:

 curl {endpoint}:{port}/rno/profiles/{id}/content > {RETURNED_PROFILE}

-XX:ProfileLogIn={RETURNED_PROFILE}

GET

/rno/statistics

Returns service-wide statistics for this instance of Cloud Native Compiler.