Журнал событий (таблица b_event_log) в 1С-Битрикс хранит важную информацию о действиях пользователей, системных ошибках, изменениях в настройках и других событиях. Сохранение этого журнала в файл может потребоваться для аудита, анализа проблем, передачи данных сторонним специалистам или просто для создания резервной копии. В этой статье рассмотрены основные способы выгрузки логов в файл, актуальные для версий 2026 года и построенные на современном API D7.
Способ 1. Экспорт через стандартные средства администрирования
В некоторых редакциях «1С-Битрикс: Управление сайтом» (например, при наличии модуля «Веб-аналитика» или в редакции «Бизнес») предусмотрена возможность выгрузки журнала событий через административный интерфейс. Чтобы проверить наличие такой функции:
- Перейдите в Настройки → Инструменты → Журнал событий.
- Если в верхней панели есть кнопка «Экспорт» (в формате Excel или CSV), воспользуйтесь ею. Система сформирует файл с данными.
- В противном случае используйте один из альтернативных методов, описанных ниже.
Способ 2. Выгрузка через SQL-запрос (phpMyAdmin)
Прямой экспорт таблицы из базы данных — самый быстрый способ получить все записи. Для этого подойдёт любой инструмент управления БД (phpMyAdmin, Adminer, командная строка).
- Откройте phpMyAdmin или подключитесь к БД через консоль.
- Выберите базу данных вашего сайта.
- Найдите таблицу b_event_log.
- Воспользуйтесь вкладкой «Экспорт» (Export) и выберите формат CSV, SQL или Excel. При необходимости задайте условия (например, экспорт только за последний месяц).
- Сохраните полученный файл на локальный компьютер.
Важно: Перед массовой выгрузкой убедитесь, что таблица не содержит конфиденциальных данных, доступ к которым должен быть ограничен. Также проверьте, что phpMyAdmin защищён паролем или доступен только с доверенных IP.
Способ 3. Написание PHP-скрипта для выгрузки в файл
Если нужна регулярная или частичная выгрузка, можно создать небольшой скрипт, который будет сохранять логи в файл на сервере.
Пример простого скрипта, который выгружает последние 1000 записей в CSV-файл:
<?php
require_once $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php';
use Bitrix\Main\Application;
$connection = Application::getConnection();
$sql = "SELECT * FROM b_event_log ORDER BY ID DESC LIMIT 1000";
$records = $connection->query($sql)->fetchAll();
if (empty($records)) {
die("Нет записей для экспорта.");
}
$filePath = $_SERVER['DOCUMENT_ROOT'].'/upload/event_log_'.date('Y-m-d_H-i-s').'.csv';
$handle = fopen($filePath, 'w');
if (!$handle) {
die("Не удалось создать файл.");
}
// Заголовки столбцов
fputcsv($handle, array_keys($records[0]));
// Данные
foreach ($records as $row) {
fputcsv($handle, $row);
}
fclose($handle);
echo "Файл сохранён: ".$filePath;
?>
Скрипт следует разместить в корне сайта (например, export_log.php) и запустить через браузер, предварительно ограничив доступ по IP или паролем.
Способ 4. Использование API D7
Более правильный с точки зрения архитектуры Битрикс способ — воспользоваться классами D7 для работы с таблицей событий. Это гарантирует совместимость с будущими обновлениями и учитывает все настройки модулей.
<?php
require_once $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php';
use Bitrix\Main\EventLog\Internal\EventLogTable;
use Bitrix\Main\Type\DateTime;
// Последние 30 дней
$filterDate = DateTime::createFromTimestamp(time() - 30 * 24 * 3600);
$params = [
'order' => ['ID' => 'DESC'],
'filter' => ['>=TIMESTAMP_X' => $filterDate],
'select' => ['*'],
'limit' => 5000
];
$result = EventLogTable::getList($params);
$filePath = $_SERVER['DOCUMENT_ROOT'].'/upload/event_log_d7_'.date('Y-m-d_H-i-s').'.csv';
$fp = fopen($filePath, 'w');
if (!$fp) {
die("Не удалось создать файл.");
}
$first = $result->fetch();
if (!$first) {
fclose($fp);
unlink($filePath); // удаляем пустой файл
die("Нет записей за указанный период.");
}
// Заголовки
fputcsv($fp, array_keys($first));
// Первая строка
fputcsv($fp, $first);
while ($row = $result->fetch()) {
fputcsv($fp, $row);
}
fclose($fp);
echo "Файл успешно создан: $filePath";
?>
Этот скрипт можно доработать: добавить фильтры по типу события, пользователю, а также настроить автоматический запуск по расписанию.
Способ 5. Автоматизация выгрузки (агенты и cron)
Для регулярного сохранения журнала (например, еженедельно) лучше настроить выполнение скрипта через агенты Битрикс или системный планировщик cron.
Агент Битрикс
Создайте метод в своем классе, который будет запускать экспорт. Для повторяющихся задач агент должен возвращать строку с кодом вызова (например, MyAgent::exportEventLog();). Для одноразовой задачи можно вернуть пустую строку или исключение — тогда агент будет удалён после выполнения. Добавьте агент через административный интерфейс в разделе Настройки → Настройки продукта → Агенты.
Задание в cron
Добавьте в планировщик сервера команду выполнения PHP-скрипта:
0 2 * * 1 /usr/bin/php /home/bitrix/www/export_log_cron.php > /dev/null 2>&1
Скрипт должен быть оптимизирован для фонового выполнения (не выводить ничего в браузер).
Рекомендации и предостережения
- Ограничивайте объём данных. Таблица b_event_log может быть очень большой. Всегда используйте лимиты и фильтры по дате, чтобы не перегружать сервер и не создавать огромные файлы.
- Защищайте скрипты выгрузки. Если вы оставляете скрипты в открытом доступе, злоумышленники могут получить конфиденциальную информацию. Удаляйте скрипты после использования или защитите их паролем (например, через .htaccess).
- Регулярно очищайте старые записи. В Битрикс можно настроить автоматическое удаление устаревших событий через системный модуль или агенты. Это снизит нагрузку на базу данных.
- Проверяйте права на запись. Папка /upload/ должна быть доступна для записи веб-сервером, чтобы скрипты могли создавать в ней файлы.
- Используйте D7 для новых разработок. Код, написанный с использованием D7, гарантирует совместимость с будущими версиями платформы и легче поддерживается.
Заключение
Сохранение журнала событий Битрикс в файл не представляет сложности и может быть выполнено несколькими способами. Выбор метода зависит от ваших целей: разовая выгрузка — через SQL или простой скрипт, регулярная — через API D7 и автоматизацию. Используя приведённые примеры, адаптированные под современные стандарты D7, вы сможете всегда иметь под рукой копию системных логов для анализа или аудита.
