Question

直到今天，我们一直使用NLog版本4.4.12（无结构化日志记录）。但是，我们使用https://www.nuget.org/packages/NLog.StructuredLogging.Json/进行结构化日志记录。

使用此扩展的好处是您不需要模板化的消息（包含索引或占位符以记录其他参数/对象）。该消息不包含要记录的其他对象（即匿名类型）的任何索引或占位符。

立即切换到支持结构化日志记录的NLog 4.6.5，我们希望摆脱该附加的NuGet程序包。但是，只有在使用带有实际索引/命名占位符的模板化消息时，才会记录我们的附加参数。

消息中没有索引或占位符会导致没有其他参数/对象通过JSON呈现。

是否可以有非模板消息，但是仍然使用NLog的结构化日志记录我们传递给他们的其他参数，以将其添加到JSON中？

下面是一个示例（请注意，我们在nlog周围使用了额外的包装器）

NLog版本：4.6.5

平台：. Net 4.5

当前的NLog配置

// Arrange
var typeUsingLogger = typeof(NLogWrapperTest);
var nLogWrapper = new NLogWrapper(typeof(NLogWrapper));

var level = (LogLevel)Enum.Parse(typeof(LogLevel), nLevel.Name);
var message = $"{Guid.NewGuid()}"; // {{extendedLogProperties}}  {{@extendedLogProperties}} {{@purchase}} {{badplaceholder}}
var innerException = new DivideByZeroException("bla inner exception");
var exception = new ArgumentNullException("bla out exception", innerException);
var extendedLogProperties = new
{
    ClientID = 8,
    MyOtherProp = "abc",
    MySubObject = new
    {
        //nested object although not recommended
        A = 123,
        B = "yep"
    }
};

//log configuration
var logConfig = new LoggingConfiguration();

var memoryTarget = new MemoryTarget("MemoryTarget");
var jsonLayout = new JsonLayout
{
    IncludeAllProperties = true,
    Attributes =
    {
            new JsonAttribute("dateTime", "${date:universalTime=true:format=o}" ),
            new JsonAttribute("level", "${level:uppercase=true}" ),
            new JsonAttribute("logger", "${logger}" ),
            new JsonAttribute("message", "${message}" ),
            new JsonAttribute("callsite", "${callsite:className=true:methodName=true:skipFrame=0}" ),
            new JsonAttribute("exception", "${exception:format=ToString:innerFormat=ToString}" ),
            new JsonAttribute("machinename", "${machinename}" ),
            new JsonAttribute("processid", "${processid}" ),
            new JsonAttribute("threadid", "${threadid}" ),
            new JsonAttribute("threadname", "${threadname}" ),
            new JsonAttribute("application", "${application}" ),
            new JsonAttribute("aspnetSessionId", "${aspnet-sessionid}" ),
            new JsonAttribute("iisSiteName", "${iis-site-name}" ),
            new JsonAttribute("stage", "${stage}" ),
    }
};
memoryTarget.Layout = jsonLayout;
logConfig.AddTarget("memoryTarget", memoryTarget);
var memoryTargetLoggingRule = new LoggingRule("*", nLevel, memoryTarget);
logConfig.LoggingRules.Add(memoryTargetLoggingRule);

LogManager.Configuration = logConfig;

// Act
nLogWrapper.Log(level, message, typeUsingLogger, exception, extendedLogProperties);

var jsonLogMsg = memoryTarget.Logs[0];
Assert.Matches("ClientID", jsonLogMsg);

我们为什么需要它？

在没有任何替换索引或占位符的情况下保持消息不变是非常好的，这样我们就可以在日志中搜索完全相同的消息。（不能使用new JsonAttribute("message", "${message:raw=true}"）
而且，这样一来，我们就不会最终在日志消息（替换模板消息的占位符/索引）和这些附加参数的附加JSON字段中使JSON序列化对象一次。

请查看其最佳做法：https://github.com/justeat/NLog.StructuredLogging.Json/blob/master/README.md#best-practices

如果您询问：“为什么不继续使用NuGet NLog扩展名？” 答案是，当在嵌套对象的模板消息中使用{@placeholder}时，NLog的结构化日志会更好地呈现附加参数。

编辑1：我想将匿名对象的所有属性呈现在json的根目录中。如：

{
    ...
    "ClientID": 8,
    "MyOtherProp": "abc",
    "MySubObject": {              
                    "A": 123,
                    "B": "yep"
                },
    ...
}

Answer 1

我认为您正在寻找logger.WithProperty。

示例：

var extendedLogProperties = new
{
    ClientID = 8,
    MyOtherProp = "abc",
    MySubObject = new
    {
        //nested object although not recommended
        A = 123,
        B = "yep"
    }
};

logger.WithProperty("extendedLogProperties", extendedLogProperties).Info("test message");

，您可以将其序列化为JSON，XML等。

示例，具有所有属性的JSON

将所有事件属性呈现为JSON

config：

 <target xsi:type="File" name="jsonFile" fileName="c:\temp\nlog-json-nested-${shortdate}.log">
     <layout type="JsonLayout">
         <attribute name="time" layout="${longdate}" />
         <attribute name="level" layout="${level}" />
         <attribute name="message" layout="${message}" />
         <attribute name="eventProperties" encode="false" >
             <layout type='JsonLayout' includeAllProperties="true"  maxRecursionLimit="2"/>
         </attribute>
     </layout>
 </target>

重要的是includeAllProperties="true"和maxRecursionLimit="2"（默认为0）。参见Json Layout docs

这应该呈现（演示的格式很好，但是将是一行）：

{
    "time": "2019-06-18 11:09:00.2349",
    "level": "Info",
    "message": "test message",
    "eventProperties": {
        "extendedLogProperties": {
            "ClientID": 8,
            "MyOtherProp": "abc",
            "MySubObject": {
                "A": 123,
                "B": "yep"
            }
        }
    }
}

注释

因此请注意：

JSON将写在一行上，因此没有换行符。

Answer 2

在包装纸中，我设法实现了这一点：

        private void Log(
            NLog.LogLevel nlogLogLevel,
            Logger nlogLogger,
            Type typeUsingLogger,
            string message,
            Exception exception,
            IDictionary<string, object> additionalProperties = null)
        {
            var logEventInfo = new LogEventInfo(nlogLogLevel, typeUsingLogger.ToString(), null, message, new object[] { }, exception);
            if (additionalProperties != null)
            {
                foreach (var x in additionalProperties)
                {
                    if (!logEventInfo.Properties.ContainsKey(x.Key))
                    {
                        logEventInfo.Properties.Add(x.Key, x.Value);
                    }
                }
            }

            nlogLogger.Log(_logWrapperType, logEventInfo);
        }

并将 includeAllProperties 设置为 true ，以及将 maxRecursionLimit 设置更高（2）

是否可以在没有模板消息的情况下使用NLog的结构化日志记录？

2 个答案:

示例，具有所有属性的JSON

注释