Коротко. Журнал отладки БП — это детальные логи каждого шага процесса (с чем стартовал, какие переменные, что выполнил, какой результат). Без журнала отладка БП = гадание на кофейной гуще. С журналом — видно, на каком шаге сломалось и почему.
Что это и как работает
Журнал отладки = опция шаблона БП «Сохранять подробные логи». При включении каждый шаг записывается с входными/выходными данными. Хранятся ограниченное время. Полная официальная инструкция со скриншотами и пошаговой настройкой — в справке Битрикс24.
Быстрый порядок настройки
- В параметрах шаблона БП → раздел «Отладка».
- Включите «Сохранять журнал отладки».
- Выберите уровень детализации (только ошибки / все шаги / все данные).
- Сохраните шаблон.
- После запуска БП → откройте журнал отладки → детальная история шагов.
- Анализируйте упавшие БП по логам.
Это базовый сценарий «по инструкции». Дальше — то, что инструкция вам не расскажет.
5 граблей с нашего опыта внедрений
1. Включили журнал в продакшене → база данных раздулась за неделю до 50 ГБ
Журнал без ротации. Лечение: журнал включаем только для отладки, после — выключаем. Автоматическая чистка логов старше 30 дней.
2. Журнал включён, но не показывает входные данные — только «выполнено»
Уровень детализации низкий. Лечение: для отладки — максимальный уровень (все данные). После исправления — минимальный.
3. Логи показывают «Ошибка», но без объяснения — где конкретно?
Стандартные ошибки Битрикс24 загадочны. Лечение: в БП добавляем кастомные действия «Записать в лог» с понятными сообщениями («Шаг X начат, переменные Y»).
4. Журнал есть, но никто не читает — БП падают, никто не реагирует
Без мониторинга. Лечение: уведомление админу при упавших БП (через робота или внешний мониторинг).
5. Логи хранятся 30 дней — БП упал 2 месяца назад, истории нет
Слишком короткий период хранения. Лечение: для критичных процессов — экспорт логов в внешнее хранилище (например, ELK).
Сами или позвать интегратора
Сами справитесь, если: включаем журнал на время отладки нового шаблона.
Зовите нас, если: промышленный мониторинг БП с алертами, дашбордами по упавшим процессам, ретенцией логов.
Бесплатная консультация по настройке Битрикс24
20 минут разговора с нашим интегратором. Покажем, как это решается у похожих клиентов, какие подводные камни ждут именно у вас, и сколько стоит передать настройку нам.
FAQ
Где хранятся логи?
В базе данных портала Битрикс24. Доступны через интерфейс журнала.
Влияет ли журнал на скорость БП?
При высокой детализации — да, на 5–15%. В продакшене лучше минимальный уровень.
Можно ли отфильтровать логи по типу события?
Да, фильтры по типу (ошибка/предупреждение/инфо), по шагу, по дате.
Сохраняются ли логи завершённых БП?
Да, до истечения срока ретенции (по умолчанию 30 дней).
Источник официальной инструкции
Полный текст со скриншотами и всеми вариантами настройки: helpdesk.bitrix24.ru/open/21994508/.
