prometheus/client_java v1.0.0-alpha-4

1.0.0-alpha-4 / 2023-09-07

on GitHub

This is the current pre-release for the upcoming 1.0.0 version.

It adds the prometheus-metrics-instrumentation-jvm module, which is a port of the simpleclient default exports to the new metrics library:

JvmMetrics
        .newBuilder()
        .register();

If a unit is present, the new metrics library requires the unit to be the last part of the metric name, as defined in Prometheus Metric and Label Naming. Therefore we had to rename a few default metrics:

• jvm_memory_bytes_init -> jvm_memory_init_bytes
• jvm_memory_bytes_committed -> jvm_memory_committed_bytes
• jvm_memory_bytes_max -> jvm_memory_max_bytes
• jvm_memory_bytes_used -> jvm_memory_used_bytes
• jvm_memory_pool_bytes_init -> jvm_memory_pool_init_bytes
• jvm_memory_pool_bytes_committed -> jvm_memory_pool_committed_bytes
• jvm_memory_pool_bytes_max -> jvm_memory_pool_max_bytes
• jvm_memory_pool_bytes_used -> jvm_memory_pool_used_bytes

Apart from that, jvm_info was renamed to jvm_runtime_info.

If these breaking changes are an issue: There will be a compatibility module that will allow you to use the old simpleclient default exports with the new metrics library.

There still isn't much documentation yet, but for each new module there's an end-to-end example and a README in the examples/ directory (on the 1.0.x branch).

The next features on the roadmap towards 1.0.0 is a backwards-compatibility module for existing simpleclient.