Microsoft.Extensions.Logging.Abstractions 10.0.0-preview.2.25163.2

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

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.

Showing the top 20 packages that depend on Microsoft.Extensions.Logging.Abstractions.

Packages Downloads
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components. This package was built from the source code at https://github.com/aspnet/HttpAbstractions/tree/91db78cf926939821bc96e8e60616cf5dde0b489
140
Microsoft.AspNetCore.Mvc.Core
ASP.NET Core MVC core components. Contains common action result types, attribute routing, application model conventions, API explorer, application parts, filters, formatters, model binding, and more. Commonly used types: Microsoft.AspNetCore.Mvc.AreaAttribute Microsoft.AspNetCore.Mvc.BindAttribute Microsoft.AspNetCore.Mvc.ControllerBase Microsoft.AspNetCore.Mvc.FromBodyAttribute Microsoft.AspNetCore.Mvc.FromFormAttribute Microsoft.AspNetCore.Mvc.RequireHttpsAttribute Microsoft.AspNetCore.Mvc.RouteAttribute This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/33c2d01092d9a1b7a583fe99a50b15686e2b7de9
113
Microsoft.AspNetCore.Hosting.Abstractions
ASP.NET Core hosting and startup abstractions for web applications.
110
Microsoft.AspNetCore.Mvc.Core
ASP.NET Core MVC core components. Contains common action result types, attribute routing, application model conventions, API explorer, application parts, filters, formatters, model binding, and more. Commonly used types: Microsoft.AspNetCore.Mvc.AreaAttribute Microsoft.AspNetCore.Mvc.BindAttribute Microsoft.AspNetCore.Mvc.ControllerBase Microsoft.AspNetCore.Mvc.FromBodyAttribute Microsoft.AspNetCore.Mvc.FromFormAttribute Microsoft.AspNetCore.Mvc.RequireHttpsAttribute Microsoft.AspNetCore.Mvc.RouteAttribute
109
Microsoft.AspNetCore.Localization
ASP.NET Core middleware for automatically applying culture information to HTTP requests. Culture information can be specified in the HTTP header, query string, cookie, or custom source. This package was built from the source code at https://github.com/aspnet/Localization/tree/de1579bdda645ba8631403af8720929b76939853
101
Microsoft.AspNetCore.Server.Kestrel
ASP.NET Core Kestrel cross-platform web server.
101
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components.
101
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components.
100
Microsoft.AspNetCore.Cors
CORS middleware and policy for ASP.NET Core to enable cross-origin resource sharing. Commonly used types: Microsoft.AspNetCore.Cors.DisableCorsAttribute Microsoft.AspNetCore.Cors.EnableCorsAttribute This package was built from the source code at https://github.com/aspnet/CORS/tree/f05b0e792d2361be214947798857ef3eac77825d
99
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components. This package was built from the source at: https://github.com/aspnet/HttpAbstractions/tree/14076d94c38960787772ea7999c7aa159afbba2b
98
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components.
97
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components.
95
Microsoft.AspNetCore.Mvc.Core
ASP.NET Core MVC core components. Contains common action result types, attribute routing, application model conventions, API explorer, application parts, filters, formatters, model binding, and more. Commonly used types: Microsoft.AspNetCore.Mvc.AreaAttribute Microsoft.AspNetCore.Mvc.BindAttribute Microsoft.AspNetCore.Mvc.ControllerBase Microsoft.AspNetCore.Mvc.FromBodyAttribute Microsoft.AspNetCore.Mvc.FromFormAttribute Microsoft.AspNetCore.Mvc.RequireHttpsAttribute Microsoft.AspNetCore.Mvc.RouteAttribute
95
Microsoft.AspNetCore.Hosting.Abstractions
ASP.NET Core hosting and startup abstractions for web applications.
95
Microsoft.AspNetCore.Routing
ASP.NET Core middleware for routing requests to application logic and for generating links. Commonly used types: Microsoft.AspNetCore.Routing.Route Microsoft.AspNetCore.Routing.RouteCollection
94
Microsoft.AspNetCore.Routing
ASP.NET Core middleware for routing requests to application logic and for generating links. Commonly used types: Microsoft.AspNetCore.Routing.Route Microsoft.AspNetCore.Routing.RouteCollection
91
Microsoft.AspNetCore.Authentication.Abstractions
ASP.NET Core common types used by the various authentication components.
90
Microsoft.AspNetCore.Mvc.Core
ASP.NET Core MVC core components. Contains common action result types, attribute routing, application model conventions, API explorer, application parts, filters, formatters, model binding, and more. Commonly used types: Microsoft.AspNetCore.Mvc.AreaAttribute Microsoft.AspNetCore.Mvc.BindAttribute Microsoft.AspNetCore.Mvc.ControllerBase Microsoft.AspNetCore.Mvc.FromBodyAttribute Microsoft.AspNetCore.Mvc.FromFormAttribute Microsoft.AspNetCore.Mvc.RequireHttpsAttribute Microsoft.AspNetCore.Mvc.RouteAttribute
89

