Запись логов¶
Эта закладка предназначения для записи файла логов - протокола событий, происходящих в модуле коммутации.
Модуль позволяет указать каталог, в котором будут храниться файлы логов и префикс имени файла логов.
Имена файлов, записываемые в указанный каталог, имеют вид prefix<дата и время создания>.csv, например rescra1_2011-05-20!+09-52-47.csv.
Формат записываемых файлов - текстовый, в кодировке unicode, UTF-8, с указанием формата в виде BOM.
Файл содержит записи об изменении состояния коммутатора в виде CSV (comma separated values) - значений, разделенных запятой. По сути, файл содержит таблицу, строками которой являются события, а в колонках, разделенных запятыми, отображается информация о событии. Одна строка содержит информацию об одном события. Файлы этого формата можно открывать любым текстовым редактором или в программах редактирования электронных таблиц типа Excel или Calc.
Пример содержимого файла:
DateTime, Id, Name, EvtType, Reserve, Abnormal, SrcName, SrcId, SrcRtpn
2011-06-20 09:52:47, 02, Санкт-Петербург, Статус, Программа, , Маяк, S02, 2
2011-06-20 09:59:24, 02, Санкт-Петербург, Сигнал, Резерв, , Маяк, S02, 2
2011-06-20 09:59:26, 02, Санкт-Петербург, Сигнал, Программа, , Маяк, S02, 2
2011-06-20 09:59:41, 02, Санкт-Петербург, Вход, Программа, , Детское радио, S04, 4
2011-06-20 10:10:51, 10, 10, АВАРИЯ, Резерв, Авария:Канал '10'. Неправильное состояние резервного коммутатора, Выключен, Off, 0
2011-06-20 10:11:05, 10, 10, Норма, Программа, , Выключен, Off, 0
Первая строка файла всегда содержит названия колонок файла. В файле присутствуют следующие колонки:
- DateTime - дата и время события
- Id - идентификатор выхода коммутатора
- Name - имя выхода коммутатора
- EvtType - тип события
- Reserve - соответствует текущему состояние данного выхода - Резерв или Программа.
- Abnormal - описание аварии, возникшей в данном канале
- SrcNane - название истопника, скоммутированного на данный выход
- SrcId - Идентификатор источника, скоммутированного на данный выход
- SrcRtpn - идентификатор потока LiveWire, скоммутированного на данный выход
Одна из колонок, EvtType содержит описание типа события. События бывают следующих типов:
- Статус - начальное состояние коммутатора на момент создания файла. Записи этого типа всегда идут в самом начале файла.
- Сигнал - изменение состояния сигнала - Резерв или Программа
- Вход - изменение источника на данном выходе
- АВАРИЯ - возникновение нештатной, аварийной ситуации на данном выходе
- Норма - возврат данного выхода в нормальное состояние
Файлы логов создаются программой в момент запуска, и при смене суток, причем файл создается не ровно полночь, а в тот момент, когда произойдет какое либо событие. Если в течении суток ничего не произойдет, то и файл лога в эти сутки создан не будет.