Безопасная отладка 1С-Битрикс: журнал событий и логи
Как собрать данные об ошибке, использовать журнал событий и добавить временное логирование без вывода секретов пользователю.
Время чтения: 9 мин.
Уровень: Средний
Системные требования
Работайте на тестовой копии или в согласованное окно. Не включайте показ PHP-ошибок и подробную отладку на публичном портале надолго.
Смотреть системные требования1. Зафиксируйте воспроизводимый сценарий
Запишите время ошибки, URL, пользователя или роль, ожидаемый результат и точные шаги. Проверьте, повторяется ли проблема в другом браузере и на тестовой копии.
Не начинайте с изменения настроек. Сначала соберите факты: HTTP-статус, сообщение интерфейса, идентификатор объекта и записи журналов за тот же интервал.
2. Используйте журнал событий
Откройте Настройки → Инструменты → Журнал событий. Отфильтруйте записи по времени, пользователю, IP, URL, источнику и срочности.
Журнал полезен для событий безопасности, изменений настроек и действий пользователей. Настройте разумный срок хранения: слишком короткий мешает расследованию, бесконтрольное хранение увеличивает базу.
Описание полей журнала событий.
Совет
В логах нельзя хранить пароли, cookie, Authorization, OAuth-токены, коды вебхуков и полные персональные данные. Маскируйте секреты до записи.
3. Проверьте журналы сервера
Смотрите последние записи, не редактируя журнал:
tail -n 100 /var/log/nginx/error.log
tail -n 100 /var/log/httpd/error_log
journalctl -p err -b --no-pager | tail -n 100Путь зависит от окружения. Сопоставляйте время записи с часовым поясом сервера и временем события в продукте.
4. Добавьте временное логирование
Записывайте только данные, которые нужны для проверки гипотезы: название операции, безопасный идентификатор, этап выполнения, время и код ошибки.
Лог должен находиться вне публично доступного каталога либо быть закрыт настройками веб-сервера. Ограничьте срок работы отладки и размер файла, после диагностики отключите подробное логирование.
Не используйте var_dump и вывод исключения на экран рабочего сайта: это раскрывает структуру проекта и мешает пользователям.
5. Сформулируйте результат диагностики
Итог должен отвечать на четыре вопроса:
- что именно сломано;
- при каких условиях ошибка повторяется;
- какая запись или измерение подтверждает причину;
- как проверить исправление и выполнить откат.
Приложите короткий фрагмент лога без секретов, версии PHP и модуля, а также шаги воспроизведения. Такой отчёт полезнее полного архива журналов без контекста.
Была ли эта статья полезной?
Спасибо за ваш отзыв!
