J4JSoftware.Logging 4.0.1

J4JLogging

A Net 5.0 library which wraps Serilog's ILogger and extends it by reporting source code information.

Licensed under GNU GPL-v3.0.

See the github documentation for more detail.

TL;DR

There are many breaking changes from the last release. Please re-review the documentation.

using System;
using System.IO;
using System.Linq;
using System.Runtime.CompilerServices;
using J4JSoftware.Logging;
using Microsoft.Extensions.Configuration;
using Serilog;

namespace ConfigurationBasedExample
{
    // shows how to use J4JLogger with a configuration file
    // see the ConfigurationBasedExample project for other files and details
    class Program
    {
        static void Main(string[] args)
        {
            var loggerConfig = new J4JLoggerConfiguration();

            var configRoot = new ConfigurationBuilder()
                .AddJsonFile( Path.Combine( Environment.CurrentDirectory, "appConfig.json" ), true )
                .Build();

            loggerConfig.SerilogConfiguration
                .ReadFrom
                .Configuration( configRoot );
                
            var logger = loggerConfig.CreateLogger();
            logger.SetLoggedType(typeof(Program));

            logger.Information("This is an Informational logging message");
            logger.Fatal("This is a Fatal logging message");
        }
    }
}

The log file, log20210801.txt, looks like this:

2021-09-15 10:14:59.173 -07:00 [INF] This is an Informational logging message ConfigurationBasedExample.Program::Main (C:\Programming\J4JLogging\examples\ConfigurationBasedExample\Program.cs:32) 
2021-09-15 10:14:59.238 -07:00 [FTL] This is a Fatal logging message ConfigurationBasedExample.Program::Main (C:\Programming\J4JLogging\examples\ConfigurationBasedExample\Program.cs:33) 

Your log file's name will be different because, by default, the log file rolls daily and the last day logging took place will be embedded in the file name.

There is a simple way of trimming the logged source code file paths to make them relative to the project directory path. See the github documentation for how to do this.

Important Note

There is one important difference in how you call the logging methods from the Serilog standard.

If you pass nothing but simple strings to the methods as property values you must specify the types of the propertyValue arguments explicitly in the method call.

An example:

string someStringValue = "abcd";
_logger.Debug<string>("The value of that argument is {0}", someStringValue);

This requirement comes about because the memberName, srcPath and srcLine arguments are automagically set for you by the compiler. The fact the memberName and srcPath arguments of the logging methods are strings makes them "collide" with string arguments you may specify. That makes explict type specifications for the arguments necessary when the compiler can't figure out what you mean...which is all too common 😃.