1.10 Migration Guide

The 2.0 milestones releases have been superseded by the 1.10 milestones.

Features that were being worked on in the 2.0 milestones will be released instead as 1.10 milestones and eventually a GA version. The 1.10.0-M1 milestone release follows the 2.0.0-M3 milestone.

Micrometer 1.10.0-M3

• Migrated the testing tools from io.micrometer.core.tck to io.micrometer.observation.tck package

Micrometer 1.10.0-M1

micrometer-observation

There is a new module that contains an Observation API for instrumenting code. micrometer-core provides an integration that produces Timer metrics from this Observation instrumentation, and micrometer-tracing provides an integration to produce spans from that instrumentation. You can make your own integrations with this API, and instrument your code with this API.

See the Migration to the Observation API wiki.

micrometer-commons

We've moved TagKey and internal utilities from micrometer-observation to a new module called micrometer-commons. You'll need to update your imports like the following

Before : io.micrometer.observation.docs.TagKey, after: io.micrometer.common.docs.KeyName

More detailed migration guide

• Classes
  • If you have a io.micrometer.common.Tags reference, change it to io.micrometer.common.KeyValues
  • If you have a io.micrometer.common.Tag reference, change it to io.micrometer.common.KeyValue
  • TagsProvider
    • After KeyValuesProvider
  • TagsProviderAware
    • After KeyValuesProviderAware
  • CompositeTagsProvider
    • After CompositeKeyValuesProvider
  • GlobalTagsProvider
    • After GlobalKeyValuesProvider
  • HttpTagsProvider
    • After HttpKeyValuesProvider
  • HttpTags
    • After HttpKeyValues
• Methods
  • TagsProvider
    • Before Tags getLowCardinalityTags()
    • After KeyValues getLowCardinalityKeyValues()
  • Observation
    • lowCardinalityTag
      • After lowCardinalityKeyValue
    • highCardinalityTag
      • After highCardinalityKeyValue
    • tagsProvider
      • After keyValuesProvider
  • Observation.Context
    • addLowCardinalityTag
      • After addLowCardinalityKeyValue
    • addHighCardinalityTag
      • After addHighCardinalityKeyValue
    • addLowCardinalityTags
      • After addLowCardinalityKeyValues
    • addHighCardinalityTags
      • After addHighCardinalityKeyValues
    • getLowCardinalityTags
      • After getLowCardinalityKeyValues
    • getHighCardinalityTags
      • After getHighCardinalityKeyValues
    • getAllTags
      • After getAllKeyValues
  • TagsProviderAware
    • setTagsProvider
      • After setKeyValueProvider
  • CompositeTagsProvider
    • getTagsProviders
      • After getKeyValueProviders
  • ObservationRegistry.ObservationConfig
    • getTagsProviders
      • After getKeyValueProviders
    • tagsProvider
      • After keyValuesProvider
  • HttpTagsProvider
    • getLowCardinalityTags
      • After getLowCardinalityKeyValues
    • getHighCardinalityTags
      • After getHighCardinalityKeyValues
  • ObservationContextAssert
    • All methods containing Tag will be renamed to KeyValue
    • All methods containing Tags will be renamed to KeyValues

Up till Micrometer 2.0.0-M3

micrometer-tracing

See https://github.com/micrometer-metrics/tracing and the corresponding reference documentation.