Как открыть LGD-файл 1С и разобрать технологический журнал

Файлы с расширением .lgd создаёт платформа 1С:Предприятие при включённом технологическом журнале — это текстовые протоколы событий сервера и клиента: запросы к СУБД, вызовы, ошибки, блокировки. Возникают они не сами по себе, а только если администратор разместил конфигурационный файл logcfg.xml в каталоге conf платформы. Поэтому первый вопрос при виде LGD-файла — откуда он взялся и какой процесс его писал.

Открыть такой файл можно обычным текстовым редактором, но для реального анализа удобнее специализированные средства: встроенный просмотр в консоли кластера недоступен, поэтому используют Notepad++, бесплатные разборщики технологического журнала или обработки для 1С. Выбор инструмента зависит от объёма файла и задачи — быстро найти ошибку или построить статистику по длительным запросам.

Что находится внутри LGD-файла

Каждая строка технологического журнала — это событие в строгом формате: длительность в микросекундах, имя события (DBMSSQL, DBPOSTGRS, EXCP, CALL, TLOCK и другие), затем пары «свойство=значение» через запятую. События одного вызова могут группироваться по идентификатору соединения и номеру интерфейса, что позволяет восстановить цепочку действий.

Файлы ротируются автоматически: платформа создаёт новый файл по истечении интервала, заданного в logcfg.xml параметром history, либо при достижении времени жизни журнала. Имена файлов содержат метку времени и имя процесса (rphost, rmngr, 1cv8), поэтому по имени уже можно понять, какой рабочий процесс сервера писал этот фрагмент.

Как включить запись LGD-файлов, если журнал не пишется

Если в каталоге технологического журнала пусто, запись не настроена. Создайте файл logcfg.xml в подкаталоге conf каталога установки платформы (например, C:\Program Files\1cv8\<версия>\bin\conf) или в каталоге conf рядом с исполняемыми файлами сервера. Минимальный конфиг включает запись ошибок и событий СУБД в указанный каталог.

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

<config xmlns="http://v8.1c.ru/v8/tech-log">
  <log location="D:\1clogs" history="24">
    <event><eq property="name" value="EXCP"/></event>
    <event><eq property="name" value="DBMSSQL"/></event>
    <property name="all"/>
  </log>
</config>

Не включайте полный дамп всех событий на постоянной основе: при интенсивной работе журнал растёт очень быстро и может занять десятки гигабайт за день. Для постоянного мониторинга ограничьтесь ошибками (EXCP) и длительными событиями через условия по длительности.

Чем открыть LGD-файл для просмотра

Самый простой способ — Notepad++ или аналогичный редактор, устойчивый к большим файлам. Стандартный «Блокнот» Windows на файлах в сотни мегабайт зависает. В Notepad++ удобно искать по имени события: например, Ctrl+F и строка «EXCP» покажет все исключения, а «DBMSSQL» — запросы к SQL Server.

Для регулярного анализа удобнее специализированные инструменты: бесплатные разборщики технологического журнала (например, решения на базе OneScript или обработки-анализаторы ТЖ), которые парсят события в таблицу с фильтрами по длительности, пользователю, типу события. Они строят топ длительных запросов и группируют ошибки — вручную это делать непрактично.

Как прочитать событие и найти нужное

Начните с конца файла, если ищете свежую ошибку: события пишутся хронологически. Найдите поиском метку времени проблемы, затем смотрите события EXCP вокруг неё. В свойствах события ищите Descr (описание), Context (контекст кода 1С), Usr (пользователь) и процесс с именем базы.

Для проблем производительности фильтруйте события DBMSSQL или DBPOSTGRS по длительности — число в начале строки до имени события. Значение в десятки миллионов микросекунд означает запрос длительностью в десятки секунд. Свойство Sql содержит текст запроса, а planSQLText — план выполнения, если его запись включена.

1. 1
   Определите примерное время возникновения проблемы по словам пользователя или журналу регистрации
2. 2
   Откройте LGD-файл нужного процесса (rphost) за этот период в Notepad++
3. 3
   Найдите поиском события EXCP вокруг нужной метки времени
4. 4
   Изучите свойства Descr и Context — там причина и место в коде
5. 5
   Проверьте соседние события DBMSSQL/TLOCK, если ошибка связана с запросом или блокировкой

Типичные проблемы при открытии и их решение

Файл не открывается из-за размера — разбейте его: в Notepad++ откройте только часть через Far Manager (просмотр по F3 умеет работать с огромными файлами без загрузки в память) или используйте PowerShell-команду Get-Content с параметром -Tail для чтения последних строк.

Кракозябры вместо русского текста означают неверную кодировку: технологический журнал пишется в UTF-8, поэтому в редакторе вручную переключите кодировку на UTF-8. Файл пустой или обрывается на середине строки — вероятно, процесс был принудительно завершён; такие «обрезки» нормальны и не лечатся.

Безопасность и ограничения

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

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

Проверка результата

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

Частые вопросы