Логирование ошибок в ASP.NET с помощью elmah

Чем дольше пользуюсь NuGet, тем больше интересных вещей с его нахожу. Одной из таких библиотек является elmah. Простота установки, особенно с использованием NuGet, и широкие возможности настройки подойдут к практически любому проекту. Я сам для этого раньше предпочитал использовать Logging модуль из Microsoft Enterprice Library, но сейчас понял что есть более гибкие и современные решения.

Elmah создан специально для того, чтобы логировать ошибки в ASP.NET приложениях.

Среди его функций есть такие:

  • логирование ошибок в различные БД (MS Sql, Oracle, PostgreSQL, SQLite и др.);
  • экспорт логов в формат CSV для последующего анализа;
  • создание RSS-фида для получения информации о новых ошибках;
  • отправление сообщений о новых исключениях прямо в ваш twitter!

Отдельно хочу сказать о логировании ошибок, которые произошли в момент обновления UpdatePanel - иногда это бывает очень полезно.

Если вы всё ещё по каким-то причинам не используете NuGet, то для вас установка будет происходить следующим способом:

  • скачать сборку Elmah.dll (всего 156KB);
  • добавить в ваш веб-проект reference на elmah;
  • последний и самый сложный пункт - внести необходимые изменения в web.config.

Так как elmah работает как обычный web handler, то проблем с ним быть никаких не должно.

По умолчанию, вся информация об ошибках хранится в памяти, а это значит что данные будут храниться пока вы не перезапустите ваш веб-сервер.

Для того, чтобы посмотреть последние логи, необходимо открыть следующий URL: http://localhost:8090/elmah.axd. В качестве тестового приложения я создал новый Web Application и посмотрел на логи:

На удивление обнаружил, что в логах уже есть одна 404-я (Not Found) ошибка. Посмотрев на детали исключения сразу становится понятно, что не найден файл favicon.ico.

Для примера, я поместил на страницу кнопку, обработчик OnClick которой бросает исключение:

throw new NotImplementedException();

Посмотрим теперь на нашм логи:

У нас появилась запись с кодом 500 (Server Error) и типом NotImplemented.

В деталях каждой записи кроме времени и текста ошибки хранится полный callstack, все параметры, которые пришли в запросе (Request.Params) и, на мой взгляд самое интересное - ссылка с именем “Original ASP.NET error page”. Перейдя по ней можно посмотреть как выглядела страница, когда произошла ошибка. Таким образом можно увидеть что показывалось пользователю, когда это случилось.

Последняя фича, о которой я хотел бы сказать - это возможность настройки фильтрации исключений. Это позволит вам логировать только те исключения, которые вам необходимы.

На этом мой короткий обзор закончен. Более детально об elmah можно прочитать на официальной странице (http://code.google.com/p/elmah/). Моей целью не было написать полный и подробный обзор-руководство по этой очень удобной и полезной библиотекой. Цель этого поста - всего-лишь познакомить с elmah тех читателей, которые еще не слышали о ней.

P.S. Для самых ленивых выложил тестовый проект на GitHub: https://github.com/e0ne/BlogSamples/tree/master/ElmahSampleProject

Tags

.net .net-framework .net-framework-3.5 agile ajax ajax-control-toolkit ampq ansible apache asp.net asp.net-mvc automation axum babel bash benchmark blog blog-engine bootstrap buildout c# cache centos chrome ci cinder ckan cli cloud code-review codeplex community config debugger deface dependencies development-environment devices devstack devtime disks django dlr dns docker dockerimage dos easy_install elmah encoding environment-variables error event events everything-as-a-code exception exceptions fabrik firefox flask foreach forms fstab gae gcc gerrit git github go google google-app-engine grep hack hacked hardware headless horizon hound html hugo iaas ienumerable iis internet iptables iron-python ironic iscsi java-script javascript jenkins jquery js jsx k8s kharkivpy kiss kombu kubernetes kvm kyiv lettuce libvirt linux lio loci logging loopback losetup lvm mac-os macos mercurial microsoft microsoft-sync-framework mobile mono ms-office msbuild networking news nginx npm npx offtopic oop open-source open-xml opensource openstack openvswitch os packages paraller-development patterns-practices performance php pika pip plugins pnp podcast popup postgresql profiler project protocols proxy pycamp pycharm pycon pykyiv pylint pypi python python-3 qcow quantum qumy rabbitmq rar react reactjs refactoring rfc rhel search-engine security selenium server shell silverlight socket software-engineering source-control sourcegear-vault sources sql sql-server sql-server-express sqlalchemy ssh static-site sublimetext svg tests tgt tipfy todo tornado typescript uapycon ui uneta unit-tests upgrades usability vim virtualenv visual-studio vitrage vm vue.js vuejs web-development web-server web-service web_root webpack webroot windows windows-live word-press x32 x64 xcode xml xss xvfb интернет-магазин книги

Recent posts

Go 1.18: new features

Всё будет Kubernetes

2022 Relaunch

Everyday Blogging

I don't want this CI


Archives

2022 (3)
2019 (73)
2018 (2)
2017 (3)
2016 (2)
2015 (3)
2014 (5)
2013 (17)
2012 (22)
2011 (36)
2010 (25)
2009 (35)
2008 (32)
2007 (2)