com.parallon.outpatient.serilog.sdk 1.0.9

LoggingConfigurator for ASP.NET Core (.NET 8, C# 12)

Overview

LoggingConfigurator is a singleton utility designed to configure Serilog logging in ASP.NET Core applications. It centralizes logging setup, enables dynamic log level changes at runtime, and integrates with the .NET dependency injection system.

Features

• Singleton pattern ensures consistent logging configuration
• Dynamic log level control using LoggingLevelSwitch
• Reads configuration from appsettings.json, environment-specific files, and environment variables
• Replaces default logging providers with Serilog
• Registers LoggingLevelSwitch for dependency injection

Usage

1. Add NuGet Packages

   • Serilog.AspNetCore
   • Serilog.Settings.Configuration
   • Serilog.Sinks.Console (or any other sinks you require)

2. Configure in Program.cs

   Use LoggingConfigurator to set up Serilog as your logging provider.

3. Dynamic Log Level Control

   Inject LoggingLevelSwitch where needed to change log levels at runtime.

4. Configuration

   Add Serilog settings to your appsettings.json.

Configuration Example

Add the following Serilog section to your appsettings.json:

{
 "Serilog": {
 "Using": [ "Serilog.Sinks.GoogleCloudLogging" ],
 "Enrich": [
 "FromLogContext",
 "WithMachineName",
 "WithEnvironmentName",
 "WithEnvironmentUserName",
 "WithThreadId",
 "WithThreadName",
 "WithProcessId",
 "WithProcessName"
 ],
 "MinimumLevel": {
 "Default": "Information",
 "Override": {
 "Microsoft": "Warning",
 "Microsoft.AspNetCore": "Warning",
 "System": "Warning"
 }
 },
 "WriteTo": [
 {
 "Name": "GoogleCloudLogging",
 "Args": {
 "projectId": "${SERILOG__WRITETO__0__ARGS__PROJECTID}", // Uses environment variable substitution for configuration
 "logName": "${SERILOG__WRITETO__0__ARGS__LOGNAME}",
 "outputTemplate": "${SERILOG__WRITETO__0__ARGS__OUTPUTTEMPLATE}",
 "useSourceContextAsLogName": false,
 "labels": {
 "environment": "${SERILOG__WRITETO__0__ARGS__LABELS__ENVIRONMENT}",
 "Label1": "${SERILOG__WRITETO__0__ARGS__LABELS__LABEL1}",
 "Label2": "${SERILOG__WRITETO__0__ARGS__LABELS__LABEL2}"
 }
 }
 }
 ]
 },
 "AllowedHosts": "*"
 // Other configuration settings...
}

This example demonstrates how to configure Serilog with Google Cloud Logging and various enrichers in your appsettings.json.

License

See the project license for details.