如何使用stringToMatch过滤器将消息与log4net中的换行符匹配?

时间:2011-05-05 07:44:19

标签: log4net log4net-configuration

我在配置StringMatchFilter以匹配a时遇到问题 带有换行符的消息中的字符串。我想跳过一些消息和我 添加了这样的过滤器,它可以工作。

<filter type="log4net.Filter.StringMatchFilter">
  <param name="AcceptOnMatch" value="false" />
  <stringToMatch value="Unexpected exception in SocketThreadWorker" />
</filter>

但是,如果我将stringToMatch更改为“现有连接是 由远程主机“强行关闭”,发生在第二行 过滤器不起作用的消息。是不是因为换行了 消息或我在这里做错了什么?

典型的消息可能如下所示:

------示例消息----------------------------

2011-05-04 16:22:24,078 [Client (connected from "127.0.0.1:4076" at 16:22)] ERROR - Unexpected exception in SocketThreadWorker System.Net.Sockets.SocketException:
An existing connection was forcibly closed by the remote host at System.Net.Sockets.Socket.EndReceive(IAsyncResult asyncResult)

------结束示例消息---------------------------

“SocketThreadWorker中出现意外异常”位于消息的第一行,“强制关闭现有连接”位于第二行。

修改

appender看起来像这样:

<appender name="SmtpAppender" type="log4net.Appender.SmtpAppender">
  <filter type="log4net.Filter.StringMatchFilter">
    <param name="AcceptOnMatch" value="false" /> 
    <stringToMatch value="An existing connection was forcibly closed by the remote host" />        
  </filter>
  <to value="..." />
  <from value="..." />
  <subject value="[... ${COMPUTERNAME}] An Error occurred" />
  <smtpHost value=".." />
  <bufferSize value="1024" />
  <lossy value="true" />
  <evaluator type="log4net.Core.LevelEvaluator">
     <threshold value="ERROR"/>
  </evaluator>
  <layout type="log4net.Layout.PatternLayout">
     <conversionPattern value="%newline%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
  </layout>
</appender>

我不想通知任何人这个错误消息,因为它真的不那么严重。该消息不是由我自己的代码生成的,而是来自我使用的库。

1 个答案:

答案 0 :(得分:15)

log4net追加

的说明

SocketThreadWorker正在投掷SocketExceptionerror code映射了异常消息“远程主机强行关闭现有连接”。

throw new SocketException(10054);

生成日志语句的代码看起来像一个未处理的异常处理程序(通过打印的消息“Unexpected exception ...”)。但是,对于这个答案,想象它看起来像这样

try
{
    ...
}
catch (Exception e)
{
    _log.Error("Unexpected exception in SocketThreadWorker", e);
}

log4net隐藏的内容是LoggingEvent。它包含提供的日志消息和异常对象(单独)。每个appender都可以决定如何将这两个项目写入最终目的地(以及其他属性,布局参数等)。

StringToMatch过滤器仅适用于日志消息。不在异常消息上!看看下面的代码,我们将构建一个系统和一个可以帮助我们调试问题的测试

繁殖和深潜

这是一个简单的套接字异常抛出类

public class SocketThreadWorker
{
    public void DoWork()
    {
        throw new SocketException(10054);
    }
}

我们将配置log4net以使用带有字符串匹配过滤器的ConsoleAppender,匹配异常消息字符串。

public static class LocalLoggingConfiguration
{
    public static void Configure()
    {
        var filter = new StringMatchFilter
        {
            StringToMatch = "An existing connection was forcibly closed by the remote host",
            AcceptOnMatch = false,
        };

        var appender = new ConsoleAppender
        {
            Layout = new SimpleLayout()
        };

        appender.AddFilter(filter);

        BasicConfigurator.Configure(appender);
    }
}

我们配置log4net,获取记录器,并在测试中进行失败的调用。你会注意到其他级别的一些日志语句和Error的另一个日志语句与我们的过滤器不匹配(如果它有效)。这样,我们就可以确定我们不会意外丢失所有消息。

[TestClass]
public class SocketLibraryTest
{
    private readonly ILog _log = LogManager.GetLogger(typeof(SocketLibraryTest));

    public SocketLibraryTest()
    {
        LocalLoggingConfiguration.Configure();
    }

    [TestMethod]
    public void CatchThatPeskyException()
    {
        _log.Debug("Testing...");

        try
        {
            new SocketThreadWorker().DoWork();
        }
        catch (Exception e)
        {
            _log.Info("An exception!");
            _log.Error("Unexpected exception in SocketThreadWorker", e);
            _log.Error("It wasn't that bad.");
        }
    }
}

在我的环境中,此测试的输出在消息的单独行中包含异常,因为默认情况下,appender会以这种方式打印异常对象。

DEBUG - Testing...  
INFO - An exception!  
ERROR - Unexpected exception in SocketThreadWorker  
System.Net.Sockets.SocketException (0x80004005): An existing connection was forcibly closed by the remote host  
   at SO5894291.SocketThreadWorker.DoWork() in d:\users\anthony.mastrean\documents\Projects\SO5894291\SO5894291\SocketLibraryTest.cs:line 16  
   at SO5894291.SocketLibraryTest.CatchThatPeskyException() in d:\users\anthony.mastrean\documents\Projects\SO5894291\SO5894291\SocketLibraryTest.cs:line 58  
ERROR - It wasn't that bad.

如果修改appender过滤器以匹配不同消息的一部分,您将看到它已正确配置并且确实有效。更改字符串以匹配“测试”,您将看到DEBUG语句从控制台输出中消失!

建议

您不希望在通用日志消息“意外异常...”上匹配。这有机会丢失消息。即使引入记录器匹配过滤器也无济于事,因为该套接字工作者可能并且将抛出其他异常(同样可能丢失消息)。

我能想到的唯一选择是实现自己的ExceptionMessageToMatchFilter。我复制了StringToMatchFilter的实现,替换了异常消息的呈现消息字符串。

public class ExceptionMessageToMatchFilter : StringMatchFilter
{
    public override FilterDecision Decide(LoggingEvent loggingEvent)
    {
        if (loggingEvent == null)
            throw new ArgumentNullException("loggingEvent");

        if (loggingEvent.ExceptionObject == null)
            return FilterDecision.Neutral;

        var exceptionMessage = loggingEvent.GetExceptionString();

        if (m_regexToMatch != null)
        {
            if (!m_regexToMatch.Match(exceptionMessage).Success)
                return FilterDecision.Neutral;

            return m_acceptOnMatch ? FilterDecision.Accept : FilterDecision.Deny;
        }

        if (m_stringToMatch == null || exceptionMessage.IndexOf(m_stringToMatch) == -1)
        {
            return FilterDecision.Neutral;
        }

        return m_acceptOnMatch ? FilterDecision.Accept : FilterDecision.Deny;
    }
}

我会在GetExceptionString()电话周围小心,我不知道它是否可以返回null。或者如果没有消息你想做什么(它是空的吗?你应该返回中立还是继续匹配?)。

在log4net配置中进行操作非常容易(特别是因为它具有匹配过滤器的字符串中的所有属性)。

<filter type="MyNamespace.ExceptionMessageToMatchFilter, MyAssembly">
    <stringToMatch value="An existing connection was forcibly closed by the remote host" />
    <acceptOnMatch value="false" />
</filter>