Сервис логирования — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Установка службы сервиса логирования)
Строка 2: Строка 2:
 
Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы IntegrationService Interlook.
 
Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы IntegrationService Interlook.
 
==Предусловия установки==
 
==Предусловия установки==
Служба LogService должна устанавливаться на компьютере, имеющем доступ к серверу базs данных MongoDB, или на компьютере, который сам является сервером базы данных.  
+
Служба LogService должна устанавливаться на компьютере, имеющем доступ к серверу базы данных MongoDB, или на компьютере, который сам является сервером базы данных.  
 
==Установка службы сервиса логирования==
 
==Установка службы сервиса логирования==
 
* Скопировать папку ''LogService'' из дистрибутива на сервер.  
 
* Скопировать папку ''LogService'' из дистрибутива на сервер.  
Строка 36: Строка 36:
 
| 3
 
| 3
 
| Строка подключения к базе данных
 
| Строка подключения к базе данных
| Задается строка подключения к базе жанных MongoDB
+
| Задается строка подключения к базе данных MongoDB
 
| <syntaxhighlight lang="xml" enclose="div">
 
| <syntaxhighlight lang="xml" enclose="div">
 
"MongoConnectionString": "mongodb://bernoulli.megatec.ru:27017"
 
"MongoConnectionString": "mongodb://bernoulli.megatec.ru:27017"
Строка 166: Строка 166:
 
<compilation debug="false" targetFramework="4.0">
 
<compilation debug="false" targetFramework="4.0">
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
==Просмотр информации из базы данных MongoDB==
 +
Для просмотра базы данных MongoDB необходимо использовать программу [https://www.mongodb.com/try/download/compass MongoDBCompass].<br />
 +
После скачивания и установки программы необходимо:<br />
 +
Запустить программу.<br />
 +
Указать в поле URL подключение к базе данных.<br />
 +
[[Файл:Ea_438.png|1000px]]<br />
 +
В разделе '''TLS/SSL''' установить значение '''Default'''.<br />
 +
[[Файл:Ea_439.png|1000px]]<br />
 +
Далее необходимо нажать кнопку '''Save&Connect'''.<br />
 +
Откроется окно ввода названия подключения.<br />
 +
Далее нажать кнопку '''Save&Connect'''.<br />
 +
[[Файл:Ea_440.png|600px]]<br />
 +
После первой записи ошибок создастся база с названием, указанным в параметре '''LogServiceDatabaseTarget''' конфигурационного файла web.config.<br />
 +
[[Файл:Ea_441.png|1000px]]<br />
 +
Ошибки сохраняются в папку с соответствующим типом: Debug, Error, Fatal, Info, Trace, Warn.<br />
 +
При открытии папки с типом ошибки отобразятся все записи по ошибкам данного типа.<br />
 +
[[Файл:Ea_442.png|1000px]]<br />
 +
Параметры ошибок:<br />
 +
*id — идентификатор ошибки<br />
 +
*Date — дата и время ошибки<br />
 +
*Level — тип ошибки<br />
 +
*Message — метод в котором сформировалась ошибка<br />
 +
*Logger — наименование ПО в котором произошла ошибка<br />
 +
*DBUserID — наименование пользователя от которого сформирована ошибка<br />
 +
*EventInfo — объект данных<br />
 +
**Host<br />
 +
**ThreadID<br />
 +
**ProcessID<br />
 +
**ProcessName<br />
 +
**SessionId<br />
 +
*Exception — объект данных<br />
 +
**Type — тип ошибки<br />
 +
**Message — сообщение ошибки<br />
 +
**Stacktrace — трассировка стека<br />
 +
Пример записи о конкретной ошибке:<br />
 +
[[Файл:Ea_443.png|600px]]<br />

Версия 08:44, 11 января 2024

Введение

Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы 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. Правила для входящих подключений MasterTourService
  • В Службах Windows добавляется служба MegatecLogService.

MegatecLogService

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

Настройка IntegrationService Interlook для работы с сервисом службы логирования

Настройка конфигурационного файла 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 подключение к базе данных.
Ea 438.png
В разделе TLS/SSL установить значение Default.
Ea 439.png
Далее необходимо нажать кнопку Save&Connect.
Откроется окно ввода названия подключения.
Далее нажать кнопку Save&Connect.
Ea 440.png
После первой записи ошибок создастся база с названием, указанным в параметре LogServiceDatabaseTarget конфигурационного файла web.config.
Ea 441.png
Ошибки сохраняются в папку с соответствующим типом: Debug, Error, Fatal, Info, Trace, Warn.
При открытии папки с типом ошибки отобразятся все записи по ошибкам данного типа.
Ea 442.png
Параметры ошибок:

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

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