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

SYSDBA: /* Хранение лога */

2015-10-13T08:46:19Z

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

SYSDBA: /* Хранение лога */

2015-10-13T08:42:34Z

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

SYSDBA: /* GD_LOG */

2015-10-12T11:00:58Z

‎GD_LOG

SYSDBA в 10:58, 12 октября 2015

2015-10-12T10:58:48Z

SYSDBA в 09:24, 12 октября 2015

2015-10-12T09:24:26Z

SYSDBA в 08:56, 12 октября 2015

2015-10-12T08:56:39Z

SYSDBA в 11:21, 18 сентября 2015

2015-09-18T11:21:45Z

SYSDBA в 10:10, 18 сентября 2015

2015-09-18T10:10:42Z

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

2015-09-18T09:56:19Z

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

Новая страница

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

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

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

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

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

[[Category:Постановка]]

@@ Строка 46: / Строка 46: @@
 !style="background:#ffdead;"| Поле
 !style="background:#ffdead;"| Тип
 !style="background:#ffdead;"| Описание
 |-
 |id
 |INTEGER NOT NULL
 |Идентификатор базы данных. Заполняется генератором.
 |-
 |db
 |VARCHAR(256) NOT NULL
 |Полная строка подключения к базе данных.
 |}
@@ Строка 62: / Строка 65: @@
 !style="background:#ffdead;"| Поле
 !style="background:#ffdead;"| Тип
 !style="background:#ffdead;"| Описание
 |-
 |crc
 |INTEGER NOT NULL
 |Хэш от текста запроса.
 |-
 |sql
 |BLOB SUB_TYPE 1
 |Текст запроса.
 |}
@@ Строка 78: / Строка 84: @@
 !style="background:#ffdead;"| Поле
 !style="background:#ffdead;"| Тип
 !style="background:#ffdead;"| Описание
 |-
 |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
 |Идентификатор операции. Латинские символы в верхнем регистре.
 |-
 |sql_crc
 |INTEGER
 |Хэш запроса. Он же ссылка на таблицу GD_LOG_SQL.
 |-
 |data
 |BLOB SUB_TYPE 1
 |Текст сообщения и/или дополнительные данные. Например, текст SQL запроса.
 |}
@@ Строка 142: / Строка 163: @@
 !style="background:#ffdead;"| Поле
 !style="background:#ffdead;"| Тип
 !style="background:#ffdead;"| Описание
 |-
 |logkey
 |INTEGER NOT NULL
 |Ссылка на GD_LOG.
 |-
 |param
 |VARCHAR(31) NOT NULL
 |Имя параметра.
 |-
 |INT
 |INTEGER
+|
 |-
@@ Строка 162: / Строка 187: @@
 |DT
 |TIMESTAMP
+|
 |-
 |CURR
 |NUMERIC(15, 4)
+|
 |-
 |FLOAT
 |DOUBLE PRECISION
+|
 |}

@@ Строка 55: / Строка 55: @@
 |VARCHAR(256) NOT NULL
 |Полная строка подключения к базе данных.
 |}
@@ Строка 111: / Строка 127: @@
 |CHAR(8) NOT NULL
 |Идентификатор операции. Латинские символы в верхнем регистре.
 |-
 |data
 |BLOB SUB_TYPE 1
 |Текст сообщения и/или дополнительные данные. Например, текст SQL запроса.
 |}

← Предыдущая		Версия 11:00, 12 октября 2015
Строка 118:		Строка 118:

	База данных содержит генератор GD_G_LOG.		База данных содержит генератор GD_G_LOG.
		+
		+	=См. также=
		+
		+	* [https://github.com/GoldenSoftwareLtd/gedemin/labels/CC Gedemin Control Center issues]

	[[Category:Постановка]]		[[Category:Постановка]]

@@ Строка 50: / Строка 50: @@
 |id
 |INTEGER NOT NULL
-|Идентификатор базы данных
+|Идентификатор базы данных. Заполняется генератором.
 |-
 |db
@@ Строка 66: / Строка 66: @@
 |id
 |INTEGER NOT NULL
-|Идентификатор записи
+|Идентификатор записи. Заполняется генератором.
 |-
 |ts
 |TIMESTAMP NOT NULL
-|Дата и время события
+|Дата и время события.
 |-
 |user_name
-|VARCHAR(60)
+|VARCHAR(20)
 |Имя пользователя платформы Гедымин.
 |-
 |os_name
-|VARCHAR(60)
+|VARCHAR(20)
 |Имя пользователя операционной системы.
 |-
@@ Строка 85: / Строка 85: @@
 |-
 |host_name
-|VARCHAR(60)
+|VARCHAR(20)
 |Имя компьютера.
 |-
@@ Строка 93: / Строка 93: @@
 |-
 |obj_class
-|VARCHAR(60)
+|VARCHAR(40)
 |Класс объекта.
 |-
@@ Строка 101: / Строка 101: @@
 |-
 |obj_name
-|VARCHAR(60)
+|VARCHAR(40)
 |Имя объекта.
 |-
@@ Строка 109: / Строка 109: @@
 |-
 |op
-|CHAR(4)
+|CHAR(8) NOT NULL
 |Идентификатор операции. Латинские символы в верхнем регистре.
 |-
 |data
 |BLOB SUB_TYPE 1
-|Дополнительные данные. Например, текст SQL запроса.
+|Текст сообщения и/или дополнительные данные. Например, текст SQL запроса.
 |}
 [[Category:Постановка]]

@@ Строка 14: / Строка 14: @@
 Предлагается:
-* Создаем отдельное приложение '''gedemin_log.exe''' для хранения/отображения/записи в БД лога, уведомлений, информации о ходе выполнения длительных процессов.
+* Создаем отдельное приложение '''gedemin_cc.exe''' для хранения/отображения/записи в БД лога, уведомлений, информации о ходе выполнения длительных процессов.
-* Функциональность gedemin_log.exe:
+* Функциональность gedemin_cc.exe:
 ** Регистрация подключения/отключения gedemin.exe
 ** Прием событий от gedemin.exe. Размещение их в буфере в оперативной памяти и запись в файл лога на диске. Для связи между приложениями используются TCP/IP Sockets.
@@ Строка 21: / Строка 21: @@
 ** Запись событий в базу данных (включая отложенную, пакетную запись).
 ** Считывание ранее сохраненного лога и отображение его.
 ** Автоматическую очистку лога.
 ** Отсылку управляющих событий на gedemin.exe.
@@ Строка 27: / Строка 28: @@
 ** Отображение иконки в System Tray. Приложение может работать как с выводом окна на экран, так и без него.
 ** Динамическое отображение информации о ходе процессов (когда известен общий и выполненный объем и, когда он не известен).
-* Создаем глобальный объект gdLog -- нить с низким приоритетом, наследованная от [[TgdMessagedThread]], для взаимодействия с gedemin_log.exe.
+* Создаем глобальный объект gdLog -- нить с низким приоритетом, наследованная от [[TgdMessagedThread]], для взаимодействия с gedemin_сс.exe.
 * Функциональность 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 следующей структуры:
+База данных содержит таблицы:
 {| border="1" cellpadding="4" cellspacing="0" style="border-collapse:collapse;"
@@ Строка 53: / Строка 72: @@
 |Дата и время события
 |-
-|gedemin_name
+|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 запроса.
 |}
 [[Category:Постановка]]