Developer's Guide for ASP.NET - 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 refers to ASP.NET WebForms. If you're using ASP.NET MVC, see Using Loupe with ASP.NET MVC - Introduction.

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 to your Web Site

The easiest way to add the Loupe Agent is via NuGet which can update your web site project or completed ASP.NET web site. 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

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.

You should also check out Third Party Integration - Using PostSharp with Loupe for information on how you can add metrics and tracing to your application in minutes by combining Loupe with the free PostSharp tool.

Because the Loupe Agent for ASP.NET 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.

Send Feedback