Fixed #

• Removed the _TrackedHttpClient warning that fired when HttpOverrides.current was not TrackedHttpOverrides. It ran on already tracked clients (false alarm) and never on new HttpClient()s created after HttpOverrides.global was replaced (the actual miss). Install custom overrides before VuTelemetry.initialize().
• TrackedHttpOverrides now forwards HttpClient and HttpClientRequest property writes to the inner client. Timeouts, User-Agent, autoUncompress, and package:http Content-Length / persistentConnection were previously stored only on the wrapper and silently ignored.
• HTTP client spans from instrumentations.http: true + http.Client() now record the download phase. Response metadata getters used to end the span on a microtask before package:http listened to the body; a cancelable timer now waits for listen() (or closes unread-body spans without inflating duration).
• Chained HttpOverrides now keep DNS/connect timing. TrackedHttpOverrides installs the instrumented connectionFactory on the prior override's client instead of wrapping it without connect instrumentation.
• HTTP client spans are no longer lost when the response body is discarded with drain() (or any StreamSubscription.asFuture use). asFuture overwrites the subscription's onDone, which replaced the handler that ends the span, so the span never closed and never exported. The end hook now sits on an internal subscription the caller cannot overwrite, and a body abandoned part-way through (subscription cancelled) also closes its span.
• A connectionFactory assigned to the HttpClient the SDK hands out is no longer dropped. connectionFactory is set-only, so the assignment used to replace the instrumented factory and silently end connect timing; the two are now composed — the app's factory does the connecting and timing is still recorded. Clearing it (null) restores the SDK's self-connecting factory.
• OtelDioInterceptor no longer copies and stringifies every request and response header on each call. The maps are built only when captureRequestHeaders / captureResponseHeaders are non-empty; previously they were built and then discarded under the default empty allowlists.
• Transport failures (no HTTP response received) now report http.response.status_code = 0 so they can be distinguished from 4xx/5xx responses. A status already set by applyResponse is never overwritten.
• Frame jank monitoring no longer resolves the current screen or starts the aggregation timer until a slow/frozen frame is observed.
• A replacement outermost Navigator (auth gate, keyed MaterialApp rebuild) now reports navigation.transition.type = app_initialization for its first route. The label previously followed _hasEverEmitted, so a depth-0 landing after anything had already emitted was tagged nested_initialization.
• screen.name no longer drops back to the enclosing page when a nested Navigator's observers are re-attached — an inline RouteObserverService.nested() recreated on rebuild, or a GlobalKey reparenting that moves it under a new ancestor. NavigatorObserver.navigator is cleared by NavigatorState.deactivate, not only by disposal, so it was never a liveness flag; per-navigator state is now keyed on the live NavigatorState and retired when that unmounts.
• pushAndRemoveUntil now reports navigation.transition.type = push. Flutter drains route additions before deletions, so the removals were relabelling the push as a pop — inverting every login / onboarding-completion transition.
• tab_switch spans from a VuIndexScope with foldIntoScreenName: false now report the branch the user left as navigation.source.name instead of repeating the destination.
• A shell that builds its branches on demand now emits a nested_initialization for each branch as it appears. Suppression of hidden IndexedStack siblings is scoped to the frame rather than to the emit-coalescing window, which every emit refreshed.
• screen.name no longer picks a hidden branch when a Visibility(visible: true) sits between that branch and the shell that hides it.
• screen.name no longer stays on a nested branch when a root PageRoute covers the shell, and a hidden depth-2 branch can no longer outrank a visible depth-1 one.
• Reading navigation state no longer registers an InheritedWidget dependency from every nested Navigator, which made them rebuild on unrelated route changes.
• A VuTelemetry.logTabChange call with no accompanying setState now completes and exports its span instead of leaving it open.
• VuTelemetry.logTabChange with per-destination labels (dynamic titles) no longer grows a controller-driven group's label list without bound.
• Dropped an unread SharedPreferences write from every route change (it also fanned out to every nested navigator, hidden branches included).

Added #

• Flutter image.load instrumentation (Android Glide/Coil parity): opt-in VuNetworkImage / VuImage.network in core, plus sibling package vunet_flutter_plugin_cached_network_image for cached_network_image / flutter_cache_manager (VuInstrumentedCacheManager, VuCachedNetworkImageProvider, VuCachedNetworkImage). Spans use scope com.vunetsystems.rum.flutter.image with attrs image.url (query stripped), image.source, image.load.status, and optional image.model_type; network path emits a child HTTP GET under the image span.

