1.0.0-beta-1 / 2023-09-16

The first beta of the upcoming Prometheus metrics library 1.0.0 is available!

It's a major breaking change, because we refactored the builder pattern to be aligned with Lombok conventions. Example of the new API:

Counter counter = Counter.builder()
    .name("events_total")
    .help("total number of events")
    .labelNames("status")
    .register();

This replaces the verbose builders from the alpha releases:

// old API, no longer available
Counter counter = Counter.newBuilder()
    .withName("events_total")
    .withHelp("total number of events")
    .withLabelNames("status")
    .register();

Moreover, we started publishing docs on https://prometheus.github.io/client_java/.

If you want to get started, the new docs have a quickstart guide: https://prometheus.github.io/client_java/getting-started/quickstart/.

The target is to finalize the docs and the 1.0.0 release before PromCon, which is 28/29 September 2023. We do not expect any more breaking changes, except for smaller things that come up while writing documentation.