Технологический журнал и его настройка
Технологический журнал представляет собой совокупность каталогов и текстовых файлов, в которые различные приложения 1С:Предприятия могут записывать информацию о работе некоторых внутренних механизмов платформы. Состав выводимой информации определяется конфигурационным файлом технологического журнала, который имеет название logcfg.xml и должен быть помещен в подкаталог conf каталога загрузочных модулей 1С:Предприятия. В этом файле средствами XML определяются условия вывода в технологический журнал событий и их свойств. Если файл logcfg.xml отсутствует, не содержит ни одного элемента log , или содержит ошибки, то технологический журнал считается выключенным и не создается. При выключенном технологическом журнале производительность 1С:Предприятия несколько выше, чем при включенном.
В приведенных ниже примерах предполагается, что 1С:Предприятие установлено стандартным способом и его загрузочные модули расположены в каталоге C:\Program Files\1cv82\bin .
Важно иметь в виду, что в каталог технологического журнала при некоторых его настройках могут выводится данные очень большого объема. Поэтому на диске, где будут храниться данные журнала регистрации, должно быть достаточно места. Для работы технологического журнала необходимо, чтобы пользователи, от имени которых запускаются приложения 1С:Предприятия (как клиентские, так и серверные), имели полные права на каталог технологического журнала (D : \ 1cv82\logs ), и право на чтение выше лежащего каталога (D : \ 1cv82 ).
ВНИМАНИЕ!
Необходимо иметь в виду, что каталог технологического журнала не предназначен для хранения в нем файлов, которые не относятся к технологическому журналу. Поэтому не следует размещать в нем дампы или использовать каталог, который может содержать файлы, не относящиеся к технологическому журналу «1С:Предприятия». Если в каталоге, который указан в качестве каталога
технологического журнала, имеются посторонние файлы, то указание каталога считается неверным, и технологический журнал не создается.
Система «1С:Предприятие» автоматически, с периодичностью 60 секунд, опрашивает каталоги конфигурационных файлов на предмет наличия файла logcfg.xml и анализирует его состав. Таким образом, изменение параметров технологического журнала может быть выполнено на ходу, без перезапуска работающих приложений системы «1С:Предприятие».
Технологический журнал выключен
Если файл logcfg.xml отсутствует или имя файла не равно «logcfg.xml » (например logcfg _1 .xml )в каталоге C:\Program Files\1cv82\bin\conf , то технологический журнал не создается. Если файл logcfg.xml необходим для правильной настойки дампов, то он не должен содержать ни одного элемента log .
Следующий пример определяет необходимость построения полного дампа приложения при его аварийном завершении. Дампы помещаются в каталог: D:\1cv82\dumps .
Полный технологический журнал
Приведенный ниже конфигурационный файл определяет вывод в технологический журнал всех событий вместе со всеми свойствами. Журнал будет сохраняться в течении 2 суток (48 часов). Объем выводимой информации при этом будет очень большим, однако, она может быть полезна при анализе сложных нештатных ситуаций. Данную конфигурацию рекомендуется использовать на этапе тестирования и при расследовании ошибок.
Обращения к СУБД
Следующий конфигурационный файл определяет, что технологический журнал будет содержать только обращения 1С:Предприятия к СУБД, а так же информацию об ошибочных ситуациях. Объем выводимой информации меньше, чем при полном технологическом журнале, но тоже может быть очень большим.
Действия администратора и ошибки
Этот конфигурационный файл создает технологический журнал небольшого объема, в котором содержится информация о запуске и завершении приложений, установке и разрыве соединений с кластером серверов 1С:Предприятия, действиях администратора кластера и об ошибочных ситуациях в работе 1С:Предприятия. Такой журнал в большинстве случаев достаточен, для расследования ошибочных ситуаций как в конфигурации, так и в технологической платформе 1С:Предприятия.
Ошибки и долгие операции
По сравнению с предыдущим, данный конфигурационный файл добавляет все операции, длительность которых превышает 10 секунд. Это может оказаться полезным для обнаружения действий пользователей, которые выполнялись длительное время, с целью, например, их последующей оптимизации. Длительность событий выражается в сотнях микросекунд.
).lt;/eventlogcfg
Андрей Луконькин
Технологический журнал «1С:Предприятие 8.1»
Система «1С:Предприятие 8.1» обеспечивает возможность ведения технологического журнала, в котором помещается информация от всех приложений, относящихся к «1С:Предприятие».
Технологический журнал представляет собой совокупность каталогов и текстовых файлов, в которые система записывает информацию о работе некоторых внутренних механизмов платформы «1С:Предприятие». Технологический журнал может использоваться разработчиками прикладных решений для анализа различных режимов работы системы, например для получения информации об ошибочных и исключительных ситуациях в конфигурации и технологической платформе, информации о запуске и завершении приложений, установке и разрыве соединений, действиях пользователей и администраторов.
Файлы журнала имеют текстовый формат, каждый файл содержит события за 1 час.
Технологический журнал может вестись на любом компьютере, на котором инсталлирована система «1С:Предприятие 8.1».
За параметры ведения технологического журнала отвечает конфигурационный файл logcfg.xml, в котором описываются:
- каталог, в котором будут располагаться файлы технологического журнала;
- состав информации, которая будет помещаться в технологический журнал;
- время, в течение которого хранятся файлы технологического журнала;
- параметры дампа, создаваемого при аварийном завершении приложения.
Файл logcfg.xml должен быть помещен в подкаталог conf каталога загрузочных модулей «1С:Предприятие» (обычно это каталог C:\Program Files\1cv81\bin).
Если файл logcfg.xml отсутствует или содержит ошибки, то технологический журнал считается выключенным и не создается. Следует избегать использования комментариев (конструкции типа ).
Важно! При создании записей технологического журнала работа системы замедляется. Это нужно учитывать в случаях, когда снижение производительности может быть критичным.
Состав конфигурационного файла logcfg.xml
По мере выхода новых версий платформы «1С:Предприятие» отслеживаемые события могут меняться и дополняться, но общий принцип структуры остается единым.
Элемент
Элемент
Например:
Это означает, что файлы будут храниться 12 часов в каталоге c:\1c8logs.
Элемент
В элемент
Событие включается в журнал, если оно удовлетворяет всем условиям внутри хотя бы одного из элементов
- eq – равно;
- ne – не равно;
- gt – больше;
- ge – больше или равно;
- lt – меньше;
- le – меньше или равно;
- like – соответствие маске.
Например:
Это означает, что в технологическом журнале будут создаваться записи о событиях с именем PROC.
Возможные имена групп событий смотрите в таблице.
Возможные имена групп событий
PROC |
События, относящиеся к процессу целиком и влияющие на дальнейшую работоспособность процесса. Например: старт, завершение, аварийное завершение и т.п. |
SCOM |
События создания или удаления серверного контекста, обычно связанного с информационной базой |
EXCP |
Исключительные ситуации приложений системы «1С:Предприятие 8.1», которые штатно не обрабатываются и могут послужить причиной аварийного завершения серверного процесса или подсоединенного к нему клиентского процесса |
EXCPCNTX |
События, которые начались, но не закончились в момент возникновения нештатной ситуации |
SDBL |
События, связанные с исполнением запросов к модели базы данных «1С:Предприятие 8.1» |
QERR |
События, связанные с обнаружением ошибок компиляции запроса или ограничения на уровне записей и полей базы данных |
PERR |
События, связанные с обнаружением ошибок работы с настройками пользователя |
CONN |
Установка или разрыв клиентского соединения с сервером |
ADMIN |
Управляющие воздействия администратора кластера серверов «1С:Предприятия 8.1» |
DBV8DBEng |
Исполнение операторов SQL файловой СУБД |
DBMSSQL |
Исполнение операторов SQL СУБД Microsoft SQL Server |
DBPOSTGRS |
Исполнение операторов SQL СУБД PostgreSQL |
Исполнение операторов SQL СУБД DB2 |
|
CALL |
Удаленный вызов |
TLOCK |
Управление транзакционными блокировками в управляемом режиме |
Элемент
Элемент
Используя свойства элемента Рассмотрим несколько примеров использования технологического журнала. Такой конфигурационный файл определяет вывод в технологический журнал всех событий вместе со всеми свойствами. Журнал будет сохраняться в течение 8 часов.
Следующий конфигурационный файл будут регистрировать все исключительные ситуации, связанные с блокировками и ожидания, превысившие 10 секунд (длительность событий выражается в сотнях микросекунд).
Этот конфигурационный файл определяет, что технологический журнал будет содержать только обращения «1С:Предприятие» к СУБД и информацию об ошибочных ситуациях.
Файл logcfg.xml легко создается в любом текстовом редакторе, но также можно воспользоваться внешней обработкой «Настройка технологического журнала» с диска ИТС (февраль 2008 г.).
Используя визуальный редактор, можно добавлять записываемые события, свойства и условия отображения свойств.
После редактирования появляется готовый текст конфигурационного файла, который можно сохранить или скопировать.
Заключение
Таким образом, использование технологического журнала позволяет зафиксировать широкий спектр действий и событий, а также дает возможность проанализировать возникшие проблемы при работе с «1С:Предприятие». На базе технологического журнала построена вся работа специализированной конфигурации «1С:Центр управления производительностью» (см. выпуск журнала №3(64) за март 2008 года).
Также возможно создание собственных систем, использующих структурированные файлы журнала для проведения анализа данных.
Примеры настройки технологического журнала
Технологический журнал выключен
Если файл logcfg.xml отсутствует в каталоге C:\Program Files\1cv81\bin, то технологический журнал не создается. Если файл logcfg.xml необходим для правильной настойки дампов, то он не должен содержать ни одного элемента log. Следующий пример определяет необходимость построения полного дампа приложения при его аварийном завершении. Дампы помещаются в каталог: C:\Program Files\1cv81\bin\dumps.
< config xmlns="http://v8.1c.ru/v8/tech-log">
< dump location="C:\Program Files\1cv81\bin\dumps" create="l" type="3"/>
< /config>
Полный технологический журнал
Приведенный ниже конфигурационный файл определяет вывод в технологический журнал всех событий вместе со всеми свойствами. Журнал будет сохраняться в течение недели (168 часов). Объем выводимой информации при этом будет очень большим, однако, она может быть полезна при анализе сложных нештатных ситуаций. Данную конфигурацию рекомендуется использовать на этапе тестирования и при расследовании ошибок.
Код
< config xmlns="http://v8.1c.ru/v8/tech-log">
< log location="C:\Program Files\1cv81\bin\logs" history="168"> < event>
< ne property="Name" value="" /> < /event>
< property name="al1"> < /property>
< /log>
< /config>
Обращения к СУБД
Следующий конфигурационный файл определяет, что технологический журнал будет содержать только обращения 1С:Предприятия к СУБД, а так же информацию об ошибочных ситуациях. Объем выводимой информации меньше, чем при полном технологическом журнале, но тоже может быть очень большим.
< config xmlns="http://v8.1c.ru/v8/tech-log">
< log location="C:\Program Files\1cv81\bin\logs" history="168"> < event>
< eq propertу ="Name" va1ue="DBV8DBEng" /> < /event>
< event>
< eq propertу ="Name" va1ue="DBMSSQL"/> < /event>
< event>
< eq property="Name" value="DBPOSTGRS"/> < /event> < event>
< eq property="Name" value="DB2"/> < /event> < event>
< eq proper t у ="Name" va1ue="EXCP"/> < /event>
< property name="al1"> < /property>
< /log>
< /config>
Действия администратора и ошибки
Этот конфигурационный файл создает технологический журнал небольшого объема, в котором содержится информация о запуске и завершении приложений, установке и разрыве соединений с кластером серверов 1С:Предприятия, действиях администратора кластера и об ошибочных ситуациях в работе 1С:Пред приятия. Такой журнал в большинстве случаев достаточен, для расследования ошибочных ситуаций как в конфигурации, так и в технологической платформе 1С:Предприятия.
< config xmlns="http://v8.1c.ru/v8/tech-log">
< log location="C:\Program Files\1cv81\bin\logs" history="168"> < event>
< event> < eq property= Name" value= PR0C"/> < /event>
< event> < eq property= Name" value= SC0M"/> < /event>
< event> < eq property= Name" value= C0NN"/> < /event>
< event> < eq property= Name" value= EXCP"/> < /event>
< event> < eq property= Name" value= ADMIN"/> < /event>
< event> < eq property= Name" value= QERR"/> < /event>
< property name="all"> < /property>
< /log>
< /config>
Ошибки и долгие операции
По сравнению с предыдущим, данный конфигурационный файл добавляет все операции, длительность которых превышает 10 секунд. Это может оказаться полезным для обнаружения действий пользователей, которые выполнялись длительное время, с целью, например, их последующей оптимизации. Длительность событий выражается в сотнях микросекунд.
< config xmlns="http://v8.1c.ru/v8/tech-log">
< log location="C:\Program Files\1cv81\bin\logs" history="168"> < event>
< event> < eq property= Name" value= PR0C"/> < /event>
< event> < eq property= Name" value= SC0M"/> < /event>
< event> < eq property= Name" value= C0NN"/> < /event>
< event> < eq property= Name" value= EXCP"/> < /event>
< event> < eq property= Name" value= ADMIN"/> < /event>
< event> < eq property= Name" value= QERR"/> < /event>
< event> < gt property= Duration" value="100000"/> < /event>
< property name="al1"> < /property>
< /log>
< /config>
Технологический журнал — специальный механизм платформы 1С 8.2 и 8.3, который позволяет протоколировать все события, происходящие в системе, в том числе системные ошибки. Рассмотрим инструкцию по настройке технологического журнала в 1С: Предприятии.
Инструкция по настройке технологического журнала
- Завести на локальных дисках серверов приложений 1С специальную папку для технологического журнала. Например, C:\LOG . И для дампов, например, C:\dumps.
- Настроить журнал на сбор сообщений об ошибках (см. файл ) в подкаталог этого каталога. Подкаталог будем называть по дате: C:\LOG\2014-04-22 и т.д.
- Сам файл logcfg.xml надо положить в каталог conf папки установки сервера (!) 1С: Предприятия (например, C:\Program Files\1cv82\8.2.17.153\bin\conf).
- После этого примерно через минуту убедиться, что в каталоге создалась папка C:\LOG\2014-01-01, и в ней еще подпапки с именами rphost_XXXX, ragent_XXXX, rphost_XXXX, а в них файлики.
- Если создались, то все нормально, если не создались, то что-то не так.
- Если что-то не так: наиболее распространенные ошибки: большие/маленькие буквы в именах каталогов (регистр должен совпадать), в файле настройки написали слеш на конце имени каталога (не нужен), а еще иногда требуется донастроить права пользователей на папки C:\LOG, C:\dumps, C:\Program Files\1cv82\8.2.17.153\bin\conf, если они чересчур «закручены».
Файл logcfg.xml изнутри должен выглядеть примерно так:
Получите 267 видеоуроков по 1С бесплатно:
Атрибуты для настройки журнала
ALL | Все события | Абсолютно все события технологического журнала |
ADMIN | Административное действие | Действия пользователя-администратора |
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 | Обращение к аппаратному ключу защиты () |
LEAKS | Утечка памяти | Событие, связанное с утечкой памяти, которая может быть вызвана ошибками в коде конфигурации 1С 8.2 |
MEM | Утечка памяти сервера | Событие, связанные с увеличением объема памяти, занятой серверными процессами (ragent, rmngr, ). |
PROC | Процесс | Событие, относящееся к процессу целиком и влияющие на дальнейшую работоспособность процесса. Например: старт, завершение, аварийное завершение и т. п. |
QERR | Ошибка запроса | Событие, связанное с обнаружением ошибок компиляции запроса или ограничением на уровне записей и полей базы данных |
SCALL | Исходящий вызов | Исходящий удаленный вызов (исходящий вызов на стороне источника вызова). |
SCOM | Серверный контекст | Событие создания или удаления серверного контекста, обычно связанного с информационной базой. |
SDBL | Запрос к базе данных | Исполнение запросов к модели базы данных 1С: Предприятия 8.3 |
SESN | Сеанс | Действие, относящиеся к сеансу работы. Например: начало сеанса, окончание сеанса и т. д. |
SRVC | Сервисы кластера | События, связанные с запуском, остановкой и оповещениями сервисов кластера серверов |
TLOCK | Блокировка | Управление транзакционными блокировками в Управляемом режиме |
TDEADLOCK | Обнаружена взаимоблокировка в Управляемом режиме | |
TTIMEOUT | Таймаут | Превышено максимальное время ожидания транзакционной блокировки |
VRSCACHE | Кеш http | Работа кеша серверных вызовов |
VRSREQUEST | Запрос к серверу | Запрос к серверу за некоторым ресурсом |
VRSRESPONSE | Ответ сервера | Ответ сервера |
SYSTEM | Системные события | Системные события механизмов платформы, предназначенные для анализа сотрудниками фирмы «1С» |