About

This project is a simple plugin to allow your .NET application to send stack traces to the exception management tool http://getexceptional.com

How To Use It

There is a single .dll (GetExceptional.dll) which you'll need to add to your project. The only line of configuration required will be your API Key for their web service. Add it to the appSettings section of your project (your web.config file if you're using ASP.NET) like so:

<add key="GetExceptionalApiKey" value="YOUR_KEY_HERE" />

Now you can use it in one of two ways. The simplest is to enable it as an http module and it will report every unhandled exception automatically. Just add this line to your web.config file in the "modules" section:

<add name="GetExceptionalModule" type="GetExceptional.GetExceptionalModule"/>

And you're done.

Alternatively, if you don't want it to handle every exception and prefer to send exceptions manually, you can make a function call in your code. The function call is simple:

GetExceptional.Exceptional.ReportException(Exception yourException, HttpRequest yourRequest,  HttpSessionState sess);

The exception will be converted to an XML representation and sent to GetExceptional under your account. This is also done in it's own thread as to not slow your app down due to potential network slowdowns. If you'd prefer the request to be synchronous however (wait for it to finish) you can add a fourth parameter to your call with the boolean flag false. There are variants on this method call, and all parameters can be null aside from the first (Exception) one.

Last edited May 9, 2009 at 7:35 PM by tlianza, version 7