Skip to content

Upgrading Microsoft.ApplicationInsights 0.17 to 1

Breaking0.17.0 → 1.2.3Breaking10Deprecated1New3Changed2Fixed2

Full comparisonBack to Microsoft.ApplicationInsights
BreakingUpgrade verdict

10 breaking changes.

In plain terms
  • The web library file has a new name, so references to the old file must be updated.
  • The telemetry channel package and its assembly have new names.
  • Configuration files that reference the old namespace names must be updated to the new names.
  • The performance counter collector assembly has a new name.
Must act Top 4 of 11 that need code or config changes

What you must change

Breaking10
Microsoft.ApplicationInsights.Web.dll is renamed to Microsoft.AI.Web.dll.
Microsoft.ApplicationInsights.Web.dllMicrosoft.AI.Web.dll
1.2.0CHANGELOG.mdSummarizedView source
Microsoft.Web.TelemetryChannel NuGet and its assembly are renamed to Microsoft.WindowsServer.TelemetryChannel.
Microsoft.Web.TelemetryChannelMicrosoft.WindowsServer.TelemetryChannel
1.2.0CHANGELOG.mdSummarizedView source
Web SDK namespaces drop the "Extensibility" part, including telemetry initializers in applicationinsights.config and the ApplicationInsightsWebTracking module in web.config.
applicationinsights.configApplicationInsightsWebTrackingweb.config
1.2.0CHANGELOG.mdSummarizedView source
Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector assembly is renamed to Microsoft.AI.PerfCounterCollector.
Microsoft.ApplicationInsights.Extensibility.PerfCounterCollectorMicrosoft.AI.PerfCounterCollector
1.2.0CHANGELOG.mdSummarizedView source
Removes the "Web" prefix from telemetry initializer and telemetry module names since the namespace already includes it.
1.0.0CHANGELOG.mdSummarizedView source
Renames RemoteDependencyModule to DependencyTrackingTelemetryModule.
RemoteDependencyModuleDependencyTrackingTelemetryModule
1.0.0CHANGELOG.mdSummarizedView source
Renames CustomPerformanceCounterCollectionRequest to PerformanceCounterCollectionRequest.
CustomPerformanceCounterCollectionRequestPerformanceCounterCollectionRequest
1.0.0CHANGELOG.mdSummarizedView source
Moves telemetry initializers and telemetry modules from separate sub-namespaces to the root Microsoft.ApplicationInsights.Extensibility.Web namespace.
Microsoft.ApplicationInsights.Extensibility.Web
1.0.0CHANGELOG.mdSummarizedView source
Moves DeviceContextInitializer from the Microsoft.ApplicationInsights assembly to the Extensibility.Web assembly and converts it to an ITelemetryInitializer.
DeviceContextInitializerMicrosoft.ApplicationInsightsMicrosoft.ApplicationInsights.Extensibility.WebITelemetryInitializer
1.0.0CHANGELOG.mdSummarizedView source
Changes namespace and assembly names from Microsoft.ApplicationInsights.Extensibility.RuntimeTelemetry to Microsoft.ApplicationInsights.Extensibility.DependencyCollector.
Microsoft.ApplicationInsights.Extensibility.RuntimeTelemetryMicrosoft.ApplicationInsights.Extensibility.DependencyCollector
1.0.0CHANGELOG.mdSummarizedView source

Deprecations to plan for

Deprecated1
SamplingRatio property of DependencyTrackingTelemetryModule does nothing and is marked obsolete.
SamplingRatioDependencyTrackingTelemetryModule
1.2.0CHANGELOG.mdSummarizedView source