Логирование

Общие сведения

Раздел Логирование в форме настроек модуля позволяет фиксировать все обращения к Bitrix24, отслеживать возникающие ошибки и настраивать автоматическую рассылку отчётов об ошибках синхронизации.

Раздел содержит две независимые настройки:

• Логирование взаимодействия с модулем — при включении фиксирует все запросы к модулю для последующего анализа. Рядом с галочкой расположены:
  • кнопка Настроить — открывает форму выбора уровня логирования;
  • ссылка Данные логирования — открывает регистр с накопленными логами.
• Оповещать об ошибках синхронизации — при включении отправляет отчёт об ошибках на указанных получателей. Рядом с галочкой расположены:
  • кнопка Настроить — открывает форму создания или редактирования рассылки отчёта;
  • ссылка Отчёт об ошибках синхронизации — открывает форму отчёта об ошибках.

Настройка уровня логирования

При нажатии кнопки Настроить напротив галочки Логирование взаимодействия с модулем открывается форма Уровень ведения логирования.

В форме доступно одно поле:

• Уровень ведения логирования — определяет, какие события будут записываться в журнал. Доступные значения:
  • Все — фиксируются все запросы к модулю, включая успешные операции и ошибки. Рекомендуется для диагностики и анализа работы модуля.
  • Только ошибки — фиксируются только запросы, завершившиеся с ошибкой. Позволяет снизить объём хранимых данных при стабильной работе модуля.

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

Настройка рассылки отчёта об ошибках

При нажатии кнопки Настроить напротив галочки Оповещать об ошибках синхронизации открывается стандартная форма 1С Рассылка отчётов.

Форма позволяет настроить автоматическую отправку отчёта об ошибках синхронизации на электронную почту. Основные поля формы:

• Наименование — произвольное название рассылки для идентификации в списке рассылок.
• Подготовлена — флаг, указывающий, что рассылка готова к использованию.
• Входит в группу — группа рассылок, к которой относится данная настройка (необязательно).
• Отправлять — способ отправки. По умолчанию установлено значение Отчёты указанным получателям.
• Получатели — список адресатов, которым будет направлен отчёт об ошибках.

Вкладки формы:

• Отчёты — список отчётов, включённых в рассылку. Используйте кнопку Подобрать для добавления отчёта об ошибках синхронизации. Кнопка Предварительный просмотр позволяет проверить содержимое отчёта перед отправкой.
• Расписание — настройка периодичности автоматической отправки (ежедневно, еженедельно и т.д.).
• Доставка — параметры доставки: учётная запись электронной почты, тема письма, формат вложения.

После заполнения всех необходимых полей нажмите Записать и закрыть.

Данные логирования

Ссылка Данные логирования открывает форму регистра сведений Логирование взаимодействия (Синхронизация с Bitrix24), в котором хранятся записи обо всех зафиксированных обращениях к Bitrix24.

Список содержит следующие колонки:

• Период — дата и время выполнения запроса к Bitrix24.
• Пользователь — пользователь 1С, от имени которого выполнялся запрос.
• Идентификатор записи — уникальный идентификатор объекта в Bitrix24, с которым производилось взаимодействие.
• Тип запроса — вид выполненной операции (например, «Структура компании получить», «Структура компании изменить»).
• Номер попытки — порядковый номер попытки выполнения запроса. Значение больше 1 означает, что предыдущие попытки завершились неудачно.
• Ошибка — флаг наличия ошибки при выполнении запроса.
• Описание ошибки — текст ошибки, возникшей при обращении к Bitrix24.
• Документ — документ 1С, связанный с данной операцией синхронизации (при наличии).

Отчёт об ошибках синхронизации

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

Форма отчёта содержит параметр:

• Количество минут — глубина выборки ошибок в минутах. При формировании отчёта будут включены только те ошибки, которые возникли за указанный период времени. По умолчанию установлено значение 5 минут.

Отчёт содержит следующие колонки:

• Период — дата и время возникновения ошибки.
• Пользователь — пользователь 1С, при работе которого возникла ошибка.
• Тип запроса — вид операции, при выполнении которой произошла ошибка.
• Описание ошибки — текст сообщения об ошибке.
• Документ — связанный документ 1С (при наличии).
• Номер попытки — номер попытки, на которой зафиксирована ошибка.
• Идентификатор записи — идентификатор объекта Bitrix24, при обработке которого возникла ошибка.

Для формирования отчёта нажмите кнопку Сформировать.