NLog文章系列——系列文章目录以及简要介绍

冷不防 2021-12-04 06:29 307阅读 0赞

早晨看到[TerryLee][]的文章《[.NET开源项目介绍及资源推荐：日志记录][.NET]》，其中说到[NLog][]这个同样开源且非常不错的日志记录工具却没什么中文资料。在TerryLee介绍前，我也不知道[NLog][]这个东西，于是就随便尝试了一下。

简单使用了一下之后，觉得NLog真的非常不错。如此漂亮的类库却没有中文资料，似乎有些可惜，于是尝试联系其作者Jaroslaw Kowalski请求翻译NLog网站中的一部分内容。没想到Jaroslaw Kowalski很快给我回了信表示同意，更巧的是居然我们还是同事！

**文章目录**

交流之后，我决定先从NLog网站的介绍文档开始，逐步翻译并介绍NLog的使用方法，直至最终推出NLog的中文版网站。接下来我也可能加入NLog开发团队，当然这是后话。在翻译的过程中，我会不断将译文发表至我的Blog之上，以下是我计划的文章列表（链接指向原英文页面，翻译过后将加入中文文章链接）：

**文档部分**

1.  [Tutorial][]（[NLog文章系列——入门教程（上）][NLog 1]、[（中）][Link 1]、[（下）][Link 2]） - NLog入门介绍
2.  [Configuration File][] \- （[如何配置NLog][NLog 2] ）配置文件介绍
3.  [Visual Studio Support][] \- （[与Visual Studio集成][Visual Studio]）Visual Studio中的snippets、智能感知等
4.  [Performance][] \- NLog的性能

**参考部分**

1.  [Targets][] \- 日志信息的输出目标
2.  [Layouts][] \- 日志信息的输出格式（纯文本、XML、CSV）
3.  [Layout Renderers][] \- 指定输出信息中包含的内容（日期、时间、类名、方法名……）
4.  [Filters][] \- 过滤输出信息
5.  [Conditions][] \- 过滤信息时用到的简单谓词语言

**How to部分**

1.  [How to write your own Target][] - 如何编写自定义的输出目标（Target）
2.  [How to write your own Layout Renderer][] - （[如何写自定义布局生成器（Layout Renderer）][Layout Renderer]）
3.  [How to write your own Filter][] - （[如何编写自定义的过滤器（Filter）][Filter] ）
4.  [How to write your own Condition Function][] - 如何编写自定义的条件函数（Condition Function）
5.  [How to optimize logging performance][] -（[如何优化日志性能][Link 3] ）
6.  [How to troubleshoot your logging problems][] - （[如何排错][Link 4] ）

**NLog简要介绍**

（以下内容原文来自NLog网站的首页：[http://www.nlog-project.org/][NLog]）

NLog是一个简单灵活的.NET日志记录类库。通过使用NLog，我们可以在任何一种.NET语言中输出**带有上下文的（contextual information）**调试诊断信息，根据喜好配置其表现样式之后发送到一个或多个**输出目标（target）**中。

NLog的**API**非常类似于[log4net][]，且配置方式非常简单。NLog使用**路由表（routing table）**进行配置，但log4net却使用[层次性的appender][appender]配置，这样就让NLog的配置文件非常容易阅读，并便于今后维护。

NLog遵从[BSD license][]，即允许商业应用且完全开放源代码。任何人都可以免费使用并对其进行测试，然后通过邮件列表反馈问题以及建议。

NLog支持**.NET**、**C/C++**以及**COM interop** API，因此我们的程序、组件、包括用C++/COM 编写的遗留模块都可以通过同一个路由引擎将信息发送至NLog中。

NLog的.NET API的过滤信息功能执行效率很高，这样我们就可以一直保留程序中的日志写入代码，然后由NLog在运行时将其根据需要过滤掉。在一个1.6G单CPU笔记本电脑上，NLog每秒钟可以过滤掉1.5亿条日志写入语句！加上**异步处理（asynchronous processing）**以及其他**包装程序（wrappers）**的支持，NLog将成为一个极为强大的、且极具伸缩性的日志记录工具，

转载于:https://www.cnblogs.com/dflying/archive/2006/12/04/581750.html

[TerryLee]: http://www.cnblogs.com/Terrylee/
[.NET]: http://www.cnblogs.com/Terrylee/archive/2006/12/03/opensource_framework_and_resource_recommendation_Log.html
[NLog]: http://www.nlog-project.org/
[Tutorial]: http://www.nlog-project.org/tutorial.html
[NLog 1]: http://www.cnblogs.com/dflying/archive/2006/12/05/583071.html
[Link 1]: http://www.cnblogs.com/dflying/archive/2006/12/06/584426.html
[Link 2]: http://www.cnblogs.com/dflying/archive/2006/12/07/585787.html
[Configuration File]: http://www.nlog-project.org/config.html
[NLog 2]: http://www.cnblogs.com/dflying/archive/2006/12/15/593158.html
[Visual Studio Support]: http://www.nlog-project.org/visualstudio.html
[Visual Studio]: http://www.cnblogs.com/dflying/archive/2006/12/08/586678.html
[Performance]: http://www.nlog-project.org/performance.html
[Targets]: http://www.nlog-project.org/targets.html
[Layouts]: http://www.nlog-project.org/layouts.html
[Layout Renderers]: http://www.nlog-project.org/layoutrenderers.html
[Filters]: http://www.nlog-project.org/filters.html
[Conditions]: http://www.nlog-project.org/conditions.html
[How to write your own Target]: http://www.nlog-project.org/howto_write_target.html
[How to write your own Layout Renderer]: http://www.nlog-project.org/howto_write_layout_renderer.html
[Layout Renderer]: http://www.cnblogs.com/dflying/archive/2006/12/22/600960.html
[How to write your own Filter]: http://www.nlog-project.org/howto_write_filter.html
[Filter]: http://www.cnblogs.com/dflying/archive/2006/12/25/603512.html
[How to write your own Condition Function]: http://www.nlog-project.org/howto_write_condition_function.html
[How to optimize logging performance]: http://www.nlog-project.org/howto_optimize_performance.html
[Link 3]: http://www.cnblogs.com/dflying/archive/2006/12/26/604397.html
[How to troubleshoot your logging problems]: http://www.nlog-project.org/howto_troubleshoot.html
[Link 4]: http://www.cnblogs.com/dflying/archive/2006/12/20/597379.html
[log4net]: http://www.nlog-project.org/external/logging.apache.org/log4net/
[appender]: http://logging.apache.org/log4net/release/sdk/log4net.Appender.html
[BSD license]: http://www.nlog-project.org/external/svn.nlog-project.org/repos/nlog/trunk/NLog/LICENSE.txt