Loupe Agent for .NET Framework

The Loupe Agent provides a generic facility for capturing log messages, exceptions, and metrics from .NET Framework applications. This repository is for the .NET Framework version of the Loupe Agent (for .NET 2.0 through 4.8). If you are using .NET Core or .NET 5 or later, it's recommend you use the Loupe Agent Core family of agents that are based on .NET Standard and .NET 5.

How do I use Loupe with my Application?

To add Loupe to your application we recommend referencing adding the Gibraltar.Agent package. Then you can also add agents for specific .NET Framework extensions that you use like ASP.NET MVC/WebAPI and Entity Framework.

For complete guidance, see Getting Started Guide from the main Loupe documentation for how to get moving.

You can use the free Loupe Desktop viewer to view logs & analyze metrics for your application or use Loupe Cloud-Hosted to add centralized logging, alerting, and error analysis to your application.

What's In This Repository

This is the repository for the Loupe Agent for .NET Framework. The following NuGet packages live here:

• Gibraltar.Agent: The primary API to use for logging & metrics.
• Gibraltar.Agent.EntityFramework: Captures telemetry for EF 6.
• Gibraltar.Agent.Web: Captures telemetry for ASP.NET WebForms applications
• Gibraltar.Agent.Web.Module: Extends ASP.NET applications with an endpoint for collecting client data.
• Gibraltar.Agent.Web.Mvc: Captures telemetry for ASP.NET WebAPI and MVC applications
• Gibraltar.Packager: Console application for moving Loupe data outside of your application.

How To Build These Projects

The various projects can all be built with Visual Studio 2022 by opening src\Agent.sln.

Contributing

Feel free to branch this project and contribute a pull request to the development branch. If your changes are incorporated into the master version they'll be published out to NuGet for everyone to use!