Skip to content
This repository was archived by the owner on Sep 2, 2025. It is now read-only.

Commit 8f588b9

Browse files
committed
Add assembly version conflicts troubleshooting info to .NET instrumentation docs
1 parent dad70e4 commit 8f588b9

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

gdi/get-data-in/application/otel-dotnet/troubleshooting/common-dotnet-troubleshooting.rst

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,37 @@ The thread sampler resumes its activity when any of the buffers is empty.
190190

191191
To avoid the loss of profiling data due to full buffers, check the configuration and the communication layer between your process and the Splunk Distribution of OpenTelemetry Collector.
192192

193+
Assembly version conflicts
194+
==========================
195+
196+
When installing the .NET instrumentation, you might encounter dependency version conflicts that result in error messages such as:
197+
198+
.. code-block:: bash
199+
200+
Unhandled exception. System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified.
201+
202+
File name: 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'
203+
at Microsoft.AspNetCore.Builder.WebApplicationBuilder..ctor(WebApplicationOptions options, Action`1 configureDefaults)
204+
at Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(String[] args)
205+
at Program.<Main>$(String[] args) in /Blog.Core/Blog.Core.Api/Program.cs:line 26
206+
207+
To resolve this issue, :ref:`install the .NET instrumentation using the NuGet packages <otel-dotnet-nuget-pkg>`, as NuGet automatically installs the correct dependencies that the package requires.
208+
209+
Alternatively, you can manually install the conflicting packages to your project.
210+
211+
For a complete list of dependencies, see:
212+
213+
* `OpenTelemetry.AutoInstrumentation <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation/OpenTelemetry.AutoInstrumentation.csproj>`__
214+
* `OpenTelemetry.AutoInstrumentation.AdditionalDeps <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props>`__.
215+
216+
You can find the correct versions in the following:
217+
218+
* `Directory.Packages.props <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/Directory.Packages.props>`__
219+
* `src/Directory.Packages.props <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/Directory.Packages.props>`__
220+
* `src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props>`__
221+
222+
For more information about troubleshooting assembly version conflicts, see the `OpenTelemetry .NET instrumentation troubleshooting <https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/troubleshooting.md#assembly-version-conflicts>`__ guidance.
223+
193224
Uninstall the instrumentation
194225
======================================
195226

0 commit comments

Comments
 (0)