Коллеги, начинаем серию статей, посвященных технологическому журналу.
В этой серии мы с вами рассмотрим практику использования полезного инструмента для расследования проблем производительности и стабильности 1С:Предприятие – технологического журнала.
Далеко не все специалисты о нем знают, а умеют грамотно использовать лишь немногие. Попытаемся исправить ситуацию:)
Описание и включение технологического журнала
Что Вы узнаете из этой статьи?
- Описание и предназначение инструмента Технологический журнал
- Как включить Технологический журнал в 1С:Предприятие 8
- Принцип формирования и сохранения логов и дампов
Описание ТЖ
ТЖ предназначен для расследования ошибок, анализа и диагностики различных проблем в работе платформы 1С:Предприятие .
С помощью ТЖ можно выяснить, какие запросы работают медленно и откуда они вызываются, при выполнении какого кода «падают» рабочие процессы сервера, куда «утекает» память и многое, многое другое.
Все инструменты анализа производительности платформы используют ТЖ для получения информации. При желании и доскональном изучении вопроса с помощью ТЖ вы можете написать свой инструмент анализа производительности.
ТЖ можно собирать как для процессов сервера 1С, так и для клиентских приложений. Соответственно, и набор событий, которые можно фиксировать в ТЖ, будет отличаться.
Клиентские логи и дампы крайне редко вызывают интерес, поэтому в статье мы будем рассматривать ТЖ исключительно с точки зрения сервера. Тем не менее все, что здесь написано, также подходит и для клиентских логов.
С помощью ТЖ можно собирать логи и настраивать формирование дампов в случае аварийного завершения работы процесса.
Логи – это файлы с расширением .log , где информация хранится в текстовом виде.
Дампы
– это файл с расширением .mdmp
, который содержит в себе содержимое оперативной памяти процесса на момент «падения».
Дамп бывает крайне необходим для расследования проблем стабильности платформы. Мы не можем самостоятельно анализировать дампы, т.к. у нас нет исходного кода платформы, но мы можем отправить их в техническую поддержку или на партнерский форум и получить решение нашей проблемы.
Включение ТЖ
По умолчанию технологический журнал включен и работает, но собирает очень ограниченный объем данных.
Под минимальным объемом данных подразумеваются 2 вещи:
1) Формирование дампов минимального размера в случае аварийного завершения работы процессов кластера 1С (ragent, rmngr или rphost ).
По умолчанию дамп создается в каталоге:
%USERPROFILE%\Local Settings\Application Data\1C\1Cv82\dumps
Если вы используете Windows Vista и выше, то будет использоваться каталог:
%LOCALAPPDATA%\1C\1Cv82\dumps
Для 8.3 вместо каталога 1Cv82 используется 1Cv8 .
2) Для 8.3 в минимальный ТЖ входит формирование логов с одним событием SYSTEM с уровнем Error .
Логи сохраняются в каталоге:
%USERPROFILE%\Local Settings\Application Data\1C\1Cv8\logs
Для Windows Vista и старше используется каталог:
%LOCALAPPDATA%\1C\1Cv8\logs
Данные логи по умолчанию будут хранится 24 часа, после чего платформа будет удалять файлы логов, которые превышают этот порог.
Чаще всего информации из ТЖ по умолчанию недостаточно, и необходимо его настраивать вручную.
Чтобы произвести тонкую настройку ТЖ, необходимо создать файл logcfg.xml с определенной структурой в определенном месте.
Данный файл необходимо разместить в каталоге:
C:\Program Files\1Cv82\conf (для 8.3 каталог 1Cv8)
В этом случае настройки ТЖ будут действовать для всех версий 1С , которые установлены на данном компьютере, и для всех пользователей. Этот вариант используется чаще всего, и именно его рекомендуем применять.
При настройках ЦУПа , облачных сервисов контроля производительности и прочих инструментов, где надо указывать путь к logcfg , также лучше использовать именно этот каталог, иначе при обновлении платформы или изменении имени пользователя, под которым запущена служба сервера 1С , описанные инструменты перестанут работать и придется менять настройку.
Тем не менее есть и другие варианты, хотя и используются они гораздо реже. Опишу лишь то, что с наибольшей вероятностью вам может понадобится.
Чтобы настроить ТЖ только для одной версии платформы, размещаем logcfg.xml в каталоге:
C:\Program Files\1Cv82\8.2.19.106\bin\conf
Где 8.2.19.106 – это номер нужной вам версии.
Крайне редко, но все же, может возникнуть необходимость настроить ТЖ отдельно для каждого пользователя, под которым запущена служба сервера 1С .
Тогда размещаем logcfg в каталоге:
%USERPROFILE%\Local Settings\Application Data\1C\1Cv82\Conf
Для ОС Windows Vista и старше:
%LOCALAPPDATA%\1C\1Cv82\Conf
Это может потребоваться, если у вас, например, 1 служба сервера 1С используется как рабочая, а вторая для отладки. При необходимости можно запустить службы под разными пользователями и собирать ТЖ только для одной из них, чтобы не загружать второй сервер и не собирать в логах лишние данные, либо сделать для каждой из служб свои настройки ТЖ .
Настройки из logcfg считываются не моментально, а каждые 60 секунд, причем каждый из процессов кластера считывает файл настроек независимо от других процессов. Например, сначала могут появиться логи процесса rmngr и только через 45 секунды логи rphost.
Для выключения ТЖ достаточно удалить или переименовать файл logcfg.xml .
Бурмистров Андрей
В следующих статьях рассмотрим нюансы настройки ТЖ и практику использования.
А пока закрепите полученный материал на своей тестовой информационной базе:)
Технологический журнал — специальный механизм платформы 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С» |
Не так давно открыл для себя нечто новое, оказывается есть технологический журнал (ТЖ). Что это за зверь такой и для чего он нужен попытаюсь ответить в этой статье.
Как говорить сама 1С Технологический журнал
системы 1С:Предприятие 8 может использоваться для анализа технологических проблем работы системы и анализа аварийных завершений. Он регистрирует информацию от всех приложений системы 1С:Предприятие 8, работающих на данном компьютере.
Из этого определения сразу становится очевидность полезности этого инструмента, из него мы можем узнать например:
- при выполнении какого кода «падают» рабочие процессы сервера
- какие запросы работают медленно и откуда они вызываются
- Посмотреть были ли взаимоблокировки или блокировки по таймауту
- и многое другое.
Файлы эти можно разделить на 2 группы
- файлы дампа
- файлы логов
Дампы – это файл с расширением mdmp, который содержит в себе содержимое оперативной памяти процесса на момент «падения» .
Идем дальше. А в каком каталоге хранятся файлы ТЖ?.
По умолчанию
ТЖ создается в каталоге:
%USERPROFILE%\Local Settings\Application Data\1C\1Cv82\
Если используется Windows Vista и выше, то будет использоваться каталог: %LOCALAPPDATA%\1C\1Cv82\
Для 8.3 вместо каталога 1Cv82 используется 1Cv8.
Но этот каталог можно изменить. Об этом чуть ниже.
Как включить ТЖ?
По умолчанию технологический журнал включен, и настроен на сохранение минимальных дампов. С помощью специального файла мы можем настроить ТЖ. А именно можем изменить каталоги ТЖ, указать какие события должны регистрироваться в ТЖ и тд.
Я говорю о файле настроек ТЖ
logcfg.xml
.
Этот файл должен находится в каталоге conf в папке с установленной 1с, например
«D:\Program Files\1Cv8\conf»
Рассмотрим пример файла настроек для полного ТЖ.
config xmlns="http://v8.1c.ru/v8/tech-log">
Целесообразней настроить ТЖ только на интересующие нас события, например мы хотим посмотреть есть были ли в системе ошибки и долгие операции (>10 секунд)
С помощью настроек ТЖ можно отфильтровать практически любые интересующие нас события.
Допустим хотим видеть в ТЖ только ошибки и информацию о запросах к таблице AccRg105, которые длились более 3 секунд. Тогда logcfg должен выглядеть следующим образом.
Между двумя работает логическое ИЛИ, т.е. при возникновении любого из событий оно будет записано в ТЖ.
Внутри одного работает логическое И, т.е. данное событие будет записано только в том случае, если будут выполнены все условия внутри одного.
При такой настройке событие EXCP будет записываться всегда, а событие DBMSSQL только в том случае, если в любом месте текста запроса содержится строка «AccRg105» и при этом запрос выполнялся дольше 3 секунд. Фильтр на длительность события, надо ставить в десятитысячных долях секунды независимо от версии платформы. В данном примере мы используем несколько условий: eq, gt и like.
Можно использовать следующие условия:
- eq – равно;
- ne – не равно;
- gt – больше;
- ge – больше или равно;
- lt – меньше;
- le – меньше или равно;
- like – соответствие маске.
Платформа раз в минуту считывает данные из файла настроек, поэтому не стоит горячится и сразу проверять файлы, только спокойствие все будет через минуточку)
Если Вы не собираетесь посылать в фирму 1с данные дампов, то не зачем их и хранить, в файле настроек не указывайте строку dump location .
Если Вы собираетесь хранить файлы ТЖ в каталоге отличном от каталога по умолчанию, то лучше предварительно создайте его сами.
В тестовой базе я умышленно создал превышение таймаута на блокировке,
На примере этого
(или часть, используя фильтр), например:
— исполняемый код 1С:Предприятие 8;
— код Transact-SQL для СУБД;
— интерактивные действия пользователей,
— сообщения об ошибках,
Примечание. Если все равно не пишется ТЖ, то дать права всем на эту папку (временно, чтобы убедиться что дела в правах).
3) В каталоге технологического журнала не должно быть посторонних файлов. Каталог, в котором имеются посторонние файлы не позволит создавать журнал (логи).
4) Место хранения dumps и logs не хранить вместе, потому что через указанный интервал (по умолчанию 1 час) содержимое польностью перетирается и вы потеряете дампы
Настройка
ТЖ лучше настраивать (с помощью фильтров — тэгов logcfg.xml) только на исследуемые события, остальное не собирать, иначе словите «отсутствие места на диске» и тормоза в быстродействии сервера.
1) Легче выполнять настройку фильтров с помощью обработки с ИТС НастройкаТехнологическогоЖурнала.epf, но при этом помнить, что новые фичи последних релизов в обратке могут отстутствавать (каждая новая версия добавляет новые возможности, в обработки они не отражены). В этом случаи корректировать файл logcfg.xml руками.
2) Чтобы логи перестали собираться достаточно переименовать файл, перезапускать сервер не надо, настройки пересчитываются каждую минуту «на лету»
3) настроить logcfg.xml для фильтрации событий по определённой ИБ нужно использовать «p:processName=»
4) http://users.v8.1c.ru/Adm1936.aspx — примеры настроек
Подробности
Понятно, что собрать логи мало, их еще нужно обработать для решения конкретной задачи.
1) Сложности чтения ТЖ:
— Требует хорошего понимания архитектуры работы системы
— Тексты запросов регистрируются на внутреннем языке 1С:Предприятия и на языке DBMS
2) Файлы технологического журнала хранятся в подкаталогах. Имя каждого подкаталога технологического журнала одного процесса будет иметь вид: <ИмяПроцесса>_<ИдентификаторПроцесса>, например: rphost_4076. Имя файла журнала задается шаблоном ГГММДДЧЧ.log. Например, в журнале 07051819.log имя файла образовано от 2007 мая 18, 19 часов)
3) Журнал для анализа можно выгрузить в эксель, используя разделителем запятую например
Если Вы хотите воспользоваться журналом для анализа сообщений об ошибках, воспользуйтесь бесплатным сервисом .
если вы не нашли ответ на ваш вопрос, давайте расширим материал