Serilog.Extensions 8.0.1

Serilog Extensions for WebApplicationBuilder

This NuGet package provides extension methods to easily configure Serilog in your .NET applications. It supports WebApplicationBuilder, IHostBuilder, and IServiceCollection.

Installation

Install the package from NuGet:

dotnet add package Serilog.Extensions

Usage

This package provides two main extension methods for WebApplicationBuilder:

1. UseSeriLogger()
2. UseSerilogWithJsonFileBuilder()

UseSeriLogger()

This method configures Serilog using the default appsettings.json file.

using YourNamespace;

var builder = WebApplication.CreateBuilder(args);
builder.UseSeriLogger();

UseSerilogWithJsonFileBuilder()

This method allows you to specify a separate JSON file for Serilog configuration.

using YourNamespace;

var builder = WebApplication.CreateBuilder(args);
builder.UseSerilogWithJsonFileBuilder();

To use this method, you need to add a JsonFileSettingsOptions section to your appsettings.json:

{
  "JsonFileSettingsOptions": [
    {
      "Filename": "appsettings-serilog.json",
      "Optional": false,
      "ReloadOnChange": true
    }
  ]
}

Then, create an appsettings-serilog.json file with your Serilog configuration:

{
  "Serilog": {
    "Using": [ "Serilog.Sinks.Console" ],
    "MinimumLevel": "Information",
    "WriteTo": [
      { "Name": "Console" }
    ],
    "Enrich": [ "FromLogContext", "WithMachineName", "WithThreadId" ]
  }
}

Configuration Options

The JsonFileSettingsOptions allows you to specify:

• Filename: The name of the Serilog configuration file.
• Optional: Whether the file is optional (if false, an exception will be thrown if the file is not found).
• ReloadOnChange: Whether to reload the configuration if the file changes.

License

Richard MAH