Skip to content

CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit www.eclipse.org/openj9/docs

-XX:[+|-]JITServerMetrics

This option enables the provision of JITServer performance metrics to a monitoring agent that follows the OpenMetrics standard.

When you enable this option, the following JITServer metrics are provided:

  • The CPU utilization of the JITServer
  • The physical memory that is available to the JITServer
  • The number of clients that are connected to the JITServer
  • The number of active compilation threads in the JITServer

Note: You can use the -XX:JITServerMetricsSSLKey and -XX:JITServerMetricsSSLCert options for encrypting the data with SSL or TLS.

Syntax

    -XX:[+|-]JITServerMetrics
Setting Effect Default
-XX:+JITServerMetrics Enable
-XX:-JITServerMetrics Disable yes

Explanation

When you enable this option, the JITServer process opens a TCP port, which can be used by monitoring agents (like Prometheus) to collect the custom metrics exported by the JITServer. Monitoring agents must issue HTTP GET requests to a URL of the form: http://<jitserveraddress>:<port>/metrics. The path for the HTTP request must be /metrics.

The default value of <port> is 38500. You can change this value by using the -XX:JITServerMetricsPort command line option.

The format for the metrics returned by the JITServer follows the OpenMetrics protocol.

Example

The following example shows an HTTP request from a Prometheus monitoring agent and the response from the JITServer:

HTTP request:

GET /metrics HTTP/1.1 Host: 127.0.0.1:9403 User-Agent: Prometheus/2.31.1 Accept: application/openmetrics-text; version=0.0.1,text/plain;version=0.0.4;q=0.5,*/*;q=0.1 Accept-Encoding: gzip X-Prometheus-Scrape-Timeout-Seconds: 3

JITServer response:

# HELP jitserver_cpu_utilization Cpu utilization of the JITServer # TYPE jitserver_cpu_utilization gauge jitserver_cpu_utilization 12.000000 # HELP jitserver_available_memory Available memory for JITServer # TYPE jitserver_available_memory gauge jitserver_available_memory 32036204544.000000 # HELP jitserver_connected_clients Number of connected clients # TYPE jitserver_connected_clients gauge jitserver_connected_clients 1.000000 # HELP jitserver_active_threads Number of active compilation threads # TYPE jitserver_active_threads gauge jitserver_active_threads 1.000000

See also