Changed #

• HTTP client phase timings (dns_ms, connect_ms, ttfb_ms, download_ms, total_ms, and event duration_ms) are now floating-point milliseconds, so a 0.4 ms hop is recorded as 0.4 rather than truncated to 0 or omitted. Unmeasured phases (pooled connect, download that never started) stay omitted.
• Added InitializationParams.httpConnectionFactory, plus the HttpConnectionFactory typedef it takes (exported from both flutter_sdk.dart and http_instrumentation.dart). A connectionFactory installed inside a prior HttpOverrides' createHttpClient cannot be read back (the property is set-only), so TrackedHttpOverrides replaces it and custom pooling / proxying / mTLS is lost. Supply it here (or via TrackedHttpOverrides.install(connectionFactory:)) and it is composed with connect timing instead. Only the combined connect phase is reported then — dns is unavailable, since the lookup happens inside the supplied factory.
• Added HttpSpanRecorder.capturesRequestHeaders / capturesResponseHeaders to http_instrumentation.dart. Custom adapters can check them before building a header map, since the allowlist is read at call time and empty by default.
• Nested-navigator docs now show a State-held RouteObserverService.nested() instead of one allocated inline in build.
• Documented W3C Trace Context Level 1 as the HTTP propagation contract: inject always uses traceparent version 00.
• Added SDK developer logging controls via InitializationParams.logLevel with SdkLogLevel.info as the default. SdkLogLevel.debug now emits lifecycle, HTTP, navigation, error, and frame-monitoring diagnostics from the Flutter layer.
• app.jank frame monitoring now uses display refresh-rate budgets, microsecond-precision comparisons, per-window total_frames / jank rates, separate slow vs frozen and build vs raster counters, and span timestamps anchored to the observed frame window (not flush time).
• foldIntoScreenName is now available on every tab API, not just VuIndexScope: VuTabScope, VuTelemetry.observeTabController and VuTelemetry.logTabChange all accept it (default true, unchanged behaviour). On the imperative APIs it applies to the call that first registers the group — the flag is fixed for the group's lifetime.

Breaking #

• ui.navigation spans moved to a navigation.* attribute vocabulary. The observer no longer writes screen.name, last.screen.name, screen.route, or last.screen.route:
  • screen.name (destination) is now navigation.destination.name. ScreenNameSpanProcessor still stamps screen.name at span start with the same destination value, but without the 'unknown' fallback — when the destination widget class cannot be derived (a route that is neither a MaterialPageRoute nor a CupertinoPageRoute, or one pushed before the navigator is attached) the span now carries no screen.name where it previously carried the literal "unknown".
  • last.screen.name is now navigation.source.name, and the initial route's value changed from 'unknown' to 'app_launch'.
  • screen.route and last.screen.route are removed. navigation.destination.type / navigation.source.type carry the route class (material / cupertino / page / unknown), not the route path, so dashboards grouping ui.navigation by route path lose that data unless a router integration supplies it. vunet_flutter_plugin_go_router does: it writes the matched path pattern to navigation.destination.route / navigation.source.route and the concrete path (query stripped) to navigation.destination.uri / navigation.source.uri. The core observer cannot — a Navigator does not know its own path patterns — so those four attributes are absent, not unknown, without an integration. Spans also gained navigation.transition.type, navigation.entry.type, navigation.trigger, navigation.is_initial, navigation.duration_ms, navigation.ttid_ms, and navigation.transition.completed.
