Glimpse for Elmah – Best of both worlds
The article below is a bit out of date, it's not a good representation of Glimpse's current capabilities and how Glimpse currently looks. Basically all you need to do to get this plugin up and running is installing it in your web application.
After installing the plugin, you should get a tab called 'Elmah' in your Glimpse UI. The tab will remain disabled it there's nothing to show.
The rest of this article gives more background information on how Glimpse and Elmah work and how you can configure both libraries to fit your needs.
We all know Elmah right? It’s one of the top packages in NuGet. For those who don’t really know or use Elmah, I’ll give a brief explanation of the functionality it provides and how you can use it in your application.
Elmah stands for Error Logging Modules and Handlers. It’s an application-wide error logging library which logs nearly all unhandled exceptions. It provides you with a web page which enables you to (remotely) view the log of recorded exceptions. This log doesn’t only contain the error message; it also includes the entire stack trace and the values of all server variables at the time of the error.
Using Elmah with ASP.NET MVC
Since we have NuGet, setting up Elmah with an ASP.NET MVC application has become really easy. Right click your web application and select ‘Add Library Package Reference…’ to pop up the NuGet Package Manager. Search for Elmah and install it. After installing, Elmah will have been added as a project reference.
The next step is to configure Elmah. I won’t go into too much detail here. We’ll just set up Elmah to log all errors to an in-memory repository and to expose those errors through a web page. First let’s add the following code to the node to make Elmah read it’s configuration from your web.config.
<sectionGroup name="elmah"> <section name="errorLog" requirePermission="false" type="Elmah.ErrorLogSectionHandler, Elmah" /> </sectionGroup>
Elmah allows you to log errors to several storages. They currently support Microsoft SQL Server, Oracle, SQLite, Access, XML files, in-memory, SQL CE, MySQL and PostgreSQL. Insert the code below in your web.config to log error to an in-memory storage. When using an in-memory repository, all errors that got recorded will vanish when the application restarts.
<elmah> <errorLog type="Elmah.MemoryErrorLog, Elmah" /> </elmah>
We still have to do two things to get everything up and running:
- Make Elmah catch and log all unhandled exceptions
- Expose a web page to allow the user to view everything that got caught by Elmah
To achieve this we have to add an HTTP module and an HTTP handler. The module is responsible for logging the exceptions while the HTTP handler will render a page with a list of errors. You’ll have to add these sections to both the <system.web> node and the <system.webServer> node in order to support IIS running in Classic mode as well as Integrated mode. More info in this can be found on MSDN – How to: Register HTPP Handlers.
<system.web> <httpHandlers> <add type="Elmah.ErrorLogPageFactory, Elmah" path="elmah.axd" verb="POST,GET,HEAD" /> </httpHandlers> <httpModules> <add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah"/> </httpModules> </system.web> <system.webServer> <modules runAllManagedModulesForAllRequests="true"> <add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah"/> </modules> <handlers> <add name="Elmah" type="Elmah.ErrorLogPageFactory, Elmah" path="elmah.axd" preCondition="integratedMode" verb="POST,GET,HEAD" /> </handlers> </system.webServer>
Let’s take a closer look at the registration of the HTTP handler. We specified a path ‘elmah.axd’, this means that the handler will only kick in when we browse to that specific path. So, let’s launch our application and take a look. If I browse to http://localhost/elmah.axd I get this:
And oh, it even gets better. Lets click on the ‘details’ link next to the error message. This is where the magic happens:
This is really neat; we get a ton of information on what was going on when the error was thrown. If an application error occurred we can almost immediately pin-point the problem. Obviously you don’t want to give access to this log to everyone that visits your website, as user might be able to spot vital problems in your code and exploit them. You can prevent access to this log in various ways (no remote access, through ASP.NET authorization …). More info on this topic can be found here: Elmah: Securing Error Log Pages.
Currently Glimpse can only be used within web applications that target .NET 4.0; however the Glimpse team is currently working on a build that supports.NET 3.5 as well. As a matter of fact, Glimpse is not just a .NET only tool; currently it only works with ASP.NET MVC and Web Forms but eventually it will support Ruby on Rails, PHP and others.
For ASP.NET MVC 3 it currently already has a bunch of nice features, like:
- Ajax call tracing
- Route debugging
- Request inspection
- Server variables inspection
- Session inspection
- .NET Tracing (no more need for the trace.axd)
Using Glimpse with ASP.NET MVC
Integrating Glimpse with ASP.NET MVC is very easy. It’s available as a NuGet package so installing it literally takes about 30 seconds. Let’s have a look … Right click your web application and select ‘Add Library Package Reference…’ to pop up the NuGet Package Manager. Search for Glimpse and install it:
The Glimpse NuGet package will automatically reference the right assembly and it will add a configuration section to your web.config. The only thing you have to do to get it up and running is the following:
- Launch your application
- Browse to: http://localhost/glimpse.axd
- Click ‘Turn Glimpse On’.
- Go back to you application, you should now see something like this:
What these Glimpse guys developed is really mind blowing. Currently Glimpse is still beta, but in my opinion it’s stable enough to integrate with all of your current ASP.NET projects.
!! Elmah for Glimpse - Best of both worlds Scott Hanselman, unofficially titled the funniest guy at Microsoft, recently featured Glimpse as ‘NuGet Package of the Week’. At the end of the article he says:
‘Glimpse, along with ELMAH, is officially my favorite add-on to ASP.NET MVC. I'll be using it every day and I recommend you do as well.’
So … wouldn’t it be cool to integrate Elmah with Glimpse?
Glimpse has a really neat plugin system. The best of all is that writing a Glimpse plugin is really easy. All you have to do is:
- Implement the ITab interface
- Or inherit from the TabBase class, which already implements the ITab interface
The ITab interface has the following methods:
- A getter for the Name of the plugin: this property will be used as the name of the tab in the Glimpse user interface.
- GetData method: accepts an HttpApplication parameter and returns an object. The object you return will be serialized into JSON, sent to the client and rendered by the Glimpse UI. How it will be rendered depends on the kind of object you return. More details about this can be found on the Glimpse Protocol page.
The GetData method is the place where you should make any decisions about what should be rendered and how you want to render it. If this method returns null, then your tab will be disabled in the Glimpse UI.
The Elmah plugin for Glimpse is available as a NuGet package. To install the package, right click your web application and select ‘Add Library Package Reference …’ search for either ‘Glimpse’, ‘Elmah’ or ‘Glimpse.Elmah’ and the Package Manager will come up with the ‘Elmah plugin for Glimpse’.
The package has dependencies to Glimpse and Elmah, so if you haven’t got these package installed yet then NuGet will get them automatically as well. If you didn’t have Elmah before, you might still have to configure it.
Let’s run our application again and see what happens. Our Elmah plugin has been added as a reference to the project so it will be discovered by the Glimpse plugin system. Glimpse will load it into its UI and voila, there we have it:
If there's any feature you would like to see implemented, you can always submit a feature request. If you want to implement a feature yourself, you can fork the project and submit a pull request.
11/09/2011 - 0.9.7.0
- Updated to version 0.86 of Glimpse
- Use build-in paging support of Glimpse
- Removed the client helper
10/23/2011 - 0.9.6.0
- Fixed bug when parsing an invalid guid
- Updated to version 0.85 of Glimpse
- Change the way the client pager script is included
07/24/2011 - 0.9.5.0
- Updated to version 0.84 of Glimpse
07/22/2011 - 0.9.4.0
- Updated to version 0.83 of Glimpse
- Errors are now sorted by descending date
06/05/2011 - 0.9.3.0
- Implemented the IProvideGlimpseHelp interface
- Changed default page size to 10
- Fixed bug in pager script
06/03/2011 - 0.9.2.0
- Updated to version 0.82 of Glimpse
- Updated to version 188.8.131.52 of Elmah
05/31/2011 - 0.9.1.0
- Added details link
- Added pager
05/18/2011 - 0.9.0.0
- Initial version