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

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Новая страница: «==Введение== Служба сервиса логирования нужна для сохранения логов, полученных в процесс…»)
 
(→‎Настройка конфигурационного файла web.config)
 
(не показаны 3 промежуточные версии этого же участника)
Строка 2: Строка 2:
 
Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы IntegrationService Interlook.
 
Служба сервиса логирования нужна для сохранения логов, полученных в процессе работы IntegrationService Interlook.
 
==Предусловия установки==
 
==Предусловия установки==
−
Служба LogService должна устанавливаться на компьютере, имеющем доступ к серверу базs данных MongoDB, или на компьютере, который сам является сервером базы данных.  
+
Служба LogService должна устанавливаться на компьютере, имеющем доступ к серверу базы данных MongoDB, или на компьютере, который сам является сервером базы данных.  
 
==Установка службы сервиса логирования==
 
==Установка службы сервиса логирования==
 
* Скопировать папку ''LogService'' из дистрибутива на сервер.  
 
* Скопировать папку ''LogService'' из дистрибутива на сервер.  
 
* Перед установкой службы сервиса логирования необходимо настроить конфигурационный файл ''appsettings.json''.
 
* Перед установкой службы сервиса логирования необходимо настроить конфигурационный файл ''appsettings.json''.
−
 
+
==Настройка конфигурационного файла appsettings.config==
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
|- style="background-color:#F2F2F2"
 
|- style="background-color:#F2F2F2"
Строка 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"
 
</syntaxhighlight>
 
</syntaxhighlight>
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
+
|}
 
* Установка осуществляется запуском скрипта ''_Install.bat'' от имени администратора. [[Файл:Bm135.png|Запуск от имени администратора]]
 
* Установка осуществляется запуском скрипта ''_Install.bat'' от имени администратора. [[Файл:Bm135.png|Запуск от имени администратора]]
 
* При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта LogService. [[Файл:Mb_192.png‎|Правила для входящих подключений MasterTourService]]
 
* При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта LogService. [[Файл:Mb_192.png‎|Правила для входящих подключений MasterTourService]]
Строка 48: Строка 48:
  
 
* Для удаления службы необходимо запустить скрипт ''_UnInstall.bat'' от имени администратора. При этом будут удалены правила для входящих подключений.
 
* Для удаления службы необходимо запустить скрипт ''_UnInstall.bat'' от имени администратора. При этом будут удалены правила для входящих подключений.
 +
==Настройка IntegrationService Interlook для работы с сервисом службы логирования==
 +
==Настройка конфигурационного файла web.config==
 +
Настройки задаются в секции <code><appSettings></code> файла <code>web.config</code> основного приложения Interlook.IntegrationService.
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 +
|- style="background-color:#F2F2F2"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 1
 +
| Подключение к базе данных
 +
| Строка подключения к базе данных
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="connectionString" value="Data Source=server;Initial Catalog=Base;User Id=User;Password=Password;Application Name=Interlook.IntegrationService" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Процедура перезапуска кэша
 +
| '''cachingTime'''
 +
"cachingTime" value="-1" - инициализация кэша максимально производительная: каждый отель загружается в своем потоке, данные в кэше хранятся постоянно (возможны сбои).</br>
 +
"cachingTime" value="-2"/> - весь кэш загружается в 2 (5,10) потока, в зависимости от значения настройки. Данные в кэше хранятся постоянно.
 +
"cachingTime" value="10"/> - кэш не загружается при старте приложения, данные в нем хранятся 10 (300,600) секунд, в зависимости от значения настройки.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="cachingTime" value="-1"/>
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 3
 +
| Уровень использования процессора
 +
| '''parallelismDegree'''</br>
 +
Уровень использования процессора при расчетах</br>
 +
Максимум - 100, минимум - 0</br>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="parallelismDegree" value="70"/>
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 4
 +
| Включение логирования о использовании памяти сервера
 +
| '''LogCacheMemory'''</br>
 +
Настройка служит для регулирования записи логов в таблицу базы данных.</br>
 +
0 - отключены логи и диагностика кеша, 1 - включены логи и диагностика кеша, 2 -  тоже что и 1, только пишутся еще дополнительные более детальные логи.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="LogCacheMemory" value="2"/>
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 5
 +
| Настройка для включения логирования с использование сервиса логирования
 +
| Настройка, позволяющая включать и выключать запись логов в сервис логирования
 +
По умолчанию настройка установлена в значении '''false'''.<br />
 +
true - включено, false - выключено
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="EnableLogServiceLogging" value="true" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 6
 +
| Настройка для установления уровня логирования при использовании сервиса логирования
 +
| Настройка, позволяющая регулировать уровень записи логов.
 +
Может ринимать значенимя Trace,Debug,Info,Warn,Error,Fatal,Off
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="LogServiceMinimumlLogLevel" value="Debug" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 7
 +
| Адрес сервиса логирования
 +
| Адрес сервиса логирования
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="LogService" value="http://localhost:6060" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
| 8
 +
| Название базы данных для сервиса логирования
 +
| Настройка, позволяющая указать в какую базу данных MongoDB записывать логи
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="LogServiceDatabaseTarget" value="IntegrationService1"/>
 +
</syntaxhighlight>
 +
|}
 +
 +
 +
В файле web.config для оптимальной работы сервиса нужно убедиться, что в секции <code><system.web></code> значение настройки '''compilation debug''' установлено в положении '''false''' 
 +
<br /><syntaxhighlight lang="xml">
 +
<compilation debug="false" targetFramework="4.0">
 +
</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 />

Текущая версия на 16:13, 13 февраля 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

Настройка служит для регулирования записи логов в таблицу базы данных.
0 - отключены логи и диагностика кеша, 1 - включены логи и диагностика кеша, 2 - тоже что и 1, только пишутся еще дополнительные более детальные логи. 

<add key="LogCacheMemory" value="2"/>
5 Настройка для включения логирования с использование сервиса логирования Настройка, позволяющая включать и выключать запись логов в сервис логирования

По умолчанию настройка установлена в значении false.
true - включено, false - выключено 

<add key="EnableLogServiceLogging" value="true" />
6 Настройка для установления уровня логирования при использовании сервиса логирования Настройка, позволяющая регулировать уровень записи логов.

Может ринимать значенимя Trace,Debug,Info,Warn,Error,Fatal,Off 

<add key="LogServiceMinimumlLogLevel" value="Debug" />
7 Адрес сервиса логирования Адрес сервиса логирования 
<add key="LogService" value="http://localhost:6060" />
8 Название базы данных для сервиса логирования Настройка, позволяющая указать в какую базу данных 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

Источник — «http://wiki.megatec.ru/index.php?title=Сервис_логирования&oldid=30589»