• 如何为Windows服务增加Log4net和EventLog的日志功能。


    一、简介

        最近在做一个项目的时候,需要该项目自动启动、自动运行,不需要认为干预。不用说,大家都知道用什么技术,那就是 Windows服务。在以前的Net Framework 平台下,Windows 服务是一个不错的选择。如果现在在Net Core版本,或者Net5.0以及以上版本,我们会有另外一个选择,这就是 Worker Service,中文叫:辅助角色服务。它使用起来,维护起来更方便。话好像有点跑题了。我们言归正传,当我们做了一个Windows服务的进程来承载程序,还有另外一个工作需要做。那就是需要让我们的服务程序告诉我们,程序是否运行正常,干了什么,没有干什么,执行了哪些步骤,说道这些,就是我们所说的,要给Windows服务增加日志功能。

        为了给Windows服务增加日志功能,我们今天选择了两个日志组件,第一:EventLog,第二:Log4net。

        开发环境:

            开发工具:Visual Studio 2019

            开发语言:C#

    二、具体操作

        1、为项目增加 EventLog 功能

            1.1、创建 Windows 服务项目。

                我们打开 Visual Studio 2019,在首页上选择“创建新项目”

                

                点击《创建新项目》,进入《创建新项目》窗体,可以在左侧选择使用过的模板,也可以在右侧选择我们需要的模板。

                

                点击《下一步》,进入《配置新项目》窗口,输入项目名称,解决方案名称和项目的保存路径地址。

                

                点击《创建》,开始创建项目和解决方案。

                

            1.2、修改Service1.cs文件名称为《MyWindowsService.cs》,并在服务的设计窗口中添加工具EventLog,在《工具栏》中打开组件《EventLog》,并将其拖到我们服务之上。

                

            1.3、然后在我们服务的构造函数中增加一下代码。 

                

      1 using System;
      2 using System.Diagnostics;
      3 using System.IO;
      4 using System.ServiceProcess;
      5 using System.Timers;
      6 
      7 namespace PatrickLiu.WindowsService.RfcPlatform
      8 {
      9     /// <summary>
     10     /// 我们定义的 Windows 服务。
     11     /// </summary>
     12     public partial class MyWindowsService : ServiceBase
     13     {
     14         private static readonly log4net.ILog logger = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
     15 
     16         private int eventId = 1;
     17 
     18         /// <summary>
     19         /// 服务的构造函数
     20         /// </summary>
     21         public MyWindowsService()
     22         {
     23             //记录到event log中,地址是 C:\Windows\System32\winevt\Logs (双击查看即可,文件名为MyNewLog)
     24             InitializeComponent();
     25             if (!System.Diagnostics.EventLog.SourceExists("PatrickLiuEventSource"))
     26             {
     27                 System.Diagnostics.EventLog.CreateEventSource("PatrickLiuEventSource", "PatrickLog");
     28             }
     29             MyEventLog.Source = "PatrickLiuEventSource";
     30             MyEventLog.Log = "PatrickLog";            
     31         }
     32 
     33         /// <summary>
     34         /// 服务开始启动。
     35         /// </summary>
     36         /// <param name="args"></param>
     37         protected override void OnStart(string[] args)
     38         {
     39             logger.Info("服务启动,启动时间:" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
     40             MyEventLog.WriteEntry("开启服务。");
     41             Log("In OnStart.");
     42 
     43             #region 可以定义个人的服务
     44 
     45             Timer timer = new Timer();
     46             timer.Interval = 60000; // 60 seconds 60秒执行一次
     47             timer.Elapsed += new ElapsedEventHandler(OnTimer);
     48             timer.Start();
     49 
     50             #endregion
     51         }
     52 
     53         /// <summary>
     54         /// 服务开始关闭
     55         /// </summary>
     56         protected override void OnStop()
     57         {
     58             logger.Info("服务停止,停止时间:" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
     59             MyEventLog.WriteEntry("关闭服务。");
     60 
     61             #region 可以定义要结束服务要做的事情。
     62 
     63             Log("In OnStop.");
     64 
     65             #endregion
     66         }
     67 
     68         /// <summary>
     69         /// 继续服务
     70         /// </summary>
     71         protected override void OnContinue()
     72         {
     73             logger.Info("服务暂停,暂停时间:" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
     74             MyEventLog.WriteEntry("In OnContinue.");
     75             Log("In OnContinue.");
     76         }
     77 
     78         /// <summary>
     79         /// 定时器中定时执行的任务
     80         /// </summary>
     81         /// <param name="sender"></param>
     82         /// <param name="args"></param>
     83         public void OnTimer(object sender, ElapsedEventArgs args)
     84         {
     85             // TODO: Insert monitoring activities here.
     86             logger.Info("我开始运行了,时间:" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
     87             MyEventLog.WriteEntry("我开始运行了!", EventLogEntryType.Information, eventId++);
     88             Log("the timer");
     89         }
     90 
     91         /// <summary>
     92         /// 记录到指定路径:D:\log.txt
     93         /// </summary>
     94         /// <param name="message"></param>
     95         private static void Log(string message)
     96         {
     97             using (FileStream stream = new FileStream("D:\\log.txt", FileMode.Append))
     98             using (StreamWriter writer = new StreamWriter(stream))
     99             {
    100                 writer.WriteLine($"{DateTime.Now}:{message}");
    101             }
    102         }
    103     }
    104 }

            1.4、右键点击我们的服务,添加安装程序。

                

                

                项目目录结构如下:

                

            1.5、修改安装程序 serviceInstaller1 名称为:MyServiceInstaller,右键,修改serviceName和Description。

                

            1.6、在 serviceProcessInstaller 上修改名称,右键,修改 Account 为 LocalSystem。

                

            1.7、如果运行 InstallUtil命令,提示不是有效命令,要执行以下操作。跟着操作就可以。

     

            1.8、将【C:\Windows\Microsoft.NET\Framework64\v4.0.30319】这个项目文件的地址增加到环境变量中;如图

                 拷贝地址:C:\Windows\Microsoft.NET\Framework64\v4.0.30319
                

                在我的电脑图标上右键点击《属性》,打开《系统》窗口,点击左侧《高级系统设置》,进入设置窗口。

                

                打开《环境变量》窗口,选择《系统变量》,它可以作用域所有用户。在《系统变量》窗口,查找《Path》,然后选择编辑,把我们拷贝的目录,复制到值最后,通过英文分号分割。

                

                确定关闭所有窗口,然后打开cmd窗口,输入:installuils,看看怎么样?和以下一样就说明你可以继续了。

                

                切记:安装服务的时候,必须以管理员的身份运行。否则会有你意想不到错误。

            1.9、编译解决方案和项目,开始安装服务,首先我们以管理员身份运行cmd。

                进入到项目的目录,执行 Installutil PatrickLiu.WindowsService.RfcPlatform.exe

                

            2.0、打开服务管理器,启动MyService服务,并且等待几分钟,然后卸载服务

               

            2.1、检验是否有效果

                

                  好了,这一篇就到这里了。

        2、为项目增加Log4net 功能。

          2.1、项目和上面的项目是同一个,我们在该目录下增加文件夹,名称为:LogConfig,在该文件夹下增加配置文件,名称:log4net.config

              

              log4.net.config 内容:          

     1 <?xml version="1.0" encoding="utf-8" ?>
     2 <log4net>
     3   <appender name="DebugAppender" type="log4net.Appender.DebugAppender" >
     4     <layout type="log4net.Layout.PatternLayout">
     5       <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
     6     </layout>
     7   </appender>
     8   <!--指定日记记录方式,以滚动文件的方式(文件记录)-->
     9   <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
    10     <!--日志路径-->
    11     <file value="LogFiles\log-" />
    12     <!--是否是向文件中追加日志-->
    13     <appendToFile value="true" />
    14     <!--log保留天数-->
    15     <param name= "MaxSizeRollBackups" value= "10"/>
    16     <!--每个文件最大1M-->
    17     <param name="maximumFileSize" value="1MB" />
    18     <!--日志根据日期滚动-->
    19     <param name="RollingStyle" value="Date" />
    20     <!--日志文件名格式为:logs_20080831.log-->
    21     <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
    22     <!--日志文件名是否是固定不变的-->
    23     <param name="StaticLogFileName" value="false" />
    24     <!--布局-->
    25     <layout type="log4net.Layout.PatternLayout">
    26       <conversionPattern value="%date %5level %logger.%method [%line] - MESSAGE: %message%newline %exception" />
    27     </layout>
    28   </appender>
    29   <root>
    30     <level value="ALL"/>
    31     <appender-ref ref="DebugAppender" />
    32     <appender-ref ref="RollingFile" />
    33   </root>
    34 </log4net>

                并且该文件的属性设置为:复制到输出目录-》始终复制。

              

          2.2、第二步,我们要安装 Log4net的组件,通过nuget来安装。

               在项目的《引用》上点击右键,选择《管理 NuGet 程序包》

                

                  然后,点击《浏览》,在文本框中输入要查找组件的名称,在右侧选择安装。

                  

              2.3、配置 AssemblyInfo.cs 文件。              

                  [assembly: log4net.Config.XmlConfigurator(ConfigFileExtension = "config", ConfigFile = "LogConfig/log4net.config", Watch = true)]

                  截图如下:
                                                    

                     

          2.4、在我们Windows服务获取Log4net 的实例。          

                  private static readonly log4net.ILog logger = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

                  

          2.3、完成之后,我们安装 Windows服务,然后在项目的运行目录里查看,确认日志是否启用。

              我们要在此安装服务,先要卸载服务。

                执行以下命令:先是切换目录,然后执行命令:installutil /u PatrickLiu.WindowsService.RfcPlatform.exe

              

               然后,我们再次执行命令:installutil PatrickLiu.WindowsService.RfcPlatform.exe 重新安装服务。

               

          2.4、Windows服务的安装过程和上面都是一样,所以这里就不重复了。

            2.5、确认log4net是否启作用。 

              

                打开LogFIles目录,我们看到了日志文件。

                

    三、总结

        好了,今天就写到这里了。俗话说的好,好记性不如烂笔头,所以我就记录下来,以防自己需要的时候查找使用。而且每步都是自己试验过的。可以放心使用。不忘初心,继续努力,老天不会辜负努力人的。

  • 相关阅读:
    【转】Android Hook框架Xposed详解
    【转】不需要 Root,也能用上强大的 Xposed 框架:VirtualXposed
    【转】手把手教你读取Android版微信和手Q的聊天记录(仅作技术研究学习)
    【转】关于音频焦点的理解
    test
    Linux只下载不安装软件包
    Linux用户创建/磁盘挂载相关命令
    telnet的安装配置及xinetd的讨论
    vsftp安装配置教程
    wordpress安装教程
  • 原文地址:https://www.cnblogs.com/PatrickLiu/p/15836824.html
Copyright © 2020-2023  润新知