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

Материал из GedeminWiki
(Различия между версиями)
Перейти к: навигация, поиск
Строка 33: Строка 33:
 
** Передачу событий в gedemin_log.exe.
 
** Передачу событий в gedemin_log.exe.
 
** Прием управляющих событий.
 
** Прием управляющих событий.
 +
 +
==Хранение лога==
 +
 +
Для хранения лога создадим локальную базу данных Firebird с именем gedemin_log.fdb. Расположим ее в подкаталоге Database, относительно выполняемого файла. Если на папку нет прав на создание/изменение файлов, то расположим ее в папке профиля, там где располагаются файлы gedemin.ini, databases.ini.
 +
 +
База данных содержит таблицу GD_LOG следующей структуры:
 +
 +
{| border="1" cellpadding="4" cellspacing="0" style="border-collapse:collapse;"
 +
!style="background:#ffdead;"| Поле
 +
!style="background:#ffdead;"| Тип
 +
!style="background:#ffdead;"| Описание
 +
|-
 +
|id
 +
|INTEGER NOT NULL
 +
|Идентификатор записи
 +
|-
 +
|ts
 +
|TIMESTAMP NOT NULL
 +
|Дата и время события
 +
|-
 +
|gedemin_name
 +
|
 +
|
 +
|-
 +
|os_name
 +
|
 +
|
 +
|-
 +
|db
 +
|
 +
|
 +
|-
 +
|host_name
 +
|
 +
|
 +
|-
 +
|host_ip
 +
|
 +
|
 +
|-
 +
|obj_class
 +
|
 +
|
 +
|-
 +
|obj_subtype
 +
|
 +
|
 +
|-
 +
|obj_name
 +
|
 +
|
 +
|-
 +
|obj_id
 +
|
 +
|
 +
|-
 +
|op
 +
|
 +
|
 +
|-
 +
|msg
 +
|
 +
|
 +
|-
 +
|data
 +
|
 +
|
 +
|}
 +
 +
 +
 +
 +
  
  
 
[[Category:Постановка]]
 
[[Category:Постановка]]

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

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

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

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

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

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

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

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

База данных содержит таблицу GD_LOG следующей структуры:

Поле Тип Описание
id INTEGER NOT NULL Идентификатор записи
ts TIMESTAMP NOT NULL Дата и время события
gedemin_name
os_name
db
host_name
host_ip
obj_class
obj_subtype
obj_name
obj_id
op
msg
data
Персональные инструменты
Пространства имён

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