Skip to content

v1.6.0

Compare
Choose a tag to compare
@shakuzen shakuzen released this 29 Oct 14:30
· 382 commits to 1.6.x since this release

1.6.x is an LTS release line - see the support page for more information on LTS vs non-LTS releases. This release contains changes from the 1.6.0 milestone.

Thank you to all the people who contributed to this release.


Compatibility impacting

  • Timer.Sample's tags methods and the stop method that takes a Timer.Builder have been removed. Instead, tags should be specified on the Timer passed to the remaining stop method. This makes for consistency - tags are always configured on the Timer.

    Example before/after Timer.Sample code
    Old codeSupported code
    Timer.Sample sample = Timer.start(meterRegistry);
    // ... do some stuff
    sample.tags("flag", flag);
    sample.tags(Tags.of("other", "tag"));
    sample.stop(meterRegistry, Timer.builder("sample.time"));
    Timer.Sample sample = Timer.start(meterRegistry);
    // ... do some stuff
    sample.stop(Timer.builder("sample.time")
             .tag("flag", flag)
             .tags(Tags.of("other", "tag"))
             .register(meterRegistry));
  • HibernateMetrics requires Hibernate 5.3 or later now.

  • Kafka metrics - #2256 The tag for client id on Kafka metrics has been changed from client-id to client.id to match the previous version of Kafka metrics from KafkaConsumerMetrics and to follow our canonical format. Likewise kafka-version has been updated to kafka.version. A MeterFilter can be applied to undo the tag name change or to apply this change to 1.5.x versions of Micrometer. For example:
    Users who want client.id in 1.5.x should configure MeterFilter.renameTag("kafka", "client-id", "client.id")
    Users who want client-id in 1.6.x should configure the opposite filter: MeterFilter.renameTag("kafka", "client.id", "client-id").

Registry-specific

  • [ElasticMeterRegistry] #2288 Default index name prefix has been changed from metrics to micrometer-metrics to avoid a conflict with a built-in index template for an xpack feature in Elasticsearch 7.9
  • [GraphiteMeterRegistry] #2083 Graphite tags should work out of the box now but requires the metrics-graphite dependency version 4.1.8 or later
  • [GraphiteMeterRegistry] #2164 In order to retain the final publish on close behavior, users should be using at least version 4.1.8 of the metrics-core dependency.
  • [WavefrontMeterRegistry] #2175 wavefront-sdk-java 2.4 or later is required now.

New Meter Registries

  • HealthMeterRegistry for SLO-based health indicators. See #2055

New metrics

  • #1875 Metrics for OkHttp ConnectionPool
  • #1712 CommonsObjectPool2Metrics
  • #2097 Expose per-region statistics for Hibernate L2 cache
  • #2248 Tomcat connection metrics
  • #2199 Add counters for QueryPlanCacheHit and QueryPlanCacheMiss in HibernateMetrics

Enhancements

  • #1861 Support Shenandoah GC in JvmGcMetrics
  • #2305 Support ZGC in JvmGcMetrics
    • Note: the time provided by the jvm.gc.pause Timer is not accurate for ZGC (it includes the concurrent time) see #2372
  • #2185 Add option to disable illegal access in ExecutorServiceMetrics
  • #2068 Add onMeterRegistrationFailed listener configuration to MeterRegistry

Registry-specific changes

CloudWatch

  • #2088 Support of high resolution metrics for CloudWatch

Elasticsearch

  • #2255 Default index pattern changed for compatibility with Elasticsearch 7.9 xpack metrics index template

Wavefront

  • #2175 Allow step intervals at finer than whole second granularity for Wavefront