Using Loupe with ASP.NET WebForms - Introduction
In This Topic
Because ASP.NET is essentially a set of libraries that runs on top of the .NET runtime, all of the capabilities that make the Loupe Agent work for other .NET applications apply with web applications as well. You can log directly into Loupe, use it with Trace or Debug, or connect it up to your favorite log system. Some parts of the Agent don't apply to service environments like ASP.NET and are automatically disabled to ensure they won't interfere including the Live Viewer, Packager Dialog, and Error Manager Alert Dialog. The entire API of the Agent is designed to be safe and will not attempt to display any user interface when running in ASP.NET.
This section applies to the ASP.NET WebForms engine. If you are developing for ASP.NET MVC 3 or Later and not using the WebForms request pipeline none of these items will be activated and this section will not apply to you. Use the
Loupe Agent for ASP.NET MVC instead
Unique ASP.NET Monitoring Capabilities
Loupe includes an agent for ASP.NET that extends the core agent with additional capabilities that are designed for ASP.NET 2.0 and above. These include:
- Integrated ASP.NET Health Monitoring: The Loupe Agent for ASP.NET implements an ASP.NET Health Event Provider. This lets it capture server events as they happen like sessions starting and ending, authentication, compilation, and unhandled exceptions. All are automatically recorded as they happen, along with specifics of the web site requests that caused them.
- ASP.NET Trace: The custom Trace environment used for ASP.NET is routed into the Agent.
- ASP.NET Performance: Metrics are recorded to complement normal web server information including the performance of each stage of the ASP.NET processing pipeline to make it easy to evaluate how long each page is taking to process and where that time is being used. The same metrics can show you what pages are being hit, how often, and when.
Adding the Loupe Agent for ASP.NET WebForms to your Web Site
Add the Loupe Agent for ASP.NET WebForms from NuGet which will automatically add the Loupe Agent and put a skeleton configuration in your web.config. You will need to then update this configuration with information about your product & application.
For complete information on how to add the Loupe Agent manually, see Developer's Guide for ASP.NET - Adding the Loupe Agent for ASP.NET .
Metrics Captured by the Loupe Agent
For complete information on the metrics captured by the Loupe Agent for ASP.NET including what data they capture and how to view them see
Using Loupe with ASP.NET - Page Hit Metric .
Optimizing your Loupe Experience for ASP.NET WebForms
Because ASP.NET is an environment that sits on top of .NET, there are some things to understand to get the most out of Loupe. See
Using Loupe with ASP.NET - Optimizing your Experience for more information.
Because the Loupe Agent for ASP.NET WebForms is written on top of the Loupe Agent, everything it does can be done by your own code as well. You can extend its metrics to fit your situation more precisely. It is intended to provide a quick start to get you going with using Loupe and ASP.NET WebForms.
See Also
ASP.NET
Developer's Guide