Pre-releases in OpenTelemetry .NET are handled through the use of pre-release packages, which can include new features, improvements, or bug fixes that are not yet considered stable. These pre-release packages can be used to test and evaluate upcoming changes before they are included in a stable release.
Here are some possible options for handling pre-releases in OpenTelemetry .NET:
- Using NuGet pre-release packages: OpenTelemetry .NET provides pre-release packages via NuGet, which can be installed using the .NET CLI or Visual Studio. To install a pre-release package, you can use the
-prerelease
flag with theInstall-Package
command. For example:
Install-Package OpenTelemetry.Exporter.OTLP -Version 1.0.0-beta1 -Prerelease
This command installs the OpenTelemetry.Exporter.OTLP
package in version 1.0.0-beta1
.
- Downloading pre-release installation scripts: OpenTelemetry .NET provides pre-release installation scripts that can be used to automatically instrument your .NET applications with the latest pre-release version of OpenTelemetry. These scripts can be downloaded from the opentelemetry-dotnet-instrumentation repository on GitHub.
For example, to download the pre-release installation script for PowerShell, you can use the following commands:
$module_url = "https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest/download/OpenTelemetry.DotNet.Auto.psm1"
$download_path = Join-Path $env:temp "OpenTelemetry.DotNet.Auto.psm1"
Invoke-WebRequest -Uri $module_url -OutFile $download_path -UseBasicParsing
Import-Module $download_path
Install-OpenTelemetryCore -PreRelease
This will download and install the latest pre-release version of OpenTelemetry .NET using PowerShell.
- Forking the demo repository: The OpenTelemetry demo repository is designed to be forked and used as a tool to show off what you are doing with OpenTelemetry. You can fork the repository and modify it to use pre-release versions of OpenTelemetry .NET. This can be useful for testing and evaluating new features in a controlled environment.
For more information on forking the demo repository, see the Forking the demo repository documentation.
These are just a few examples of how pre-releases can be handled in OpenTelemetry .NET. For more information, see the OpenTelemetry .NET documentation.
Sources:
- https://opentelemetry.io/docs/instrumentation/net/
- https://opentelemetry.io/docs/instrumentation/net/getting-started
- https://opentelemetry.io/blog/2023/otel-dotnet-auto-instrumentation
- https://opentelemetry.io/docs/instrumentation/net/automatic
- https://opentelemetry.io/community/roadmap
- https://opentelemetry.io/community/mission
- https://opentelemetry.io/blog/2022/collector-builder-sample
- https://grafana.com/blog/2021/02/11/instrumenting-a-.net-web-api-using-opentelemetry-tempo-and-grafana-cloud
- https://opentelemetry.io/blog/2023/demo-birthday
- https://opentelemetry.io/docs/specs/otel/versioning-and-stability