Оптимизация работы агентов 1С-Битрикс

Оптимизация агентов Битрикс: диагностика и настройка фоновых задач

Агенты в Битрикс — это PHP-функции, которые платформа запускает по расписанию. Звучит просто, пока не обнаруживаешь, что сайт тормозит каждые 30 секунд, все страницы отдаются медленнее на 500–800 мс именно в момент хита агентов, а в b_agent накопилось 400+ записей, половина из которых — зависшие задачи со статусом ACTIVE = Y и NEXT_EXEC в прошлом.

Стандартная схема запуска агентов через веб-запросы (hitAgent) — это архитектурный компромисс Битрикс, который работает приемлемо на небольших сайтах и становится проблемой на нагруженных проектах. Каждый входящий HTTP-запрос может стать «жертвой», на которую вешается выполнение агентов, блокируя ответ пользователю на время работы фоновой задачи.

Диагностика текущего состояния

Первое, что делаем — смотрим реальную картину в таблице агентов:

SELECT NAME, ACTIVE, NEXT_EXEC, LAST_EXEC,
       TIMESTAMPDIFF(MINUTE, LAST_EXEC, NOW()) AS minutes_since_last
FROM b_agent
WHERE ACTIVE = 'Y'
ORDER BY NEXT_EXEC ASC;

Агенты с NEXT_EXEC в прошлом на несколько часов или дней — это зависшие задачи. Они постоянно пытаются запуститься, занимают слот выполнения и блокируют остальные агенты в очереди.

Второе — смотрим на время выполнения тяжёлых агентов. Если агент поиска (CSearchIndex::IndexAgent) выполняется 45 секунд, а настроен на запуск каждую минуту — он никогда не завершается корректно и запускается повторно до окончания предыдущего экземпляра.

Третье — профилируем влияние агентов на время ответа страниц. Включаем Битрикс-панель отладки или логируем время через \Bitrix\Main\Diag\Debug::startTimeLabel / stopTimeLabel в init.php.

Перевод агентов на cron

Это самое важное изменение. В файле /bitrix/.settings.php или через административный интерфейс (Настройки → Производительность):

'agents' => [
    'value' => [
        'pull_agent_manager' => 'cron',
    ],
],

В crontab добавляем:

*/1 * * * * /usr/bin/php -f /var/www/bitrix/bitrix/modules/main/tools/cron_events.php > /dev/null 2>&1

После перевода на cron агенты больше не выполняются в контексте веб-запросов. Время ответа страниц выравнивается, исчезают характерные «провалы» на графике latency каждые N секунд.

Важный нюанс: агент поиска CSearchIndex::IndexAgent при работе через cron может конкурировать с PHP-FPM за CPU. Выносим его в отдельный cron-скрипт с nice -n 10 и ограничением по времени через timeout.

Оптимизация очереди и приоритетов

После перевода на cron разбираем накопившийся долг:

Чистка зависших агентов. Агенты с NEXT_EXEC старше суток и без успешного LAST_EXEC за последние 48 часов — кандидаты на деактивацию или пересоздание. Для каждого разбираемся: модуль живой? Функция существует? Есть ли исключение в логах?

Оптимизация интервалов. CSearchIndex::IndexAgent с интервалом 30 секунд при реальном времени выполнения 20 секунд — расписание на катастрофу. Пересчитываем интервалы исходя из реального времени работы + буфер 50%.

Разнесение тяжёлых агентов. Если несколько тяжёлых агентов (синхронизация с 1С, отправка email-рассылок, пересчёт цен) настроены на запуск одновременно — разносим их старт через NEXT_EXEC с интервалом 5–10 минут.

Мониторинг выполнения. Добавляем логирование в кастомные агенты:

function MyHeavyAgent(): string
{
    $start = microtime(true);
    // ... логика ...
    $elapsed = microtime(true) - $start;
    if ($elapsed > 10) {
        \Bitrix\Main\Diag\Debug::writeToFile(
            "MyHeavyAgent took {$elapsed}s",
            '',
            '/bitrix/logs/agent_performance.log'
        );
    }
    return 'MyHeavyAgent();';
}

Тяжёлые системные агенты: что с ними делать

CSearchIndex::IndexAgent — индексация поиска. На каталоге 50 000+ товаров может работать часами. Решение: ограничить количество элементов за один запуск через параметр SEARCH_ELEMENT_COUNT в настройках модуля поиска, или перейти на Elasticsearch и отключить встроенный поиск.

CEventMessageAgent — отправка email. Если используется встроенная почта Битрикс без очереди — при накоплении тысяч писем агент зависает. Решение: настроить SMTP через PHPMailer-совместимый транспорт или перейти на Unisender/SendPulse API с очередью.

CBitrixCloudBackupAgent — облачный бэкап. Может занимать всё I/O сервера при больших объёмах. Переносим на ночное время, добавляем ограничение скорости через ionice.

CTaskNotifications::agent (Битрикс24) — уведомления CRM. При большом объёме задач выполняется долго. Разбиваем на пакеты через параметр лимита в теле агента.

Настройка мониторинга агентов

Добавляем в Zabbix/Prometheus метрику количества зависших агентов:

SELECT COUNT(*) as stuck_agents
FROM b_agent
WHERE ACTIVE = 'Y'
  AND NEXT_EXEC < DATE_SUB(NOW(), INTERVAL 1 HOUR);

Если значение > 0 на протяжении более 30 минут — алерт в Telegram/Slack. Это ранний индикатор проблем с cron или перегрузки сервера.

Результат

Перевод на cron и оптимизация очереди агентов убирают периодические просадки времени ответа, снижают нагрузку на БД в пиковые моменты на 20–40%, обеспечивают предсказуемое выполнение фоновых задач без влияния на пользовательские запросы.