NLog 配置文件中布局渲染器(layout renderers)

发布时间 2024-01-05 21:09:31作者: leviliang

NLog 配置文件中,布局渲染器(layout renderers)是一种机制,用于在日志消息中插入动态内容或格式化信息。它们允许您将变量、属性、日期时间信息等添加到日志消息中,以便更详细地记录和分析日志。布局渲染器是在${}中包含的占位符,会在运行时替换为实际值。

1、所有的布局参数

变量名

描述

${cached}

将缓存应用于另一个布局输出。

${db-null}

为数据库呈现 DbNull。

${exception}

通过调用记录器方法之一提供的异常信息。

${level}

日志级别(例如错误、调试)或级别序号(数字)。

${literal}

字符串 literal。(文本) - 用于转义括号。

${logger}

记录器名称。GetLogger,GetCurrentClassLogger 等。

${message}

(格式化的)日志消息。

${newline}

换行符文字。

${object-path}

呈现对象的(嵌套)属性。

${onexception}

仅在为日志消息定义了异常时才输出内部布局。

${onhasproperties}

仅当事件属性包含在日志事件中时才输出内部布局。

${var}

渲染变量

2、调用站点和堆栈跟踪

变量名

描述

${callsite}

调用站点(类名、方法名和源信息)。

${callsite-filename}

调用站点源文件名。

${callsite-linenumber}

呼叫站点源行编号。

${stacktrace}

呈现堆栈跟踪。

3、条件

变量名

描述

${when}

仅在满足指定条件时输出内部布局。

${whenempty}

当内部布局生成空结果时输出备用布局。

4、上下文信息

变量名

描述

${activity}

从 System.Diagnostics.Activity.Current NLog.DiagnosticSource External 捕获跟踪上下文。

${activityid}

将 System.Diagnostics 跟踪关联 ID 放入日志中。

${all-event-properties}

记录所有事件上下文数据。

${event-context}

记录事件属性数据 - 替换为 ${事件属性}。

${event-properties}

记录事件属性数据 - 重命名 ${事件-上下文}。

${gdc}

全局诊断上下文项。用于保存每个应用程序实例值的字典结构。

${install-context}

安装参数(传递给 InstallNLogConfig)。

${mdc}

映射的诊断上下文 - 线程本地结构。

${mdlc}

异步映射诊断上下文 - 作用域内上下文的线程本地结构。MDC 的异步版本。

${ndc}

嵌套诊断上下文 - 线程本地结构。

${ndlc}

异步嵌套诊断上下文 - 线程本地结构。

5、计数器

参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy

6、日期和时间

参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy


7、编码和字符串转换

 参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy

8、环境和配置文件

  参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy

9、文件和目录

 参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy

10、进程、线程和程序集

 参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy

11、ASP.NET 和 ASP.NET Core

  参考文档:NLog 配置文件中布局渲染器(layout renderers)-CJavaPy