Симон Робинсон - C# для профессионалов. Том II

В журнале событий будет помещена следующая информация:

□ Type может быть Information, Warning и Error. Information — это редкая успешная операция, Warning — проблема, которая не является немедленно значимой, и Error — основная проблема. Дополнительными типами являются FailureAudit и SuccessAudit, но эти типы используются только для журнала Security.

□ Date и Time показывают время, когда происходит событие.

□ Source — имя программного обеспечения, регистрирующего событие. Source для журнала Application конфигурируется в HKLM\System\CurrentControlSet\Services\EventLog\Application. Под этим ключом конфигурируется значение EventMessageFileдля указания на DLL ресурса, который содержит сообщения об ошибках.

□ Category можно определить так, чтобы журналы событий фильтровались при использовании Event View.

□ Идентификатор события определяет сообщение об определенном событии.

Пространство имен System.Diagnosticsимеет несколько классов для регистрации событий:

□ С помощью класса EventLogможно прочитать и внести записи в журнал событий, а также определить приложения как источники событий.

□ EventLogEntryявляется единственным входом в журнал событий. С помощью EventLogEntryCollectionможно просмотреть EventLogEntry.

□ Класс EventLogInstallerпредназначен для установки компонента EventLog. EventLogInstallerвызывает EventLog.CreateEventSource()для создания источника событий.

□С помощью EventLogTraceListenerможно записать в журнал событий трассировки. Этот класс реализует абстрактный класс TraceListener.

Если свойство AutoLogкласса ServiceBaseзадано как true, то автоматически включается регистрация событий. Класс ServiceBaseрегистрирует информационное событие при запросах службы для запуска, остановки, паузы и продолжения. В классе ServiceInstallerсоздается экземпляр EventLogInstaller, чтобы сконфигурировать источник журнала событий. Этот источник журнала событий имеет такое же имя, как и служба. Для записи события используем статический метод WriteEntry()класса EventLog. Свойство Sourceбыло уже задано в классе ServiceBase:

EventLog.WriteEntry("event log message");

Этот метод регистрирует информационное событие. Если должно быть создано событие предупреждения или ошибки, то для определения этого типа используется перезагруженный метод WriteEvent():

EventLog.WriteEntry("event log message", EventLogEntryType.Warning);

EventLog.WriteEntry("event log message", EventLogEntryType.Error);

Для служб класс ServiceBaseавтоматически добавляет свойства регистрации событий. Если желательно использовать регистрацию событий в других типах приложений, это легко делается с помощью Visual Studio.NET.

□ Используйте ToolBox для добавления компонента EventLogв конструктор.

□ Задайте свойство Logкомпонента EventLogкак Application, а свойство Sourceкак выбранное имя. Обычно это бывает имя приложения, которое показано в Event View.

□ Теперь можно записать журналы с помощью метода WriteEntry()экземпляра EventLog.

□ Можно добавить программу установки из пункта контекстного меню Add Installer компонента EventLog. Это создает класс ProjectInstaller, который конфигурирует источник событий в реестре.

□ С помощью команды installutilтеперь можно зафиксировать приложение, installutilвызывает класс ProjectInstallerи регистрирует источник событий.

Для установки типа хсору последние два шага на самом деле не нужны. Если задано свойство Sourceэкземпляра EventLog, источник автоматически регистрируется, когда журнал событий заполняется в первый раз. Это действительно легко сделать, но для реального приложения предпочтительнее добавить программу установки: с помощью installutil /uконфигурация регистрации событий отменяется. Если приложение просто удаляется, этот ключ реестра остается, если не будет вызван метод EventLog.DeleteEventSource().

Можно сделать так, чтобы все сообщения трассировки направлялись в журнал событий. На самом деле это не нужно, так как в нормально работающей системе журнал событий будет перегружен сообщениями трассировки. Системный администратор пропустит действительно важные записи, если это произойдет. Помните, что тип записи события — это ошибка, предупреждение и информационное. При этом информационные сообщения редко являются информацией об успехе. Включение трассировочных сообщений в журнал событий может быть полезным свойством для тестирования проблемных служб. Трассировка возможна как с отладочным, так и с окончательным кодом.