Megatec Integration Service:Работа с окном История. Логирование. — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Настройка логирования отправки данных)
 
(не показано 15 промежуточных версий 5 участников)
Строка 1: Строка 1:
 
<span style="color:red;font-size:120%">Статья находится на стадии разработки.</span><br>
 
<span style="color:red;font-size:120%">Статья находится на стадии разработки.</span><br>
 
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
 
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
 +
 +
==Введение==
 +
Нажав кнопку [[Файл:Ud_072.png|История]]  в главном меню, вы попадете в окно '''История'''. <br />
 +
Данное окно служит для просмотра истории действии пользователей, автозагрузчиков и автоимпортов.
  
 
==Работа с окном История==
 
==Работа с окном История==
  
Для просмотра действии пользователей, работающих в «'''Megatec Integration Service'''» существует вкладка «'''История'''».
+
В данном окне три режима, а именно:  
В данной вкладке три вкладки, а именно:  
 
 
*'''Ручной режим''';  
 
*'''Ручной режим''';  
 
*'''Работа с внешней системой''';  
 
*'''Работа с внешней системой''';  
 
*'''Автоимпорт'''.
 
*'''Автоимпорт'''.
  
Во вкладке «'''Ручной режим'''» отображается информация о возникших ситуациях во время работы пользователя (дата запуска «'''Megatec Integration Service'''», ручной импорт цен, предупреждения во время работы). <br />
+
«'''Ручной режим'''» отображает информацию о возникших ситуациях во время работы пользователя (дата запуска «'''Megatec Integration Service'''», ручной импорт данных, предупреждения во время работы). <br />
[[Файл: vhm18.jpg | Окно история]] <br />
+
«'''Работа с внешней системой'''» отображает информацию об операциях с сервисом внешней системы (загрузка справочников, цен, квот и стопов). <br />
 +
«'''Автоимпорт'''» отображает информацию об операциях автоимпорта (автоимпорт цен, квот и стопов). <br />
 +
 
 +
[[Файл: VH_dfsd2.png‎ | Окно история]] <br />
 +
 
 +
==Настройка==
 +
 
 +
Также можно настроить логирование импорта данных и отправку писем об ошибках в программе на электронную почту для этого необходимо зайти для каждого адаптера в окно история, нажать на кнопку [[Файл:TP_72.png|Окно конфигурации файлов истории]] и настроить по схеме описанной ниже.
 +
 
 +
===Настройка логирования отправки данных===
 +
 +
Раздел '''<appender name="HotelPricesImport" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">''' <br/>
 +
 
 +
name="HotelPricesImport" - действия в главном окне (фильтрация, поиск...) и ручной импорт данных в Мастер-Тур
 +
name="HotelPricesAuto" - автоматический импорт данных в Мастер-Тур
 +
name="HotelPricesExternal" - загрузка из внешней системы данных в промежуточную базу
 +
 
 +
<syntaxhighlight lang="xml"> 
 +
      <maximumFileSize value="10MB" /> <!-- максимальный размер файла -->
 +
      <file value="Logs\\Import\\ManualTravelLinePricesImport.log.txt" /> <!-- путь и название файла -->
 +
      <layout type="log4net.Layout.PatternLayout">
 +
        <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" /> <!-- формат строки логирования -->
 +
      </layout>
 +
    </appender>
 +
</syntaxhighlight>
 +
 
 +
Аналогичные настройки у разделов: AgreementsReservationImport/Auto/External(бронирование путевок), HotelQuotaImport/Auto/External (квоты и стопы).<br/>
 +
Варианты записи логов:<br/>
 +
ALL – все сообщения попадают в лог <br />
 +
DEBUG – отладочные сообщения <br />
 +
INFO - информационные сообщения<br />
 +
WARN - предупреждения <br />
 +
ERROR - ошибки <br />
 +
FATAL – ошибки, которые приводят к закрытию приложения <br />
 +
OFF – логирование отключено <br /> <br />
 +
Эти уровни вложены друг в друга.<br />
 +
Если стоит DEBUG, то в лог попадают сообщения с уровнем DEBUG и ниже – INFO, WARN, ERROR …<br />
 +
Если стоит INFO, то в лог попадают сообщения с уровнем INFO и ниже – WARN, ERROR … DEBUG уже не попадет.
 +
Логи хранятся в папке Import. Пример: D:\MasterTour15.3\MIS\Logs\Import<br />
  
