К статье
Практический материал

Администрирование · 11 мин

Чем открыть файл LGF в 1С: обзор способов и инструментов

Что такое файл LGF в 1С, чем его открыть: блокнот, Notepad++, конфигуратор, специализированные просмотрщики. Структура, настройка и решение проблем.

Файл с расширением .lgf — это файл технологического журнала платформы «1С:Предприятие». В него система записывает служебные события: вызовы сервера, запросы к базе данных, ошибки, длительные операции и другую диагностическую информацию. Администраторы и разработчики используют эти файлы для поиска причин ошибок и анализа производительности.

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

Ниже разобраны основные способы открытия LGF-файлов: от встроенных средств Windows до специализированных просмотрщиков, а также настройка самого технологического журнала и типичные проблемы при работе с ним.

Что такое файл LGF и где он находится

Технологический журнал — это механизм платформы 1С, который фиксирует события работы сервера и клиентских приложений. Он включается не по умолчанию, а через конфигурационный файл logcfg.xml, размещаемый в каталоге conf установки платформы или в каталоге служебных файлов сервера.

После включения журнала платформа создаёт каталоги по именам процессов (rphost, ragent, rmngr, 1cv8 и другие), а внутри них — файлы вида 24112800.lgf, где имя отражает дату и час создания. Каждый файл обычно охватывает один час работы, после чего создаётся следующий.

Рядом с LGF-файлами могут находиться файлы с расширением .lgp — это служебные файлы с параметрами журнала, их открывать и редактировать вручную не требуется. Для анализа нужны именно файлы .lgf.

Открытие LGF встроенными средствами Windows

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

При этом способе важно учитывать кодировку. Технологический журнал платформа пишет в кодировке UTF-8. Если вместо русских сообщений об ошибках вы видите нечитаемые символы, при сохранении или открытии вручную выберите кодировку UTF-8. В современных версиях Блокнота UTF-8 определяется автоматически.

Ограничение Блокнота очевидно: LGF-файлы могут достигать сотен мегабайт, и стандартный редактор открывает такие объёмы медленно или вообще отказывается. Кроме того, в нём нет подсветки структуры событий, поэтому искать нужное приходится только через поиск по тексту (Ctrl+F).

Просмотр в Notepad++ и других текстовых редакторах

Для файлов среднего размера заметно удобнее использовать Notepad++ или аналогичные редакторы (Visual Studio Code, AkelPad). Они быстрее работают с большими файлами, поддерживают поиск по регулярным выражениям и позволяют настроить подсветку синтаксиса.

Практический приём: поскольку события в LGF разделены запятыми и содержат пары «свойство=значение», удобно искать по именам событий. Например, поиск по строке ,EXCP, покажет все исключения (ошибки), а ,DBMSSQL, — запросы к Microsoft SQL Server. Так можно быстро отфильтровать нужный тип событий, не читая весь журнал.

Если файл очень большой (несколько гигабайт), даже продвинутые редакторы могут не справиться. В этом случае помогут утилиты просмотра больших логов (Large Text File Viewer, glogg и подобные) либо разбиение файла на части. Альтернатива — открывать только нужный часовой сегмент, так как журнал и так нарезается по часам.

Специализированные просмотрщики технологического журнала

Для регулярного анализа текстовые редакторы неудобны: события многострочные, свойства перечислены через запятую, а длительности указаны в микросекундах. Специализированные инструменты парсят LGF-файлы и представляют данные в виде таблиц с фильтрами и сортировкой.

К таким инструментам относятся решения, распространяемые через портал ИТС (для подписчиков), а также сторонние анализаторы технологического журнала, доступные в сообществе разработчиков 1С. Они позволяют отфильтровать события по типу, длительности, пользователю, соединению, построить топ самых тяжёлых запросов и увидеть тексты запросов в читаемом виде.

Часть инструментов работает как внешние обработки непосредственно внутри 1С: вы указываете путь к каталогу технологического журнала, обработка загружает события и показывает их в табличном документе. Это удобно, когда анализ ведёт тот же специалист, который работает в конфигураторе.

Сравнение вариантов

Блокнот Windows

Подходит для разового просмотра небольшого файла. Ограничение: плохо работает с большими файлами, нет фильтрации событий.

Notepad++ / VS Code

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

Просмотрщики ТЖ (ИТС, сторонние)

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

Как включить технологический журнал, если файлов LGF нет

Если каталог технологического журнала пуст или отсутствует, значит, журнал не настроен. Чтобы платформа начала писать LGF-файлы, нужно создать файл logcfg.xml в каталоге conf установки платформы (например, в папке bin\conf соответствующей версии) и перезапустить сервер 1С или клиентское приложение.

Минимальная конфигурация включает элемент <log> с указанием каталога размещения (location), периода хранения (history, в часах) и списка событий (<event>). Например, чтобы ловить только ошибки, достаточно добавить событие EXCP; для анализа производительности добавляют события DBMSSQL, DBPOSTGRS, CALL, TLOCK и другие.

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

Порядок действий
  1. 1
    Создайте файл logcfg.xml в каталоге conf нужной версии платформы
  2. 2
    Укажите в нём каталог журнала, глубину хранения и нужные события (например, EXCP для ошибок)
  3. 3
    Перезапустите службу сервера 1С или клиентское приложение
  4. 4
    Дождитесь появления каталогов rphost/ragent с файлами .lgf
  5. 5
    Откройте файл нужного часа в редакторе или просмотрщике и проверьте наличие событий

