NLog 配置文件中布局渲染器(layout renderers)
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、计数器
参考文档:
7、编码和字符串转换
参考文档:
8、环境和配置文件
参考文档:
9、文件和目录
参考文档:
10、进程、线程和程序集
参考文档:
11、ASP.NET 和 ASP.NET Core
参考文档: