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

Технологический журнал предназначен для выявления ошибок, возникающих при эксплуатации системы, и диагностики работы системы службой технической поддержки фирмы «1С», а также для анализа технологических характеристик работы системы.

Состав и свойства событий технологического журнала могут меняться при выпуске обновлений платформы.

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

Технологический журнал может вестись на любом компьютере, на котором установлена система «1С: Предприятие». За ведение технологического журнала отвечает конфигурационный файл, в котором описываются:

Ø каталог, в котором будут располагаться файлы технологического журнала;

Ø состав информации, которая будет помещаться в технологический журнал;

Ø время, в течение которого хранятся файлы технологического журнала;

Ø параметры дампа, создаваемого при аварийном завершении приложения.

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

%USERPROFILE%\AppData\Local\1C\1cv8\dumps

       При необходимости может быть выполнена произвольная настройка журнала регистрации с помощью отдельного конфигурационного файла. Этот файл должен иметь имя logcfg.xml и располагаться в каталоге конфигурационных файлов системы «1С: Предприятие» «C :\ Program Files ( x 86)\1 cv 8\8.3.7.2008\ bin \ conf » ПРИМЕЧАНИЕ. Для работы технологического журнала в ОС Windows необходимо, чтобы пользователь процесса, который пишет технологический журнал, имел полные права на каталог технологического журнала и права на чтение владельца каталога технологического журнала.

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

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

ВНИМАНИЕ! Необходимо иметь в виду, что каталог технологического журнала не предназначен для хранения в нем файлов, которые не относятся к технологическому журналу. Поэтому не следует размещать в нем дампы или использовать каталог, который может содержать файлы, не относящиеся к технологическому журналу «1С: Предприятия». Если в каталоге, который указан в качестве каталога технологического журнала, имеются посторонние файлы, то указание каталога считается неверным, и технологический журнал не создается.

В простейшем виде конфигурационный файл может иметь, например, следующее содержимое:

<config xmlns="http://v8.1c.ru/v8/tech-log">

<log location="c:\1c\logs" history="1">

   <event>

       <eq property="name" value="conn"/>

   </event>

</log>

<dump location="c:\1c\dumps" create="1" type="2"/>

</config>

Данный конфигурационный файл указывает на следующее:

Ø в технологическом журнале регистрируются все события установки и разрыва клиентского соединения с сервером;

Ø файлы технологического журнала располагаются в каталоге C:\1c\logs;

Ø файлы технологического журнала хранятся в течение одного часа;

Ø файлы дампа помещаются в каталог C:\1c\dumps;

Ø файлы дампа содержат всю доступную информацию (содержимое всей памяти процесса).

При отсутствии конфигурационного файла используются следующие параметры:

Ø Технологический журнал – выключен.

Ø Технологический журнал по умолчанию – включен.

Ø Дампы минимального размера.

Ø Дампы сохраняются в каталог %USERPROFILE%\AppData\Local\1C\1cv8\dumps профиля текущего пользователя.

       Для записи событий, возникающих в критических ситуациях (с точки зрения системы «1С: Предприятие») предназначен технологический журнал по умолчанию. Для этого журнала создается фиксированный фильтр событий, который формирует платформа и который невозможно изменить.

Технологический журнал по умолчанию имеет следующие настройки:

Ø Каталог файлов технологического журнала по умолчанию:

Ø %USERPROFILE%\AppData\Local\1C\1cv8\dumps

Ø Информация удаляется из технологического журнала по умолчанию через 24 часа.

Ø В технологический журнал по умолчанию попадают события SYSTEM с уровнем Error.

       Указанные настройки можно изменить с помощью элемента <defaultlog>. Настройка правил формирования событий, которые регистрируются в технологическом журнале по умолчанию выполняется с помощью элемента <system>.

       Технологический журнал представляет собой каталог, в подкаталогах которого располагаются файлы с собранными технологическими данными. Каталог журнала имеет следующую структуру:

<каталог журнала>

<идентификатор процесса операционной системы>

   <файлы журнала одного процесса>

Каждый файл журнала содержит события за 1 час и имеет имя yymmddhh.log, где:

· yy – две последние цифры года;

· mm – номер месяца;

· dd – номер дня;

· hh – номер часа.

       Файлы журнала имеют текстовый формат. В файле сведения о завершении каждого события записываются с новой строки.

Например:

16:08.8750-9060,CALL,0,process=rphost,p:processName=DebugControlCenter,t:clientID=221,t:applicationName=Debugger,t:computerName=COMP1,Interface=5cf29e71-ec34-4f01-b7d1-3529a3da6a21,Method=0

16:08.8911-1,DBPOSTGRS,2,process=rphost,p:processName=Database,t:clientID=216,t:applicationName=1CV8,t:computerName= COMP1,t:connectID=125,Usr= User2,Trans=1,dbpid=58152,Sql="SELECT 1::INT8 FROM PG_CLASS WHERE pg_catalog.pg_table_is_visible(OID) AND RELKIND='r' AND RELNAME='params' LIMIT 1",Result=PGRES_TUPLES_OK

16:08.8913-1,DBPOSTGRS,2,process=rphost,p:processName=Database,t:clientID=216,t:applicationName=1CV8,t:computerName= COMP1,t:connectID=125,Usr=User2,Trans=1,dbpid=58152,Sql="SELECT Creation,Modified,Attributes,DataSize,BinaryData FROM Params WHERE FileName = 'ibparams.inf'",Result=PGRES_TUPLES_OK

Строка окончания события имеет формат: mm:ss.tttttt-d, <наименование>, <уровень>, <ключевые свойства>, где:

· mm – номер минуты в текущем часе.

· ss – номер секунды в текущей минуте.

· tttttt – номер микросекунды текущей секунды.

· d – длительность события в микросекундах.

· <наименование> – наименование события.

· <уровень> – уровень события в стеке текущего потока.

· <ключевые свойства> – <ключевое свойство>, <ключевое свойство>, …

· <Ключевое свойство> – <имя> = <значение>; <наименование>, <имя>, <значение> – произвольный текст. Если в нем присутствуют символы «конец строки» или «запятая», то текст заключается в кавычки или апострофы, в зависимости от того, каких символов в строке меньше, а кавычки или апострофы в тексте удваиваются.

       Пример настройки файла конфигурации технологического журнала (logcfg.xml), необходимой для создания дампов памяти аварийного завершения.

<config xmlns="http://v8.1c.ru/v8/tech-log">

<dump location="C:\Program Files\1cv8\dumps" create="1" type="3"/>

</config>

При такой настройке дампы памяти будут формироваться в каталоге C:\Program Files\1cv8\dumps и построенные дампы будут включать содержимое всей памяти процесса и дополнительный сегмент данных.

Пользователь, от чьего имени выполняется клиентское приложение или сервер, должен иметь полные права на каталоги:

· каталог временных файлов,

· каталог технологического журнала,

· каталог дампов.

Пользователь, от чьего имени выполняется клиентское приложение или сервер, должен иметь право на чтение каталогов:

· конфигурационных файлов;

· каталога-владельца каталога дампов.

Если в файле logcfg.xml выполнена настройка получения планов запросов, то такой файл должен располагаться в каталоге конфигурационных файлов соответствующего приложения:

· для клиент-серверного варианта – в каталоге конфигурационных файлов, доступных серверу «1С: Предприятия»;

· для файлового варианта с прямым подключением – в каталоге конфигурационных файлов, доступных нужной версии клиентского приложения;

· для файлового варианта с подключением через веб-сервер – в каталоге конфигурационных файлов, доступных расширению веб-сервера, обслуживающего данную информационную базу.