.NET Framework 4.6.2

.NET 8.0

.NET 9.0

.NET 10.0

.NET Standard 2.0

Version Downloads Last updated
10.0.0-preview.3.25171.5 11 4/12/2025
10.0.0-preview.2.25163.2 14 3/18/2025
10.0.0-preview.1.25080.5 26 2/26/2025
9.0.4 11 4/9/2025
9.0.3 13 3/13/2025
9.0.2 20 2/14/2025
9.0.1 32 1/18/2025
9.0.0 30 11/13/2024
9.0.0-rc.2.24473.5 22 10/10/2024
9.0.0-rc.1.24431.7 26 9/12/2024
9.0.0-preview.7.24405.7 34 8/13/2024
9.0.0-preview.6.24327.7 39 7/10/2024
9.0.0-preview.5.24306.7 32 6/15/2024
9.0.0-preview.4.24266.19 31 5/27/2024
9.0.0-preview.3.24172.9 33 4/17/2024
9.0.0-preview.2.24128.5 33 3/26/2024
9.0.0-preview.1.24080.9 41 2/18/2024
8.0.3 25 2/14/2025
8.0.2 21 10/15/2024
8.0.1 37 3/28/2024
8.0.0 42 11/16/2023
8.0.0-rc.2.23479.6 40 10/13/2023
8.0.0-rc.1.23419.4 47 9/15/2023
8.0.0-preview.7.23375.6 52 8/22/2023
8.0.0-preview.6.23329.7 59 8/2/2023
8.0.0-preview.5.23280.8 58 7/18/2023
8.0.0-preview.4.23259.5 61 5/20/2023
8.0.0-preview.3.23174.8 48 5/14/2023
8.0.0-preview.2.23128.3 50 5/17/2023
8.0.0-preview.1.23110.8 57 2/23/2023
7.0.1 46 8/3/2023
7.0.0 52 12/5/2022
7.0.0-rc.2.22472.3 51 12/5/2022
7.0.0-rc.1.22426.10 60 9/16/2022
7.0.0-preview.7.22375.6 62 9/17/2022
7.0.0-preview.6.22324.4 48 9/17/2022
7.0.0-preview.5.22301.12 71 6/29/2022
7.0.0-preview.4.22229.4 63 6/29/2022
7.0.0-preview.3.22175.4 62 6/29/2022
7.0.0-preview.2.22152.2 61 6/29/2022
7.0.0-preview.1.22076.8 56 6/29/2022
6.0.4 68 8/3/2023
6.0.3 46 12/5/2022
6.0.2 53 9/17/2022
6.0.2-mauipre.1.22102.15 80 6/29/2022
6.0.2-mauipre.1.22054.8 63 6/29/2022
6.0.1 51 6/29/2022
6.0.0 56 6/29/2022
6.0.0-rc.2.21480.5 57 6/29/2022
6.0.0-rc.1.21451.13 66 6/29/2022
6.0.0-preview.7.21377.19 61 6/29/2022
6.0.0-preview.6.21352.12 59 6/29/2022
6.0.0-preview.5.21301.5 51 6/29/2022
6.0.0-preview.4.21253.7 62 6/29/2022
6.0.0-preview.3.21201.4 67 6/29/2022
6.0.0-preview.2.21154.6 60 6/29/2022
6.0.0-preview.1.21102.12 62 6/29/2022
5.0.0 62 6/29/2022
5.0.0-rc.2.20475.5 69 6/29/2022
5.0.0-rc.1.20451.14 47 6/29/2022
5.0.0-preview.8.20407.11 55 6/29/2022
5.0.0-preview.7.20364.11 64 6/29/2022
5.0.0-preview.6.20305.6 66 6/29/2022
5.0.0-preview.5.20278.1 64 6/29/2022
5.0.0-preview.4.20251.6 65 6/29/2022
5.0.0-preview.3.20215.2 59 6/29/2022
5.0.0-preview.2.20160.3 60 6/29/2022
5.0.0-preview.1.20120.4 58 6/29/2022
3.1.32 50 1/24/2023
3.1.31 49 12/5/2022
3.1.30 61 12/5/2022
3.1.29 57 9/17/2022
3.1.28 54 9/17/2022
3.1.27 50 9/17/2022
3.1.26 51 6/29/2022
3.1.25 42 6/29/2022
3.1.24 54 6/29/2022
3.1.23 58 6/29/2022
3.1.22 52 6/29/2022
3.1.21 50 6/29/2022
3.1.20 74 6/29/2022
3.1.19 52 6/29/2022
3.1.18 43 6/29/2022
3.1.17 51 6/29/2022
3.1.16 50 6/29/2022
3.1.15 59 6/29/2022
3.1.14 50 6/29/2022
3.1.13 65 6/29/2022
3.1.12 58 6/29/2022
3.1.11 71 6/29/2022
3.1.10 52 6/29/2022
3.1.9 54 6/29/2022
3.1.8 56 6/29/2022
3.1.7 46 6/29/2022
3.1.6 60 6/29/2022
3.1.5 55 6/29/2022
3.1.4 54 6/29/2022
3.1.3 53 6/29/2022
3.1.2 48 6/29/2022
3.1.1 69 6/29/2022
3.1.0 59 6/29/2022
3.1.0-preview3.19553.2 57 6/29/2022
3.1.0-preview2.19525.4 50 6/29/2022
3.1.0-preview1.19506.1 55 6/29/2022
3.0.3 60 6/29/2022
3.0.2 60 6/29/2022
3.0.1 64 6/29/2022
3.0.0 57 6/29/2022
3.0.0-rc1.19456.10 70 6/29/2022
3.0.0-preview9.19423.4 60 6/29/2022
3.0.0-preview8.19405.4 61 6/29/2022
3.0.0-preview7.19362.4 62 6/29/2022
3.0.0-preview6.19304.6 60 6/29/2022
3.0.0-preview5.19227.9 48 6/29/2022
3.0.0-preview4.19216.2 72 6/29/2022
3.0.0-preview3.19153.1 51 6/29/2022
3.0.0-preview.19074.2 67 6/29/2022
3.0.0-preview.18572.1 65 6/29/2022
2.2.0 50 6/29/2022
2.2.0-preview3-35497 69 6/29/2022
2.2.0-preview2-35157 69 6/29/2022
2.2.0-preview1-35029 57 6/29/2022
2.1.1 56 6/29/2022
2.1.0 49 6/29/2022
2.1.0-rc1-final 65 6/29/2022
2.1.0-preview2-final 67 6/29/2022
2.1.0-preview1-final 61 6/29/2022
2.0.2 51 6/29/2022
2.0.1 45 6/29/2022
2.0.0 55 6/29/2022
2.0.0-preview2-final 71 6/29/2022
2.0.0-preview1-final 55 6/29/2022
1.1.2 52 6/29/2022
1.1.1 48 6/29/2022
1.1.0 77 6/29/2022
1.1.0-preview1-final 64 6/29/2022
1.0.2 43 6/29/2022
1.0.1 52 6/29/2022
1.0.0 50 6/29/2022
1.0.0-rc2-final 66 6/29/2022
1.0.0-rc1-final 66 6/29/2022