如何使用`System.Diags ... Trace`登录详细级别

Question

好的,不要笑.在2005年,我读到了使用System.Diagnostics命名空间的跟踪,它很复杂,我从那时起就使用了log4net和NLog(其他人都是如此).

今天,我的应用程序将托管在Windows Azure网站上,并使用我们的老朋友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.你可以让traceource听取所有级别:

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
  }
}

侦听器可以在许多traceource之间共享,并且它只接收它TraceSwitch级别允许的数据级别.

System.Diagnostics.Trace使用像这样(在一个侦听DefaultTraceListener),其由缺省添加到这两个Debug.Listeners和Trace.Listeners,但是在内部,它的工作原理如I中所述.

这一切看起来有点令人困惑,但它真的很强大,一旦你有一组辅助类...至少我,已经停止使用第三方日志库并在很大程度上使用它.

至于Azure,这是纯粹的猜测,因为我从来没有做过任何Azure,但我想你会在你的app.config(可能是web.config不确定的web)中配置这样的traceource ,为日志添加一个默认的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集合中添加一个