如何将日志记录到 Windows事件日志 中

每当出现一些未捕获异常时，操作系统都会将异常信息写入到 Windows 事件日志 中，可以通过 Windows 事件查看器 查看，如下图：

这篇文章将会讨论如何使用编程的方式将日志记录到 Windows 事件日志 中。

安装 EventLog

要想在 .NET Core 中记录数据到 Windows 事件日志中，可以用 Nuget 安装一下 Microsoft.Extensions.Logging.EventLog 包，用 Visual Studio 中的 NuGet Package Manager 可视化面板 或者 使用 NuGet Package Manager Console 命令行界面都可以，输入命令如下：

Install-Package Microsoft.Extensions.Logging.EventLog

通过 EventLog 记录日志

要想将日志写入 Windows 事件日志中，可以使用如下代码：

EventLog eventLog = new EventLog();
eventLog.Source = "MyEventLogTarget";
eventLog.WriteEntry("This is a test message.", EventLogEntryType.Information);

通过 EventLog 清空日志

为了能够实现清空所有 windows 日志，可以使用如下代码：

EventLog eventLog = new EventLog();
eventLog.Source = "MyEventLogSource";
eventLog.Clear();

Clear 是清空所有的 windows 事件日志，那如何清除某一个类别的日志呢？ 比如说：MyEventLogTarget，修改代码如下：

if (EventLog.Exists("MyEventLogTarget"))
{
   EventLog.Delete("MyEventLogTarget");
}

读取 Windows 事件日志 记录

可以使用 foreach 迭代 Entries 来获取所有的日志记录。

EventLog eventLog = new EventLog();
eventLog.Log = "MyEventLogTarget";
foreach (EventLogEntry entry in eventLog.Entries)
{ 
   //Write your custom code here
}

使用 NLog 将日志记录到 Windows 事件日志 中

要想使用 NLog 将日志记录到 windows事件日志 中，你需要用 NuGet 安装一下 NLog.WindowsEventLog ，这个包封装了连接 EventLog 错综复杂的细节，所以你只需要像平时用 NLog 一样的操作即可。

创建 ILogManager 接口

下面的接口方法用于记录不同级别的日志 （information, warning, debug, or error）

    public interface ILogManager
    {
        void LogInformation(string message);
        void LogWarning(string message);
        void LogDebug(string message);
        void LogError(string message);
    }

创建 NLogManager 类

接下来，从 ILogManager 接口上派生一个 NLogManager 类，代码如下：

    public class NLogManager : ILogManager
    {
        private static NLog.ILogger logger = LogManager.GetCurrentClassLogger();

        public void LogDebug(string message)
        {
            throw new NotImplementedException();
        }
        public void LogError(string message)
        {
            logger.Error(message);
        }
        public void LogInformation(string message)
        {
            throw new NotImplementedException();
        }
        public void LogWarning(string message)
        {
            throw new NotImplementedException();
        }
    }

使用 LogError 方法

为了简单起见，我就仅实现 LogError 方法，其他的三个方法大家可以自行实现，为了能够了解如何通过 NLog 记录日志到 Windows事件日志 中，修改代码如下：

    public void LogError(string message)
    {
        Logger logger = LogManager.GetLogger("EventLogTarget");
        var logEventInfo = new LogEventInfo(LogLevel.Error,logger.Name, message);
        logger.Log(logEventInfo);
    }

请注意，上面我创建了一个名为 EventLogTarget 的 EventLog，然后在 LogEventInfo 的构造函数中传递 log级别，logger的名字 以及 需要记录的 log 信息。

配置 Nlog 将日志记录到 Windows事件日志 中

为了能够配置 Nlog 以编程的方式 通过 EventLog 记录日志，可以使用如下代码。

var config = new NLog.Config.LoggingConfiguration();
var logEventLog = new NLog.Targets.EventLogTarget("EventLogTarget");
config.AddRule(NLog.LogLevel.Info, NLog.LogLevel.Error, logEventLog);
NLog.LogManager.Configuration = config;

完整的 NLogManager 例子

以下是 NLogManager 的完整代码实例，可供大家参考。

    public class NLogManager : ILogManager
    {
        private static NLog.ILogger logger =LogManager.GetCurrentClassLogger();

        public void LogDebug(string message)
        {
            logger.Debug(message);
        }

        public void LogError(string message)
        {
            Logger logger = LogManager.GetLogger("EventLogTarget");
            var logEventInfo = new LogEventInfo(LogLevel.Error,logger.Name, message);
            logger.Log(logEventInfo);
        }
        public void LogInformation(string message)
        {
            logger.Info(message);
        }
        public void LogWarning(string message)
        {
            logger.Warn(message);
        }
    }

为了能够在 Controller 中使用 NLogManager，还需要在 Startup 下的 ConfigureServices 方法中进行注入，代码如下:

services.AddSingleton<ILogManager, NLogManager>();

当你打开 Windows 事件查看器，就会看到错误信息已成功记录到这里了，参考如下截图：

Windows事件日志 通常用于记录 系统事件，网络流量和诸如安全，性能相关的信息 等等，你也可以将应用程序的日志记录到 Windows事件日志中，通常来说，如果你的程序仅仅是跑在 windows 上，那么将应用程序信息记录到 Windows事件日志 中是一个非常不错的选择。

译文链接：https://www.infoworld.com/article/3598750/how-to-log-data-to-the-windows-event-log-in-csharp.html