Использование Журнала регистрации

Область применения: управляемое приложение, обычное приложение.

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

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

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

2.2. Уровень важности события. Критичные события, требующие повышенного внимания администратора (ошибки бизнес-логики, сбои в программе, и т.п.), записываются в Журнал регистрации с уровнем важности «Ошибка». Потенциальные проблемы и не фатальные ошибки регистрируются как «Предупреждения». Для вывода информационных сообщений об успешном завершении той или иной операции используется уровень важности «Информация». Также возможно применять и более низкий уровень важности – «Примечание».

2.3. Комментарий. Содержит текстовую неструктурированную информацию о событии. В случае ошибок в этом поле содержится информация, необходимая для расследования причины проблемы. Не следует помещать в комментарий информацию сразу о нескольких событиях. Например, неправильно записывать одно событие с комментарием вида:

[01.01.2010 00:00:01] Начало инициализации обмена данными по настройке «Обмен данными выгрузка», номер строки настройки: 1
[01.01.2010 00:00:02] Окончание инициализации обмена данными (успешно)
[01.01.2010 00:00:03] Начало процесса обмена данными по настройке «Обмен данными выгрузка», номер строки настройки: 1
[01.01.2010 00:00:04] Начало записи изменений в файл обмена
[01.01.2010 00:00:05] Окончание записи изменений в файл обмена (успешно)
[01.01.2010 00:00:06] Окончание процесса обмена данными по настройке «Обмен данными выгрузка», номер строки настройки: 1
[01.01.2010 00:00:07] Выполнено, Выгрузка данных, Обработано 1 объектов

правильно записать столько событий, сколько их реально произошло.

Текст комментария – локализуем. Для записи в Журнал регистрации информации о возникшем исключении следует использовать конструкцию:

Пример регистрации дополнительных событий в функциональной подсистеме «Мой механизм»:

