Integrating ELMAH with Umbraco | Lee Kelleher

Update: For the latest details on how to integrate ELMAH with Umbraco, please read the article over on the Our Umbraco wiki.

I have a few Umbraco projects that have a lot of custom .NET code, mostly in they are in the form of user-controls and XSLT extensions. As far as I’m aware Umbraco doesn’t have an extendable mechanism for exception handling and sending out notification emails, (there is the umbraco.BusinessLogic.Log, which writes to the umbracoLog table in the database, but that’s all).

Initially I looked at Tim Gaunt’s Advanced Error Reporting – a great drop-in solution that does exactly what it says on the tin! Whilst reading the comments on Tim’s blog, Simon Dingley reminded me of the ELMAH project – which has been one of those web-applications that you keep meaning to try out, but never get around to.

What is ELMAH?

ELMAH (Error Logging Modules and Handlers) is an application-wide error logging facility that is completely pluggable. It can be dynamically added to a running ASP.NET web application, or even all ASP.NET web applications on a machine, without any need for re-compilation or re-deployment.

So I decided to see how nicely it plays with Umbraco… the result, it plays very nicely indeed.

If you are interested, here’s how…

Download the latest ELMAH binary release (1.0 Beta 3 at the time of writing [direct link]) from the Google Code project page. (http://code.google.com/p/elmah/)
Extract the files from the ZIP.
Select the DLLs from the “/bin/” folder, for Umbraco you’ll be using the DLL from “/bin/net-2.0/Release/“. For the benefit of this post, I decided to use the SQLite option to store the error logs in a database. I could easily have used the SQL Server or VistaDB options.
Drop the DLLs into the “/bin/” folder of your Umbraco installation.
Open the web.config of your Umbracoo installation and add the following lines:

Add the following to your <configSections> section:

<sectionGroup name="elmah">
	<section name="security" requirePermission="false" type="Elmah.SecuritySectionHandler, Elmah"/>
	<section name="errorLog" requirePermission="false" type="Elmah.ErrorLogSectionHandler, Elmah"/>
	<section name="errorMail" requirePermission="false" type="Elmah.ErrorMailSectionHandler, Elmah"/>
	<section name="errorFilter" requirePermission="false" type="Elmah.ErrorFilterSectionHandler, Elmah"/>
</sectionGroup>

Add the following just after the </configSections> section:

<elmah>
	<security allowRemoteAccess="yes" />
	<errorLog type="Elmah.SQLiteErrorLog, Elmah" connectionStringName="ELMAH.SQLite" />
	<errorMail from="no-reply@domain.com" to="webmaster@domain.com" />
</elmah>

Add the following to your <connectionStrings> section, (if you have one, otherwise create one):

<add name="ELMAH.SQLite" connectionString="Data Source=~/data/errors.s3db"/>

In the <httpModules> section, add this:

<add name="ErrorMail" type="Elmah.ErrorMailModule, Elmah"/>
<add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah"/>
<add name="ErrorFilter" type="Elmah.ErrorFilterModule, Elmah"/>

… and finally, in the <httpHandlers> section, add this:

<add verb="POST,GET,HEAD" path="elmah.axd" type="Elmah.ErrorLogPageFactory, Elmah"/>

If you run into any trouble, there is a more detailed guide on Setting Up ELMAH from DotNetSlackers.

By now you should have ELMAH up and running. Open up your web-browser and go to http://localhost/elmah.axd, (obviously replace “localhost” with whatever your hostname is). You should see the ELMAH Error Log page. Since this is open to the public, you may want to secure it, see the Securing Error Log Pages article for further details.

The last part is to integrate the ELMAH Error Log page into the Umbraco back-end. I created a new user-control in the “/usercontrols/” folder called “ELMAH.ascx”, using the following HTML:

<%@ Control Language="C#" %>
<iframe height="98%" width="100%" scrolling="auto" src="elmah.axd" style="margin-top:5px;"></iframe>

Then in the “/config/Dashboard.config” configuration file, I added a new section for the developer area.

<section>
	<areas>
		<area>developer</area>
	</areas>
	<tab caption="Error Logging Modules and Handlers for ASP.NET">
		<control>/usercontrols/ELMAH.ascx</control>
	</tab>
</section>

Now in the Umbraco back-end the developer area looks like this.

I have been very impressed with how well ELMAH functions. Aside from the essential email notifications, the RSS feeds are a great bonus!

23 thoughts on “Integrating ELMAH with Umbraco”

Nice article. Thanks for sharing!

Great article Lee,

Now I should try that out as well, having a bunch of .net controls as well…

Thanks for sharing.
/Dirk

This is great,

Far more easy to integrate as a Log4Net or other framework. And you can actually see the error reports. Great thanks for sharing.

Richard

Works great, small issue when installing on x64 server. Needs other SQLLite assembly

Great stuff Lee, worked a treat for me.

Nice one Lee! I tried this after seeing your tweet the other week and it worked great. I had to update the path to include a leading slash, i.e. “/elmah.axd” instead of “elmah.axd”. I used SQL Server too, and to change the compatibility level I needed to use the stored procedure (rather than the command included in the instructions on the Elmah site):
EXEC sp_dbcmptlevel MY_DATABASE, 80;

It runs like a dream and you can flag your own error messages to it for debugging – I’ll definitely be using this for every site from now on. Thanks for the tip on the user control for Umbraco’s admin back-end – I hadn’t thought of that bit!

David

Pingback: Integrating log4net into Umbraco site. « Ismail’s umbraco adventures

Lee,

Just found this about sending elmah logs via Gmail http://scottonwriting.net/sowblog/posts/13845.aspx could be of interest.

Regards

Ismail

Superb!! It works like a charm.

Hello Everybody,

I was just curious if any body has tried integrating ELMAH with MySql, i am trying for the implementation but stuck at the moment.

Hi Rajiv,

Thanks for your comment, I see that you have been liaising with Atif (the core ELMAH developer) about it – that’s probably your best bet.

http://groups.google.com/group/elmah/browse_thread/thread/33d2597ad0fd15cd

A MySQL provider should be straight-forward to implement. To be honest, I’m quite surprised that it has not been done already!

If you still need help, feel free to contact me via the form on my website:
http://leekelleher.com/contact/

Cheers,
- Lee

Thanks for sharing, works perfect with umbraco (using the MS SQL edition)

Pingback: MySql data-source support for ELMAH « Lee Kelleher’s Weblog

Excellent thanks.
I made this tweak to get the iframe filling the panel.

Thanks Murray, I’ve been meaning to get around to posting a fix for it in Umbraco v4.

(I combined your 2 comments into 1 btw)

I’ve been working on tighter ELMAH integration in my sparse [sic] time – building it as a custom appTree.

Hi Lee,
did you try securing elmah?
I have a problem with it, in that umbraco does not seem to login using standard .net authorization ‘roles’.

Here’s the bit of the web.config that’s not working: (this denies access to everyone)

Or do I have the role name wrong?
Cheers.
Murray.

Hi Murray, I haven’t tried to set ELMAH up for remote access for a specific user group/role.

You could try the ELMAH support group forum? See if they have any ideas?
http://groups.google.com/group/elmah

I recently was trying to get Elmah into one of my projects, but it was just not recording anything at all.

Turns out, that when you’re running on an asp.net 3.5 config (as opposed to 2.0), you need to add some more keys:

In system.webServermodules, add:

And in system.webServerhandlers, add:

And, since that didn’t work.. you can read all about it in this forum post

http://our.umbraco.org/forum/developers/extending-umbraco/6105-How-to-use-ELMAH-as-a-user-control-in-umbraco?p=0#comment22034

Lee,

Just come across this again and realised I used this in a project I (and later you too!) worked on. Thanks for the info!

Rob

Hey Lee,

Thanks for the great post. However, I should say that it would be better to follow the instructions at http://our.umbraco.org/wiki/how-tos/use-elmah-with-umbraco because there is some code missing in your blog for some reason. There’s also a section that needs to be added when using the .NET 3.5 version. I can also confirm that the instructions work for Umbraco 4.5.1.

Hi David, thanks for your comments.

Yeah, I wrote this blog post about 18-months ago, when I was still using Umbraco v3 and .NET 2.0.

I’ll add a message onto the Our Umbraco wiki page – which originally was based on this blog post!

Cheers,
- Lee

Pingback: Umbraco, ELMAH, MADAM and authentication | kipusoep's tech blog

Kenneth Solberg on April 24, 2009 at 06:58 said:

Nice article. Thanks for sharing!
Dirk on April 24, 2009 at 07:58 said:

Great article Lee,

Now I should try that out as well, having a bunch of .net controls as well…

Thanks for sharing.
/Dirk
Richard on April 24, 2009 at 08:38 said:

This is great,

Far more easy to integrate as a Log4Net or other framework. And you can actually see the error reports. Great thanks for sharing.

Richard
Tim Geyssens on April 24, 2009 at 15:26 said:

Works great, small issue when installing on x64 server. Needs other SQLLite assembly
Simon Dingley on April 28, 2009 at 14:40 said:

Great stuff Lee, worked a treat for me.
David Conlisk on May 8, 2009 at 13:42 said:

Nice one Lee! I tried this after seeing your tweet the other week and it worked great. I had to update the path to include a leading slash, i.e. “/elmah.axd” instead of “elmah.axd”. I used SQL Server too, and to change the compatibility level I needed to use the stored procedure (rather than the command included in the instructions on the Elmah site):
EXEC sp_dbcmptlevel MY_DATABASE, 80;

It runs like a dream and you can flag your own error messages to it for debugging – I’ll definitely be using this for every site from now on. Thanks for the tip on the user control for Umbraco’s admin back-end – I hadn’t thought of that bit!

David
Pingback: Integrating log4net into Umbraco site. « Ismail’s umbraco adventures
ismailmayat on May 22, 2009 at 15:36 said:

Lee,

Just found this about sending elmah logs via Gmail http://scottonwriting.net/sowblog/posts/13845.aspx could be of interest.

Regards

Ismail
Mario Allegro on May 25, 2009 at 09:52 said:

Superb!! It works like a charm.
Rajiv on June 8, 2009 at 04:06 said:

Hello Everybody,

I was just curious if any body has tried integrating ELMAH with MySql, i am trying for the implementation but stuck at the moment.
Lee Kelleher on June 8, 2009 at 05:17 said:

Hi Rajiv,

Thanks for your comment, I see that you have been liaising with Atif (the core ELMAH developer) about it – that’s probably your best bet.

http://groups.google.com/group/elmah/browse_thread/thread/33d2597ad0fd15cd

A MySQL provider should be straight-forward to implement. To be honest, I’m quite surprised that it has not been done already!

If you still need help, feel free to contact me via the form on my website:
http://leekelleher.com/contact/

Cheers,
- Lee
Christian Palm on June 11, 2009 at 13:48 said:

Thanks for sharing, works perfect with umbraco (using the MS SQL edition)
Pingback: MySql data-source support for ELMAH « Lee Kelleher’s Weblog
Murray on September 2, 2009 at 22:54 said:

Excellent thanks.
I made this tweak to get the iframe filling the panel.

<style>
.tabpageContent{height:100%;}
#elmahFrame{border:0;}
</style>
<iframe height=”98%” width=”100%” scrolling=”auto” src=”elmah.axd” style=”margin-top:5px;” id=”elmahFrame”></iframe>
Lee Kelleher on September 2, 2009 at 23:02 said:

Thanks Murray, I’ve been meaning to get around to posting a fix for it in Umbraco v4.

(I combined your 2 comments into 1 btw)

I’ve been working on tighter ELMAH integration in my sparse [sic] time – building it as a custom appTree.
Murray on September 17, 2009 at 03:56 said:

Hi Lee,
did you try securing elmah?
I have a problem with it, in that umbraco does not seem to login using standard .net authorization ‘roles’.

Here’s the bit of the web.config that’s not working: (this denies access to everyone)

<location path=”elmah.axd”>
<system.web>
<authorization>
<allow roles=”Administrators”/>
<deny users=”*” />
</authorization>
</system.web>
</location>

Or do I have the role name wrong?
Cheers.
Murray.
Lee Kelleher on September 17, 2009 at 08:11 said:

Hi Murray, I haven’t tried to set ELMAH up for remote access for a specific user group/role.

You could try the ELMAH support group forum? See if they have any ideas?
http://groups.google.com/group/elmah
Sebastiaan Janssen on December 29, 2009 at 14:03 said:

I recently was trying to get Elmah into one of my projects, but it was just not recording anything at all.

Turns out, that when you’re running on an asp.net 3.5 config (as opposed to 2.0), you need to add some more keys:

In system.webServermodules, add:

And in system.webServerhandlers, add:
Sebastiaan Janssen on December 29, 2009 at 14:07 said:

And, since that didn’t work.. you can read all about it in this forum post

http://our.umbraco.org/forum/developers/extending-umbraco/6105-How-to-use-ELMAH-as-a-user-control-in-umbraco?p=0#comment22034
Rob Stevenson-Leggett on December 30, 2009 at 00:44 said:

Lee,

Just come across this again and realised I used this in a project I (and later you too!) worked on. Thanks for the info!

Rob
davidsiew on August 1, 2010 at 13:12 said:

Hey Lee,

Thanks for the great post. However, I should say that it would be better to follow the instructions at http://our.umbraco.org/wiki/how-tos/use-elmah-with-umbraco because there is some code missing in your blog for some reason. There’s also a section that needs to be added when using the .NET 3.5 version. I can also confirm that the instructions work for Umbraco 4.5.1.
Lee Kelleher on August 1, 2010 at 13:39 said:

Hi David, thanks for your comments.

Yeah, I wrote this blog post about 18-months ago, when I was still using Umbraco v3 and .NET 2.0.

I’ll add a message onto the Our Umbraco wiki page – which originally was based on this blog post!

Cheers,
- Lee
Pingback: Umbraco, ELMAH, MADAM and authentication | kipusoep's tech blog