每当出现一些未捕获异常时,操作系统都会将异常信息写入到 Windows 事件日志
中,可以通过 Windows 事件查看器
查看,如下图:
这篇文章将会讨论如何使用编程的方式将日志记录到 Windows 事件日志 中。
要想在 .NET Core 中记录数据到 Windows 事件日志中,可以用 Nuget 安装一下 Microsoft.Extensions.Logging.EventLog
包,用 Visual Studio 中的 NuGet Package Manager
可视化面板 或者 使用 NuGet Package Manager Console
命令行界面都可以,输入命令如下:
Install-Package Microsoft.Extensions.Logging.EventLog
要想将日志写入 Windows 事件日志中,可以使用如下代码:
EventLog eventLog = new EventLog(); eventLog.Source = "MyEventLogTarget"; eventLog.WriteEntry("This is a test message.", EventLogEntryType.Information);
为了能够实现清空所有 windows 日志,可以使用如下代码:
EventLog eventLog = new EventLog(); eventLog.Source = "MyEventLogSource"; eventLog.Clear();
Clear 是清空所有的 windows 事件日志,那如何清除某一个类别的日志呢?比如说:MyEventLogTarget,修改代码如下:
if (EventLog.Exists("MyEventLogTarget")) { EventLog.Delete("MyEventLogTarget"); }
可以使用 foreach 迭代 Entries 来获取所有的日志记录。
EventLog eventLog = new EventLog(); eventLog.Log = "MyEventLogTarget"; foreach (EventLogEntry entry in eventLog.Entries) { //Write your custom code here }
要想使用 NLog 将日志记录到 windows事件日志 中,你需要用 NuGet 安装一下 NLog.WindowsEventLog
,这个包封装了连接 EventLog 错综复杂的细节,所以你只需要像平时用 NLog 一样的操作即可。
下面的接口方法用于记录不同级别的日志 (information, warning, debug, or error)
public interface ILogManager { void LogInformation(string message); void LogWarning(string message); void LogDebug(string message); void LogError(string message); }
接下来,从 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 方法,其他的三个方法大家可以自行实现,为了能够了解如何通过 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 以编程的方式 通过 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 的完整代码实例,可供大家参考。
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事件日志 中是一个非常不错的选择。