Prometheus JVM Client Files

What's Changed

Unicode support

UTF-8 is now supported for metric and label names!

• this is a backwards compatible change
• only Prometheus servers that can handle UTF-8 will actually see it
• otherwise you'll still get the same _ replacement characters as before
• in the push gateway, you have to enable UTF-8 support explicitly
• unit names still do not support UTF-8
• refer to the documentation for details

🏕 Features

• UTF-8 support in metric and label names by @fedetorres93 in https://github.com/prometheus/client_java/pull/1255
• public StatefulMetric by @sideeffffect in https://github.com/prometheus/client_java/pull/1474
• Builder.withoutExemplars() setting cannot be overridden via properties by @cruftex in https://github.com/prometheus/client_java/pull/1477
• Update PrometheusScrapeHandler compression handling by @jaydeluca in https://github.com/prometheus/client_java/pull/1493

🧹 Chore

• pin mise by @zeitlinger in https://github.com/prometheus/client_java/pull/1475
• add Nullaway by @zeitlinger in https://github.com/prometheus/client_java/pull/1511

👒 Dependencies

• Update dependency com.diffplug.spotless:spotless-maven-plugin to v2.45.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1452
• Update module go:github.com/gohugoio/hugo to v0.148.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1453
• Update dependency com.google.errorprone:error_prone_core to v2.40.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1454
• Update eclipse-temurin:21.0.7_6-jre Docker digest to f7d9b21 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1455
• Update module go:github.com/gohugoio/hugo to v0.148.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1456
• Update jdx/mise-action action to v2.4.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1457
• Update dependency com.github.ben-manes.caffeine:caffeine to v3.2.2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1458
• Update prom/prometheus Docker tag to v3.5.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1459
• Update otel/opentelemetry-collector-contrib Docker tag to v0.130.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1460
• Update dependency org.apache.maven.plugins:maven-enforcer-plugin to v3.6.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1462
• Update dependency maven to v3.9.11 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1461
• Update eclipse-temurin:21.0.7_6-jre Docker digest to 28bede2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1463
• Update eclipse-temurin:21.0.7_6-jre Docker digest to 313b224 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1464
• Update dependency commons-io:commons-io to v2.20.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1468
• Update dependency java to v21.0.8+9.0.LTS by @renovate[bot] in https://github.com/prometheus/client_java/pull/1465
• Update module go:github.com/grafana/oats to v0.4.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1466
• Update eclipse-temurin:21.0.7_6-jre Docker digest to bca347d by @renovate[bot] in https://github.com/prometheus/client_java/pull/1469
• Update dependency com.diffplug.spotless:spotless-maven-plugin to v2.46.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1470
• Update super-linter/super-linter action to v8 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1467
• Update junit-framework monorepo to v5.13.4 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1472
• Update dependency com.diffplug.spotless:spotless-maven-plugin to v2.46.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1473
• Update otel/opentelemetry-collector-contrib Docker tag to v0.130.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1476
• Update grafana/grafana Docker tag to v12.1.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1479
• Update jdx/mise-action action to v2.4.2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1480
• Update dependency org.springframework.boot:spring-boot-starter-parent to v3.5.4 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1481
• Update module go:github.com/gohugoio/hugo to v0.148.2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1484
• Update jdx/mise-action action to v2.4.4 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1485
• Update dependency mise to v2025.7.29 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1486
• Update otel/opentelemetry-collector-contrib Docker tag to v0.131.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1487
• Update dependency com.google.errorprone:error_prone_core to v2.41.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1482
• Update otel/opentelemetry-collector-contrib Docker tag to v0.131.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1491
• Update eclipse-temurin Docker tag to v21.0.8_9-jre by @renovate[bot] in https://github.com/prometheus/client_java/pull/1490
• Update dependency org.apache.tomcat.embed:tomcat-embed-core to v11.0.10 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1492
• Update grafana/tempo Docker tag to v2.8.2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1494
• Update jetty monorepo to v12.0.24 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1495
• Update dependency org.assertj:assertj-core to v3.27.4 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1497
• Update actions/cache digest to 0400d5f by @renovate[bot] in https://github.com/prometheus/client_java/pull/1496
• Update dependency mise to v2025.8.7 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1499
• Update actions/checkout action to v4.3.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1501
• Update actions/checkout digest to 08eba0b by @renovate[bot] in https://github.com/prometheus/client_java/pull/1500
• Update actions/checkout action to v5 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1502
• Update eclipse-temurin:21.0.8_9-jre Docker digest to b2fa3ed by @renovate[bot] in https://github.com/prometheus/client_java/pull/1503
• Update jetty monorepo to v12.0.25 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1504
• Update eclipse-temurin:21.0.8_9-jre Docker digest to ea350fe by @renovate[bot] in https://github.com/prometheus/client_java/pull/1505
• Update otel/opentelemetry-collector-contrib Docker tag to v0.132.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1506
• Update otel/opentelemetry-collector-contrib Docker tag to v0.132.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1507
• Update grafana/k6 Docker digest to 072db02 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1508
• Update grafana/grafana Docker tag to v12.1.1 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1509
• Update otel/opentelemetry-collector-contrib Docker tag to v0.132.2 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1510
• Update dependency org.mockito:mockito-core to v5.19.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1514
• Update dependency com.google.protobuf:protobuf-java to v4.32.0 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1513
• Update dependency org.apache.maven.plugins:maven-javadoc-plugin to v3.11.3 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1515
• Update dependency mise to v2025.8.12 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1516
• Update otel/opentelemetry-collector-contrib Docker tag to v0.132.4 by @renovate[bot] in https://github.com/prometheus/client_java/pull/1517

New Contributors

• @sideeffffect made their first contribution in https://github.com/prometheus/client_java/pull/1474
• @cruftex made their first contribution in https://github.com/prometheus/client_java/pull/1477
• @jaydeluca made their first contribution in https://github.com/prometheus/client_java/pull/1493
• @fedetorres93 made their first contribution in https://github.com/prometheus/client_java/pull/1255

Full Changelog: https://github.com/prometheus/client_java/compare/v1.3.10...v1.4.0