Developer's Guide for ASP.NET - Adding the Loupe Agent for ASP.NET

In This Topic

The Loupe Agent for ASP.NET (Gibraltar.Agent.Web.dll) extends the Loupe Agent to offer some out of the box monitoring and metric capability for ASP.NET applications. To do this, it has to be integrated with your ASP.NET web site as both a Health Monitor and an HTTP Module. This is done by editing your web.config file and either adding a reference to Gibraltar.Agent.Web or placing it and the Gibraltar.Agent into the Bin directory of your web site.

All of this is done automatically for you by the Configuration Wizard which is the easiest way to get this configuration information added correctly and safely to your web.config. It will make a backup of the configuration file when it changes it so you can easily undo your changes if there is a problem.

Web.Config changes to fully enable the Loupe Agent for ASP.NET	Copy Code
<?xml version="1.0"?> <!-- Your configuration file will have many more entries than this example has. It is intended just to highlight the Loupe-specific entries.--> <configuration> <system.web> <!-- If you want to enable verbose tracing, uncomment the line below which will also route it to the Loupe Agent --> <!-- <trace enabled="true" requestLimit="40" localOnly="false" writeToDiagnosticsTrace="true"/> --> <!-- IIS 6 ONLY! Add the following to your httpModules section to enable the request tracking module which does the Page Hit metric --> <!-- <httpModules> <add name="RequestTrackingModule" type="Gibraltar.Agent.Web.RequestTrackingModule, Gibraltar.Agent.Web"/> </httpModules> --> <!-- Add the following section to enable the health monitoring of the Loupe Agent --> <healthMonitoring enabled="true" heartbeatInterval="0"> <profiles> <add name="GibraltarProfile" minInstances="1" maxLimit="Infinite" minInterval="00:00:00"/> </profiles> <providers> <add name="Loupe" type="Gibraltar.Agent.Web.GibraltarEventProvider, Gibraltar.Agent.Web"/> </providers> <rules> <add name="Loupe Event Provider" eventName="All Events" provider="Loupe" profile="GibraltarProfile"/> </rules> </healthMonitoring> </system.web> <!-- The system.webServer section is required for running ASP.NET AJAX under Internet Information Services 7.0. It is not necessary for previous version of IIS. --> <system.webServer> <!-- Add the following to your modules section to enable the request tracking module which does the Page Hit metric --> <modules> <add name="RequestTrackingModule" type="Gibraltar.Agent.Web.RequestTrackingModule, Gibraltar.Agent.Web"/> </modules> </system.webServer> </configuration>

Web.Config changes to fully enable the Loupe Agent for ASP.NET

Copy Code

<?xml version="1.0"?>
<!-- Your configuration file will have many more entries than this example has.
     It is intended just to highlight the Loupe-specific entries.-->
<configuration>
  <system.web>
<!-- If you want to enable verbose tracing, uncomment the line below which will also route it to the Loupe Agent -->
    <!-- <trace enabled="true" requestLimit="40" localOnly="false" writeToDiagnosticsTrace="true"/> -->
<!-- IIS 6 ONLY! Add the following to your httpModules section to enable the request tracking module which does the Page Hit metric -->
<!--     <httpModules>
      <add name="RequestTrackingModule" type="Gibraltar.Agent.Web.RequestTrackingModule, Gibraltar.Agent.Web"/>
    </httpModules> -->
<!--  Add the following section to enable the health monitoring of the Loupe Agent -->
    <healthMonitoring enabled="true" heartbeatInterval="0">
      <profiles>
        <add name="GibraltarProfile" minInstances="1" maxLimit="Infinite" minInterval="00:00:00"/>
      </profiles>
      <providers>
        <add name="Loupe" type="Gibraltar.Agent.Web.GibraltarEventProvider, Gibraltar.Agent.Web"/>
      </providers>
      <rules>
        <add name="Loupe Event Provider" eventName="All Events" provider="Loupe" profile="GibraltarProfile"/>
      </rules>
    </healthMonitoring>
  </system.web>
  <!-- The system.webServer section is required for running ASP.NET AJAX under Internet
        Information Services 7.0.  It is not necessary for previous version of IIS. -->
  <system.webServer>
<!-- Add the following to your modules section to enable the request tracking module which does the Page Hit metric -->
    <modules>
      <add name="RequestTrackingModule" type="Gibraltar.Agent.Web.RequestTrackingModule, Gibraltar.Agent.Web"/>
    </modules>
  </system.webServer>
</configuration>

Developer's Guide

Developer's Guide - Agent Configuration

Developer's Guide - Agent Configuration through Configuration Files

Send Feedback