Во вкладке «'''Работа с внешней системой'''» отображается информация об операциях с сервисом внешней системы (автоматическая загрузка справочников, цен, обновлении по ценами и т.д.). <br />
+
===Отправка писем об ошибках на почту===
[[Файл: vhm19.jpg | Окно история]] <br />
+
Данная функция только для адаптеров ProTour и TravelLine
 +
Раздел  '''<appender name="ImportSendMail" type="log4net.Appender.SMTPAppender">''':<br/>
 +
<syntaxhighlight lang="xml">
 +
      <to value="" /> <!-- адресат, если несколько, то адреса прописываются через запятую -->
 +
      <from value="" /> <!-- корреспондент -->
 +
      <username value="" /> <!-- имя пользователя, учетная запись которого будет использоваться для отправки-->
 +
      <password value="" /> <!-- пароль-->
 +
      <subject value="INFO" /> <!-- тема письма-->
 +
      <smtpHost value="" /> <!-- адрес почтового сервиса-->
 +
      <port value="25" /> <!-- порт -->
  
Во вкладке «'''Автоимпорт'''» отображается информация об операциях автоимпорта (автоимпорт цен, наличия мест). <br />
+
</syntaxhighlight>
[[Файл: vhm20.jpg | Окно история]] <br />
 
  
Для просмотра истории за предыдущий день необходимо нажать кнопку «'''Показать больше'''».
+
После настройки необходимо выбрать к какому режиму будет применено и раскомментировать строку в выбранном режиме:
 +
<syntaxhighlight lang="xml"><!-- <appender-ref ref="ImportSendMail" />  --> </syntaxhighlight>
 +
==Полное логирование==
 +
Для настройки полного логирования импорта данных необходимо зайти для каждого адаптера в окно история, нажать на кнопку[[Файл:TP_72.png|Окно конфигурации файлов истории]]и настроить по схеме описанной ниже.
 +
<appender name="FullHotelPricesExternal" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">
 +
      <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
 +
      <encoding value="utf-8" />
 +
      <appendToFile value="true" />
 +
      <maximumFileSize value="5MB" />
 +
      <compressRollingFile value="false" />
 +
      <rollingStyle value="Size" />
 +
      <maxSizeRollBackups value="-1" />
 +
      <file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" />
 +
      <layout type="log4net.Layout.PatternLayout">
 +
        <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" />
 +
      </layout>
 +
    </appender>
 +
appender name="FullHotelPricesExternal" -загрузка цен из внешней системы данных в промежуточную базу. <br />
 +
appender name="FullDictionariesExternal" - загрузка справочников из внешней системы данных в промежуточную базу. <br />
 +
appender name="FullHotelQuotaExternal" загрузка квот и стоп из внешней системы данных в промежуточную базу. <br />
 +
appender name="FullAgreementsReservationExternal" - отправка путевки и получение статуса. <br />
 +
<file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" /> - расположения файла с логами. <br />
 +
<maximumFileSize value="5MB" /> - максимальный размер файла с логами. В случае превышения размера файла создается новый. <br />
 +
<compressRollingFile value="false" /> - архивирование файла с логами если превышает допустимый размер. (false - настройка отключена, true - включена). <br />
 +
Далее в теге  logger прописывается для какого процесса необходимо полное логирование. <br />
 +
  <logger name="FullHotelQuotaExternal">
 +
      <level value="ALL" />
 +
      <appender-ref ref="FullHotelQuotaExternal" />
 +
    </logger>
 +
Значения  level value= <br />
 +
OFF  значение по умолчанию, логирование  выключено <br />
 +
ALL  запись  и запроса и ответа <br />
 +
'''Для хранения  файлов с полным логами в папке Import создаётся папка Full.'''
 
[[Category:Megatec_Integration_Service]]
 
[[Category:Megatec_Integration_Service]]

Текущая версия на 14:55, 11 декабря 2019

Статья находится на стадии разработки.
Версия статьи от 11-12-2019.

Введение

Нажав кнопку История в главном меню, вы попадете в окно История.
Данное окно служит для просмотра истории действии пользователей, автозагрузчиков и автоимпортов.

Работа с окном История

В данном окне три режима, а именно:

  • Ручной режим;
  • Работа с внешней системой;
  • Автоимпорт.

«Ручной режим» отображает информацию о возникших ситуациях во время работы пользователя (дата запуска «Megatec Integration Service», ручной импорт данных, предупреждения во время работы).
«Работа с внешней системой» отображает информацию об операциях с сервисом внешней системы (загрузка справочников, цен, квот и стопов).
«Автоимпорт» отображает информацию об операциях автоимпорта (автоимпорт цен, квот и стопов).

Окно история

Настройка

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

Настройка логирования отправки данных

Раздел <appender name="HotelPricesImport" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">

name="HotelPricesImport" - действия в главном окне (фильтрация, поиск...) и ручной импорт данных в Мастер-Тур
name="HotelPricesAuto" - автоматический импорт данных в Мастер-Тур
name="HotelPricesExternal" - загрузка из внешней системы данных в промежуточную базу
   
      <maximumFileSize value="10MB" /> <!-- максимальный размер файла -->
      <file value="Logs\\Import\\ManualTravelLinePricesImport.log.txt" /> <!-- путь и название файла -->
      <layout type="log4net.Layout.PatternLayout">
        <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" /> <!-- формат строки логирования -->
      </layout>
    </appender>

Аналогичные настройки у разделов: AgreementsReservationImport/Auto/External(бронирование путевок), HotelQuotaImport/Auto/External (квоты и стопы).
Варианты записи логов:
ALL – все сообщения попадают в лог
DEBUG – отладочные сообщения
INFO - информационные сообщения
WARN - предупреждения
ERROR - ошибки
FATAL – ошибки, которые приводят к закрытию приложения
OFF – логирование отключено

Эти уровни вложены друг в друга.
Если стоит DEBUG, то в лог попадают сообщения с уровнем DEBUG и ниже – INFO, WARN, ERROR …
Если стоит INFO, то в лог попадают сообщения с уровнем INFO и ниже – WARN, ERROR … DEBUG уже не попадет. Логи хранятся в папке Import. Пример: D:\MasterTour15.3\MIS\Logs\Import

Отправка писем об ошибках на почту

Данная функция только для адаптеров ProTour и TravelLine 

Раздел <appender name="ImportSendMail" type="log4net.Appender.SMTPAppender">:

      <to value="" /> <!-- адресат, если несколько, то адреса прописываются через запятую -->
      <from value="" /> <!-- корреспондент -->
      <username value="" /> <!-- имя пользователя, учетная запись которого будет использоваться для отправки-->
      <password value="" /> <!-- пароль-->
      <subject value="INFO" /> <!-- тема письма-->
      <smtpHost value="" /> <!-- адрес почтового сервиса-->
      <port value="25" /> <!-- порт -->

После настройки необходимо выбрать к какому режиму будет применено и раскомментировать строку в выбранном режиме:

<!-- <appender-ref ref="ImportSendMail" />  -->

Полное логирование

Для настройки полного логирования импорта данных необходимо зайти для каждого адаптера в окно история, нажать на кнопкуОкно конфигурации файлов историии настроить по схеме описанной ниже.

<appender name="FullHotelPricesExternal" type="Megatec.MasterTour.Plugins.ImportManager.Common.FileAppenderExt">
     <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
     <encoding value="utf-8" />
     <appendToFile value="true" />
     <maximumFileSize value="5MB" />
     <compressRollingFile value="false" />
     <rollingStyle value="Size" />
     <maxSizeRollBackups value="-1" />
     <file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" />
     <layout type="log4net.Layout.PatternLayout">
       <param name="ConversionPattern" value="%date{dd.MM.yyyy HH:mm} %-5level: %message%newline" />
     </layout>
   </appender>

appender name="FullHotelPricesExternal" -загрузка цен из внешней системы данных в промежуточную базу.
appender name="FullDictionariesExternal" - загрузка справочников из внешней системы данных в промежуточную базу.
appender name="FullHotelQuotaExternal" загрузка квот и стоп из внешней системы данных в промежуточную базу.
appender name="FullAgreementsReservationExternal" - отправка путевки и получение статуса.
<file value="Logs\\Import\\Full\\SamoExternalPricesLoad.log" /> - расположения файла с логами.
<maximumFileSize value="5MB" /> - максимальный размер файла с логами. В случае превышения размера файла создается новый.
<compressRollingFile value="false" /> - архивирование файла с логами если превышает допустимый размер. (false - настройка отключена, true - включена).
Далее в теге logger прописывается для какого процесса необходимо полное логирование.

 <logger name="FullHotelQuotaExternal">
     <level value="ALL" />
     <appender-ref ref="FullHotelQuotaExternal" />
   </logger>

Значения level value=
OFF значение по умолчанию, логирование выключено
ALL запись и запроса и ответа
Для хранения файлов с полным логами в папке Import создаётся папка Full.