Add Loupe to Your Project

Start by adding the Gibraltar Loupe Agent NuGet package

Enable Exception Logging

Add a couple lines to your App class and Loupe will log all unhandled exceptions. 

using System.Windows;
using Gibraltar.Agent;
public partial class App : Application
    public App() {
        DispatcherUnhandledException += (sender, e) => {
                Log.ReportException(e.Exception, "Unhandled", true, false);
                e.Handled = true;

    protected override void OnStartup(StartupEventArgs e) {

    protected override void OnExit(ExitEventArgs e) {


Log.ReportException also displays a dialog to the user. If you prefer to silently log exceptions, use Log.RecordException instead.

Add Loupe Server for Exception Reporting

Add a couple more lines and Loupe Server will centralize log collection, analysis and error management. 

<?xml version="1.0"?>
        <sectionGroup name="gibraltar">
            <section name="server"
                     type="Gibraltar.Agent.ServerElement, Gibraltar.Agent" />
        <server autoSendSessions="true"
                customerName="YOUR LOUPE SERVICE ACCOUNT" />
        <!-- If you have an on-premises Loupe Server, use this instead:
        <server autoSendSessions="true"
                server="YOUR LOUPE SERVER" /> -->

Or you can configure server integration in code

protected override void OnStart(string[] args)
    Log.Initializing += Log_Initializing;
    // ...

private void Log_Initializing(object sender, LogInitializingEventArgs e)
    var server = e.Configuration.Server;
    server.AutoSendSessions = true;

    server.UseGibraltarService = true; // Using subscription Loupe Service
    server.CustomerName = &quot;YOUR LOUPE SERVICE ACCOUNT&quot;;

    // server.UseGibraltarService = false; // Using on-premises Loupe Server
    // server.Server = &quot;YOUR LOUPE SERVER&quot;;

Ship our Packager Utility along with your application so sessions will be automatically transmitted in the background immediately after your application exits. 

That was easy! What's Next?

With just these few steps you're now collecting crucial details on every error, recording performance  metrics and logging every trace message your program emits. 

Learn more about Loupe in our Developers Guide.