Технологический журнал удобно использовать для отслеживания и последующего анализа процессов, происходящих при работе платформы 1С Предприятие. Благодаря обширному количеству опций можно выполнить гибкую настройку технологического журнала для получения наиболее точной и конкретной информации о выбранных событиях.
Сегодня мы рассмотрим:
- что представляет собой технологический журнал,
- где находится конфигурационный файл технологического журнала,
- как правильно включать технологический журнал,
- как выполнить настройку технологического журнала для сбора требуемой информации,
- какие опции используются для настройки технологического журнала,
- примеры рабочих конфигурационных файлов для технологического журнала.
Что представляет собой технологический журнал
Форматом технологического журнала 1С, определенным разработчиком, является набор текстовых файлов. Текстовые файлы с отобранной диагностической информацией располагаются в определенных каталогах, в зависимости от состава описываемых процессов. Файлы именуются по следующему шаблону [ИМЯ ПРОЦЕССА]_[ИДЕНТИФИКАТОР ПРОЦЕССА]. Например: ragent_0856.
Где находится конфигурационный файл технологического журнала
Конфигурационный файл, использующийся для работы технологического журнала, содержит следующую информацию:
- папка, в которой будут находиться файлы отчета об анализируемых процессах;
- описание набора анализируемых процессов;
- время хранения файлов журнала;
- опции для дампа, который формируется при аварийном завершении.
По умолчанию такой файл отсутствует. Технологический журнал при этом включен и обеспечивает сохранение минимальных дампов при аварийном завершении приложения в следующую папку:
%USERPROFILE%\Local Settings\Application Data\1C\1cv8\dumps
Для операционных систем выше Windows Vista:
%LOCALAPPDATA%\1C\1cv8\dumps
Также обеспечивается удаление информации по умолчанию через 24 часа, уровень формирования событий журнала установлен в Error.
Как правильно включать технологический журнал
Чтобы включить технологический журнал на сбор нужной отладочной информации, нужно создать отдельный конфигурационный файл. Он должен называться logcfg.xml и находиться в папке конфигурационных файлов системы «1С:Предприятие».
Это:
- в ОС Windows может располагаться в папках:
- Каталог bin\conf установленной версии (для версии 8.3.8.2027 — %SYSTEMDRIVE%\Program Files\1Cv8\8.3.8.2027\bin\conf)
- Каталог %USERPROFILE%\Local Settings\Application Data\1C\1Cv82\Conf активного пользователя (для Windows 10 и пользователя «Администратор» — C:\Users\Администратор\AppData\Local\1C\1cv8\conf).
- Каталог, определяемый в файле bin\conf\conf.cfg.
- в ОС Linux файл находится в папке: /opt/1C/v8.2/i386/conf (для 64-битной — /opt/1C/v8.2/x86-64/conf ).
Итак, подготовим нужные папки. Например создадим папку для отладочной информации %SYSTEMDRIVE%\LogFiles и для файлов дампов %SYSTEMDRIVE%\Dumps.
Как выполнить настройку технологического журнала для сбора требуемой информации
Далее создадим файл logcfg.xml в одном из упомянутых выше каталогов, например С:\Program Files\1Cv8\8.3.8.2027\bin\conf Затем определим в файле logcfg.xml нужные опции для отображения в лог-файлах.
Простейший пример файла logcfg.xml:
1 2 3 4 5 6 7 8 9 10 |
<?xml version=»1.0″ encoding=»UTF-8″?> <config xmlns="http://v8.1c.ru/v8/tech-log"> <dump create="true" location="c:\Dumps" prntscrn="true" type="2"/> <log history="48" location="c:\LogFiles"> <event> <eq property="name" value="EXCP"/> </event> <property name="all"/> </log> </config> |
Этот файл настраивает технологический журнал на сбор данных обо всех исключительных ситуациях, возникших в работе системы 1С:Предприятие, данные хранятся 48 часов и располагаются в созданных нами каталогах.
Сервер обращается к файлу настроек один раз в минуту. Поэтому, в случае нормального запуска и настройки в указанных каталогах для логов и дампов должны появиться файлы описанного вначале формата с диагностической информацией.
Если файлы не появились, то рекомендуем проверить:
- права на созданные папки;
- формат записей в файле конфигурации;
- пути к папкам, они не должны завершаться «слешем»;
- регистры букв и т.д.
Какие опции используются для настройки технологического журнала
ALL | Все события | Абсолютно все события технологического журнала |
ADMIN | Административное действие | Действия пользователя-администратора кластера серверов 1С Предприятия 8.2 |
CALL | Входящий вызов | Входящий удаленный вызов (удаленный вызов на стороне приемника вызова) |
CONN | Соединение с сервером | Установка или разрыв TCP-соединения между процессами системы «1С 8.3» |
CLSTR | Активность кластера | Выполнение операций, изменяющих работу кластера серверов |
EDS | Внешний источник данных | Все события внешних источников данных |
DB2 | IBM DB2 | Исполнение операторов SQL СУБД IBM DB2 |
DBMSSQL | Microsoft SQL Server | Исполнение операторов SQL СУБД Microsoft SQL Server |
DBPOSTGRS | PostgreSQL | Исполнение операторов SQL СУБД PostgreSQL |
DBORACLE | Oracle Database | Исполнение операторов SQL СУБД Oracle Database |
DBV8DBEng | SQL, Файловая СУБД | Исполнение операторов SQL файловой СУБД |
EXCP | Исключение | Исключительная ситуация приложения системы «1С:Предприятие», которое штатно не обрабатывается и может послужить причиной аварийного завершения серверного процесса или подсоединенного к нему клиентского процесса |
EXCPCNTX | Контекст исключения | Событие, которые началось, но не закончились в момент возникновения нештатной ситуации |
HASP | Обращение к HASP | Обращение к аппаратному ключу защиты (HASP) |
LEAKS | Утечка памяти | Событие, связанное с утечкой памяти, которая может быть вызвана ошибками в коде конфигурации 1С 8.2 |
MEM | Утечка памяти сервера | Событие, связанные с увеличением объема памяти, занятой серверными процессами (ragent, rmngr, rphost). |
PROC | Процесс | Событие, относящееся к процессу целиком и влияющие на дальнейшую работоспособность процесса. Например: старт, завершение, аварийное завершение и т. п. |
QERR | Ошибка запроса | Событие, связанное с обнаружением ошибок компиляции запроса или ограничением на уровне записей и полей базы данных |
SCALL | Исходящий вызов | Исходящий удаленный вызов (исходящий вызов на стороне источника вызова). |
SCOM | Серверный контекст | Событие создания или удаления серверного контекста, обычно связанного с информационной базой. |
SDBL | Запрос к базе данных | Исполнение запросов к модели базы данных 1С:Предприятия 8.3 |
SESN | Сеанс | Действие, относящиеся к сеансу работы. Например: начало сеанса, окончание сеанса и т. д. |
SRVC | Сервисы кластера | События, связанные с запуском, остановкой и оповещениями сервисов кластера серверов |
TLOCK | Блокировка | Управление транзакционными блокировками в Управляемом режиме |
TDEADLOCK | Взаимоблокировка | Обнаружена взаимоблокировка в Управляемом режиме |
TTIMEOUT | Таймаут | Превышено максимальное время ожидания транзакционной блокировки |
VRSCACHE | Кеш http | Работа кеша серверных вызовов |
VRSREQUEST | Запрос к серверу | Запрос к серверу за некоторым ресурсом |
VRSRESPONSE | Ответ сервера | Ответ сервера |
SYSTEM | Системные события | Системные события механизмов платформы, предназначенные для анализа сотрудниками фирмы «1С» |
Примеры рабочих конфигурационных файлов для технологического журнала
Соберем данные о запросах, которые выполняются более 10 секунд на сервере, работающей под управлением СУБД PostgreSQL
1 2 3 4 5 6 7 8 9 10 |
<?xml version=»1.0″ encoding=»UTF-8″?> <config xmlns="http://v8.1c.ru/v8/tech-log"> <dump create="true" location="c:\Dumps" prntscrn="true" type="2"/> <log history="1" location="c:\LogFiles"> <event> <eq property="Name" value="DBPOSTGRS" /> </event> <property name="sql"> <event> <eq property="Name" value="DBPOSTGRS" /> <gt property="Duration" value="10000" /> </event> </property> </log> </config> |
Такой конфигурационный файл создаст журнал с данными о о запуске и завершении приложений, установке и разрыве соединений с кластером серверов «1С:Предприятия», действиях администратора кластера и об ошибочных ситуациях в работе «1С:Предприятия».
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
<config xmlns="http://v8.1c.ru/v8/tech-log"> <log location="с:\LogFiles" history="168"> <event> <eq property="name" value="admin"/> </event> <event> <eq property="name" value="conn"/> </event> <event> <eq property="name" value="excp"/> </event> <event> <eq property="name" value="proc"/> </event> <event> <eq property="name" value="qerr"/> </event> <event> <eq property="name" value="scom"/> </event> <property name="all"/> </log> </config> |
Выведем полный технологический журнал
1 2 3 4 5 6 7 8 9 |
<config xmlns="http://v8.1c.ru/v8/tech-log"> <log location="с:\LogFiles" history="72"> <event> <ne property="name" value=""/> </event> <property name="all"> </property> </log> </config> |
Если у Вас появились вопросы по статье или остались нерешенные проблемы обсудить их Вы можете на Форуме 1С Вопросы и ответы
Добавить комментарий
Для отправки комментария вам необходимо авторизоваться.