Package referenced in documentation is "pre-release only". Nuget fails to add the package.

[atleag]

Type of issue

Code doesn't work

Description

Hi.

TL;DR: The package OpenTelemetry.Exporter.Prometheus.AspNetCore referenced in the article is "Pre-Release" only. No stable versions are available. It will fail to be added if the user does as instructed.

---

Steps

1. Run dotnet add package OpenTelemetry.Exporter.Prometheus.AspNetCore in the terminal or the Package Manager Console.

Expected result
Package is successfully added.

Actual result
An error occurs
There are no stable versions available, 1.14.0-beta.1 is the best available. Consider adding the --prerelease option

Cause
The OpenTelemetry.Exporter.Prometheus.AspNetCore package is "Pre-Release" only and will not be visible unless "Include prerelease" is checked in the IDE, or the --prerelease option is applied.

If the use of "prerelease"-only packages is intended in the article series, it would be wonderful if it was clear quite early. At the very least under chapter 4. Reference the OpenTelemetry packages and on the Overview page.

Additional info
The open-telemtry documentation states:

Warning
This component is still under development due to a dependency on the experimental Prometheus and OpenMetrics Compatibility specification and can undergo breaking changes before stable release. Production environments should consider using OpenTelemetry.Exporter.OpenTelemetryProtocol. Refer to the Getting Started with Prometheus and Grafana tutorial for more information.

Possibly related issue #44562

Cheers!

Page URL

https://learn.microsoft.com/en-us/dotnet/core/diagnostics/observability-prgrja-example

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/diagnostics/observability-prgrja-example.md

Document Version Independent Id

59d4807e-8b88-9d39-cd51-977792064cf6

Platform Id

2f326b35-4a98-0694-da18-c1eb7c9dd0eb

Article author

@tommcdon

Metadata

• ID: eded9b69-1a38-a8bb-7e76-2f72a2e78abe
• PlatformId: 2f326b35-4a98-0694-da18-c1eb7c9dd0eb
• Service: dotnet-fundamentals

Related Issues