NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #96 most downloaded on pub.dev
A package for logging analytics for all Dart and Flutter related tooling to Google Analytics.
Latest stable
8.4.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 54 of 57 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
58 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Deprecated topLevelTool() . Tools no longer need to read DASH__TOOL themselves: pass your own tool to Analytics , which resolves the root tool, and us…
DashToolKind and DashTool.kind to distinguish top-level tools fromDashTool.canBeRootTool.DashTool values: analysisServeranalysis-server), dartMcpServer (dart-mcp-server), and skillsCliskills-cli).topLevelTool() now ignores a DASH__TOOL value that names a sharedtopLevelTool(). Tools no longer need to read DASH__TOOLAnalytics, which resolves the root tool,getEnvironment() for child processes.Analytics now resolves the root tool (the user's entry point) fromDASH__TOOL, then an optional new fallbackRootTool parameter onAnalytics and Analytics.development, then the tool itself. Only tools,root_tool, the resolvedleaf_tool, the logical tool passed as tool to Analyticstool user property keeps its current value, the tool itself for aLogFileStats.toolCount now counts events by leaf tool, falling back totool for log records written before leaf_tool existed.fallbackRootTool and rootTool (a test-only override) parameters toAnalytics.fake, which resolves DASH__TOOL from its environment.clientShowedMessage(), and getConsentMessage are now keyed on the rootAnalytics factories return a NoOpAnalytics, and other instances reportokToSend == false, show no consent message, and never write to the configgetEnvironment() to set DASH__TOOL to the tool's label (forvscode-plugins) instead of its Dart enum name (vscodePlugins),DashTool.fromLabel rejected. It now passes on the resolved rootDASH__TOOL when no root tool resolves.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Exported areAnalyticsSuppressedIn, which reads DASH__SUPPRESS_ANALYTICS from a provided environment map instead of the real process environment. This
areAnalyticsSuppressedIn, which reads DASH__SUPPRESS_ANALYTICS
from a provided environment map instead of the real process environment.
This lets tools with an overridable environment (such as dartdev) let
DASH__SUPPRESS_ANALYTICS take precedence over their own implicit
suppression, e.g.
areAnalyticsSuppressedIn(environment, defaultValue: isBot).Exports areAnalyticsSuppressedIn from package:unified_analytics, and bumps the version to 8.3.0.
Why: dartdev (in the Dart SDK) wants DASH__SUPPRESS_ANALYTICS to take precedence over its implicit bot/CI suppression, i.e. areAnalyticsSuppressedIn(environment, defaultValue: implicitlySuppressAnalytics). dartdev's environment can be overridden in its tests, so it can't use areAnalyticsSuppressed, which always reads Platform.environment.
Changes:
areAnalyticsSuppressedIn alongside areAnalyticsSuppressed.areAnalyticsSuppressedIn tests now import it through the public library, so they cover the export.Default agent in Analytics and Analytics.development to AiAgent.detectAgentName(Platform.environment) when omitted.
agent in Analytics and Analytics.development to
AiAgent.detectAgentName(Platform.environment) when omitted.AiAgent.cursor detection in AiAgent.detectAgentName to check
CURSOR_AGENT and CURSOR_EXTENSION_HOST_ROLE=agent-exec rather than
TERM_PROGRAM=cursor or any CURSOR_* environment variable.Analytics.isBot to detect CI and bot environments from environment
variables.Added optional isExternal parameter to Analytics.fake to allow overriding the build configuration during testing.
isExternal parameter to Analytics.fake to allow overriding the build configuration during testing.package:platform in favor of dart:io.send with a full log from about 16 ms to under 1 ms.Analytics instances no longer send any events, including from setTelemetry, when DASH__SUPPRESS_ANALYTICS is true.environment parameter to Analytics.fake; it defaults to empty, so tests ignore DASH__SUPPRESS_ANALYTICS in the real environment.Event.migrateEvent to track events from dart migrate.Added optional hostArch parameter to Event.flutterCommandResult.
hostArch parameter to Event.flutterCommandResult.pubspecHasFlutterSdk, pubspecEnvironmentSdk, and pubspecDependencies parameters to the Event.dartCliCommandExecuted constructor.hostArch parameter to Event.flutterCommandResult.pubspecHasFlutterSdk, pubspecEnvironmentSdk, and
pubspecDependencies parameters to the Event.dartCliCommandExecuted
constructor.minSdkConstraints and languageVersionOverrides parameters
to the Event.contextStructure constructor.isExternal to indicate if analytics are collected from an extenal build
system. The analytics consent mechanism is bypassed for non external builds.Added optional agentPlugin parameter to the Event.dartMCPEvent constructor to identify agent plugin usage.
Added Event.packageSkillsEvent to track events from package:skills.
Event.packageSkillsEvent to track events from package:skills.dart format.Added IDE and plugin information to Event.serverSession .
Event.serverSession.Exception or Error thrown while reading or writing analytics logs.agent parameter to Analytics constructors to track the AI coding assistant/agent executing the tool.Added HCPP related analytics to Event.commandUsageValues.
Event.commandUsageValues.Added success indicator and label to Event.flutterTrackAndroidDependencies
success indicator and label to Event.flutterTrackAndroidDependenciesDeprecated Event.flutterWasmDryRun in favor of Event.flutterWasmDryRunPackage.
Event.flutterTrackAndroidDependencies to track android dependencies.Event.flutterWasmDryRun in favor of Event.flutterWasmDryRunPackage.Event.plugins to track new analyzer pluginsDashEvent.ideEvent to track IDE reported events.Added Event.flutterWasmDryRunPackage to track dart2wasm dry run metrics from Flutter including public package information.
Event.flutterWasmDryRunPackage to track dart2wasm dry run metrics from Flutter
including public package information.Fix Event.flutterWasmDryRun fields.
Event.flutterWasmDryRun fields.Changed Event.flutterWasmDryRun to track dart2wasm dry run metrics from Flutter.
Event.flutterWasmDryRun to track dart2wasm dry run metrics from Flutter.Added Event.dartMCPEvent for events from the dart mcp-server command.
Event.dartMCPEvent for events from the dart mcp-server command.Added Event.flutterInjectDarwinPlugins event for plugins injected into an iOS/macOS project.
Event.flutterInjectDarwinPlugins event for plugins injected into an iOS/macOS project.Allow LogStatsFile to contain more granular event types (specifically property_editor events).
LogStatsFile to contain more granular event types (specifically property_editor events).Fixed UnsupportedError thrown when Event.exception is called without providing a value for args.
UnsupportedError thrown when Event.exception is called without providing a value for args.Added a required parameter screen to the Event.devtoolsEvent constructor.
screen to the Event.devtoolsEvent constructor.additionalMetrics to the Event.devtoolsEvent constructor.CustomMetrics class for unified_analytics clients to define custom event metrics.uiDurationMicros, rasterDurationMicros, shaderCompilationDurationMicros,
traceEventCount, cpuSampleCount, cpuStackDepth, heapDiffObjectsBefore, heapDiffObjectsAfter,
heapObjectsTotal, rootSetCount, rowCount, inspectorTreeControllerId, androidAppId, iosBundleId
from the Event.devtoolsEvent constructor.Nothing published for this version
Remove any data entries with a null value in the Event.exception constructor.
data entries with a null value in the Event.exception constructor.Fix formatting and remove dependency on package:intl.
package:intl.package:path in favor of package:file.androidAppId and iosBundleId to the Event.devtoolsEvent constructor.Added isWasm parameter to the Event.devtoolsEvent constructor.
isWasm parameter to the Event.devtoolsEvent constructor.data to the Event.exception constructor.unified_analytics: now deletes old log file if it exceeds kMaxLogFileSize of 25MiB (to prevent FileSystemExceptions) by @christopherfujino in https://
FileSystemExceptions) by @christopherfujino in https://github.com/dart-lang/tools/pull/277Full Changelog: https://github.com/dart-lang/tools/compare/unified_analytics-v6.1.1...unified_analytics-v6.1.2
[unified_analytics] Suppress any FileSystemException thrown during Analytics.send by @andrewkolos in https://github.com/dart-lang/tools/pull/274
FileSystemException thrown during Analytics.send by @andrewkolos in https://github.com/dart-lang/tools/pull/274Full Changelog: https://github.com/dart-lang/tools/compare/unified_analytics-v6.1.0...unified_analytics-v6.1.1
Analytics.send could result in a FileSystemException when unable to write to a log file.Added new event constructor Event.devtoolsEvent for the single devtools event with a new enum value DashEvent.devtoolsEvent
Event.devtoolsEvent for the single devtools event with a new enum value DashEvent.devtoolsEventConsolidate Session functionality into UserProperty to prevent race condition crash where session logic crashed before initializing UserProperty
Session functionality into UserProperty to prevent race condition crash where session logic crashed before initializing UserPropertylate variables throughout implementation class, AnalyticsImplEvent.analyticsException) encountered within package will be sent when invoking Analytics.close; replacing ErrorHandler functionalityFakeAnalytics.sendPendingErrorEvents to send error events on commandEvent.fromJson static method to generate instance of Event from JSONmeasurementId and apiSecret from the Analytics.test constructorAnalytics.test factory constructor in favor of Analytics.fake static method to return a FakeAnalytics instanceFakeAnalytics default constructor in favor of Analytics.fakeBug fix rewrite the other call site for the session file
Nothing published for this version
Avoid opening large telemetry log files to prevent out of memory errors.
Analytics.send could result in a FileSystemException when unable to write to a log file.Bug fix to rewrite the last_ping key into the session json file
last_ping key into the session json fileRefactored session handler class to use the last modified timestamp as the last ping value
Fix late initialization error for Analytics.userProperty bug
Analytics.userProperty bugExporting all enums from `enums.dart` through lib/testing.dart
enums.dart through lib/testing.dartFix bug when parsing session json file
Added new event Event.analyticsException to track internal errors for this package
Event.analyticsException to track internal errors for this packageAnalytics.test factory to return an instance of FakeAnalyticsRefactor logic for okToSend and shouldShowMessage
okToSend and shouldShowMessageFix template string for consent message
enabledFeatures to constructor to collect features enabled for each dash toolNothing published for this version
Added the Event.commandUsageValues constructor
Event.commandUsageValues constructorAdded the Event.timing constructor
Event.timing constructorEdit to the Event.flutterCommandResult constructor to add commandHasTerminal
Event.flutterCommandResult constructor to add commandHasTerminalAnalytics.setTelemetry to prevent the clients from hangingEvent.appleUsageEvent constructorEvent.exception constructorAdded the Event.codeSizeAnalysis constructor
Event.codeSizeAnalysis constructorUser property "host_os_version" added to provide detail version information about the host
Event.flutterCommandResult constructorAdded the Event.hotRunnerInfo constructor
Event.hotRunnerInfo constructorAdded the Event.flutterBuildInfo constructor
Event.flutterBuildInfo constructorPotential breaking changes due to the function signature changing for the Analytics.send and Analytics.close methods.
package:dart_flutter_team_lintsEvent.doctorValidatorResult constructorPotential breaking changes due to the function signature changing for the Analytics.send and Analytics.close methods.
Adding constant for the NoOpAnalytics instance client ID to enable clients to reference it in tests
Potential breaking change for clients using this package that implement Analytics since there is a new instance getter for clientId
LogFileStats data to include information about flutter channel counts and tool countsanalytics.suppressTelemetry()SurveyHandler feature to Analytics instance to fetch available surveys from remote endpoint to display to users along with functionality to dismiss themFakeAnalytics for clients of this tool that need to ensure workflows are sending events in testsAnalytics instance to fetch the client ID being sent to GA4Potential breaking change for clients using this package that implement Analytics since there is a new instance getter for clientId
Old functions still exists as deprecated, forwarding to the new functions without the preferNewest argument. Makes PackageConfig , Package and Languag…
findPackageConfigAndFile and findPackageConfigAndUri..packages file..packages files.packages.readAnyConfigFile to readConfigFile, and removedpreferNewest parameter.readAnyConfigFileUri which becomes readConfigFileUri.preferNewest argument.PackageConfig, Package and LanguageVersion @sealed classes,final in a future update.PackageConfig.minVersion to complement .maxVersion.2.file and httpEvent class that will standardize what event data can be sent with each eventsendEvent method in favor of the send methodBreaking change has been introduced when swapping Analytics.sendEvent() for Analytics.send() with a new Event class for .send()
Breaking change introduced when changing the default constructor for Analytics to remove overrides. This change is due to the revision of the privacy…
dateStamp utility function to be defined in utils.dart instead of having static methods in Initializer and ConfigHandlerpddFlag now that the revisions to the PDD have been finalized to persist data in the log file and session json fileenableAsserts parameter added to constructors for Analytics to check body of POST request for Google Analytics 4 limitationsNoOpAnalytics returned by Analytics factory constructorBreaking change introduced when changing the default constructor for Analytics to remove overrides. This change is due to the revision of the privacy document being approved.
Added a okToSend getter so that clients can easily and accurately check the state of the consent mechanism.
okToSend getter so that clients can easily and accurately check the state of the consent mechanism.deepCopyLinks argument to copyPath and copyPathSync.@visibleForTesting annotation from SharedStdIn.SharedStdIn.new.
AnsiCode and AnsiCodeType marked final. ThesefinalexpectApiSummaryClean, ApiSummaryFormat, andApiSummaryVerificationException to support one-liner golden file verificationdart test (e.g. test('api_summary', expectApiSummaryClean);).--write (-w), --check (-c), and --output (-o) flags to theapi_summary CLI executable.Error handling on the analytics.sendEvent(...) method to silently error out and return a 500 http status code to let tools using this package know Goo
analytics.sendEvent(...) method to silently error out and return a 500 http status code to let tools using this package know Google Analytics did not receive the event (all successful requests will have a status code of 2xx provided by Google Analytics)Error handling functionality added to prevent malformed session json data from causing a crash
clientShowedMessage()Implemented fake Google Analytics Client for Analytics.test(...) constructor; marked with visible for testing annotation
Analytics.test(...) constructor; marked with visible for testing annotationBumping intl package to 0.18.0 to fix version solving issue with flutter_tools
- Initial version
Nothing published for this version
One column per quarter.