Структура записи и как читать события

Каждая строка LGF-файла начинается с метки времени в формате ММ:СС.микросекунды, затем идёт длительность события в микросекундах, имя события, номер процесса и список свойств через запятую. Многострочные свойства (например, текст SQL-запроса) заключаются в кавычки и могут занимать десятки строк.

Ключевые события, которые чаще всего ищут: EXCP — исключения и ошибки платформы; DBMSSQL, DBPOSTGRS, DBORACLE — запросы к соответствующей СУБД с текстом запроса и длительностью; TLOCK и TDEADLOCK — управляемые блокировки и взаимоблокировки; CALL — сетевые вызовы; MEM — события нехватки памяти.

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

Контрольные точки

Как проверить результат

Журнал пишется
Норма

В указанном каталоге появились папки процессов с файлами .lgf текущего часа

Тревожный признак

Каталог пуст — проверьте путь в logcfg.xml, права на запись и перезапуск службы

Содержимое файла
Норма

Строки начинаются с меток времени, видны имена событий (EXCP, DBMSSQL и др.), русский текст читаем

Тревожный признак

Кракозябры вместо текста — файл открыт не в UTF-8; событий нет — не настроены нужные типы в logcfg.xml

Найдена ошибка
Норма

Событие EXCP по времени совпадает с жалобой пользователя, есть описание и контекст

Тревожный признак

Нужного события нет — ошибка произошла вне периода записи или журнал был отключён

Типичные проблемы и ошибки при работе с LGF

Самая частая ситуация — журнал перестал писаться или не создаётся вовсе. Причины: ошибка в синтаксисе logcfg.xml (платформа молча игнорирует некорректный файл), отсутствие прав на запись в указанный каталог у учётной записи службы сервера, переполненный диск, а также файл конфигурации, размещённый не в том каталоге conf.

Вторая группа проблем — нечитаемое содержимое. Если текст отображается неправильно, проверьте кодировку (нужна UTF-8). Если события есть, но среди них нет ошибок, хотя пользователи на них жалуются, — вероятно, в logcfg.xml не добавлено событие EXCP или настроен слишком узкий фильтр по свойствам.

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

Типичные ошибки
01
Опечатка в logcfg.xml — платформа игнорирует файл целиком, журнал не создаётся, а сообщений об ошибке нет
02
Включение всех событий без фильтров — гигабайты логов в час и лишняя нагрузка на диск
03
Отсутствие параметра history — файлы копятся месяцами и забивают диск сервера
04
Поиск ошибки не в том файле — события ищутся без учёта того, что имя LGF содержит час создания
05
Анализ файла в кодировке ANSI — русские сообщения превращаются в нечитаемые символы
Итог

Что важно запомнить

LGF — текстовый лог технологического журнала 1С в кодировке UTF-8. Для быстрого просмотра подойдёт Блокнот или Notepad++, для анализа — специализированные просмотрщики. Журнал включается через logcfg.xml, файлы нарезаются по часам, а настройку нужно делать избирательно, чтобы не перегрузить сервер.

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

Можно ли открыть LGF в самой 1С без сторонних программ?

Штатного просмотрщика технологического журнала в конфигураторе нет. Однако существуют внешние обработки, которые запускаются в режиме 1С:Предприятие, читают LGF-файлы и выводят события в табличный документ с фильтрами. Их можно найти на портале ИТС или в сообществах разработчиков.

Чем LGF отличается от журнала регистрации?

Журнал регистрации фиксирует прикладные события: действия пользователей с документами и справочниками, входы в систему, изменения данных. Технологический журнал (LGF) — низкоуровневый: запросы к СУБД, вызовы, блокировки, ошибки платформы. Для расследования «кто изменил документ» нужен журнал регистрации, для «почему всё тормозит» — технологический.

Файл LGF занимает несколько гигабайт и не открывается. Что делать?

Используйте программы для просмотра больших текстовых файлов, которые читают данные порциями, или разбейте файл на части. Также проверьте настройку logcfg.xml: вероятно, включён слишком широкий набор событий без фильтров. Сузьте состав событий и задайте фильтры по длительности, чтобы журнал писал только значимые данные.

Безопасно ли удалять старые файлы LGF?

Да, закрытые файлы прошлых часов можно удалять вручную — на работу платформы это не влияет. Не удаляйте только файл текущего часа, в который идёт запись. Правильнее всего ограничить глубину хранения параметром history в logcfg.xml, тогда платформа будет очищать старые файлы автоматически.

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

Наиболее вероятные причины: событие EXCP не добавлено в logcfg.xml; ошибка произошла на клиенте, а журнал настроен только для сервера (или наоборот); файл конфигурации не был применён из-за отсутствия перезапуска; либо ошибка произошла раньше, чем началась запись журнала. Проверьте конфигурацию и настройте сбор на нужном узле.

Можно ли конвертировать LGF в Excel или CSV?

Напрямую открыть LGF в Excel неудобно из-за многострочных событий и специфического формата разделителей. Практичнее использовать просмотрщики технологического журнала, которые парсят файл и позволяют выгрузить отфильтрованные события в табличный формат. Для разовых задач можно написать скрипт обработки, учитывающий структуру записей.