Serilog.Extensions.Hosting 9.0.0-dev-02303

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.

Versioning: This package tracks the versioning and target framework support of its Microsoft.Extensions.Hosting dependency. Most users should choose the version of Serilog.Extensions.Hosting that matches their application's target framework. I.e. if you're targeting .NET 7.x, choose a 7.x version of Serilog.Extensions.Hosting. If you're targeting .NET 8.x, choose an 8.x Serilog.Extensions.Hosting version, and so on.

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. Call AddSerilog() on the host application builder:

using Serilog;

Log.Logger = new LoggerConfiguration()
    .Enrich.FromLogContext()
    .WriteTo.Console()
    .CreateLogger();

try
{
    Log.Information("Starting host");

    var builder = Host.CreateApplicationBuilder(args);
    builder.Services.AddHostedService<PrintTimeService>();
    builder.Services.AddSerilog();

    var app = builder.Build();
    
    await app.RunAsync();
    return 0;
}
catch (Exception ex)
{
    Log.Fatal(ex, "Host terminated unexpectedly");
    return 1;
}
finally
{
    await Log.CloseAndFlushAsync();
}

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.

Inline initialization

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

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

This has the advantage of making builder'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.

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

Packages Downloads
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 46
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 47
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 50
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 51
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 54
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 58
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 70
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 72
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 98
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 313
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 1,867
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 3,184
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 11,054
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 14,206

.NET Framework 4.6.2

.NET Standard 2.1

.NET Standard 2.0

.NET 9.0

.NET 8.0

Version Downloads Last updated
9.0.0 6 12/22/2024
9.0.0-dev-02303 6 12/05/2024
9.0.0-dev-02301 3 12/06/2024
8.0.0 20 11/16/2023
8.0.0-dev-00145 10 05/22/2024
8.0.0-dev-00143 9 05/22/2024
8.0.0-dev-00140 8 05/22/2024
8.0.0-dev-00137 15 11/16/2023
7.0.0 46 05/24/2023
7.0.0-dev-00131 26 06/25/2023
7.0.0-dev-00129 19 06/25/2023
7.0.0-dev-00126 30 05/24/2023
5.1.0-dev-00123 21 06/25/2023
5.0.1 14,880 08/12/2022
5.0.1-dev-00113 40 08/20/2022
5.0.0 45 08/20/2022
5.0.0-dev-00108 30 08/20/2022
5.0.0-dev-00095 43 06/27/2022
5.0.0-dev-00094 27 08/22/2022
5.0.0-dev-00093 39 08/29/2022
4.2.1-dev-00092 21 08/20/2022
4.2.0 202 06/27/2022
4.2.0-dev-00079 31 08/20/2022
4.1.2 11,045 06/27/2022
4.1.2-dev-00062 55 08/20/2022
4.1.1 36 08/20/2022
4.1.1-dev-00058 32 08/20/2022
4.1.0 38 08/21/2022
4.1.0-dev-00054 23 08/20/2022
4.0.0 59 08/20/2022
4.0.0-dev-00051 25 08/20/2022
4.0.0-dev-00050 30 09/07/2022
3.1.0 37 08/20/2022
3.1.0-dev-00041 39 08/20/2022
3.1.0-dev-00037 40 08/21/2022
3.1.0-dev-00035 50 08/20/2022
3.0.0 1,468 06/27/2022
3.0.0-dev-00024 47 08/20/2022
3.0.0-dev-00019 30 08/29/2022
3.0.0-dev-00016 20 09/07/2022
3.0.0-dev-00015 33 08/21/2022
2.0.1-dev-00009 38 08/20/2022
2.0.1-dev-00007 44 08/20/2022
2.0.1-dev-00004 29 08/21/2022
2.0.0 23 08/29/2022
2.0.0-dev-00001 39 08/22/2022