Serilog.Extensions.Hosting 8.0.0

Serilog.Extensions.Hosting Build status NuGet Version

Serilog logging for Microsoft.Extensions.Hosting. This package routes framework log messages through Serilog, so you can get information about the framework's internal operations written to the same Serilog sinks as your application events.

ASP.NET Core applications should consider using Serilog.AspNetCore instead, which bundles this package and includes other ASP.NET Core-specific features.

Instructions

First, install the Serilog.Extensions.Hosting NuGet package into your app. You will need a way to view the log messages - Serilog.Sinks.Console writes these to the console; there are many more sinks available on NuGet.

dotnet add package Serilog.Extensions.Hosting
dotnet add package Serilog.Sinks.Console

Next, in your application's Program.cs file, configure Serilog first. A try/catch block will ensure any configuration issues are appropriately logged:

public class Program
{
    public static int Main(string[] args)
    {
        Log.Logger = new LoggerConfiguration()
            .MinimumLevel.Debug()
            .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
            .Enrich.FromLogContext()
            .WriteTo.Console()
            .CreateLogger();

        try
        {
            Log.Information("Starting host");
            BuildHost(args).Run();
            return 0;
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Host terminated unexpectedly");
            return 1;
        }
        finally
        {
            Log.CloseAndFlush();
        }
    }

Then, add UseSerilog() to the host builder in BuildHost().

    public static IHost BuildHost(string[] args) =>
        new HostBuilder()
            .ConfigureServices(services => services.AddSingleton<IHostedService, PrintTimeService>())
            .UseSerilog() // <- Add this line
            .Build();
}

Finally, clean up by removing the remaining "Logging" section from appsettings.json files (this can be replaced with Serilog configuration as shown in this example, if required)

That's it! You will see log output like:

[22:10:39 INF] Getting the motors running...
[22:10:39 INF] The current time is: 12/05/2018 10:10:39 +00:00

A more complete example, showing appsettings.json configuration, can be found in the sample project here.

Using the package

With Serilog.Extensions.Hosting installed and configured, you can write log messages directly through Serilog or any ILogger interface injected by .NET. All loggers will use the same underlying implementation, levels, and destinations.

Tip: change the minimum level for Microsoft to Warning

Inline initialization

You can alternatively configure Serilog using a delegate as shown below:

    // dotnet add package Serilog.Settings.Configuration
    .UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
        .ReadFrom.Configuration(hostingContext.Configuration)
        .Enrich.FromLogContext()
        .WriteTo.Console())

This has the advantage of making the hostingContext's Configuration object available for configuration of the logger, but at the expense of ignoring Exceptions raised earlier in program startup.

If this method is used, Log.Logger is assigned implicitly, and closed when the app is shut down.

Versioning

This package tracks the versioning and target framework support of its Microsoft.Extensions.Hosting dependency.

Showing the top 20 packages that depend on Serilog.Extensions.Hosting.

Packages Downloads
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 27
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 29
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 32
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 33
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 34
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 35
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 37
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 41
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 46
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 63
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 301
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 1,644
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 2,927
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 9,907
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 12,801

.NET Framework 4.6.2

.NET Standard 2.0

.NET 8.0

.NET 7.0

.NET 6.0

Version Downloads Last updated
8.0.0 9 11/16/2023
8.0.0-dev-00145 0 04/05/2024
8.0.0-dev-00143 0 03/25/2024
8.0.0-dev-00140 0 03/14/2024
8.0.0-dev-00137 5 11/16/2023
7.0.0 30 05/24/2023
7.0.0-dev-00131 13 06/25/2023
7.0.0-dev-00129 7 06/25/2023
7.0.0-dev-00126 17 05/24/2023
5.1.0-dev-00123 7 06/25/2023
5.0.1 13,467 08/12/2022
5.0.1-dev-00113 21 08/20/2022
5.0.0 24 08/20/2022
5.0.0-dev-00108 16 08/20/2022
5.0.0-dev-00095 21 06/27/2022
5.0.0-dev-00094 11 08/22/2022
5.0.0-dev-00093 19 08/29/2022
4.2.1-dev-00092 8 08/20/2022
4.2.0 191 06/27/2022
4.2.0-dev-00079 13 08/20/2022
4.1.2 9,888 06/27/2022
4.1.2-dev-00062 33 08/20/2022
4.1.1 19 08/20/2022
4.1.1-dev-00058 15 08/20/2022
4.1.0 19 08/21/2022
4.1.0-dev-00054 10 08/20/2022
4.0.0 35 08/20/2022
4.0.0-dev-00051 9 08/20/2022
4.0.0-dev-00050 12 09/07/2022
3.1.0 20 08/20/2022
3.1.0-dev-00041 23 08/20/2022
3.1.0-dev-00037 23 08/21/2022
3.1.0-dev-00035 29 08/20/2022
3.0.0 1,249 06/27/2022
3.0.0-dev-00024 24 08/20/2022
3.0.0-dev-00019 15 08/29/2022
3.0.0-dev-00016 9 09/07/2022
3.0.0-dev-00015 18 08/21/2022
2.0.1-dev-00009 19 08/20/2022
2.0.1-dev-00007 27 08/20/2022
2.0.1-dev-00004 15 08/21/2022
2.0.0 10 08/29/2022
2.0.0-dev-00001 22 08/22/2022