Технологический журнал в 1С

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

Общая информация

Технологический журнал является основным источником информации для всех инструментов анализа производительности платформы.

Ведение технологического журнала возможно как для сервера, так и для клиентских приложений. Так как клиентские логи и дампы, за редким исключением, не представляют практического интереса, вопрос мы будем рассматривать только со стороны сервера. Тем не менее, все сказанное ниже, будет верно и для клиента.

Технологический журнал может продуцировать два вида информации:

• Логи — файлы с расширением *.log, в которых в текстовом виде храниться информация о произошедших событиях;
• Дампы — файлы с расширением *.mdmp, в которых хранится содержимое оперативной памяти рабочего процесса на момент его «падения». Самостоятельный анализ дампа невозможен, так как исходный код платформы закрыт. Единственный способ проанализировать дамп — отправить  его в тех. поддержку или на партнерский форум.

Включение технологического журнала

По умолчанию технический журнал включен и работает, дампы хранятся здесь:

%LOCALAPPDATA%\1C\1cv8\dumps (пример: C:\Users\USR1CV8\AppData\Local\1C\1cv8\dumps)

а логи здесь:

%LOCALAPPDATA%\1C\1cv8\logs (пример: C:\Users\USR1CV8\AppData\Local\1C\1cv8\logs)

USR1CV8 — имя пользователя под которым работает сервер 1С. Логи хранятся 24 часа, при этом делятся на файлы — каждый час новый файл.

Собираемая таким образом информация минимальна — формируются дампы минимального размера при аварийном завершении работы рабочих процессов, а в логи попадают только события SYSTEM с уровнем Error.

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

Выбор директории зависит от задачи: если нужно настроить тех. журнал для всех версий 1С, то файл настроек нужно разместить здесь:

C:\Program Files\1cv8\conf

Если настроить нужно конкретную версию, то здесь (зависит от версии):

C:\Program Files\1cv8\8.3.13.1513\bin\conf

Иногда может потребовать включить тех. журнал для конкретного пользователя, из под которого запущен сервер 1С, в этом случае файл настроек следует разместить тут:

C:\Users\USR1CV8\AppData\Local\1C\1cv8\conf

Перезагружать сервер не требуется, настройки считаются и будут применены не более чем через 60 секунд. Выключить тех. журнал еще проще — нужно переместить или переименовать файл настроек.

Создание файла настроек

Теперь перейдем к содержимому файла настроек logcfg.xml.

Вначале приведем пример файла настроек:

<dump>

Этот элемент отвечает за формирование дампов памяти. Атрибуты:

location — каталог в который будут сохраняться дампы, значение этого атрибута должно отличаться от значений такого же атрибута у других элементов (<log> и <defaultlog>).

create — записывать (1) или не записывать (0) дампы.

type — тип дампа, любая комбинация (сумма) из перечисленных ниже флажков:

• 0 — минимальный;
• 1 — дополнительный сегмент данных;
• 2 — содержимое всей памяти процесса;
• 4 — данные хэндлов;
• 8 — оставить в дампе только информацию, необходимую для восстановления стеков вызовов;
• 16 — если стек содержит ссылки на память модулей, то добавить флажок флаг 64;
• 32 — включить в дамп память из-под выгруженных модулей;
• 64 — включить в дамп память, на которую есть ссылки;
• 128 — добавить в дамп подробную информацию о файлах модулей;
• 256 — добавить в дамп локальные данные потоков;
• 512 — включение в дамп памяти из всего доступного виртуального адресного пространства.

Компания «1С» советует использовать значение 3 (1+2), так как в большинстве случаев этого достаточно.

<log>

Этот элемент определяет каталог тех. журнала и события которые в него попадают. Таких элементов может быть несколько т.е. сервер 1С может вести сразу несколько тех. журналов с различными настройками. Тем не менее компания «1С» не рекомендует вести более 20 тех. журналов одновременно, так как это может замедлить работу системы. Может содержать внутри себя элементы <event> и <property>. Атрибуты:

location — каталог в который будут записываться логи, этот каталог должен быть пустым, кроме этого он не должен совпадать со значениями аналогичных атрибутов у других элементов.

history — время жизни логов, в часах.

<event>

Определяет условия, при выполнении которых событие попадает в журнал. Само условие задается следующими элементами:

• eq — равно;
• ne — не равно;
• gt — больше;
• ge — больше или равно;
• lt — меньше;
• le — меньше или равно;
• like — соответствие маске.

<property>

Определяет условия попадания в журнал значения свойства события.

Элемент <property name=»all»> </property> включает записи в журнал всех свойств событий.

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

Руководство администратора (желтая, не очень толстая книжечка) можно легко найти в электронном виде, да и бумажном оно встречается достаточно часто, так как входит во многие поставки продуктов компании 1С.

На этом все, надеюсь эта статья была Вам полезна.

Оценка статьи:

(оценок: 16, средняя оценка: 2,19 из 5)