SimpleLog4.NET 2.3.0.18

Fast Non-Blocking Zero Allocation Thread Safe Logger for .NET Standard and Greater

All formatting and logging is done in a different thread.

Creating a Simple Log

using SimpleLog4.NET;

Create a new SimpleLog with SimpleLogLevel.Information

SimpleLog Log = new SimpleLog(@"C:\test.txt", logLevel: SimpleLogLevel.Information);

Create a new SimpleLog with SimpleLogLevel.Error that also logs to Console

SimpleLog Log = new SimpleLog(@"C:\loglevelError.txt", true);

Create a new SimpleLog and change the DateFormat

SimpleLog Log = new SimpleLog(@"C:\test.txt", dateFormat: "MM/dd/yyyy HH:mm:ss:fff");

Create a new SimpleLog and change the IFormatProvider

SimpleLog Log = new SimpleLog(@"C:\test.txt", formatProvider: CultureInfo.InvariantCulture);

Write to the Log

Messages

You should always provide the unformatted message to the logging methods

Log.Information("Some Information"); 
// [05/06/24 18:19:19:170][Info] Some Information

Log.Trace();
Log.Debug();
Log.Warning();
Log.Error();
Log.Critical();
Log.Fatal();

Exceptions

Exceptions are specially formatted automatically

Log.Exception(exception); // Exception
// [05/06/24 17:00:27:383][Exception]
// System.ArgumentException | HRESULT: -2147024809
// Message: Invalid Argument
// Stack Trace: 
//    at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 72

WriteExceptionDirect can be used to log Exceptions inside Unhandled Exception Handlers

Log.WriteExceptionDirect(exception); // Skips Queue

More Output Examples

Below are more examples of what the output should look like in a text file

Normal Output

[05/06/24 18:19:19:170][Info] Updated Exchange Information for [2617] symbols
[05/06/24 18:19:19:170][Info] Loaded [11] Stored Quotes from file
[05/06/24 18:19:19:170][Info] Loaded [0] Alerts from file
[05/06/24 18:19:19:372][Info] Loaded [405] Orders from file
[05/06/24 18:19:19:950][Info] Loaded [5782] Orders from file
[05/06/24 18:19:20:090][Info] Loaded [555] Orders from file
[05/06/24 18:19:20:090][Info] Loaded [71] Orders from file
[05/06/24 18:19:20:108][Info] Loaded [16] Orders from file
[05/06/24 18:19:20:123][Info] Got new Exchange Information from Server..
[05/06/24 18:19:20:123][Info] Updated Exchange Information for [2617] symbols

Single Exception

[05/06/24 17:00:27:383][Critical] Test Critical
[05/06/24 17:00:27:383][Exception]
System.ArgumentException | HRESULT: -2147024809
Message: Invalid Argument
Stack Trace: 
   at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 72
[05/06/24 17:00:27:383][FATAL] Test Fatal

Aggregate Exception

[05/06/24 17:00:27:383][Critical] Test Critical
[05/06/24 17:00:27:383][Exception]
System.AggregateException | HRESULT: -2146233088
Message: One or more errors occurred.
Stack Trace: 
   at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 99
--------
System.ArgumentException | HRESULT: -2147024809
Message: Invalid Argument
Stack Trace: 
   at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 72
--------
System.ArgumentOutOfRangeException | HRESULT: -2146233086
Message: Count Must be greater than 5
Parameter name: exampleField
Stack Trace: 
   at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 81
--------
System.ArgumentNullException | HRESULT: -2147467261
Message: Count can not be null
Parameter name: exampleField
Stack Trace: 
   at TestApp.MainContext.TestAll() in C:\Project\Base\MainContext.cs:line 90
--------
[05/06/24 17:00:27:383][FATAL] Test Fatal