SignalR通过web.config配置日志的异常问题及精细化配置咨询

问题1：文本日志无日期时间信息的解决 #

默认的System.Diagnostics.TextWriterTraceListener不会自动追加时间戳，可通过替换TraceListener实现带时间戳的输出：

• 方案：使用系统自带的DelimitedListTraceListener，通过traceOutputOptions指定输出时间参数，配置示例如下：

<system.diagnostics>
  <sharedListeners>
    <add 
      name="SignalRTextLogger"
      type="System.Diagnostics.DelimitedListTraceListener"
      initializeData="C:\your_log_path\signalr.log"
      delimiter=" "
      traceOutputOptions="DateTime, ThreadId"
    >
      <filter type="System.Diagnostics.EventTypeFilter" initializeData="Information"/>
    </add>
  </sharedListeners>
  <sources>
    <source name="Microsoft.AspNet.SignalR" switchValue="Verbose">
      <listeners>
        <add name="SignalRTextLogger"/>
      </listeners>
    </source>
  </sources>
  <trace autoflush="true"/>
</system.diagnostics>

如果需要自定义日志格式，可自行实现继承TraceListener的类，重写Write/WriteLine方法，手动拼接时间、日志级别、内容等字段。

问题2：事件日志缺少消息描述的解决 #

SignalR没有内置适配Windows事件日志的消息资源文件，默认的EventLogTraceListener会从系统EventLogMessages.dll查找事件ID对应的模板，自然匹配不到SignalR的事件内容，可通过自定义监听器解决：

1. 实现自定义EventLog监听器，代码示例：

using System;
using System.Diagnostics;

namespace YourNamespace
{
    public class SignalREventLogListener : EventLogTraceListener
    {
        public SignalREventLogListener(string eventSource) : base(eventSource) { }

        public override void WriteLine(string message)
        {
            EventLog.WriteEntry(
                source: EventLog.Source,
                message: $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} {message}",
                type: EventLogEntryType.Information
            );
        }

        public override void Write(string message) => WriteLine(message);
    }
}

2. 替换web.config中的监听器配置：

<sharedListeners>
  <add 
    name="SignalREventLogger"
    type="YourNamespace.SignalREventLogListener, YourAssemblyName"
    initializeData="你预先创建的事件源名称"
  >
    <filter type="System.Diagnostics.EventTypeFilter" initializeData="Warning"/>
  </add>
</sharedListeners>

其他精细化配置技巧 #

• 日志粒度控制：调整source节点的switchValue属性，可选值包括Off/Error/Warning/Information/Verbose，生产环境建议设置为Warning或Information减少日志冗余
• 日志滚动：可使用Microsoft.VisualBasic.Logging.FileLogTraceListener，无需引入第三方组件即可实现按时间、文件大小自动切割日志
• 分类输出：可拆分多个source节点，分别绑定不同的监听器，实现连接管理、消息传输、异常等不同类型日志的独立输出

内容的提问来源于stack exchange，提问作者Manfred