Элемент <dump>

Вывод контекстов исключительных ситуаций

Элемент <dump> определяет параметры дампа, создаваемого при аварийном завершении работы программы. Чтобы отключить запись дампов, в элементе <dump> необходимо установить для параметра create = "0" или create = "false". Если элемент <dump> отсутствует, для записи дампов будет использоваться каталог %USERPROFILE%\Local Settings\Application Data\1C\1Cv8\Dumps (для ОС Windows).

ВНИМАНИЕ!

В ОС Linux настройка формирования дампов выполняется средствами ОС. Поэтому элемент <dump> игнорируется.

Атрибуты элемента:

Атрибут location ОС Windows

Имя каталога, в котором будут формироваться файлы дампов.

Примечание

В элементах <log>, <dump> и <defaultlog> в атрибутах location следует указывать разные каталоги.

Атрибут create ОС Windows

Определяет, создавать ли файл дампа.

• 0 (false) – не создавать;
• 1 (true) – создавать.

Атрибут type ОС Windows

Тип дампа, представляющий собой произвольную комбинацию приведенных ниже флагов в десятичной или шестнадцатеричной системе счисления (сумма значений флагов). Представление в шестнадцатеричной системе должно начинаться с символа 'x', например, x0002.

Доступны следующие значения:

• 0 (x0000) – минимальный;
• 1 (x0001) – дополнительный сегмент данных;
• 2 (x0002) – содержимое всей памяти процесса;
• 4 (x0004) – данные хендлов;
• 8 (x0008) – оставить в дампе только информацию, необходимую для восстановления стеков вызовов;
• 16 (x0010) – если стек содержит ссылки на память модулей, добавить флаг 64 (0x0040);
• 32 (x0020) – включить в дамп память выгруженных модулей;
• 64 (0x0040) – включить в дамп память, на которую имеются ссылки;
• 128 (x0080) – добавить в дамп подробную информацию о файлах модулей;
• 256 (0x0100) – добавить в дамп локальные данные потоков;
• 512 (0x0200) – включить в дамп память из всего доступного виртуального адресного пространства.

СОВЕТ

В большинстве случаев достаточно установить для атрибута type значение 3, например, type="3".

Атрибут prntscrn ОС Windows

Определяет, создавать ли файл снимка экрана при аварийном завершении клиентской части программы. Имя файла совпадает с именем дампа, но имеет расширение png. Файлы снимков экрана создаются в том же каталоге, что и дампы (атрибут location).

• 0 (false) – не создавать;
• 1 (true) – создавать.

При аварийном завершении работы программы BAS система отображает диалог с информацией о процессе записи дампа, который автоматически закрывается после завершения записи дампа.

Атрибут externaldump ОС Windows

Управляет формированием дампа аварийного завершения работы, если система работает под управлением ОС Windows. Атрибут может принимать следующие значения:

• 0 (false) – дамп формируется аварийно завершающимся процессом (значение по умолчанию).
• 1 (true) – дамп формируется внешней программой dumper.exe, включенной в комплект поставки системы. При использовании внешней программы исключается возможность зависания во время создания дампа.

Если внешняя программа не найдена или при ее запуске обнаружены проблемы, будет использован обычный режим создания дампов (с помощью аварийно завершающегося процесса).

Рекомендуется использовать внешнюю программу формирования дампов для серверов BAF, работающих без ежедневного обслуживания.

Вывод контекстов исключительных ситуаций

Контекстом исключительных ситуаций (исключения) является последовательность событий технологического журнала типа EXCPCNTX. Каждое событие типа EXCPCNTX является одним из длительных событий, которые начались, но не завершились на момент возникновения нештатной ситуации в работе программы. События выводятся в порядке убывания уровня вложенности. Тип события, исходного для события EXCPCNTX, становится значением свойства SrcName события EXCPCNTX.

Контекст исключения выводится в технологический журнал, если технологический журнал включен (в файле logcfg.xml есть хотя бы один элемент log) и произошла одна из следующих нештатных ситуаций:

• Во время работы системы произошла исключительная ситуация операционной системы, процесс (клиентский или серверный) аварийно завершился, сформирован дамп аварийного завершения.
• Произошла исключительная ситуация в базе данных, которая привела к появлению сообщения об ошибке и закрытию программы BAS.

При возникновении любой ошибки базы данных в технологический журнал записывается событие типа EXCP, если оно соответствует условиям, записанным в конфигурационном файле технологического журнала (logcfg.xml).