AGG Software
Задать вопрос  В начало  Назад  Дальше

Формирование лог-файлов

Основная функция программы - возможность записать любые данные в лог-файл. Для этого в программе предусмотрены широкие возможности (рис. 4.1.1). Сохраненный файл данных называют лог-файлом (журналом).

 

options logformat

Рис. 4.1.1. Режимы формирования лог-файла

 

Сначала, выберите тип лог-файла, который вы будете получать: для принимаемых или отправляемых данных. Если вы активируете опцию "Записывать в лог файл для полученных данных", то получаемые и отправляемые данные будут записываться в один и тот же файл.

 

Затем, включите опцию  "Формировать файлы логов на диске". После этого, укажите путь к папке, в которой будут сохраняться файлы, с помощью диалогового окна "Обзор папок", которое откроется после нажатия на кнопку с изображением открытой папки. В диалоговом окне выберите необходимую папку и нажмите "OK". Программа может работать с сетевыми дисками из сетевого окружения, но это может повлиять на скорость работы программы, а большой поток данных или перегрузка сети могут привести к отказу.

 

В Advanced PBX Data Logger имя лог-файла - это штамп времени, и новый лог-файл создается через определенные промежутки времени.

 

Методика смены имени лог-файла определяется следующими основными параметрами:

 

Префикс имени файла - набор символов, который будет добавляться к началу имени;
Штамп времени в имени файла. Формат штампа времени зависит от выбранного в списке "Новый файл" режима. Например, если префикс имени файла установлен как "sample", расширение файла как "log ", а периодичность формирования файлов задана "Ежедневно", то каждый создаваемый лог-файл будет иметь формат "sampleYYYYMMDD.log". 21-го марта 2003 года будет создан лог-файл "sample20030321.log".
Расширение имени файла - набор символов, который будет расширением имени файла (символы после точки).

 

Префикс, расширение, путь к папке могут быть символьной строкой разумной длины и содержать любые символы, допустимые в имени файла.

 

Выпадающий список "Новый файл" позволяет задать периодичность создания нового файла:

 

1.Ежедневно - новый файл будет создаваться каждый день, в указанное время. При этом в имя файла будет автоматически подставляться дата создания файла в формате DDMMYYYY, где DD - это двухразрядное значение дня, MM - двухразрядное значение месяца и YYYY - четырехразрядное значение текущего года;
2.Ежемесячно - новый файл будет создаваться каждый месяц. При этом в имя файла будет автоматически подставляться дата создания файла в формате MMYYYY;
3.Формат пользователя - в этом режиме пользователь имеет возможность задать свою маску даты и времени, например YYYYMMDD;
4.Каждый пакет данных сохранять в отдельном файле - каждая полученная порция данных будет сохранена в отдельный файл. В данном режиме имя файла будет содержать не штамп времени, а порядковый номер. Например: sample00000001.log.Данный режим удобно использовать этот режим при записи в лог-файл после обработки;
5.Не создавать новый файл - новый файл не будет создаваться;
6.Еженедельно - новый файл будет создаваться каждую неделю. При этом в имя файла будет автоматически подставляться дата создания файла в формате WWYYYY, где WW - это двухразрядное значение номера недели, а YYYY - четырехразрядное значение текущего года;
7.После таймаута данных - новый файл будет создаваться, если данных не было в течении указанного пользователем промежутка времени;
8.Ежечасно - новый файл будет создаваться каждый час. При этом в имя файла будет автоматически подставляться дата создания файла в формате HHDDMMYYYY;
9.Постоянное имя файла с переименованием по времени - текущий лог-файл всегда будет иметь постоянное имя. В момент создания нового файла, существующий лог-файл будет сохранен с новым именем, содержащим штамп времени.

 

Возможные форматы даты и времени:

 

d        - день, не включает ноль (1 - 31);

dd        - день, включает ноль (01 - 31);

ddd        - день недели в текстовом формате (Пн - Вс) согласно стандарту, установленному на данном компьютере;

dddd     - день недели в полном текстовом формате (Понедельник - Воскресенье) согласно стандарту, установленному на данном компьютере;

m        - месяц, не включает ноль (1 - 12);

mm        - месяц, включает ноль (01 - 12);

mmm    - месяц в текстовом формате (Янв - Дек) согласно стандарту, установленному на данном компьютере;

mmmm - месяц в полном текстовом формате (Январь - Декабрь) согласно стандарту, установленному на данном компьютере;

yy        - год в формате двух последних разрядов (00 - 99);

yyyy        - год в формате четырех последних разрядов (0000 - 9999);

h        - часы, не включает ноль (0 - 23);

hh        - часы, включает ноль (00 - 23);

n        - минуты, не включает ноль (0 - 59);

nn        - минуты, включает ноль (00 - 59);

s        - секунды, не включает ноль (0 - 59);

ss        - секунды, включает ноль (00-59).

 

Пример: Вы хотите создавать лог-файл каждый час. Также для Вас необходимо, чтобы имя файла начиналось с "sample_log", и чтобы расширение файла было "txt".

 

Ответ: установите префикс файла = sample_log_, расширение файла = txt (без точки!). В формате имени файла задайте HHDDMMYYYY. Теперь файл будет создаваться каждый час. Естественно, вы можете установить любую комбинацию символов формата, описанных выше.

 

Добавить значение даты и времени в имя файла - данная опция доступна для режимов создания нового файла №4 и №7 и позволяет включить в имя файла также и дату/время создания файла.

 

Добавить номер источника данных к имени файла - если данная опция включена, то в начало имени файла будет добавляться имя источника данных. Например, COM1-sample20030321.log.

 

Записывать дату/время перед записью данных - если данная опция включена, то программа будет записывать в файл штамп времени перед каждой порцией данных.

 

Перезаписывать существующие файлы - данная опция доступна для режимов создания нового файла №4 и №7. Если данная опция включена, то программа будет удалять существующий файл перед созданием нового.

 

Вы можете ограничить размер лог-файла, установив его размер в килобайтах в поле "Ограничить размер". Если вы укажите нулевой размер, размер файла не будет ограничиваться. Можно выбрать следующие режимы ограничения размера лог-файла:

1.Очистить файл - после достижения установленного размера файла текущий файл будет обнулен. Будьте внимательны!
2.Переименовать старый - после достижения установленного размера файла текущий файл будет переименован с другим именем.
3.Сдвинуть (без порога) - наиболее старые данные в лог файле будут удалены. Новые данные будут дописаны в конец файла.
4.Сдвинуть (с порогом срабатывания). В этом режиме программа будет ожидать, когда размер файла превысит установленное ограничение на размер порога срабатывания. В этом случае наиболее старые данные в лог файле будут удалены. Новые данные будут дописаны в конец файла. Данный режим эффективен, если данные поступают часто и мелкими порциями.

Copyright © 1999-2016, AGG Software.
All rights reserved.