AWS.Distro.OpenTelemetry.AutoInstrumentation 1.5.0

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Framework 4.6.2 This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher. 
dotnet add package AWS.Distro.OpenTelemetry.AutoInstrumentation --version 1.5.0                

                    
                

            
NuGet\Install-Package AWS.Distro.OpenTelemetry.AutoInstrumentation -Version 1.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="AWS.Distro.OpenTelemetry.AutoInstrumentation" Version="1.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add AWS.Distro.OpenTelemetry.AutoInstrumentation --version 1.5.0                

                    
                

            
#r "nuget: AWS.Distro.OpenTelemetry.AutoInstrumentation, 1.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install AWS.Distro.OpenTelemetry.AutoInstrumentation as a Cake Addin
#addin nuget:?package=AWS.Distro.OpenTelemetry.AutoInstrumentation&version=1.5.0

// Install AWS.Distro.OpenTelemetry.AutoInstrumentation as a Cake Tool
#tool nuget:?package=AWS.Distro.OpenTelemetry.AutoInstrumentation&version=1.5.0

Using the AWS.Distro.OpenTelemetry.AutoInstrumentation NuGet package

When to use the NuGet package

Use the NuGet package in the following scenarios:

  1. You control the application build but not the machine/container where the application is running.
  2. Support instrumentation of self-contained applications.
  3. Facilitate developer experimentation with automatic instrumentation through NuGet packages.
  4. Solve version conflicts between the dependencies used by the application and the automatic instrumentation.

Limitations

While NuGet packages are a convenient way to deploy automatic instrumentation, they can't be used in all cases. The most common reasons for not using NuGet packages include the following:

  1. You can't add the package to the application project. For example, the application is from a third party that can't add the package.
  2. Reduce disk usage, or the size of a virtual machine, when multiple applications to be instrumented are installed in a single machine. In this case you can use a single deployment for all .NET applications running on the machine.
  3. A legacy application that can't be migrated to the SDK-style project.

Using the NuGet packages

To automatically instrument your application with the AWS Distribution of OpenTelemetry .NET add the AWS.Distro.OpenTelemetry.AutoInstrumentation package to your project:

dotnet add [<PROJECT>] package AWS.Distro.OpenTelemetry.AutoInstrumentation --prerelease

If the application references packages that can be instrumented, but require other packages for the instrumentation to work, the build will fail and prompt you to either add the missing instrumentation package or to skip the instrumentation of the corresponding package:

~packages/opentelemetry.autoinstrumentation.buildtasks/1.7.0/build/OpenTelemetry.AutoInstrumentation.BuildTasks.targets(29,5): error : OpenTelemetry.AutoInstrumentation: add a reference to the instrumentation package 'MongoDB.Driver.Core.Extensions.DiagnosticSources' version 1.4.0 or add 'MongoDB.Driver.Core' to the property 'SkippedInstrumentations' to suppress this error.

To resolve the error either add the recommended instrumentation package or skip the instrumentation of the listed package by adding it to the SkippedInstrumentation property. For example:

  <PropertyGroup>
    <SkippedInstrumentations>MongoDB.Driver.Core;StackExchange.Redis</SkippedInstrumentations>
  </PropertyGroup>

The same property can be also specified directly using the terminal. Notice that the ; separator needs to be properly escaped as '%3B':

  dotnet build -p:SkippedInstrumentations=StackExchange.Redis%3BMongoDB.Driver.Core

To distribute the appropriate native runtime components with your .NET application, specify a Runtime Identifier (RID) to build the application using dotnet build or dotnet publish. This might require choosing between distributing a self-contained or a framework-dependent application. Both types are compatible with automatic instrumentation.

Example: dotnet build --runtime linux-x64. This builds the application and instrumentation for OS: Linux and Arch: x64.

Use the script in the output folder of the build to launch the application with automatic instrumentation activated.

  • On Windows, use adot-launch.cmd <application_executable>
  • On Linux or Unix, use adot-launch.sh <application_executable>
    • Call-out: before running the adot-launch.sh script, you will have to run sed -i -e 's/\r$//' path/to/adot-launch.sh
    • You can refer to this setup as an example

If you launch the application using the dotnet CLI, add dotnet after the script.

  • On Windows, use adot-launch.cmd dotnet <application>
  • On Linux and Unix, use adot-launch.sh dotnet <application>

The script passes to the application all the command-line parameters you provide.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.5.0 1,184 12/9/2024
1.4.0 2,152 11/1/2024
1.3.2 7,316 9/26/2024
1.3.1 146 9/26/2024
1.3.0 87 9/3/2024

See release notes at https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases