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

• KeyValuesProvider to ObserationConvention migration

  • Up till this 1.10.0-M3 the rule of thumb for instrumentations was as follows
    • Create a dedicated context for the given instrumentation (e.g. MongoContext)
    • Create an interface that extends the KeyValuesProvider with the concrete context type (e.g. interface MongoKeyValuesProvider extends KeyValuesProvider<MongoContext>)
    • Create a default implementation that sets default key values (e.g. class DefaultMongoKeyValuesProvider implements MongoKeyValuesProvider)
    • Your instrumentation would have a setter (you can use the KeyValuesProviderAware interface for your convenience) to allow the users to override the default KeyValuesProvider
  • With 1.10.0-M3 the flow looks the same but instead of plain KeyValuesProvider we're introducing a better concept which is the ObservationConvention<? extends Observation.Context>. That interface extends the KeyValuesProvider but also requires a default name.
  • The rationale is that we might have different naming convention that can be used locally (e.g. you want different name and tags for Mongo) or globally on the ObservationConfiguration (e.g. you want to rename all http client observations and their tags)

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.