Microsoft.Extensions.Logging.Abstractions
10.0.0-preview.1.25080.5
Prefix Reserved
dotnet add package Microsoft.Extensions.Logging.Abstractions --version 10.0.0-preview.1.25080.5
NuGet\Install-Package Microsoft.Extensions.Logging.Abstractions -Version 10.0.0-preview.1.25080.5
<PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.0-preview.1.25080.5" />
paket add Microsoft.Extensions.Logging.Abstractions --version 10.0.0-preview.1.25080.5
#r "nuget: Microsoft.Extensions.Logging.Abstractions, 10.0.0-preview.1.25080.5"
// Install Microsoft.Extensions.Logging.Abstractions as a Cake Addin #addin nuget:?package=Microsoft.Extensions.Logging.Abstractions&version=10.0.0-preview.1.25080.5&prerelease // Install Microsoft.Extensions.Logging.Abstractions as a Cake Tool #tool nuget:?package=Microsoft.Extensions.Logging.Abstractions&version=10.0.0-preview.1.25080.5&prerelease
About
Microsoft.Extensions.Logging.Abstractions
provides abstractions of logging. Interfaces defined in this package are implemented by classes in Microsoft.Extensions.Logging and other logging packages.
This package includes a logging source generator that produces highly efficient and optimized code for logging message methods.
Key Features
- Define main logging abstraction interfaces like ILogger, ILoggerFactory, ILoggerProvider, etc.
How to Use
Custom logger provider implementation example
using Microsoft.Extensions.Logging;
public sealed class ColorConsoleLogger : ILogger
{
private readonly string _name;
private readonly Func<ColorConsoleLoggerConfiguration> _getCurrentConfig;
public ColorConsoleLogger(
string name,
Func<ColorConsoleLoggerConfiguration> getCurrentConfig) =>
(_name, _getCurrentConfig) = (name, getCurrentConfig);
public IDisposable? BeginScope<TState>(TState state) where TState : notnull => default!;
public bool IsEnabled(LogLevel logLevel) =>
_getCurrentConfig().LogLevelToColorMap.ContainsKey(logLevel);
public void Log<TState>(
LogLevel logLevel,
EventId eventId,
TState state,
Exception? exception,
Func<TState, Exception?, string> formatter)
{
if (!IsEnabled(logLevel))
{
return;
}
ColorConsoleLoggerConfiguration config = _getCurrentConfig();
if (config.EventId == 0 || config.EventId == eventId.Id)
{
ConsoleColor originalColor = Console.ForegroundColor;
Console.ForegroundColor = config.LogLevelToColorMap[logLevel];
Console.WriteLine($"[{eventId.Id,2}: {logLevel,-12}]");
Console.ForegroundColor = originalColor;
Console.Write($" {_name} - ");
Console.ForegroundColor = config.LogLevelToColorMap[logLevel];
Console.Write($"{formatter(state, exception)}");
Console.ForegroundColor = originalColor;
Console.WriteLine();
}
}
}
Create logs
// Worker class that uses logger implementation of teh interface ILogger<T>
public sealed class Worker : BackgroundService
{
private readonly ILogger<Worker> _logger;
public Worker(ILogger<Worker> logger) =>
_logger = logger;
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
while (!stoppingToken.IsCancellationRequested)
{
_logger.LogInformation("Worker running at: {time}", DateTimeOffset.UtcNow);
await Task.Delay(1_000, stoppingToken);
}
}
}
Use source generator
public static partial class Log
{
[LoggerMessage(
EventId = 0,
Level = LogLevel.Critical,
Message = "Could not open socket to `{hostName}`")]
public static partial void CouldNotOpenSocket(this ILogger logger, string hostName);
}
public partial class InstanceLoggingExample
{
private readonly ILogger _logger;
public InstanceLoggingExample(ILogger logger)
{
_logger = logger;
}
[LoggerMessage(
EventId = 0,
Level = LogLevel.Critical,
Message = "Could not open socket to `{hostName}`")]
public partial void CouldNotOpenSocket(string hostName);
}
Main Types
The main types provided by this library are:
Microsoft.Extensions.Logging.ILogger
Microsoft.Extensions.Logging.ILoggerProvider
Microsoft.Extensions.Logging.ILoggerFactory
Microsoft.Extensions.Logging.ILogger<TCategoryName>
Microsoft.Extensions.Logging.LogLevel
Microsoft.Extensions.Logging.Logger<T>
Microsoft.Extensions.Logging.LoggerMessage
Microsoft.Extensions.Logging.Abstractions.NullLogger
Additional Documentation
Related Packages
Microsoft.Extensions.Logging Microsoft.Extensions.Logging.Console Microsoft.Extensions.Logging.Debug Microsoft.Extensions.Logging.EventSource Microsoft.Extensions.Logging.EventLog Microsoft.Extensions.Logging.TraceSource
Feedback & Contributing
Microsoft.Extensions.Logging.Abstractions is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. 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. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0-preview.1.25080.5)
- System.Buffers (>= 4.6.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.0-preview.1.25080.5)
- System.Memory (>= 4.6.0)
-
.NETStandard 2.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0-preview.1.25080.5)
- System.Buffers (>= 4.6.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.0-preview.1.25080.5)
- System.Memory (>= 4.6.0)
-
net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0-preview.1.25080.5)
-
net8.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0-preview.1.25080.5)
- System.Diagnostics.DiagnosticSource (>= 10.0.0-preview.1.25080.5)
-
net9.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0-preview.1.25080.5)
- System.Diagnostics.DiagnosticSource (>= 10.0.0-preview.1.25080.5)
NuGet packages (9.7K)
Showing the top 5 NuGet packages that depend on Microsoft.Extensions.Logging.Abstractions:
Package | Downloads |
---|---|
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging. |
|
Microsoft.Extensions.Hosting.Abstractions
Hosting and startup abstractions for applications. |
|
Microsoft.IdentityModel.Tokens
Includes types that provide support for SecurityTokens, Cryptographic operations: Signing, Verifying Signatures, Encryption. |
|
Microsoft.Extensions.Caching.Memory
In-memory cache implementation of Microsoft.Extensions.Caching.Memory.IMemoryCache. |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging. |
GitHub repositories (673)
Showing the top 5 popular GitHub repositories that depend on Microsoft.Extensions.Logging.Abstractions:
Repository | Stars |
---|---|
microsoft/PowerToys
Windows system utilities to maximize productivity
|
|
jellyfin/jellyfin
The Free Software Media System - Server Backend & API
|
|
DevToys-app/DevToys
A Swiss Army knife for developers.
|
|
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
|
|
dotnet/maui
.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
|
Version | Downloads | Last updated | |
---|---|---|---|
10.0.0-preview.1.25080.5 | 479 | 2/25/2025 | |
9.0.2 | 1,526,952 | 2/11/2025 | |
9.0.1 | 4,985,115 | 1/14/2025 | |
9.0.0 | 20,521,360 | 11/12/2024 | |
9.0.0-rc.2.24473.5 | 644,274 | 10/8/2024 | |
9.0.0-rc.1.24431.7 | 380,870 | 9/10/2024 | |
9.0.0-preview.7.24405.7 | 292,936 | 8/13/2024 | |
9.0.0-preview.6.24327.7 | 260,484 | 7/9/2024 | |
9.0.0-preview.5.24306.7 | 184,369 | 6/11/2024 | |
9.0.0-preview.4.24266.19 | 145,655 | 5/21/2024 | |
9.0.0-preview.3.24172.9 | 313,035 | 4/11/2024 | |
9.0.0-preview.2.24128.5 | 186,992 | 3/12/2024 | |
9.0.0-preview.1.24080.9 | 206,335 | 2/13/2024 | |
8.0.3 | 387,671 | 2/11/2025 | |
8.0.2 | 53,347,034 | 10/8/2024 | |
8.0.1 | 83,116,148 | 3/12/2024 | |
8.0.0 | 244,419,038 | 11/14/2023 | |
8.0.0-rc.2.23479.6 | 2,089,420 | 10/10/2023 | |
8.0.0-rc.1.23419.4 | 1,305,302 | 9/12/2023 | |
8.0.0-preview.7.23375.6 | 688,897 | 8/8/2023 | |
8.0.0-preview.6.23329.7 | 450,178 | 7/11/2023 | |
8.0.0-preview.5.23280.8 | 303,395 | 6/13/2023 | |
8.0.0-preview.4.23259.5 | 535,465 | 5/16/2023 | |
8.0.0-preview.3.23174.8 | 442,524 | 4/11/2023 | |
8.0.0-preview.2.23128.3 | 337,294 | 3/14/2023 | |
8.0.0-preview.1.23110.8 | 326,708 | 2/21/2023 | |
7.0.1 | 84,416,454 | 6/13/2023 | |
7.0.0 | 270,405,905 | 11/7/2022 | |
7.0.0-rc.2.22472.3 | 1,664,785 | 10/11/2022 | |
7.0.0-rc.1.22426.10 | 445,255 | 9/14/2022 | |
7.0.0-preview.7.22375.6 | 440,084 | 8/9/2022 | |
7.0.0-preview.6.22324.4 | 278,408 | 7/12/2022 | |
7.0.0-preview.5.22301.12 | 180,218 | 6/14/2022 | |
7.0.0-preview.4.22229.4 | 512,585 | 5/10/2022 | |
7.0.0-preview.3.22175.4 | 196,348 | 4/13/2022 | |
7.0.0-preview.2.22152.2 | 247,864 | 3/14/2022 | |
7.0.0-preview.1.22076.8 | 191,774 | 2/17/2022 | |
6.0.4 | 50,975,689 | 6/13/2023 | |
6.0.3 | 52,993,533 | 11/7/2022 | |
6.0.2 | 48,390,338 | 9/13/2022 | |
6.0.1 | 167,516,712 | 3/8/2022 | |
6.0.0 | 613,084,928 | 11/8/2021 | |
6.0.0-rc.2.21480.5 | 1,890,114 | 10/12/2021 | |
6.0.0-rc.1.21451.13 | 631,024 | 9/14/2021 | |
6.0.0-preview.7.21377.19 | 832,269 | 8/10/2021 | |
6.0.0-preview.6.21352.12 | 348,470 | 7/14/2021 | |
6.0.0-preview.5.21301.5 | 284,199 | 6/15/2021 | |
6.0.0-preview.4.21253.7 | 185,831 | 5/24/2021 | |
6.0.0-preview.3.21201.4 | 601,095 | 4/8/2021 | |
6.0.0-preview.2.21154.6 | 230,463 | 3/11/2021 | |
6.0.0-preview.1.21102.12 | 543,410 | 2/12/2021 | |
5.0.0 | 526,718,145 | 11/9/2020 | |
5.0.0-rc.2.20475.5 | 1,100,193 | 10/13/2020 | |
5.0.0-rc.1.20451.14 | 616,069 | 9/14/2020 | |
5.0.0-preview.8.20407.11 | 517,334 | 8/25/2020 | |
5.0.0-preview.7.20364.11 | 245,055 | 7/21/2020 | |
5.0.0-preview.6.20305.6 | 145,021 | 6/25/2020 | |
5.0.0-preview.5.20278.1 | 66,644 | 6/10/2020 | |
5.0.0-preview.4.20251.6 | 309,146 | 5/18/2020 | |
5.0.0-preview.3.20215.2 | 236,808 | 4/23/2020 | |
5.0.0-preview.2.20160.3 | 317,843 | 4/2/2020 | |
5.0.0-preview.1.20120.4 | 167,705 | 3/16/2020 | |
3.1.32 | 25,198,723 | 12/13/2022 | |
3.1.31 | 3,892,493 | 11/8/2022 | |
3.1.30 | 2,640,294 | 10/11/2022 | |
3.1.29 | 2,822,963 | 9/13/2022 | |
3.1.28 | 6,555,425 | 8/9/2022 | |
3.1.27 | 2,462,989 | 7/12/2022 | |
3.1.26 | 4,223,250 | 6/14/2022 | |
3.1.25 | 3,357,504 | 5/10/2022 | |
3.1.24 | 3,995,685 | 4/11/2022 | |
3.1.23 | 4,840,259 | 3/8/2022 | |
3.1.22 | 19,693,506 | 12/14/2021 | |
3.1.21 | 10,340,431 | 11/7/2021 | |
3.1.20 | 5,552,461 | 10/11/2021 | |
3.1.19 | 5,615,652 | 9/14/2021 | |
3.1.18 | 63,879,418 | 8/10/2021 | |
3.1.17 | 7,541,043 | 7/13/2021 | |
3.1.16 | 17,161,281 | 6/8/2021 | |
3.1.15 | 8,592,030 | 5/11/2021 | |
3.1.14 | 14,789,400 | 4/6/2021 | |
3.1.13 | 14,223,427 | 3/9/2021 | |
3.1.12 | 12,718,147 | 2/9/2021 | |
3.1.11 | 20,568,983 | 1/12/2021 | |
3.1.10 | 28,495,156 | 11/9/2020 | |
3.1.9 | 81,871,956 | 10/13/2020 | |
3.1.8 | 254,226,922 | 9/8/2020 | |
3.1.7 | 43,740,182 | 8/11/2020 | |
3.1.6 | 47,862,654 | 7/14/2020 | |
3.1.5 | 48,890,883 | 6/9/2020 | |
3.1.4 | 56,246,998 | 5/12/2020 | |
3.1.3 | 120,786,849 | 3/24/2020 | |
3.1.2 | 82,174,677 | 2/18/2020 | |
3.1.1 | 45,490,463 | 1/14/2020 | |
3.1.0 | 191,417,604 | 12/3/2019 | |
3.1.0-preview3.19553.2 | 2,080,904 | 11/13/2019 | |
3.1.0-preview2.19525.4 | 108,343 | 11/1/2019 | |
3.1.0-preview1.19506.1 | 1,290,313 | 10/15/2019 | |
3.0.3 | 179,357,564 | 2/18/2020 | |
3.0.2 | 1,155,889 | 1/14/2020 | |
3.0.1 | 7,737,758 | 11/18/2019 | |
3.0.0 | 142,310,753 | 9/23/2019 | |
3.0.0-rc1.19456.10 | 174,206 | 9/16/2019 | |
3.0.0-preview9.19423.4 | 1,684,982 | 9/4/2019 | |
3.0.0-preview8.19405.4 | 614,847 | 8/13/2019 | |
3.0.0-preview7.19362.4 | 207,109 | 7/23/2019 | |
3.0.0-preview6.19304.6 | 478,839 | 6/12/2019 | |
3.0.0-preview5.19227.9 | 784,684 | 5/6/2019 | |
3.0.0-preview4.19216.2 | 54,038 | 4/18/2019 | |
3.0.0-preview3.19153.1 | 396,604 | 3/6/2019 | |
3.0.0-preview.19074.2 | 179,111 | 1/29/2019 | |
3.0.0-preview.18572.1 | 165,166 | 12/4/2018 | |
2.2.0 | 585,905,391 | 12/3/2018 | |
2.2.0-preview3-35497 | 563,808 | 10/17/2018 | |
2.2.0-preview2-35157 | 569,413 | 9/12/2018 | |
2.2.0-preview1-35029 | 254,042 | 8/22/2018 | |
2.1.1 | 503,551,916 | 6/18/2018 | |
2.1.0 | 515,255,364 | 5/29/2018 | |
2.1.0-rc1-final | 662,650 | 5/6/2018 | |
2.1.0-preview2-final | 839,337 | 4/10/2018 | |
2.1.0-preview1-final | 858,565 | 2/26/2018 | |
2.0.2 | 39,230,464 | 5/7/2018 | |
2.0.1 | 52,530,631 | 3/13/2018 | |
2.0.0 | 464,332,959 | 8/11/2017 | |
2.0.0-preview2-final | 440,618 | 6/28/2017 | |
2.0.0-preview1-final | 1,166,455 | 5/10/2017 | |
1.1.2 | 30,132,585 | 5/9/2017 | |
1.1.1 | 46,509,659 | 3/6/2017 | |
1.1.0 | 21,843,423 | 11/16/2016 | |
1.1.0-preview1-final | 208,002 | 10/24/2016 | |
1.0.2 | 126,941,388 | 3/6/2017 | |
1.0.1 | 4,907,345 | 12/12/2016 | |
1.0.0 | 57,202,420 | 6/27/2016 | |
1.0.0-rc2-final | 2,209,668 | 5/16/2016 | |
1.0.0-rc1-final | 895,885 | 11/18/2015 |