Меню


Курсы Стимул Справочник Полезные материалы 1С:Предприятие 8.2 Разработчикам Соглашения при написании ко…

1С:Предприятие 8.2 /
Разработчикам /
Соглашения при написании кода

Оглавление

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

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 = '"Во время выполнения действия произошла неизвестная ошибка.'") + Символы.ПС +
	ПодробноеПредставлениеОшибки(ИнформацияОбОшибке());
КонецПопытки; 
 КонецПроцедуры 

где переменная КодОсновногоЯзыка содержит код основного языка конфигурации. Подробнее см. Требования по локализации конфигурации , п. 8.1.

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

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

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


Нас находят: ВызватьИсключение НСтр(ru = При отражении документов в регл учете возникли ошибки Подробнее см в журнале регистрации );, https://yandex ru/clck/jsredir?from=yandex ru%3Bsearch%3Bweb%3B%3B&text=&etext=1838 qBsaEuv-Sv02O4LcPa4YhGt6DcDTgziUXi_0euRVxxtqvt9LgAvgBLqio8Na1por c53b8121925fb0a42cc2352d335318a095e95047&uuid=&state=_BLhILn4SxNIvvL0W45KSic66uCIg23qh8iRG9, https://yandex ru/clck/jsredir?from=yandex ru%3Bsearch%3Bweb%3B%3B&text=&etext=1825 IIrdG29vm1_CardsIkaNiSATfJt46XEm8-1w9ga2htq2s8CL1E2KvlejsUs-O6nO cfafab32866ec6680ff57e46d2336aa8f5ea74ed&uuid=&state=_BLhILn4SxNIvvL0W45KSic66uCIg23qh8iRG9, https://yandex ru/clck/jsredir?from=yandex ru%3Bsearch%3Bweb%3B%3B&text=&etext=1825 Lkr0aDpQcbt8c-krj2Ibra5PCVxcXuhVQL22kKiQGiJzbh-0Cadcvg0x3eO2wYwH 6cb53a92062b7207889563aa1a3068cafe91976d&uuid=&state=_BLhILn4SxNIvvL0W45KSic66uCIg23qh8iRG9, https://yandex ru/clck/jsredir?from=yandex ru%3Bsearch%3Bweb%3B%3B&text=&etext=1825 G2_2iHTwwTvIGVDZZnh4-4wYYTGimWIcL9GMpGIgsQAwFhNr2ec55dK8sKds-Fmw 525baff1dc1a5a3ce1d4ea8756d0d445d854b890&uuid=&state=_BLhILn4SxNIvvL0W45KSic66uCIg23qh8iRG9, https://yandex ru/clck/jsredir?from=yandex ru%3Bsearch%3Bweb%3B%3B&text=&etext=1825 151-p6fUTzZKmF_jGMA8ht9Q1Nv6b-5p9684fPrv9zKnQaKEdpwUcxO_lvDTmaun 35f891dfd9a55358d4177e1806255cb8cd5a4f49&uuid=&state=_BLhILn4SxNIvvL0W45KSic66uCIg23qh8iRG9, ЗаписьЖурналаРегистрации 1c 7 7, {ОбщийМодуль ОбменДаннымиСервер Модуль(633)}: При обновлении правил обмена данными возникли ошибки (см Журнал регистрации) ВызватьИсключение НСтр(ru = При обновлении правил обмена данными возникли ошибки (см Журнал регистрации) );, Попытка ЗаписьЖурналаРегистрации, обработка ЗаписьЖурналаРегистрации


Подписка на новости RSS         Мы в Google+    

 

Мы на Facebook