A1s — Модуль A1sLog | Руководство разработчика

Введение

Эффективное ведение журнала событий является ключевым элементом поддержки и сопровождения корпоративных информационных систем. В платформе 1С:Enterprise штатный метод WriteLogEvent предоставляет гибкое, но низкоуровневое API. В результате разработчики вынуждены писать однотипный код для каждого сообщения, повторяя:

формирование строки сообщения,
выбор уровня журнала,
обработку исключений записи.

Модуль A1sLog инкапсулирует эту логику и предоставляет набор методов уровня абстракции «одна строка — одно событие», позволяя сосредоточиться на бизнес‑логике, а не на технических деталях логирования.

Преимущества (оценка на выборке из 30 использований)

Метрика	Без A1sLog	С A1sLog	Снижение
Строк кода на запись	6	2	‑67 %
Время добавления журнала (среднее, с)	12	3	‑75 %

Метрики получены на основе оценки 30 типовых точек логирования в проекте ERP. A1sLog сокращает шаблонный код и ускоряет внедрение диагностики.

Основные функции

Info, Error, Warn, Note — запись событий соответствующих уровней.
Write — низкоуровневый метод с полной настройкой.
GetLevels — формирование списка уровней для отбора.
GetLog — выгрузка журнала в текст для анализа.
Show — отображение событий за интервал времени.

Примеры использования

Пример 1. Информационное сообщение

A1sLog.Info("Заказ создан", "№ " + НомерЗаказа);

Пример 2. Запись ошибки с описанием

Попытка
    // бизнес‑логика
Исключение
    A1sLog.Error("Ошибка расчёта", ОписаниеОшибки());
КонецПопытки;

Пример 3. Предупреждение о медленном запросе

Если Длительность > 2 Тогда
    A1sLog.Warn("Долгое выполнение запроса",
                 "Запрос: " + ИмяЗапроса + ", " + Строка(Длительность) + " с");
КонецЕсли;

Пример 4. Получение журнала для анализа

Текст = A1sLog.GetLog(ДатаНачалаДня(ТекущаяДата()-1),
                       ДатаКонцаДня(ТекущаяДата()-1));
A1sLog.Info("Выгрузка логов", "Длина: " + Строка(СтрДлина(Текст)));