Microsoft.Extensions.AmbientMetadata.Application 10.9.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.
Showing the top 20 packages that depend on Microsoft.Extensions.AmbientMetadata.Application.
| Packages | Downloads |
|---|---|
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
116 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
119 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
122 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions
|
128 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
114 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
116 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
117 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
118 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
119 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
120 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
121 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
122 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
124 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
125 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
130 |
|
Microsoft.Extensions.Telemetry
Provides canonical implementations of telemetry abstractions.
|
137 |
.NET Framework 4.6.2
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
.NET Standard 2.0
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Configuration (>= 8.0.0)
.NET 10.0
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.11)
- Microsoft.Extensions.Configuration (>= 10.0.11)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.11)
.NET 9.0
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.19)
- Microsoft.Extensions.Configuration (>= 9.0.19)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.19)
.NET 8.0
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Configuration (>= 8.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 10.9.0 | 8 | 08/14/2026 |
| 10.8.0 | 18 | 07/20/2026 |
| 10.7.0 | 17 | 06/10/2026 |
| 10.6.0 | 19 | 05/14/2026 |
| 10.5.0 | 32 | 04/15/2026 |
| 10.4.0 | 29 | 03/12/2026 |
| 10.3.0 | 33 | 02/11/2026 |
| 10.2.0 | 31 | 01/14/2026 |
| 10.1.0 | 60 | 12/11/2025 |
| 10.0.0 | 60 | 11/12/2025 |
| 9.10.0 | 78 | 10/15/2025 |
| 9.9.0 | 88 | 09/11/2025 |
| 9.8.0 | 98 | 08/14/2025 |
| 9.7.0 | 103 | 07/10/2025 |
| 9.6.0 | 102 | 06/12/2025 |
| 9.5.0 | 102 | 05/16/2025 |
| 9.4.0 | 121 | 04/11/2025 |
| 9.3.0 | 109 | 04/01/2025 |
| 9.2.0 | 107 | 04/01/2025 |
| 9.1.0 | 109 | 04/01/2025 |
| 9.0.0 | 108 | 03/31/2025 |
| 9.0.0-preview.9.24507.7 | 106 | 04/01/2025 |
| 9.0.0-preview.8.24460.1 | 114 | 04/01/2025 |
| 9.0.0-preview.7.24412.10 | 110 | 03/31/2025 |
| 9.0.0-preview.6.24353.1 | 118 | 04/01/2025 |
| 9.0.0-preview.5.24311.7 | 105 | 03/31/2025 |
| 9.0.0-preview.4.24271.2 | 98 | 03/31/2025 |
| 9.0.0-preview.3.24209.3 | 94 | 04/01/2025 |
| 9.0.0-preview.2.24157.4 | 120 | 04/01/2025 |
| 9.0.0-preview.1.24108.1 | 107 | 04/01/2025 |
| 8.10.0 | 108 | 04/01/2025 |
| 8.9.1 | 93 | 04/01/2025 |
| 8.9.0 | 118 | 03/31/2025 |
| 8.8.0 | 110 | 04/01/2025 |
| 8.7.0 | 94 | 04/01/2025 |
| 8.6.0 | 105 | 04/01/2025 |
| 8.5.0 | 122 | 03/31/2025 |
| 8.4.0 | 123 | 03/31/2025 |
| 8.3.0 | 120 | 04/01/2025 |
| 8.2.0 | 117 | 04/01/2025 |
| 8.1.0 | 105 | 04/01/2025 |
| 8.0.0 | 110 | 03/31/2025 |
| 8.0.0-rc.2.23510.2 | 109 | 03/31/2025 |
| 8.0.0-rc.1.23453.1 | 107 | 04/01/2025 |
| 8.0.0-preview.7.23407.5 | 118 | 04/01/2025 |
| 8.0.0-preview.6.23360.2 | 116 | 04/01/2025 |
| 8.0.0-preview.5.23308.3 | 112 | 04/01/2025 |
| 8.0.0-preview.4.23273.7 | 107 | 04/01/2025 |