Сервис логирования

Введение

Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы IntegrationService Interlook.

Предусловия установки

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

Установка службы сервиса логирования

• Скопировать папку LogService из дистрибутива на сервер.
• Перед установкой службы сервиса логирования необходимо настроить конфигурационный файл appsettings.json.

Настройка конфигурационного файла appsettings.config

№	Название	Описание	Настройка
1	Название службы	Задается название службы. По умолчанию служба будет создана с названием MegatecLogService.	"ServiceName": "MegatecLogService"
2	Адрес сервиса	Адрес сервиса логирования.	"ServiceAddress": [ "http://*:6060" ]
3	Строка подключения к базе данных	Задается строка подключения к базе данных MongoDB	"MongoConnectionString": "mongodb://bernoulli.megatec.ru:27017"

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта LogService.
• В Службах Windows добавляется служба MegatecLogService.
  

• Для удаления службы необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.

Настройка конфигурационного файла web.config

Настройки задаются в секции <appSettings> файла web.config основного приложения Interlook.IntegrationService.

№	Описание	Значение	Настройка
1	Подключение к базе данных	Строка подключения к базе данных	<add key="connectionString" value="Data Source=server;Initial Catalog=Base;User Id=User;Password=Password;Application Name=Interlook.IntegrationService" />
2	Процедура перезапуска кэша	cachingTime "cachingTime" value="-1" - инициализация кэша максимально производительная: каждый отель загружается в своем потоке, данные в кэше хранятся постоянно (возможны сбои). "cachingTime" value="-2"/> - весь кэш загружается в 2 (5,10) потока, в зависимости от значения настройки. Данные в кэше хранятся постоянно. "cachingTime" value="10"/> - кэш не загружается при старте приложения, данные в нем хранятся 10 (300,600) секунд, в зависимости от значения настройки.	<add key="cachingTime" value="-1"/>
3	Уровень использования процессора	parallelismDegree Уровень использования процессора при расчетах Максимум - 100, минимум - 0	<add key="parallelismDegree" value="70"/>
4	Включение логирования о использовании памяти сервера	LogCacheMemory Настройка служит для включения или отключения логирования в таблицу базы данных о использовании кешем сервиса памяти сервера. false - выключена, true - включена	<add key="LogCacheMemory" value="true"/>
5	Уровни логирования	Настройка, позволяющая регулировать логирование в БД SQL 0 - не логируется, 1 - логируется, 2 - логируется с дополнительными параметрами.	<add key="EnableSqlServerLogging" value="1" />
6	Настройка для включения логирования с использование сервиса логирования	Настройка, позволяющая включать и выключать запись логов в сервис логирования По умолчанию настройка установлена в значении false. true - включено, false - выключено	<add key="EnableLogServiceLogging" value="true" />
7	Настройка для установления уровня логирования при использовании сервиса логирования	Настройка, позволяющая регулировать уровень записи логов. Может ринимать значенимя Trace,Debug,Info,Warn,Error,Fatal,Off	<add key="LogServiceMinimumlLogLevel" value="Debug" />
8	Настройка количества попыток подключения к сервису логирования	Настройка, позволяющая регулировать количество попыток подключения к сервису логирования Значение регулирует количество попыток подключения.	<add key="LogServiceConnectionAttempts" value="10"/>
9	Адрес сервиса логирования	Адрес сервиса логирования	<add key="LogService" value="http://localhost:6060" />
10	Название базы данных для сервиса логирования	Настройка, позволяющая указать в какую базу данных MongoDB записывать логи	<add key="LogServiceDatabaseTarget" value="IntegrationService1"/>

В файле web.config для оптимальной работы сервиса нужно убедиться, что в секции <system.web> значение настройки compilation debug установлено в положении false

<compilation debug="false" targetFramework="4.0">

Просмотр информации из базы данных MongoDB

Для просмотра базы данных MongoDB необходимо использовать программу MongoDBCompass.
После скачивания и установки программы необходимо:
Запустить программу.
Указать в поле URL подключение к базе данных.

В разделе TLS/SSL установить значение Default.

Далее необходимо нажать кнопку Save&Connect.
Откроется окно ввода названия подключения.
Далее нажать кнопку Save&Connect.

После первой записи ошибок создастся база с названием, указанным в параметре LogServiceDatabaseTarget конфигурационного файла web.config.

Ошибки сохраняются в папку с соответствующим типом: Debug, Error, Fatal, Info, Trace, Warn.
При открытии папки с типом ошибки отобразятся все записи по ошибкам данного типа.

Параметры ошибок:

• id — идентификатор ошибки
  
• Date — дата и время ошибки
  
• Level — тип ошибки
  
• Message — метод в котором сформировалась ошибка
  
• Logger — наименование ПО в котором произошла ошибка
  
• DBUserID — наименование пользователя от которого сформирована ошибка
  
• EventInfo — объект данных
  
  • Host
    
  • ThreadID
    
  • ProcessID
    
  • ProcessName
    
  • SessionId
    
• Exception — объект данных
  
  • Type — тип ошибки
    
  • Message — сообщение ошибки
    
  • Stacktrace — трассировка стека
    

Пример записи о конкретной ошибке: