Утилита логирования и уведомлений (постановка)

Материал из GedeminWiki
(Различия между версиями)
Перейти к: навигация, поиск
Строка 14: Строка 14:
 
Предлагается:
 
Предлагается:
  
−
* Создаем отдельное приложение '''gedemin_log.exe''' для хранения/отображения/записи в БД лога, уведомлений, информации о ходе выполнения длительных процессов.
+
* Создаем отдельное приложение '''gedemin_cc.exe''' для хранения/отображения/записи в БД лога, уведомлений, информации о ходе выполнения длительных процессов.
−
* Функциональность gedemin_log.exe:
+
* Функциональность gedemin_cc.exe:
 
** Регистрация подключения/отключения gedemin.exe
 
** Регистрация подключения/отключения gedemin.exe
 
** Прием событий от gedemin.exe. Размещение их в буфере в оперативной памяти и запись в файл лога на диске. Для связи между приложениями используются TCP/IP Sockets.
 
** Прием событий от gedemin.exe. Размещение их в буфере в оперативной памяти и запись в файл лога на диске. Для связи между приложениями используются TCP/IP Sockets.
Строка 21: Строка 21:
 
** Запись событий в базу данных (включая отложенную, пакетную запись).
 
** Запись событий в базу данных (включая отложенную, пакетную запись).
 
** Считывание ранее сохраненного лога и отображение его.
 
** Считывание ранее сохраненного лога и отображение его.
 +
** Импорт/экспорт событий в текстовый файл.
 
** Автоматическую очистку лога.
 
** Автоматическую очистку лога.
 
** Отсылку управляющих событий на gedemin.exe.
 
** Отсылку управляющих событий на gedemin.exe.
Строка 27: Строка 28:
 
** Отображение иконки в System Tray. Приложение может работать как с выводом окна на экран, так и без него.
 
** Отображение иконки в System Tray. Приложение может работать как с выводом окна на экран, так и без него.
 
** Динамическое отображение информации о ходе процессов (когда известен общий и выполненный объем и, когда он не известен).
 
** Динамическое отображение информации о ходе процессов (когда известен общий и выполненный объем и, когда он не известен).
−
* Создаем глобальный объект gdLog -- нить с низким приоритетом, наследованная от [[TgdMessagedThread]], для взаимодействия с gedemin_log.exe.
+
* Создаем глобальный объект gdLog -- нить с низким приоритетом, наследованная от [[TgdMessagedThread]], для взаимодействия с gedemin_сс.exe.
 
* Функциональность gdLog:
 
* Функциональность gdLog:
−
** Запуск и/или установление соединения с gedemin_log.exe.
+
** Запуск и/или установление соединения с gedemin_сс.exe.
 
** Накопление событий во внутренней очереди.
 
** Накопление событий во внутренней очереди.
−
** Передачу событий в gedemin_log.exe.
+
** Передачу событий в gedemin_сс.exe.
 
** Прием управляющих событий.
 
** Прием управляющих событий.
  
 
==Хранение лога==
 
==Хранение лога==
  
−
Для хранения лога создадим локальную базу данных Firebird с именем gedemin_log.fdb. Расположим ее в подкаталоге Database, относительно выполняемого файла. Если на папку нет прав на создание/изменение файлов, то расположим ее в папке профиля, там где располагаются файлы gedemin.ini, databases.ini.
+
Для хранения лога создадим локальную базу данных Firebird с именем '''gedemin_log.fdb'''. Расположим ее в подкаталоге '''Database''', относительно выполняемого файла. Если на папку нет прав на создание/изменение файлов, то расположим ее в папке профиля, там где располагаются файлы gedemin.ini, databases.ini.
  
−
База данных содержит таблицу GD_LOG следующей структуры:
+
База данных содержит таблицы:  
 +
 
 +
===GD_LOG_DB===
 +
 
 +
{| border="1" cellpadding="4" cellspacing="0" style="border-collapse:collapse;"
 +
!style="background:#ffdead;"| Поле
 +
!style="background:#ffdead;"| Тип
 +
!style="background:#ffdead;"| Описание
 +
|-
 +
|id
 +
|INTEGER NOT NULL
 +
|Идентификатор базы данных
 +
|-
 +
|db
 +
|VARCHAR(256) NOT NULL
 +
|Полная строка подключения к базе данных.
 +
|}
 +
 
 +
===GD_LOG===
  
 
{| border="1" cellpadding="4" cellspacing="0" style="border-collapse:collapse;"  
 
{| border="1" cellpadding="4" cellspacing="0" style="border-collapse:collapse;"  
Строка 53: Строка 72:
 
|Дата и время события
 
|Дата и время события
 
|-
 
|-
−
|gedemin_name
+
|user_name
−
|
+
|VARCHAR(60)
−
|
+
|Имя пользователя платформы Гедымин.
 
|-
 
|-
 
|os_name
 
|os_name
−
|
+
|VARCHAR(60)
−
|
+
|Имя пользователя операционной системы.
 
|-
 
|-
 
|db
 
|db
−
|
+
|INTEGER NOT NULL
−
|
+
|Идентификатор БД. Ссылка на таблицу GD_LOG_DB.
 
|-
 
|-
 
|host_name
 
|host_name
−
|
+
|VARCHAR(60)
−
|
+
|Имя компьютера.
 
|-
 
|-
 
|host_ip
 
|host_ip
−
|
+
|CHAR(15)
−
|
+
|IP адрес компьютера.
 
|-
 
|-
 
|obj_class
 
|obj_class
−
|
+
|VARCHAR(60)
−
|
+
|Класс объекта.
 
|-
 
|-
 
|obj_subtype
 
|obj_subtype
−
|
+
|VARCHAR(31)
−
|
+
|Подтип объекта.
 
|-
 
|-
 
|obj_name
 
|obj_name
−
|
+
|VARCHAR(60)
−
|
+
|Имя объекта.
 
|-
 
|-
 
|obj_id
 
|obj_id
−
|
+
|INTEGER
−
|
+
|ИД объекта.
 
|-
 
|-
 
|op
 
|op
−
|
+
|CHAR(4)
−
|
+
|Идентификатор операции. Латинские символы в верхнем регистре.
 
|-
 
|-
 
|msg
 
|msg
−
|
+
|VARCHAR(256)
−
|
+
|Текст сообщения/события.
 
|-
 
|-
 
|data
 
|data
−
|
+
|BLOB SUB_TYPE 1
−
|
+
|Дополнительные данные. Например, текст SQL запроса.
 
|}
 
|}
−
 
−
 
−
 
−
 
−
 
  
  
 
[[Category:Постановка]]
 
[[Category:Постановка]]

Версия 12:24, 12 октября 2015

В разное время и для разных целей в платформу были добавлены следующие функции для логирования операций и/или уведомления пользователя о ходе фоновых процессов:

  • Метод глобального объекта IBLogin AddEvent для записи в таблицу GD_JOURNAL.
  • Форма TfrmSQLProcess и процедуры в модуле at_frmSQLProcess.
  • Запись событий в лог операционной системы.
  • Отсылка сообщений на электронную почту о успешной/не успешной загрузке пакетов ПИ.
  • Окно с анимацией в процессе построения длительного отчета.
  • Окно с временем выполнения длительного SQL запроса.
  • Объект gdNotifierThread для вывода сообщений в специальной области главного окна.
  • Окно Время выполнения скрипт-функций в редакторе скрипт-объектов.

Основная проблема указанных выше механизмов -- невозможно организоват вывод на экран, пока заблокирована основная нить приложения. Использование IBLogin.AddEvent приводит к дополнительной нагрузке на базу данных.

Предлагается:

  • Создаем отдельное приложение gedemin_cc.exe для хранения/отображения/записи в БД лога, уведомлений, информации о ходе выполнения длительных процессов.
  • Функциональность gedemin_cc.exe:
    • Регистрация подключения/отключения gedemin.exe
    • Прием событий от gedemin.exe. Размещение их в буфере в оперативной памяти и запись в файл лога на диске. Для связи между приложениями используются TCP/IP Sockets.
    • Отображение/фильтрация/поиск событий на экране.
    • Запись событий в базу данных (включая отложенную, пакетную запись).
    • Считывание ранее сохраненного лога и отображение его.
    • Импорт/экспорт событий в текстовый файл.
    • Автоматическую очистку лога.
    • Отсылку управляющих событий на gedemin.exe.
    • Приложение может одновременно обслуживать несколько gedemin.exe на этом же компьютере или с подключением по сети.
    • Приложение взаимодействует с Windows Notifications
    • Отображение иконки в System Tray. Приложение может работать как с выводом окна на экран, так и без него.
    • Динамическое отображение информации о ходе процессов (когда известен общий и выполненный объем и, когда он не известен).
  • Создаем глобальный объект gdLog -- нить с низким приоритетом, наследованная от TgdMessagedThread, для взаимодействия с gedemin_сс.exe.
  • Функциональность gdLog:
    • Запуск и/или установление соединения с gedemin_сс.exe.
    • Накопление событий во внутренней очереди.
    • Передачу событий в gedemin_сс.exe.
    • Прием управляющих событий.

Хранение лога

Для хранения лога создадим локальную базу данных Firebird с именем gedemin_log.fdb. Расположим ее в подкаталоге Database, относительно выполняемого файла. Если на папку нет прав на создание/изменение файлов, то расположим ее в папке профиля, там где располагаются файлы gedemin.ini, databases.ini.

База данных содержит таблицы:

GD_LOG_DB

Поле Тип Описание
id INTEGER NOT NULL Идентификатор базы данных
db VARCHAR(256) NOT NULL Полная строка подключения к базе данных.

GD_LOG

Поле Тип Описание
id INTEGER NOT NULL Идентификатор записи
ts TIMESTAMP NOT NULL Дата и время события
user_name VARCHAR(60) Имя пользователя платформы Гедымин.
os_name VARCHAR(60) Имя пользователя операционной системы.
db INTEGER NOT NULL Идентификатор БД. Ссылка на таблицу GD_LOG_DB.
host_name VARCHAR(60) Имя компьютера.
host_ip CHAR(15) IP адрес компьютера.
obj_class VARCHAR(60) Класс объекта.
obj_subtype VARCHAR(31) Подтип объекта.
obj_name VARCHAR(60) Имя объекта.
obj_id INTEGER ИД объекта.
op CHAR(4) Идентификатор операции. Латинские символы в верхнем регистре.
msg VARCHAR(256) Текст сообщения/события.
data BLOB SUB_TYPE 1 Дополнительные данные. Например, текст SQL запроса.
Источник — «https://gsbelarus.com:80/gs/wiki/index.php?title=%D0%A3%D1%82%D0%B8%D0%BB%D0%B8%D1%82%D0%B0_%D0%BB%D0%BE%D0%B3%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F_%D0%B8_%D1%83%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_(%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)&oldid=6612»
Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты