Add api-version support

[dhabierre]

When using a versioned API with Microsoft.AspNetCore.Mvc.Versioning nuget package, the {version:apiVersion} is not replaced with the real controller version.

Discussion issue #2967 & #4525

Changes

• Update OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs in order to replace {version:apiVersion} url segment with the real controller version.
• Add ApiVersioning support & ApiVersioningControllers in TestApp.AspNetCore project

Merge requirement checklist

• CONTRIBUTING guidelines followed (nullable enabled, static analysis, etc.)
• Unit tests added/updated
• Appropriate CHANGELOG.md files updated for non-trivial changes

This is my first PR here, hope all is fine :)
Any feedback about my proposal is welcome.

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: dhabierre (96da260)

[alanwest]

@dhabierre Thanks for the contribution! Including API version information in the Activity name (and/or the http.route attribute) sounds like it could be a really good idea. However, we're going to hold off on accepting this PR at the moment.

There is a strong push at the spec level going on at the moment to stabilize the HTTP semantic conventions and we're actively working to align our instrumentation to the conventions. Routing is complex as there are many scenarios to consider handling (API versioning being a potential scenario), so naming the Activity and including the route information is one of the trickier parts to hash out before we can release stable ASP.NET Core instrumentation.

@vishweshbankwar will be working with the ASP.NET Core team to sort out the optimal way to retrieve the route information we include in the Activity. We'll add API version to the list of things we're considering. Please bear with us as we work through this.

@vishweshbankwar suggested a potential solution in the interim could be to use Enrich to modify the Activity as you need it.

[dhabierre]

Hi @alanwest and thanks for your post.
Hope that versionned APIs will be supported soon :)