Overview

We've added support for the System.Diagnostics Debug/Trace functionality. This allows you to leverage your current investment in this, but leverage the power and flexibility that comes with the ReflectInsight viewer. You can view your Debug/Trace messages in realtime, in a rich viewer that allows you to filter out and search for what really matters to you.

.NET Diagnostic Debug/Trace Configuration

1. Download and install the ReflectInsight Viewer. You will need this installed to view your messages from the ReflectInsight Logging Extensions.

Download

2. Download the ReflectInsight Extension Binaries or Source and rebuild if necessary. Alternatively you can use the NuGet package. See below for details on the NuGet package.

NOTE: If you have added the Debug/Trace Extension from the NuGet gallery, then you can skip step #3 as it's already done for you.

3. Once you have the ReflectInsight Extensions, go to your project in Visual Studio and add a reference to ReflectSoftware.Insight.dll.
DebugTrace_Adding_Assembly.png
4. The next step is to configure your app or web configuration file and incorporate the ReflectInsight appender. If you don't already have an App.config or Web.config, add it. Then open the configuration file and add a new ConfigSection as shown here:

<configuration>
  <configSections>    
    <section name="insightSettings" type="ReflectSoftware.Insight.ConfigurationHandler,ReflectSoftware.Insight" />
  </configSections>
</configuration>
5. Now you will need to add the InsightSettings section. You can get started with the following simple configuration:

<configuration>
   <insightSettings>
    <baseSettings>
      <configChange enabled="true"/>      
      <propagateException enabled="false"/>      
      <exceptionEventTracker time="20"/>
      <debugMessageProcess enabled="true" />
    </baseSettings>

    <listenerGroups active="Debug">
      <group name="Debug" enabled="true" maskIdentities="false">
        <destinations>
          <destination name="Viewer" enabled="true" filter="" details="Viewer"/>
        </destinations>
      </group>
    </listenerGroups>
    
    <logManager>      
      <instance name="RITraceListener" category="Trace" />      
    </logManager>    
  </insightSettings>
</configuration>
6. Now you need to configure your system.diagnostics configuration section with a reference to the ReflectInsight Appender. Add the following section to your app/web config file:

<configuration>
  <!--<system.diagnostics>
    <trace>
     <listeners>
      <clear />        
      <add name="Test" type="ReflectSoftware.Insight.RITraceListener, ReflectSoftware.Insight" />
     </listeners>
    </trace>
   </system.diagnostics>-->
  <!-- OR -->
  <system.diagnostics>
    <sources>
      <source name="SourceTrace" switchValue="All">
        <listeners>
          <clear />
          <add name="ReflectInsight.Trace" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="ReflectInsight.Trace" type="ReflectSoftware.Insight.RITraceListener, ReflectSoftware.Insight" />
    </sharedListeners>
  </system.diagnostics>
</configuration>
7. Alternatively you can take a look at the configuration that is included in the samples.

8. That's it, you're done!

NuGet Package

We've created a NuGet package for our Debug/Trace extension. You can find it over on Nuget.

To install ReflectInsight Debug/Trace extension, run the following command in the Package Manager Console.

sshot-323.png

Last edited Jul 22, 2013 at 3:10 AM by RSDeveloper, version 17