Расширенное логирование и получение дополнительной отладочной информации

Введение

Во время работы в «Форсайт. Аналитическая платформа» ядром формируется и выводится отладочная информация. По умолчанию данная информация нигде не фиксируется. В некоторых случаях она может потребоваться для выяснения причин возникновения каких-либо ошибок. Для этого предусмотрена возможность вывода отладочной информации в файл. Все настройки по логированию отладочной информации хранятся в реестре операционной системы. Необходимо помнить, что включение вывода отладочной информации в файл приведет к замедлению работы среды разработки и прикладных форм, поэтому указанные ниже параметры необходимо убирать после того, как исследование проблемы завершено, и необходимость в логе отсутствует.

Лог работы

Для вывода отладочной информации в файл в реестр необходимо внести следующие изменения:

• создайте раздел «Log» в следующей ветке реестра:

• [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0] - при работе в настольной версии «Форсайт. Аналитическая платформа»;

• [HKEY_LOCAL_MACHINE\Software\Foresight\Foresight Analytics Platform\9.0] - при работе с BI-сервером «Форсайт. Аналитическая платформа».

• в разделе «Log» создайте следующие параметры:

• FileName. Строковый параметр, содержащий путь и наименование файла, в который будет выводиться отладочная информация;

• SeverityLevel. DWORD-параметр, содержащий уровень логирования. Для данного параметра могут быть установлены следующие значения:

• 0. Фиксируется вся отладочная информация, генерируемая в ядре «Форсайт. Аналитическая платформа»;

• 1. Фиксируется предупреждения, ошибки и критичные ошибки;

• 2. Фиксируются ошибки и критичные ошибки;

• 3. Фиксируются только критичные ошибки.

• IsolatedByDate. DWORD-параметр, указывающий необходимость разбиения файла по датам. Если параметр создан и имеет значение «1», то каждый день будет создаваться новый файл, в который будет выводиться отладочная информация. Текущая дата будет добавлена к имени файла.

Отладочная информация среды разработки

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

• в ветке [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0\Debug] создать следующие DWORD-параметры и установить им значение «1»:

• GCTrace. Указывает на необходимость регистрации всех сообщений сборщика мусора;

• DisableMetabaseSqlLog. Отключает вывод в отладочную информацию SQL-запросов к системным таблицам репозитория, которые формируются при обращении к объектам репозитория.

• в ветке [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0\DevEnv] создать следующие DWORD-параметры и установить им значение «1»:

• DevEnvDebug. Фиксация информации о создании компонентов;

• DevEnvParserDebug. Фиксация информации парсера среды разработки.

• в ветке [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0\Fore] создать следующие параметры:

• CheckLeaks. DWORD-параметр включает проверку наличия утечек памяти при закрытии репозитория в настольном приложении. Для включения проверки установите параметру значение «1». Если есть утечки, то будет выведен диалог сохранения утечек в файл;

• LeaksGraphFile. Путь и наименование файла, в который будут сохраняться список утечек памяти при закрытии репозитория. Если параметр задан, то диалог не выводится, а происходит сохранение в указанный файл. Файл создаётся в формате TGF (trivial graph format);

• ExternRefLogging. DWORD-параметр включает логирование изменения внешних ссылок при входе в репозиторий;

• ExtRefChangesFile. Путь и наименование файла, в который будет сохраняться лог изменения внешних ссылок объектов при закрытии репозитория. Файл создаётся в формате TXT.

Примечание. Отладочная информация среды разработки выводится, если для параметра SeverityLevel установлено значение «0».