README.md

Nvosk.Extensions.Logging.JsonConsole

JsonConsole logger provider implementation for Microsoft.Extensions.Logging.

Outputs json formatted logs to stdout/console.

Ideal for high performance centralised structured logging in environments such as Kubernetes with EFK stack (Elasticsearch/Fluent-Bit/Kibana).

Install nuget package

PM> Install-Package Nvosk.Extensions.Logging.JsonConsole

Add the "Console" section in appsettings.{environment}.json

The "JsonMessageTemplate" section is optional.

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    },
    "Console": {
      "Format": "Json",
      "TimestampFormat": "yyyy-MM-ddTHH:mm:ss",
      "LogToStandardErrorThreshold": "Warning",
      "LogLevel": {
        "Default": "Information"
      },
      "JsonMessageTemplate": {
        "TimeStamp": "time",
        "LogLevel": "level",
        "Source": "source",
        "EventId": "event_id",
        "Message": "message",
        "Exception": "exception"
      }
    }
  }
}

Add the "ConfigureLogging" section in Program.cs

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.ConfigureLogging((hostContext, configLogging) =>
                    {
                        // clear all previously registered providers
                        configLogging.ClearProviders();

                        configLogging.AddConfiguration(hostContext.Configuration.GetSection("Logging"));
                        configLogging.AddJsonConsole();
                    })
                   .UseStartup<Startup>();
                });

Example json output

{"time":"2019-12-31T23:59:54","level":"trce","source":"ConsoleApp.Program","event_id":0,"message":"LogTrace..."}
{"time":"2019-12-31T23:59:55","level":"dbug","source":"ConsoleApp.Program","event_id":0,"message":"LogDebug..."}
{"time":"2019-12-31T23:59:56","level":"info","source":"ConsoleApp.Program","event_id":0,"message":"LogInformation..."}
{"time":"2019-12-31T23:59:57","level":"warn","source":"ConsoleApp.Program","event_id":0,"message":"LogWarning..."}
{"time":"2019-12-31T23:59:58","level":"fail","source":"ConsoleApp.Program","event_id":0,"message":"LogError..."}
{"time":"2019-12-31T23:59:59","level":"crit","source":"ConsoleApp.Program","event_id":0,"message":"LogCritical..."}

3.1.17 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.17
• Updated System.Text.Json to v5.0.2

3.1.13 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.13

3.1.12 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.12

3.1.9 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.9

3.1.8 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.8

3.1.7 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.7

3.1.6 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.6

3.1.5 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.5

3.1.4 Release notes

• Downgraded TargetFramework from netstandard2.1 to netstandard2.0 to reflect original Microsoft.Extensions.Logging.Console
• Updated Microsoft.Extensions.* packages to v3.1.4
• Updated System.Text.Json to v4.7.2

3.1.3 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.3

3.1.2 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.2
• Updated System.Text.Json to v4.7.1

3.1.1 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.1

3.1.0 Release notes

• Updated Microsoft.Extensions.* packages to v3.1.0
• Updated System.Text.Json to v4.7.0

3.0.0 Release notes

• Based on Microsoft.Extensions.Logging.Console v3.0.0.
• All original functionality from Microsoft.Extensions.Logging.Console is included.
• Via the new "Format" property one can switch between Default, Json or Systemd formats.
• Replaced Newtonsoft.Json with Microsoft's new high performance System.Text.Json.Utf8JsonWriter.
• Breaking changes: please review your appsettings.json files as there are some renames and new additions.

1.0.0 Release notes

• Based on Microsoft.Extensions.Logging.Console v2.2.0.
• Initial JsonConsole.