Microsoft.Extensions.AmbientMetadata.Application 11.0.0
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 TBuilder UseApplicationMetadata<TBuilder>(this TBuilder builder, string sectionName = DefaultSectionName) where TBuilder : IHostApplicationBuilder
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.
Supported Platforms
This package includes .NET Framework compatible targets, but is not officially supported on .NET Framework.
Showing the top 20 packages that depend on Microsoft.Extensions.AmbientMetadata.Application.
| Packages | Downloads |
|---|---|
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
55 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
53 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
48 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
48 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
46 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
45 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
44 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
43 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
42 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
42 |
.NET 10.0
- Microsoft.Extensions.Configuration (>= 10.0.15)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.15)
.NET 11.0
- Microsoft.Extensions.Configuration (>= 11.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 11.0.0)
.NET Framework 4.6.2
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
.NET 8.0
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
.NET 9.0
- Microsoft.Extensions.Configuration (>= 9.0.23)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.23)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.23)
.NET Standard 2.0
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 11.0.0 | 1 | 11/13/2026 |
| 10.11.0 | 8 | 10/18/2026 |
| 10.10.0 | 12 | 9/11/2026 |
| 10.9.0 | 21 | 8/13/2026 |
| 10.8.0 | 25 | 7/16/2026 |
| 10.7.0 | 26 | 6/10/2026 |
| 10.6.0 | 34 | 5/14/2026 |
| 10.5.0 | 35 | 5/4/2026 |
| 10.4.0 | 31 | 3/12/2026 |
| 10.3.0 | 28 | 2/12/2026 |
| 10.2.0 | 34 | 1/17/2026 |
| 10.1.0 | 40 | 12/12/2025 |
| 10.0.0 | 41 | 12/10/2025 |
| 9.10.0 | 38 | 12/12/2025 |
| 9.9.0 | 43 | 12/12/2025 |
| 9.8.0 | 38 | 12/12/2025 |
| 9.7.0 | 35 | 12/12/2025 |
| 9.6.0 | 41 | 12/12/2025 |
| 9.5.0 | 40 | 12/12/2025 |
| 9.4.0 | 42 | 12/12/2025 |
| 9.3.0 | 43 | 12/12/2025 |
| 9.2.0 | 37 | 12/12/2025 |
| 9.1.0 | 36 | 12/12/2025 |
| 9.0.0 | 37 | 12/12/2025 |
| 9.0.0-preview.9.24507.7 | 37 | 12/12/2025 |
| 9.0.0-preview.8.24460.1 | 37 | 12/12/2025 |
| 9.0.0-preview.7.24412.10 | 30 | 12/12/2025 |
| 9.0.0-preview.6.24353.1 | 39 | 12/12/2025 |
| 9.0.0-preview.5.24311.7 | 40 | 12/12/2025 |
| 9.0.0-preview.4.24271.2 | 35 | 12/12/2025 |
| 9.0.0-preview.3.24209.3 | 38 | 12/12/2025 |
| 9.0.0-preview.2.24157.4 | 38 | 12/12/2025 |
| 9.0.0-preview.1.24108.1 | 32 | 12/12/2025 |
| 8.10.0 | 33 | 12/12/2025 |
| 8.9.1 | 36 | 12/12/2025 |
| 8.9.0 | 39 | 12/12/2025 |
| 8.8.0 | 39 | 12/12/2025 |
| 8.7.0 | 42 | 12/12/2025 |
| 8.6.0 | 42 | 12/12/2025 |
| 8.5.0 | 45 | 12/12/2025 |
| 8.4.0 | 47 | 12/12/2025 |
| 8.3.0 | 37 | 12/12/2025 |
| 8.2.0 | 47 | 12/12/2025 |
| 8.1.0 | 44 | 12/12/2025 |
| 8.0.0 | 40 | 12/12/2025 |
| 8.0.0-rc.2.23510.2 | 37 | 12/12/2025 |
| 8.0.0-rc.1.23453.1 | 38 | 12/12/2025 |
| 8.0.0-preview.7.23407.5 | 35 | 12/12/2025 |
| 8.0.0-preview.6.23360.2 | 35 | 12/12/2025 |
| 8.0.0-preview.5.23308.3 | 36 | 12/12/2025 |
| 8.0.0-preview.4.23273.7 | 34 | 12/12/2025 |