asp.net core 5.0 中的 JsonConsole

Intro

asp.net core 5.0 中日志新增了 JsonConsole，還是輸出日志到 Console，但是會應用 Json 格式的一個 Formatter 把日志格式化成 json 再輸出到控制臺

Sample

一起來看一個示例，以我的一個小專案為例子來演示，默認的 console 日志格式是多行的，不夠結構化，想要進行加工的話就會比較麻煩，不能很方便的進行加工和擴展，而 JSON 則是一種相對來說比較結構化的資料，相對來說進行擴展就比較方便了，

來看一下默認日志輸出效果：

default console log

如圖所示，一條日志默認是兩行，第一行是日志級別和日志對應的 CategoryName 和 EventId，第二行是日志的具體內容

接著我們來使用一下 JsonConsole，配置方式如下，可以在 Program.cs 呼叫（推薦）

json console configure

再來看輸出的日志：

json console log

可以看到現在的日志已經是 JSON 了，每一條日志都是一個 JSON

Implement

它的實作在于一個 JsonConsoleFormatter，是基于 System.Text.Json 來實作的 Json 格式化，

我們也可以實作自己的 ConsoleFormatter 來自定義 Console 的日志格式，詳細實作可以參考：https://github.com/dotnet/runtime/blob/v5.0.0/src/libraries/Microsoft.Extensions.Logging.Console/src/JsonConsoleFormatter.cs

擴展方法實作https://github.com/dotnet/runtime/blob/v5.0.0/src/libraries/Microsoft.Extensions.Logging.Console/src/ConsoleLoggerExtensions.cs：

AddJsonConsole 擴展實作：

AddJsonConsole

AddConsoleWithFormatter 實作：

AddConsoleWithFormatter

AddConsole 實作：

AddConsole

在之前的版本，如果想要把日志格式化成 JSON 輸出到控制臺，需要使用第三方的日志框架把日志序列化成 JSON，有了 JsonConsoleFormatter 之后我們就可以很方便的將日志格式化成 JSON 輸出到控制臺了，

日志輸出為 JSON 之后，想要對日志進行擴展和補充就會很容易，我們的應用目前使用的 .netcore 3.1，使用的是 nlog 把日志格式化成 JSON 輸出到控制臺，再通過 Fluentd 收集 es，收集的同時會把應用所在的 k8s 環境資訊如containerName, podName,clusterName 等也 Patch 到日志資訊中

示例使用了默認的配置，我們也可以通過帶 action 的多載擴展方法自定義 Json 格式化的配置

Reference

https://docs.microsoft.com/en-us/aspnet/core/release-notes/aspnetcore-5.0?view=aspnetcore-5.0#console-logger-formatter
https://github.com/WeihanLi/SparkTodo

轉載請註明出處，本文鏈接：https://www.uj5u.com/net/245912.html

標籤：.NET技术

上一篇：計劃新版博客

下一篇：看圖知義，Winform開發的技術特點分析

asp.net core 5.0 中的 JsonConsole

asp.net core 5.0 中的 JsonConsole

Intro

Sample

Implement

More

Reference