.NET Core 6中如何配置SSH.NET第三方诊断日志？

核心排查与修复步骤 #

1. 全局确认条件编译符号
   确保DEBUG、TRACE、FEATURE_DIAGNOSTICS_TRACESOURCE是项目全局定义的（通过项目属性→生成→条件编译符号添加），而非仅在单个代码文件中定义。SSH.NET的TraceSource日志功能依赖该宏全局生效。

2. 修正TraceSource代码配置
   你的代码存在两处关键问题，调整为以下正确写法：

   // 必须在SSH.NET客户端初始化前执行此配置
   static readonly TraceSource _sshTraceSource = new TraceSource("SshNet.Logging");
   
   // 初始化方法（放在启动逻辑最前面）
   private static void InitSshLogging()
   {
       // 使用枚举设置开关级别，确保与SSH.NET的日志输出级别匹配
       var sourceSwitch = new SourceSwitch("SshNetSwitch", SourceLevels.Verbose.ToString());
       _sshTraceSource.Switch = sourceSwitch;
   
       // 移除默认Listener，避免日志被静默丢弃
       _sshTraceSource.Listeners.Remove("Default");
   
       // 添加控制台Listener并配置输出选项
       var consoleListener = new ConsoleTraceListener();
       consoleListener.TraceOutputOptions = TraceOptions.DateTime | TraceOptions.ThreadId;
       _sshTraceSource.Listeners.Add(consoleListener);
   }
   

   注意：初始化逻辑必须早于SSH.NET客户端的创建，否则日志配置无法生效。

3. 使用.NET Core原生配置替代app.config
   .NET Core不再支持传统app.config中的system.diagnostics节点，改用appsettings.json配置：

   {
     "Logging": {
       "SystemDiagnostics": {
         "Sources": [
           {
             "Name": "SshNet.Logging",
             "SwitchLevel": "Verbose",
             "Listeners": [
               {
                 "Name": "Console"
               }
             ]
           }
         ]
       }
     }
   }
   

   然后在Program.cs中启用System.Diagnostics日志：

   var builder = WebApplication.CreateBuilder(args);
   
   // 配置System.Diagnostics日志
   builder.Host.ConfigureLogging(logging =>
   {
       logging.AddConfiguration(builder.Configuration.GetSection("Logging"));
       logging.AddSystemDiagnostics();
   });
   

   需提前安装NuGet包：Microsoft.Extensions.Logging.SystemDiagnostics

4. 排除第三方日志框架干扰
   如果项目中使用了Serilog、NLog等日志框架，需确保它们配置了对System.Diagnostics TraceSource的捕获。例如Serilog需添加对应Sink并配置相关开关。

验证方法 #

在SSH.NET操作代码前添加测试日志，确认TraceSource是否正常工作：

_sshTraceSource.TraceEvent(TraceEventType.Verbose, 0, "SSH日志初始化完成");

如果控制台能输出这条日志，说明配置生效，再检查SSH.NET的日志输出逻辑是否触发。

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