Skip to content

1.0 Migration Guide

Jonatan Ivanov edited this page Sep 7, 2022 · 4 revisions

Micrometer Tracing 1.0.0-M8

  • [Breaking change] We have made SampleTestRunner create and close the meter/observation registries on each parameterized test run. Prior to this change, to use custom registries, the constructor needed to take them. After this change, create[Meter|Observation]Registry methods are added. You can override them to provide custom registries.

Micrometer Tracing 1.0.0-M7

  • [Breaking change] We have made FinishedSpan return Instant for start and finish timestamps (Issue). You have to convert your code to use Instant.
  • [Breaking change] We have removed all Http related handlers (HTTP client and HTTP server). You should be using the PropagatingSenderTracingObservationHandler and PropagatingReceiverTracingObservationHandler respecitively. Also if you were using HttpRequest / HttpResponse and the like from micrometer-core it got moved to tracing under io.micrometer.tracing.http package (PR)

Micrometer Tracing 1.0.0-M6

  • [Breaking change] We have renamed the micrometer-tracing-api JAR to micrometer-tracing (PR)

Micrometer Tracing 1.0.0-M4

Since we're aligning to Micrometer 1.10, you need to update your code with the changes around Tag and Tags in commons changing to KeyValue and KeyValues. All the methods in DocumentedSpan need to be updated too.

  • DocumentedSpan
    • TagKey -> KeyName
    • getTagKeys() -> getKeyNames()
    • getAdditionalTags() -> getAdditionalKeyNames()
  • SpanAssert
    • hasTagWithKey(TagKey key) -> hasTagWithKey(KeyName key)
    • hasTag(TagKey key, String value) -> hasTag(KeyName key, String value)
    • doesNotHaveTagWithKey(TagKey key) -> doesNotHaveTagWithKey(KeyName key)
    • doesNotHaveTag(TagKey key, String value) -> doesNotHaveTag(KeyName key, String value)
  • SpansAssert
    • hasASpanWithATag(TagKey key, String value) -> hasASpanWithATag(KeyName key, String value)
    • hasASpanWithATagKey(TagKey key) -> hasASpanWithATagKey(KeyName key)