• Removed the shared_preferences dependency — nothing in the SDK reads it any more. Apps that were picking it up transitively must declare it themselves.
• Renamed VuTelemetry.logClickEvent to VuTelemetry.logInteraction; the signal covers gestures and value changes, not only clicks. No alias is kept — call sites must be updated.
• ui.interaction spans no longer emit event.name. The first argument to VuTelemetry.logInteraction is now the widget acted on and is emitted as app.widget.name (blank values fall back to unknown). Backend queries keyed on event.name stop working and need coordinated updates.
• ui.interaction spans now always carry app.widget.source (flutter) and interaction.type. interaction.type comes from the new optional logInteraction(interactionType:) parameter, defaulting to InteractionTypes.tap; the InteractionTypes vocabulary (tap, gesture, value_change, menu, menu_item) is exported from flutter_sdk.dart and mirrors the native iOS SDK. Entries in attributes can no longer override these three keys.
• app.widget.name / app.widget.source deliberately differ from the native iOS spelling (element.name / ui.framework) for the same ui.interaction span name. Backend queries must branch by platform until one spelling wins.
• logInteraction no longer writes screen.name itself. ScreenNameSpanProcessor still stamps it at span start (native does not add it to spans bridged from Flutter), but the 'unknown' fallback is gone: an interaction fired before the first route resolves now emits no screen.name where it previously emitted the literal "unknown". Queries filtering or grouping on that literal change behaviour. Precedence also flips — a screen.name passed in attributes now overrides the processor instead of being discarded.
• HTTP spans no longer write screen.name themselves. ScreenNameSpanProcessor still stamps it at span start, but the 'unknown' fallback is gone: a request before the first route resolves now emits no screen.name where it previously emitted the literal "unknown". The screenName argument was removed from HttpSpanRecorder.start.
• Moved Dio instrumentation (OtelDioInterceptor, attachInstrumentedDio) out of vunet_flutter_plugin into the sibling package vunet_flutter_plugin_dio. Apps that use Dio must add that dependency and import package:vunet_flutter_plugin_dio/vunet_flutter_plugin_dio.dart. The hard dio dependency was removed from core.
• Added package:vunet_flutter_plugin/http_instrumentation.dart for official HTTP client integrations and advanced custom adapters (HttpSpanRecorder, timing helpers, InstrumentationScopes). App code should continue to use flutter_sdk.dart.
• Replaced InitializationParams.enableSlowFrameTracking with instrumentations.jankDetection on nested InstrumentationsConfig. Also gates auto-install of error handlers (errors) and TrackedHttpOverrides (http). Navigation and Dio remain app-wired.
• Renamed Flutter RUM instrumentation scopes to com.vunetsystems.rum.flutter.* (e.g. HTTP → ...http, Dio → ...http.dio, custom action → ...custom.action). Backends that filter on instrumentationScope.name must update queries.
• Removed legacy Flutter anr-instrumentation / freezeDetected span emission (native SDK owns ANR/jank).
• RUM tracers now set instrumentation scope version to the plugin version.
• Custom actions: use VuTelemetry.action.startAction / withAction (was VuAction.startAction / withAction). VuAction remains the handle type.
• Error spans share scope com.vunetsystems.rum.flutter.errors with distinct names (flutter.ui.error, flutter.platform.error, flutter.custom.error) and error.source. Only custom errors are app-facing via VuTelemetry.error.record(...); UI/platform capture is SDK-internal.

Full Changelog

Merged pull requests:

• Make registerGlobalContextManager public API #183 (jonathancampbell-wk)
• O11Y-4831: Use test URL in test #181 (kennytrytek-wf)

Full Changelog

Merged pull requests:

• PPI-165 : fix timestamp rounding issues and expose helpers for high res timestamps #179 (blakeroberts-wk)
• update changelog #178 (blakeroberts-wk)

Full Changelog

Closed issues:

• [Question] What is correct way to call Context.current.span now? #173
• RecordException doesn't capture Exception as Event #152

Merged pull requests:

• add cross-cutting context api functions #176 (blakeroberts-wk)
• Update CODEOWNERS #175 (tylerrinnan-wf)
• Exception as event #160 (mikebosland)
• Improve pub.flutter-io.cn PUB POINTS 100->130 #159 (mikebosland)

Full Changelog

Closed issues:

• I can't find withContext and setSpan from README #162

Merged pull requests:

• O11Y-4632 Release 0.18.3 #171 (changliu-wk)
• O11Y-4623: Update Context API examples in opentelemetry-dart README #170 (michaelyeager-wf)
• O11Y-4010: Add ContextManager for Context #167 (changliu-wk)
• Replace mockito with mocktail #165 (sourcegraph-wk)
• Update GHA publishing steps #164 (michaelyeager-wf)
• Allow a custom time provider in TracerProviderBase #158 (mikebosland)
• Allow custom timestamps to be used on Span.end() #115 (rafaelring)

Full Changelog

Closed issues:

• PreFlight request support #154

Merged pull requests:

• expose sdk.Attributes #157 (yuzurihaaa)
• O11Y-4317: update generated mocks and format project #155 (blakeroberts-wk)
• O11Y-4273: Version Bump #151 (kennytrytek-wf)
• O11Y-4278: Add publishing note #149 (kennytrytek-wf)

