Frontmatec.Extensions.Logging.File 2.0.0

Frontmatec.Logging

Custom logging extensions for .NET applications.

Frontmatec.Extensions.Logging.Console

Simple console logger with clean output formatting.

Installation

dotnet add package Frontmatec.Extensions.Logging.Console

Usage

builder.Logging.AddFrontmatecConsole();

Frontmatec.Extensions.Logging.File

File-based logger with rolling file support and customizable file naming.

Installation

dotnet add package Frontmatec.Extensions.Logging.File

Usage

builder.Logging.AddFrontmatecFile();

Or with options:

builder.Logging.AddFrontmatecFile(options =>
{
    options.FileName = "logs/app.log";
    options.FileSizeLimit = "10MB";
    options.RollOnFileSizeLimit = true;
    options.RetainedFileCountLimit = 5;
});

Configuration

{
  "Logging": {
    "LogLevel": {
      "Default": "Information"
    },
    "File": {
      "FileName": "logs/app.log",
      "FileSizeLimit": "10MB",
      "RollOnFileSizeLimit": true,
      "RetainedFileCountLimit": 5
    }
  }
}

Advanced Configuration

{
  "Logging": {
    "File": {
      "FileName": "logs/app-%APP_INSTANCE_ID%.log",
      "FileSizeLimit": "10MB",
      "RollOnFileSizeLimit": true,
      "RetainedFileCountLimit": 5,
      "AuditLog": true
    }
  }
}

FileName

Log file path. Defaults to {EntryAssemblyName}.log in the application directory.

• Non-rooted paths are resolved relative to AppContext.BaseDirectory
• Supports environment variables using standard Windows/Linux syntax (e.g., %AppData%\logs\app.log):
  • %APP_INSTANCE_ID% - Unique 12-character hash generated from the application location and command-line arguments
  • %APP_PID% - Current process ID
  • %DOTNET_ENVIRONMENT% - Runtime environment name (Development, Staging, Production, etc.). Defaults to "Production" if not set

FileSizeLimit

Maximum file size before rolling. Default: "1MB"

Supported formats: "10KB", "5MB", "1GB", or plain numbers (treated as MB)

RollOnFileSizeLimit

Enable automatic file rolling when size limit is reached. Default: true

When enabled, the current log file is renamed with a numeric suffix and a new file is created.

RetainedFileCountLimit

Number of rolled log files to retain. Default: 1

Rolled files are named with incremental suffixes (e.g., app-1.log, app-2.log, app-3.log)

AuditLog

Enable appending a hash (###signatureBase64) to each logentry to make log entries tamper resistant.