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

На одном проекте с каталогом 12 000 товаров агенты поиска и синхронизации 1С запускались каждые 30 секунд через hitAgent. Каждый хит добавлял 700 мс к времени ответа, а раз в 2 минуты страница отдавалась 3 секунды из-за блокировки. В таблице b_agent скопилось 400 записей с NEXT_EXEC на неделю назад. Такая ситуация типична для нагруженных сайтов на Битрикс: фоновая очередь агентов деградирует постепенно, но в итоге приводит к просадкам времени отклика и росту нагрузки на сервер. Если ничего не делать, бизнес теряет конверсию и посетителей из-за медленных страниц.

За 5 лет работы мы оптимизировали агентов на 50+ проектах — от интернет-магазинов с 100 000 товаров до корпоративных порталов Битрикс24. Методика убирает эти проблемы. Переводим агентов на cron, чистим очередь, оптимизируем тяжёлые задачи и настраиваем мониторинг. Результат — стабильное время отклика без просадок. Инвестиции окупаются за 2–3 месяца. Согласно официальному руководству Битрикс, перевод на cron — единственный способ полностью устранить влияние агентов на пользовательские запросы. На практике cron снижает latency в среднем в 3 раза по сравнению с hitAgent.

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

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

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 в прошлом на несколько часов или дней — это зависшие задачи. Они постоянно пытаются запуститься, занимают слот выполнения и блокируют остальные агенты в очереди. Так, на одном проекте мы обнаружили 1200 зависших записей — после чистки время ответа упало с 2.5 с до 0.8 с.

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

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

оптимизация агентов влияет на скорость сайта?

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

перевод на cron не панацея?

Cron решает проблему с блокировкой пользовательских запросов, но не исправляет неэффективные агенты сами по себе. Если агент выполняется 30 секунд и делает это каждые 2 минуты, он просто перегружает сервер уже вне веб-хитов. Важно:

• проанализировать каждый тяжёлый агент;
• разбить длительные задачи на пакеты;
• настроить приоритеты и мониторинг.

Вот таблица типичных тяжёлых агентов и их оптимизация:

Перевод агентов на cron: пошаговая инструкция

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

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

2. В crontab добавьте:

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

3. Проверьте, что cron запускается (добавьте запись в лог).
4. Настройте мониторинг выполнения (см. ниже).

После перевода на 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();';
}

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

Добавляем в 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 или перегрузки сервера. Например, на одном проекте алерт сработал при 50 зависших агентах — после анализа выяснилось, что cron не запускался из-за ошибки в crontab.

входит в работу

• Аудит текущего состояния с отчётом по каждому агенту (количество, время выполнения, интервал).
• Перевод на cron с индивидуальным расписанием.
• Оптимизация тяжёлых агентов (кэширование, пакетная обработка).
• Настройка мониторинга (Zabbix/Prometheus, алерты в Telegram).
• Инструкция по дальнейшему обслуживанию и рекомендации.
• Гарантия 90 дней на результат.

Результат и гарантия

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