Full Changelog

Closed issues:

• Process crashes when no collector is running #147
• 0.18.0 release to pub.flutter-io.cn? #142

Merged pull requests:

• Show log and keep running on export failure #148 (tapih)
• Bump the pub group with 1 update #145 (dependabot[bot])

Full Changelog

Closed issues:

• Support for Events? #116

Merged pull requests:

• Bump the pub group with 2 updates #144 (dependabot[bot])
• Bump the pub group with 1 update #143 (dependabot[bot])
• O11Y-3814: version bump #141 (kennytrytek-wf)
• O11Y-3814: Support Dart 2 and Dart 3 #140 (kennytrytek-wf)
• O11Y-3736: opentelemetry-dart: Deprecate MeterSharedState #139 (michaelyeager-wf)
• O11Y-3733: opentelemetry-dart: Implement Improvements to Timer in BatchSpanProcessor #137 (michaelyeager-wf)
• Implemented Span.addEvent and added tests for it #136 (baskillen)
• Bump the github-actions group with 1 update #132 (dependabot[bot])

Full Changelog

Merged pull requests:

• opentelemetry-dart 0.17.0 #135 (michaelyeager-wf)
• O11Y-3369: Migrate opentelemetry-dart to GHA #134 (michaelyeager-wf)
• Bump the pub group with 1 update #133 (dependabot[bot])
• Dart 2.19 #131 (sourcegraph-wk)
• O11Y-3369: Migrate opentelemetry-dart to GHA #126 (michaelyeager-wf)
• O11Y-3138: Update deprecation messages #122 (michaelyeager-wf)
• Rollout Analyzer 5 #120 (sourcegraph-wk)
• O11Y-3138: Improve Adherence to Specification #118 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-3136 : update protoc to v20.0.1 #113 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• Add dependency for meta to pubspec.yaml #111 (michaelyeager-wf)

Full Changelog

Closed issues:

• MeterProvider doesn't yet support resources #87

Merged pull requests:

• Move W3CTraceContextPropagator to API package #109 (michaelyeager-wf)
• O11Y-2859: Disable code coverage comments on pull requests #108 (dustinlessard-wf)
• Update dart dependencies #106 (sourcegraph-wk)
• O11Y-2792: Update action versions #105 (changliu-wk)
• Fix syntax errors in README example code. #104 (scidev20)
• Pin mockito 5 #103 (sourcegraph-wk)
• Extended exporter with a headers map for authorization #102 (v-shemet)
• O11Y-2370: Report Code Coverage on PRs #96 (dustinlessard-wf)
• O11Y-2256 : Resource can be passed into MeterProvider #90 (dustinlessard-wf)

Full Changelog

Full Changelog

Closed issues:

• We need a pull request template #82
• SDK.MetricsOptions.setUnits lack implementation #77
• MetricOptions.setDescription lacks implementation #76

Merged pull requests:

• Update http to allow 0.13.0 #91 (robbecker-wf)
• O11Y-2352 : added missing dependency #89 (dustinlessard-wf)
• New Template #84 (danrick-wk)
• O11Y-2154 : Add MeterProvider classes #78 (dustinlessard-wf)

Full Changelog

Full Changelog

Closed issues:

• Global setup code should be exposed via the api not via the sdk #80

Merged pull requests:

• O11Y-2238 moved to api #81 (danrick-wk)

Full Changelog

Closed issues:

• Repo lacks assets helpful to contributors #69
• Pub publishing indicates warning related to missing changelog #67
• opentelemetry-dart should expose CI results to contributors #64

Merged pull requests:

• O11Y-2149: Resolve changelog warning for publishing to public pub server #68 (dustinlessard-wf)

Full Changelog

Merged pull requests:

• O11Y-2150 : Opentelemetry-dart lacks assets helpful to contributors #70 (dustinlessard-wf)

Full Changelog

Merged pull requests:

• O11Y-1873: Adjust copyright information in OpenTelemetryDart #62 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Add Resource Attribute for Deployment Environment #61 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• trace shouldn't alter the return type of the function being traced #58 (jasonaguilon-wf)

Full Changelog

Merged pull requests:

• O11Y-1842 : commit protobuf generated code #60 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• O11Y-1784: Tracing attributes should follow naming convention guidelines #54 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1770: Add required files to opentelemetry-dart repo for OSS #51 (keruitan-wk)

