Перейти к основному содержимому
Версия: 5.x

Журналы и логи

Журналы

  • Журнал ошибок (рис.1).

Данный журнал содержит все ошибки, возникшие в ходе работы. Ошибки делятся на следующие классы (колонка Класс объекта):

  • ошибки, возникшие на сервере –– ошибки отображены на белом фоне и входят в единственный класс Исключение на сервере;
  • ошибки, возникшие на сервере и полученные клиентским приложением –– ошибки отображены на розовом фоне и входят в единственный класс Исключение на сервере (от клиента);
  • ошибки, возникшие на клиентском приложении – ошибки отображены на желтом фоне и входят в два класс: Исключение на клиенте и Исключение на web-клиенте;
  • ошибки связи – ошибки отображены на голубом фоне и входят в два класса:
    • Временное исключение связи - связь с сервером прерывалась, но была восстановлена;
    • Постоянное исключение связи - связь с сервером прерывалась и не восстановилась;

Рис. 1 Журнал ошибок.

В секции След исключения отображается java-стек ошибки, в секции LSF след исключения - lsfusion-стек.

  • Журнал подключений (рис. 2).

** **

Рис. 2 Журнал подключений.

В журнале храниться информация о пользователях, которые подключались к системе, с какого компьютера, каковы характеристика этого ПК, а также информация о дате и времени подключения/отключения. На форме можно отобразить пользователей, работающих в данный момент с БД – отметка Активные подключения.

В секции Форма видно сколько раз и в какие формы входил пользователь. В секции Сессия, для некоторых форм, можно проследить, когда применялись изменения.

  • Журнал запусков хранит информацию о дате и времен запуска (перезапуска) сервера приложений. Также видно имя компьютера, на котором установлен сервер и версия приложения (если заполняется при сборке).

  • Журнал изменений содержит более подробную информацию о примененных изменениях, которые были отражены в Журнале подключений в секции Сессия (рис. 3.).

Рис. 3 Журнал изменений.

В колонке Изменения отображается список Свойств (колонок), в которых менялись значения, а также количество изменений (строк). Логируются только изменения на текущей форме – зависимые Свойства, которые меняются одновременно на других таблицах, в данный список не попадают.

На форме можно отфильтровать изменения, сделанные пользователями (без системных изменений) – отметка Только изменения пользователя.

  • Журнал клиентских приложений содержит информацию о качестве соединения во время работы с сервером приложений за определенный период времени (рис. 4.).

Рис. 4 Журнал клиентских приложений.

В верхней части формы для клиентских компьютеров, помимо системных показателей памяти, можно проанализировать средние значения времени отклика (ping) в миллисекундах, доступной и используемой java-приложением памяти. Анализируемый период задается вводом Дата с и Дата по в секции Дата со временем. Кроме дат, здесь можно задать пороговый значения для этих же показателей (ping и память)– это позволит получить суммарно время (в секундах), когда клиентский ПК превысил пороговые значения.

В нижней части, на вкладке Данные представлена хронология изменений времени отклика, доступной и используемой памяти. Эта информация отображается только для Desktop-клиента.

Сколько должна храниться информация в перечисленных журналах указывается на форме Администрирование > Настройки > вкладка Логирование (рис. 5.).

Рис. 5 Установка количества дней логирования.

Если необходимо отслеживать изменения отдельных значений в каких-либо Свойствах (колонках), на определенных Формах, для таких случаем разработан механизм пользовательского логирования. Например, в справочнике Сотрудники нужно протоколировать изменения фамилии сотрудника. Для этого:

  • находясь на любой записи колонки Фамилия, по правой клавише мыши вызываем меню Настройка политики свойств (рис. 6.);

Рис. 6 Выбор свойства для протоколирования изменений.

  • в форме Политика безопасности устанавливаем отметку Логируется пользователем и нажимаем кнопку ОК (рис. 7.);

Рис. 7 Установка пользовательского логирования.

  • после перезапуска сервера приложений, при нажатии правой клавиши мыши на Свойстве Фамилия, появится дополнительный пункт меню Показать историю изменений. Если, для текущей записи, фамилия была кем-то изменена, то это найдет отражение в истории изменения свойств (рис. 8).

Рис. 8. История изменения свойства.

Время хранения для подобных протоколов устанавливается одинаковым времени хранения для Журнала изменений.

Логи

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

КомпонентПапкаЛоги
Сервер приложений (Server)$FUSION_DIR$/logs, где $FUSION_DIR$ - папка запуска сервера приложений
  • stdout - лог стандартного вывода (выводится в стандартный поток вывода, то есть в консоль ОС, IDE и т.п.). Включает в себя логи start и explain.
  • stderr - общий лог ошибок
  • start - лог процесса остановки и запуска
  • remote, invocation - логи процессов связанных с обращением к серверу приложений
  • sql, sqlhand, sqlconnection, sqlconflict, sqladjust - логи процессов связанных с обращением к серверу бд
  • explain, explaincompile - логи, в которые выводятся планы запросов (сервера БД и сервера приложений соответственно)
  • lru - лог процессов управления памятью (в основном LRU кэшами)
  • allocatedbytes - лог процессов выделения памяти
  • assert - лог различных проверок на выполнение заданных условий (а точнее их невыполнение)
  • mail - лог почты
  • jasperReports - лог JasperReports
  • jdbc - лог jdbc-драйвера
  • exinfo - лог дополнительной информации (не входящей в вышеописанные)
Веб-сервер (Client)$CATALINA_BASE$/logs, где $CATALINA_BASE$ - папка, в которую установлен Tomcat
  • catalina.out - общий лог вывода
  • gwtlog, gwtlog-err - логи GWT
  • invocation - логи процессов связанных с обращением к веб-серверу
Десктоп-клиент$USER_DIR$/.fusion/logs, где $USER_DIR$ - папка пользователя
  • stdout - лог стандартного вывода (выводится в стандартный поток вывода, то есть в консоль ОС, IDE и т.п.).
  • stderr - общий лог ошибок
  • remote, invocation - логи процессов связанных с обращением к серверу приложений
  • jasperReports - лог JasperReports
к сведению

При автоматической установке под Linux для этих папок (как и для файлов lsFusion параметров запуска) автоматически создаются symlink'и на другие папки, расположение которых лучше соответствует идеологии Linux.