Microsoft.Extensions.AmbientMetadata.Application
9.0.0-preview.3.24209.3
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.Extensions.AmbientMetadata.Application --version 9.0.0-preview.3.24209.3
NuGet\Install-Package Microsoft.Extensions.AmbientMetadata.Application -Version 9.0.0-preview.3.24209.3
<PackageReference Include="Microsoft.Extensions.AmbientMetadata.Application" Version="9.0.0-preview.3.24209.3" />
paket add Microsoft.Extensions.AmbientMetadata.Application --version 9.0.0-preview.3.24209.3
#r "nuget: Microsoft.Extensions.AmbientMetadata.Application, 9.0.0-preview.3.24209.3"
// Install Microsoft.Extensions.AmbientMetadata.Application as a Cake Addin #addin nuget:?package=Microsoft.Extensions.AmbientMetadata.Application&version=9.0.0-preview.3.24209.3&prerelease // Install Microsoft.Extensions.AmbientMetadata.Application as a Cake Tool #tool nuget:?package=Microsoft.Extensions.AmbientMetadata.Application&version=9.0.0-preview.3.24209.3&prerelease
Microsoft.Extensions.AmbientMetadata.Application
This flows runtime information for application-level ambient metadata such as the version, deployment ring, environment, and name. This information can be useful to enrich telemetry.
Install the package
From the command-line:
dotnet add package Microsoft.Extensions.AmbientMetadata.Application
Or directly in the C# project file:
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.AmbientMetadata.Application" Version="[CURRENTVERSION]" />
</ItemGroup>
Usage Example
Registering Services
The services can be registered using any of the following methods:
public static IHostBuilder UseApplicationMetadata(this IHostBuilder builder, string sectionName = DefaultSectionName)
public static IServiceCollection AddApplicationMetadata(this IServiceCollection services, Action<ApplicationMetadata> configure)
Configuration
When loading from configuration, the version and deployment ring metadata are read from the ambientmetadata:application
section. The environment and application names are read from the IHostEnvironment
.
{
"AmbientMetadata" {
"Application" {
"BuildVersion": "1.0-alpha1.2346",
"DeploymentRing": "InnerRing"
}
}
}
Consuming Services
The ApplicationMetadata
can be injected wherever needed. For example:
public class MyClass
{
public MyClass(IOptions<ApplicationMetadata> options) { Application = options.Value; }
private ApplicationMetadata Application { get; }
public void DoWork()
{
Log.LogEnvironment(Application.Version, Application.DeploymentRing, Application.Environment, Application.Name);
}
}
Feedback & Contributing
We welcome feedback and contributions in our GitHub repo.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. 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. net9.0 is compatible. |
.NET Framework | net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
-
.NETFramework 4.6.2
- Microsoft.Extensions.Configuration (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.0-preview.3.24172.9)
-
net8.0
- Microsoft.Extensions.Configuration (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.0-preview.3.24172.9)
-
net9.0
- Microsoft.Extensions.Configuration (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0-preview.3.24172.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.0-preview.3.24172.9)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Microsoft.Extensions.AmbientMetadata.Application:
Package | Downloads |
---|---|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions. |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Microsoft.Extensions.AmbientMetadata.Application:
Repository | Stars |
---|---|
bradygaster/dotnet-cloud-native-build-2023
|
Version | Downloads | Last updated |
---|---|---|
9.0.0 | 28,249 | 11/12/2024 |
9.0.0-preview.9.24507.7 | 20,854 | 10/8/2024 |
9.0.0-preview.8.24460.1 | 16,597 | 9/10/2024 |
9.0.0-preview.7.24412.10 | 5,649 | 8/14/2024 |
9.0.0-preview.6.24353.1 | 4,926 | 7/10/2024 |
9.0.0-preview.5.24311.7 | 5,082 | 6/11/2024 |
9.0.0-preview.4.24271.2 | 6,196 | 5/21/2024 |
9.0.0-preview.3.24209.3 | 7,655 | 4/11/2024 |
9.0.0-preview.2.24157.4 | 3,473 | 3/12/2024 |
9.0.0-preview.1.24108.1 | 2,035 | 2/13/2024 |
8.10.0 | 593,815 | 10/8/2024 |
8.9.1 | 659,240 | 9/6/2024 |
8.9.0 | 41,916 | 9/5/2024 |
8.8.0 | 593,395 | 8/13/2024 |
8.7.0 | 894,019 | 7/10/2024 |
8.6.0 | 651,200 | 6/11/2024 |
8.5.0 | 775,225 | 5/14/2024 |
8.4.0 | 1,164,469 | 4/9/2024 |
8.3.0 | 509,584 | 3/12/2024 |
8.2.0 | 855,989 | 2/13/2024 |
8.1.0 | 381,034 | 1/9/2024 |
8.0.0 | 893,490 | 11/14/2023 |
8.0.0-rc.2.23510.2 | 5,106 | 10/10/2023 |
8.0.0-rc.1.23453.1 | 1,776 | 9/12/2023 |
8.0.0-preview.7.23407.5 | 1,335 | 8/8/2023 |
8.0.0-preview.6.23360.2 | 739 | 7/12/2023 |
8.0.0-preview.5.23308.3 | 2,831 | 6/14/2023 |
8.0.0-preview.4.23273.7 | 2,674 | 5/23/2023 |