c# - 如何使用 `System.Diags...Trace` 以详细级别登录

Question

好了别笑了。 2005 年，我读到有关使用 System.Diagnostics 命名空间进行跟踪的信息，它很复杂，从那以后我就一直使用 log4net 和 NLog(其他人也是如此)。

今天，我的应用程序将托管在 Windows Azure 网站上，并使用我们的老 friend Trace。

http://azure.microsoft.com/en-gb/documentation/articles/web-sites-enable-diagnostic-log/

自鸣得意，我总是使用抽象，IoC，所以我只是在写一个新的小垫片来使用 Trace 但它只有 TraceInformation，TraceWarning 和 TraceError。

有一些 Write* 方法，但我不知道它们会在哪里结束以及在什么情况下结束。糟糕的 API。 [堵嘴]

哪种方法适用于详细/调试级别？

编辑:从标题中删除了“Easy one”。显然不是。

Answer 1

您描述的是 System.Diagnostics.Trace类，它确实有一些简单的方法来写入诊断跟踪输出。

这远不是 .NET 中跟踪诊断的强大

进行跟踪的最好方法是创建一个 TraceSource .在 TraceSource类有一个 Switch依次具有 Level 的属性您可以在其中定义特定 TraceSource 所需的冗长级别的属性.您可以让该跟踪源监听所有级别:

var ts = new TraceSource("My Verbose Debugger") {Switch = {Level = SourceLevels.All}};

然后要追踪某些东西，您可以追踪到那个来源，您可以在其中指定级别，如下所示:

ts.TraceData(TraceEventType.Verbose, 0, dataToBeTraced);

0是跟踪的 ID，dataToBeTraced是一个包含您要跟踪的特定数据的对象(它是一个 params [] object 参数，因此您可以根据需要传入多个对象)。

现在如何使用这些数据？使用 TraceListener你添加到你的 TraceSource的 Listeners收藏。您创建自己的类派生自 TraceListener并覆盖 TraceData方法，像这样:

class MyTraceListener : TraceListener
{
  public override void TraceData(TraceEventCache eventCache, string source, TraceEventType eventType, int id, params object[] data)
  {
    base.TraceData(eventCache, source, eventType, id, data);
    // do what you want with the objects in the "data" parameter
  }
}

监听器可以在多个跟踪源之间共享，它只会接收 TraceSwitch 级别的数据。水平允许。

System.Diagnostics.Trace使用像这样的监听器(DefaultTraceListener)，它默认添加到 Debug.Listeners和 Trace.Listeners ，但在内部，它按照我描述的那样工作。

这一切一开始可能看起来有点困惑，但它真的很强大，一旦你有了一组帮助类......至少我已经停止使用第三方日志库并在很大程度上使用它。

至于 Azure，这纯粹是猜测，因为我从未使用过任何 Azure，但我猜你会在你的 app.config 中像这样配置你的跟踪源。 (也许 web.config ？不确定网络)，为日志添加默认的 azure 监听器:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <sharedListeners>
       <add name="AzureListener" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener, Microsoft.WindowsAzure.Diagnostics, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
           <filter type="" />
       </add>
    </sharedListeners>        
    <sources>
      <source name="MyTraceSource" switchValue="Verbose" >
         <listeners>
            <add name="AzureListener" />
         </listeners>
      </source>
   </sources>
 </system.diagnostics>
</configuration>

"MyTraceSource"是你给你的字符串名称 TraceSource在通过代码执行此操作时在构造函数中。

或者您可以只创建一个 TraceSource在上面的代码中，添加一个 Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener到它的Listeners收藏