Full Changelog

Merged pull requests:

• O11Y-1750: implement spanLinks #56 (changliu-wk)

Full Changelog

Merged pull requests:

• O11Y-1489: Update span processors to match otel spec #59 (keruitan-wk)

Full Changelog

Merged pull requests:

• O11Y-1804: Update Dart Dockerfile to use new Dart image #57 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1748: OpenTelemetry Dart: Implement forceFlush for SpanExporters #55 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Replace deprecated commands with new dart commands #49 (sourcegraph-wk)

Full Changelog

Merged pull requests:

• O11Y 1771 Update CODEOWNERS file #52 (sourcegraph-wk)

Full Changelog

Merged pull requests:

• O11Y-1749: OpenTelemetry Dart: Complete Implementation of SpanKind #50 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1508: Change Span to use high resolution time instead of DateTime.now() #39 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1694: move attributes and resource to sdk #47 (changliu-wk)

Full Changelog

Merged pull requests:

• O11Y-1709: Move Sampler to SDK #48 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1665: Stub out remaining interface methods in opentelemetry-dart #43 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1716 : add skynet.yaml #46 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• O11Y-1631: add SpanLimits, implement maxNumAttributes and maxNumAttributeLength #42 (changliu-wk)

Full Changelog

Merged pull requests:

• O11Y-1679: Move Tracer.trace out of Tracer class/interface #44 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1504: wo11y-dart tracer.trace spans don't end until the parent span ends #41 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Run semver report as part of CI #40 (jayudey-wf)

Full Changelog

Merged pull requests:

• O11Y-1528 : update sdk to use api where possible #36 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• Temporarily disable the mockito builder for better build perf #38 (sourcegraph-wk)

Full Changelog

Merged pull requests:

• Widen ranges of fixnum and protobuf #35 (evanweible-wf)

Full Changelog

Merged pull requests:

• O11Y-1356: Add trace() helper for opentelemetry dart #34 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1293 : include span attributes in collector exporter #32 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• Raise Max Versions #33 (sourcegraph-wk)

Full Changelog

Merged pull requests:

• O11Y-1027: Parent Based Sampling #30 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• RED-4673 : add aviary.yaml #29 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• Expose StatusCode API #27 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1291 : allow for multiple tracers #26 (blakeroberts-wk)

Full Changelog

Merged pull requests:

• Add global registration documentation #25 (garrickpeterson-wf)

Full Changelog

Merged pull requests:

• API For Registering Global Instance #24 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Fix Version Make Target #23 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Expose Attribute SDK #22 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Remove Text Map Propagators #21 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• O11Y-1045: opentelemetry-dart must manage different contexts for async code #19 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Pin protoc_plugin to 19.3.1 to account for SDK 2.11 #18 (tylersnavely-wf)

Full Changelog

Merged pull requests:

• O11Y-1208: Direct commit release version #17 (tylersnavely-wf)
• O11Y-1208: Release every pull #15 (tylersnavely-wf)

Full Changelog

Merged pull requests:

• O11Y-1208: Set pubspec.yaml version automatically #14 (tylersnavely-wf)

Full Changelog

Merged pull requests:

• Readme step by step #9 (tylersnavely-wf)

Full Changelog

Merged pull requests:

• O11Y-1019: Inject and Extract context from a message to feed into span creation #12 (michaelyeager-wf)
• Raise the Dart SDK minimum to at least 2.11.0 #11 (sourcegraph-wk)
• O11Y-994: OTEL Dart: Implement Tracer Provider API #10 (michaelyeager-wf)
• O11Y-989: Functionality to set attributes on spans #3 (michaelyeager-wf)

Full Changelog

Merged pull requests:

• Fix release validation errors #8 (tylersnavely-wf)

0.0.1 (2021-08-27) #

Full Changelog

Merged pull requests:

• O11Y-1062: Create version 0.0.1 #7 (tylersnavely-wf)
• O11Y-992: OTEL Dart: Implement OTLP HTTP Reporter #6 (tylersnavely-wf)
• O11Y-990: Set span status #5 (michaelyeager-wf)
• O11Y-993: OTEL Dart: Implement OTLP Console Reporter #4 (tylersnavely-wf)
• O11Y-988: Record Spans #2 (tylersnavely-wf)
• Initial branch #1 (tylersnavely-wf)

* This Changelog was automatically generated by github_changelog_generator