Build status NuGet Samples

Logging to from Umbraco

Since Umbraco itself is written in ASP.NET, ELMAH works like a dream inside Umbraco. Besides logging uncaught errors, also supports other types of messages like information and debug. In fact, all the log levels that you already know from log4net, NLog and Serilog, are supported on as well. Logging in Umbraco CMS is based on Serilog, which also support. We have brought all these pieces together into a NuGet package that we call: Elmah.Io.Umbraco.

To start utilizing from your Umbraco site, all you need to do is install the Elmah.Io.Umbraco package:

Install-Package Elmah.Io.Umbraco

During the installation, you will be asked for your API key (Where is my API key?) and log ID (Where is my log ID?).

Hit F5 and watch messages start flowing into

Umbraco Cloud

When using Umbraco Cloud, you may not have a local clone of the source code. To install on Umbraco cloud, execute the following steps:

Install-Package Elmah.Io.Umbraco
  • Commit and push all changes to the git respository. This will add logging to your remote Umbraco Cloud project.

In case you want logging to different logs from each Umbraco Cloud environment, please check out Umbraco's support for config transformations here: Config transforms.

What's inside?

The Elmah.Io.Umbraco package basically installs and configures three things:

  • The Serilog sink (Warning and above)
  • An Umbraco content finder for logging 404's
  • ELMAH with as error log

All unhandled exceptions from both ASP.NET / MVC / Web API as well as 404's are logged automatically. Warnings, errors and fatal messages logged through Serilog are send to as well.


If you are running on the default Umbraco template, all nessecary configuration is added during installation of the Elmah.Io.Umbraco NuGet package. If your web.config file for some reason aren't updated during installation, you can configure manually: Configure manually. Likewise, the installer configure the sink for Serilog in your config\serilog.user.config file.

Umbraco 7

We still support Umbraco 7 through Elmah.Io.Umbraco 3.2.35:

Install-Package Elmah.Io.Umbraco -Version 3.2.35

New features will be added to the updated package for Umbraco 8 only.

This article was brought to you by the team. is the best error management system for .NET web applications. We monitor your website, alert you when errors start happening and help you fix errors fast.

See how we can help you monitor your website for crashes Monitor your website