Журналирование

СЭП «КриптоПро DSS» позволяет вести журналирование и протоколирование сообщений, которыми обмениваются веб-клиент и веб-службы СЭП «КриптоПро DSS».

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

В СЭП «КриптоПро DSS» возможности журналирования предоставляются технологией Windows Communication Foundation (WCF). Основными источниками журналирования WCF являются System.ServiceModel и System.ServiceModel.MessageLogging. Источник журналирования System.ServiceModel — наиболее общий источник журналирования WCF, записывающий основные этапы приложения по всему стеку связи WCF: от входа и выхода из транспорта до входа и выхода из пользовательского кода. Источник журналирования System.ServiceModel.MessageLogging записывает все сообщения, проходящие через систему.

СЭП «КриптоПро DSS» позволяет настроить журналирование из вышеуказанных источников отдельно для каждого из своих компонентов. Для каждого из источников журналирования можно настроить уровень журналирования и путь к файлу, в который будет записываться журналирование. Файлы журналирования имеют расширение .svclog, и для просмотра таких файлов используется программа SvcTraceViewer.exe (дистрибутив поставляется в составе Windows SDK на официальном сайте Microsoft).

Настройка журналирования осуществляется с помощью командлетов в зависимости от компонента для которого выполняется настройка. Все модули содержат однотипный набор команд для настройки журналирования. Наборы командлетов в зависимости от компонента DSS приведены ниже:

• Сервис Подписи
• Центр Идентификации
• Сервис Аудита
• Веб-интерфейс Пользователя

Для каждого из источников журналирования определен набор настраиваемых параметров:

• глобальная настройка для включения/отключения журналирования (с помощью командлетов Enable/Disable-DssXXXTracing);
• уровень журналирования, путь к файлу журналирования, максимальный размер одного файла трасировки и найстройка циклической перезаписи файла журналирования (с помощью командлетов Set-DssXXXTracing).

Примечание

Здесь XXX – имя компонента для которого настаивается оповещение: SignServer - для Сервиса Подписи, FE (Frontend) - для Веб-интерфейса Пользователя, AnalyticsService - для Сервиса Аудита, UMS (User Management Service) или STS(Security Token Service) - для Центра Идентификации.