Утилита логирования и уведомлений (постановка)
Материал из GedeminWiki
(Различия между версиями)
SYSDBA (обсуждение | вклад) |
SYSDBA (обсуждение | вклад) |
||
| Строка 50: | Строка 50: | ||
|id | |id | ||
|INTEGER NOT NULL | |INTEGER NOT NULL | ||
| − | |Идентификатор базы данных | + | |Идентификатор базы данных. Заполняется генератором. |
|- | |- | ||
|db | |db | ||
| Строка 66: | Строка 66: | ||
|id | |id | ||
|INTEGER NOT NULL | |INTEGER NOT NULL | ||
| − | |Идентификатор записи | + | |Идентификатор записи. Заполняется генератором. |
|- | |- | ||
|ts | |ts | ||
|TIMESTAMP NOT NULL | |TIMESTAMP NOT NULL | ||
| − | |Дата и время события | + | |Дата и время события. |
|- | |- | ||
|user_name | |user_name | ||
| − | |VARCHAR( | + | |VARCHAR(20) |
|Имя пользователя платформы Гедымин. | |Имя пользователя платформы Гедымин. | ||
|- | |- | ||
|os_name | |os_name | ||
| − | |VARCHAR( | + | |VARCHAR(20) |
|Имя пользователя операционной системы. | |Имя пользователя операционной системы. | ||
|- | |- | ||
| Строка 85: | Строка 85: | ||
|- | |- | ||
|host_name | |host_name | ||
| − | |VARCHAR( | + | |VARCHAR(20) |
|Имя компьютера. | |Имя компьютера. | ||
|- | |- | ||
| Строка 93: | Строка 93: | ||
|- | |- | ||
|obj_class | |obj_class | ||
| − | |VARCHAR( | + | |VARCHAR(40) |
|Класс объекта. | |Класс объекта. | ||
|- | |- | ||
| Строка 101: | Строка 101: | ||
|- | |- | ||
|obj_name | |obj_name | ||
| − | |VARCHAR( | + | |VARCHAR(40) |
|Имя объекта. | |Имя объекта. | ||
|- | |- | ||
| Строка 109: | Строка 109: | ||
|- | |- | ||
|op | |op | ||
| − | |CHAR( | + | |CHAR(8) NOT NULL |
|Идентификатор операции. Латинские символы в верхнем регистре. | |Идентификатор операции. Латинские символы в верхнем регистре. | ||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
|data | |data | ||
|BLOB SUB_TYPE 1 | |BLOB SUB_TYPE 1 | ||
| − | | | + | |Текст сообщения и/или дополнительные данные. Например, текст SQL запроса. |
|} | |} | ||
| + | База данных содержит генератор GD_G_LOG. | ||
[[Category:Постановка]] | [[Category:Постановка]] | ||
Версия 13:58, 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(20) | Имя пользователя платформы Гедымин. |
| os_name | VARCHAR(20) | Имя пользователя операционной системы. |
| db | INTEGER NOT NULL | Идентификатор БД. Ссылка на таблицу GD_LOG_DB. |
| host_name | VARCHAR(20) | Имя компьютера. |
| host_ip | CHAR(15) | IP адрес компьютера. |
| obj_class | VARCHAR(40) | Класс объекта. |
| obj_subtype | VARCHAR(31) | Подтип объекта. |
| obj_name | VARCHAR(40) | Имя объекта. |
| obj_id | INTEGER | ИД объекта. |
| op | CHAR(8) NOT NULL | Идентификатор операции. Латинские символы в верхнем регистре. |
| data | BLOB SUB_TYPE 1 | Текст сообщения и/или дополнительные данные. Например, текст SQL запроса. |
База данных содержит генератор GD_G_LOG.
