Invex.Extensions.Logging.File
0.2.0-rc.8
See the version list below for details.
dotnet add package Invex.Extensions.Logging.File --version 0.2.0-rc.8
NuGet\Install-Package Invex.Extensions.Logging.File -Version 0.2.0-rc.8
<PackageReference Include="Invex.Extensions.Logging.File" Version="0.2.0-rc.8" />
<PackageVersion Include="Invex.Extensions.Logging.File" Version="0.2.0-rc.8" />
<PackageReference Include="Invex.Extensions.Logging.File" />
paket add Invex.Extensions.Logging.File --version 0.2.0-rc.8
#r "nuget: Invex.Extensions.Logging.File, 0.2.0-rc.8"
#:package Invex.Extensions.Logging.File@0.2.0-rc.8
#addin nuget:?package=Invex.Extensions.Logging.File&version=0.2.0-rc.8&prerelease
#tool nuget:?package=Invex.Extensions.Logging.File&version=0.2.0-rc.8&prerelease
Invex Logging Extensions
Useful utilities for Microsoft.Extensions.Logging.
Packages
| Package | Description |
|---|---|
Invex.Extensions.Logging.File |
A simple, dependency-light file logger provider with size- and time-based rollover, disk usage caps, and per-level log file routing. |
Supported targets: net10.0, net9.0, net8.0, and netstandard2.0.
Quick start
Install the package:
dotnet add package Invex.Extensions.Logging.File
Register the provider:
using Invex.Extensions.Logging.File;
var builder = WebApplication.CreateBuilder(args);
builder.Logging.AddFile();
That's it — log entries are now written to a Logs directory next to your application, in files named after
the application, rolled over daily or at 100 MiB (whichever comes first), with total disk usage capped at 10 GiB.
Log entries look like this:
[2026-06-11 09:41:23.123 +10:00 INF MyApp.Services.OrderService] Order 42 submitted
Configuration
Configure via appsettings.json (the provider alias is File):
{
"Logging": {
"File": {
"LogDirectory": "Logs",
"LogName": "my-app",
"FileSizeLimitBytes": 104857600,
"RolloverInterval": "Day",
"MaxTotalSizeBytes": 10737418240,
"PerLevelLogName": {
"Error": "my-app-errors"
}
}
}
}
Or in code:
builder.Logging.AddFile(options =>
{
options.LogDirectory = "Logs";
options.LogName = "my-app";
options.RolloverInterval = FileRolloverInterval.Hour;
});
See the configuration guide for every option and its default.
Buffered vs. direct writing
By default, log entries are queued in memory and written to disk by a dedicated background thread, keeping file I/O off your application threads. If you need every entry persisted before the log call returns (for example, in short-lived tools where the process may exit abruptly), use direct mode:
builder.Logging.AddFile(buffered: false);
See buffered vs. direct writing for details and trade-offs.
Documentation
- Getting started
- Configuration
- File rollover and retention
- Buffered vs. direct writing
- Log output format
- API reference
License
Licensed under the terms of LICENSE.txt.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- JetBrains.Annotations (>= 2026.2.0)
- Microsoft.Bcl.TimeProvider (>= 10.0.9)
- Microsoft.Extensions.Logging.Configuration (>= 10.0.9)
- System.IO.Abstractions (>= 22.1.1)
- System.Threading.Channels (>= 10.0.9)
-
net10.0
- JetBrains.Annotations (>= 2026.2.0)
- Microsoft.Extensions.Logging.Configuration (>= 10.0.9)
- System.IO.Abstractions (>= 22.1.1)
-
net8.0
- JetBrains.Annotations (>= 2026.2.0)
- Microsoft.Extensions.Logging.Configuration (>= 10.0.9)
- System.IO.Abstractions (>= 22.1.1)
-
net9.0
- JetBrains.Annotations (>= 2026.2.0)
- Microsoft.Extensions.Logging.Configuration (>= 10.0.9)
- System.IO.Abstractions (>= 22.1.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.4.0-rc.4 | 32 | 8/14/2026 |
| 0.4.0-rc.2 | 54 | 8/7/2026 |
| 0.3.0 | 100 | 8/3/2026 |
| 0.3.0-rc.5 | 54 | 8/3/2026 |
| 0.3.0-rc.4 | 55 | 7/24/2026 |
| 0.3.0-rc.2 | 59 | 7/17/2026 |
| 0.2.0 | 106 | 7/13/2026 |
| 0.2.0-rc.33 | 50 | 7/13/2026 |
| 0.2.0-rc.30 | 80 | 7/10/2026 |
| 0.2.0-rc.28 | 62 | 7/9/2026 |
| 0.2.0-rc.24 | 59 | 7/5/2026 |
| 0.2.0-rc.20 | 59 | 6/30/2026 |
| 0.2.0-rc.18 | 69 | 6/29/2026 |
| 0.2.0-rc.16 | 63 | 6/25/2026 |
| 0.2.0-rc.14 | 70 | 6/24/2026 |
| 0.2.0-rc.10 | 66 | 6/22/2026 |
| 0.2.0-rc.8 | 67 | 6/19/2026 |
| 0.2.0-rc.6 | 74 | 6/17/2026 |
| 0.2.0-rc.4 | 75 | 6/15/2026 |
| 0.2.0-rc.2 | 64 | 6/12/2026 |