Попытка
ЗаписьЖурналаРегистрации(НСтр(«ru = ‘Мой механизм.Действие с возможной ошибкой'», КодОсновногоЯзыка),
УровеньЖурналаРегистрации.Информация, , ,
НСтр(«ru = ‘Начато действие'»));
ДействиеСВозможнойОшибкой(ОбъектДействия);
ЗаписьЖурналаРегистрации(НСтр(«ru = ‘Мой механизм.Действие с возможной ошибкой'», КодОсновногоЯзыка),
УровеньЖурналаРегистрации.Информация, , ,
НСтр(«ru = ‘Завершено действие'»);
Исключение
ЗаписьЖурналаРегистрации(НСтр(«ru = ‘Мой механизм.Действие с возможной ошибкой'», КодОсновногоЯзыка),
УровеньЖурналаРегистрации.Ошибка, , ,
НСтр(«ru = ‘»Во время выполнения действия произошла неизвестная ошибка.'») + Символы.ПС +
ПодробноеПредставлениеОшибки(ИнформацияОбОшибке());
КонецПопытки;
КонецПроцедуры

где переменная КодОсновногоЯзыка содержит код языка для хранения данных в информационной базе. Подробнее см. Автогенерированные данные в информационной базе: требования по локализации, п. 1.

3. Не следует использовать выборку из журнала регистрации в тех задачах, где критична высокая скорость выполнения выборки. Поскольку при больших объемах журнала регистрации скорость выборки падает пропорционально увеличению его объема.

Рекомендуется заводить отдельный регистр для протоколирования интересующих событий или обращаться к специализированным объектам платформы (например, МенеджерФоновыхЗаданий для выборки истории выполнения фоновых заданий).

Эту особенность нужно также учитывать при разработке отчетов по журналу регистрации.

Источник

Журнал регистрации

Журнал регистрации содержит информацию о том, какие события происходили в информационной базе в определенный момент времени или какие действия выполнял тот или иной пользователь. Для каждой записи журнала, отражающей изменение данных, отображается статус завершения транзакции (транзакция завершена успешно, или же транзакция отменена). Это позволяет понять изменены реально данные или нет:

Для событий успешной и неуспешной аутентификации в информационной базе 1С:Предприятия в журнал записывается, какой именно пользователь операционной системы выполняет эту аутентификацию.

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

Журнал регистрации доступен как в режиме 1С:Предприятие, так и в режиме Конфигуратор.

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

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

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

Кроме этого разработчик может самостоятельно добавлять записи в журнал регистрации, используя средства встроенного языка. Такая возможность позволяет настраивать журнал регистрации под нужды конкретного прикладного решения.

Используя средства работы со списками, разработчик имеет возможность выгрузить журнал регистрации в текстовый или табличный документ, который в дальнейшем может быть сохранен в собственном формате или, например, формате листа Excel или документа HTML.

Кроме этого поддерживается выгрузка журнала регистрации в формате XML, что может использоваться для последующего анализа выгруженных записей средствами встроенного языка.

Источник

Работа с журналами документов

В данном разделе будут рассмотрены особенности работы с журналами документов и даны некоторые рекомендации по их разработке.

Журнал документов как вторичные данные

Основной особенностью журналов документов в 1С:Предприятии 8.1 является то, что журналы — вторичные данные не несущие никакой первичной информации и представляющие собой не более чем еще одно представление списка документов. Эта особенность журналов документов и определяет их поведение.

При реструктуризации

Таблица журнала документов имеет следующий состав полей:

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

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

Случаи 4 и 5 возникают при манипуляциях с документами, включенными в журнал и тоже вполне объяснимы.

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

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

При тестировании и исправлении информационной базы

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

При записи документов

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

Кроме того, к изменениям реквизитов документа можно отнести:

Во всех этих случаях также выполняется «перерегистрация» во всех журналах документов, в которых регистрируется документ.

Удаление документов, разумеется, также будет выполняться с удалением в той же транзакции соответствующих записей журналов документов.

Рекомендации по конфигурированию

Число документов, регистрируемых в одном журнале, не ограничено. В одном из журналов документов могут регистрироваться даже все документы конфигурации. Но, при принятии решения о числе видов документов, регистрируемых в журнале, следует помнить о зависимости такой характеристики, как параллельность работы пользователей, от наличия в ней таких журналов, которые охватывают все или большую часть видов документов. Особенно это касается работы в файловом варианте информационной базы. Необходимость заблокировать при записи документа таблицы всех журналов, в которых он регистрируется, приводит к последовательной записи таких документов. Можно сказать, что создание журналов документов, регистрирующих все или большую часть видов документов, допустимо только для конфигураций, которые заведомо рассчитаны на небольшое число одновременно работающих пользователей.

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

Оптимизация отбора по графам журнала

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

Описанные в данном разделе особенности имеют отношение к реализации журналов документов в версии программы 8.0.10 и более поздних версиях.

Источник

Журнал регистрации в 1С 8.3

Рассмотрим что такое журнал регистрации в 1С 8.3. Изучим где найти и как правильно сделать настройки в журнале регистрации в 1С 8.3 Бухгалтерия 3.0. Посмотрим на примере как посмотреть в 1С кто создавал, проводил и изменял документ из журнала регистрации.

Что такое журнал регистрации в 1С 8.3

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

Журнал регистрации в 1С 8.3 предназначен для хранения событий в информационной базе 1С и содержит действия пользователей в системе:

• Попытки входа и выхода из информационной базы;
• Ошибки аутентификации;
• Ошибки в сервисах и программном коде;
• Технические ошибки;
• Выполнение фоновых заданий;
• Создание документов и справочников;
• Удаление документов и элементов справочников;
• Проведение и отмена проведения документов:

Где найти журнал регистрации в 1С 8.3

Файловая информационная база

В окне запуска информационных баз 1С узнаем месторасположение базы:

В проводнике заходим по данному пути и в каталоге увидим папку 1Cv8Log, в которой находится журнал регистрации:

Клиент-серверная база

В клиент-серверной базе журнал расположен: C:\Program Files (x86)\1cv8\srvinfo\reg_1541\f12880f9-dbd1-4314-a8d8-5db9c25d71b6\1Cv8Log\. Где:

• C:\ProgramFiles (x86)\1cv8 – путь установки 1С;
• srvinfo – каталог со служебными данными кластера;
• reg_1541 – кластер, который находится на порту 1541;
• f12880f9-dbd1-4314-a8d8-5db9c25d71b6 – ID информационной базы;
• 1Cv8Log – каталог с журналом регистрации:

Какой ID относится к определенной базе 1С можно узнать из файла 1CV8Clst.lst, который можно открыть для просмотра, например, с помощью блокнота:

Здесь увидим данную информацию:

Настройка журнала регистрации в 1С 8.3

Для того чтобы произвести настройки журнала нужно открыть информационную базу в конфигураторе. Главное меню Администрирование – Настройка журнала регистрации:

Для журнала регистрации доступно установить следующие настройки:

• Не регистрировать;
• Регистрировать ошибки;
• Регистрировать ошибки, предупреждения;
• Регистрировать ошибки, предупреждения, информацию;
• Регистрировать ошибки, предупреждения, информацию, примечания.

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

Можно изменить уровень регистрации событий, установив соответствующий переключатель. Но ранее записанные данные в журнале при этом не удаляются.

Уменьшить размер журнала регистрации

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

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

Далее указываем до какой даты хотим удалить события. Перед тем как нажать на кнопку ОК – нужно создать резервную копию журнала регистрации в 1С. Данную операцию можно выполнить следующими способами:

• Скопировать файл lgd из каталога 1Cv8Log в нужную папку и при необходимости заархивировать файл;
• Либо установить флажок Записать удаляемые события в файл, где указать путь и имя файла.

Теперь нажимаем на кнопку ОК и соглашаемся для продолжения данной операции:

Данная операция может занять продолжительное время, в зависимости от объема файла и мощности компьютера.

Давайте теперь посмотрим размер файла журнала регистрации и удивимся, что размер файла не уменьшился. Дело в том, что файл журнала – база данных формата SQLite. При удалении данных память не освобождается. Для этого воспользуемся бесплатным менеджером баз данных SQLite, который можно скачать в Интернете.

Внимание! Прежде чем дальше выполнять операции – закройте конфигуратор и пользовательский режим 1С. Либо можно скопировать журнал регистрации и выполнять действия на копии.

Запустим и подключим базу 1С, а затем воспользуемся командой Выполнить VACUUM:

Данная операция удаляет лишнее «пустое» пространство, тем самым уменьшается размер файла базы данных 1С. Давайте теперь еще раз глянем на наш файл. Раньше был – 820 Мб, а теперь стал – 138 Мб.

Работа с журналом регистрации в 1С 8.3

Журнал регистрации можно открыть в конфигураторе либо в пользовательском режиме. Изучим более подробно.

Работа с журналом регистрации в конфигураторе

1. Меню Файл – Открыть или сочетание клавиш Ctrl +O:

Таким образом можем открыть ранее сохраненный Журнал Регистрации:

1. Меню Администрирование – Журнал регистрации:

Работа с журналом регистрации в пользовательском режиме

• Главное меню – Все функции – Стандартные – Журнал регистрации:

• Раздел Администрирование – панель навигации Журнал регистрации или Настройки программы – Поддержка и обслуживание:

• Поддержка и обслуживание – Журнал регистрации:

Работа с журналом регистрации в пользовательском режиме почти не отличается от работы в конфигураторе. Однако, есть ограничение – в конфигураторе нет возможности в журнале установить отбор по полю Данные, то есть отфильтровать по определенному документу:

Можем накладывать различные фильтры:

• Показывать – есть возможность установить определенное количество событий:

• Критичность – показать только Ошибки или Предупреждения, или Все события:

• Выбрать события за определенный период:

• Установить отбор по значению в текущей колонки:

• Обновить журнал регистрации на текущее время:

• Если текст сообщения большой и полностью не входит в колонку, то можно посмотреть текущее событие в отдельном окне:

• Также есть возможность установить более сложные фильтры:

В этой форме можно наложить следующие фильтры:

• Установить период, за который нужно отобрать события;
• Поле События – указать конкретные события (добавления, изменения, проведение, удаление);
• Поле Пользователи – произвести отбор по определенному пользователю;
• Поле Компьютеры – произвести отбор по нужному компьютеру, с которого производилась работа в программе 1С;
• Поле Важность – выбрать степень важности событий;
• Поле Метаданные – выбрать все документы, например, документы Реализация (акты, накладные);
• Поле Данные – можно посмотреть какие действия производились с определенным документом или элементом справочника:

Журнал регистрации в 1С 8.3 – как посмотреть

Например, нужно посмотреть кто создавал, проводил и выполнил отмену проведения определенного документа Реализация (акт, накладная). В форме отбора журнала регистрации в поле События установим следующие флажки:

В поле Данные выберем нужный документ Реализация (акт, накладная) и нажмем на кнопку «ОК»:

При этом, в журнале регистрации не фиксируется, что именно пользователь изменил в документе. Для этих целей служит «Версионирование объектов».

Если Вы не отключили и работаете с журналом регистрации, то при создании резервных копий – не забывайте копировать и журнал регистрации.

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

На сайте ПРОФБУХ8 Вы можете посмотреть другие наши бесплатные статьи и материалы по конфигурациям:
1C 8.3 Бухгалтерия, 1С 8.2 Бухгалтерия, 1С 8.3 ЗУП.

Источник