Перейти к содержанию

Тайм-ауты, кэш и фоновые задачи

Сроки действия токенов авторизации, сроки актуальности фоновых задач, интервалы объединения частых обновлений, сроки хранения данных в кэше, параметры блокировок, планировщика и отложенных задач. Значения по умолчанию подобраны для типичной нагрузки; меняйте их только по рекомендации технической поддержки Webim.

Как изменить параметры и применить изменения, описано в разделе Параметры .env. Все параметры на этой странице необязательные.

Авторизация сотрудников

Сроки действия токенов авторизации отсчитываются от последней активности сотрудника: пока сотрудник работает в Webim, срок продлевается. Токены входа технической поддержки Webim не продлеваются.

Параметр Тип По умолчанию Описание
AUTH_TOKEN_PERSISTENT_EXPIRY_DAYS Целое число, дни 30 Срок действия токена авторизации, если при входе сотрудник установил флажок «Запомнить».
AUTH_TOKEN_TEMPORARY_EXPIRY_DAYS Целое число, дни 1 Срок действия токена авторизации, если при входе флажок «Запомнить» не установлен.
AUTH_TOKEN_SLIDING_REFRESH_MINUTES Целое число, минуты 5 Как часто продлевается срок действия токена при активности сотрудника: не чаще одного раза за указанный период.
AUTH_TOKEN_ACTIVITY_DB_THROTTLE_MINUTES Целое число, минуты 5 Как часто время последней активности токена записывается в базу данных: не чаще одного раза за указанный период. Не задавайте значение меньше AUTH_TOKEN_SLIDING_REFRESH_MINUTES.
AUTH_TOKEN_ACTIVITY_REDIS_THROTTLE_SECONDS Целое число, секунды 1 Как часто время последней активности токена записывается в Redis: не чаще одного раза за указанный период.
AUTH_TOKEN_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения данных токена в кэше Redis.
AUTH_TOKEN_LOCAL_TTL_SECONDS Целое число, секунды 30 Срок хранения данных токена в памяти процесса.
AUTH_AGENT_CACHE_TTL_SECONDS Целое число, секунды 5 Срок хранения в кэше Redis данных сотрудника, которые нужны для проверки авторизации.
AUTH_AGENT_LOCAL_CACHE_TTL_SECONDS Целое число, секунды 2 Срок хранения в памяти процесса данных сотрудника, которые нужны для проверки авторизации.
AUTH_PASSWORD_CACHE_TTL_SECONDS Целое число, секунды 10 Срок хранения в кэше результата успешной проверки пароля. Проверка пароля требует много вычислений, поэтому повторный вход с тем же паролем в течение этого срока не проверяется заново. После смены пароля сохранённый результат не действует.
LOGIN_ATTEMPTS_TIMEOUT_MINUTES Целое число, минуты 30 Период, за который учитываются неудачные попытки входа. Если за этот период было 5 неудачных попыток с одним адресом электронной почты или с одного IP-адреса (30 попыток — для IP-адресов из TRUSTED_IPS), вход блокируется.
SESSION_LOOKUP_TTL_SECONDS Целое число, секунды 10 Срок хранения в кэше Redis сведений о сессии посетителя: идентификаторов посетителя, диалога и оператора.
PERIODIC_SSO_SYNC_INTERVAL_HOURS Целое число, часы 1 Интервал автоматической синхронизации данных сотрудников с системой единого входа (SSO).
SSO_MANUAL_SYNC_MIN_INTERVAL_SECONDS Целое число, секунды 60 Минимальный интервал между запусками синхронизации с системой единого входа вручную.

Сроки актуальности фоновых задач

Если обработчик очереди получает задачу позже срока актуальности, например когда под нагрузкой накопилась очередь, задача отбрасывается без выполнения: её результат к этому времени уже неактуален. Слишком большой срок приводит к выполнению устаревших действий, слишком маленький — к потере задач при кратковременных задержках обработки.

Сроки актуальности задач индексации поиска описаны в разделе Поиск и проверка текста, задач BI-отчётов — в разделе ClickHouse и аналитика.

Параметр Тип По умолчанию Описание
KAFKA_TTL_VISITOR_MESSAGE_SECONDS Целое число, секунды 60 Обработка сообщения посетителя.
KAFKA_TTL_VISIT_SESSION_SIGNAL_SECONDS Целое число, секунды 60 Обработка изменений состояния сессии посетителя, полученных при опросе сервера виджетом.
KAFKA_TTL_VISIT_SESSION_STREAM_SECONDS Целое число, секунды 60 Отправка обновлений сессий посетителей в рабочие места операторов.
KAFKA_TTL_INTERACTION_META_MINUTES Целое число, минуты 2 Обновление отметок о новых сообщениях в диалоге для оператора и посетителя.
KAFKA_TTL_ROUTE_TO_BOT_SECONDS Целое число, секунды 60 Назначение бота на новый диалог.
KAFKA_TTL_ROUTE_INTERACTIONS_MINUTES Целое число, минуты 1 Распределение диалогов из очереди между операторами.
KAFKA_TTL_AUTO_ASSIGN_COMMIT_SECONDS Целое число, секунды 30 Завершение автоматического назначения диалога оператору.
KAFKA_TTL_TIMEOUT_CENTER_SECONDS Целое число, секунды 60 Перепланирование тайм-аутов диалога (см. Таймауты диалогов).
KAFKA_TTL_LAST_MESSAGE_KEYBOARD_MINUTES Целое число, минуты 2 Показ клавиатуры бота под последним сообщением диалога.
KAFKA_TTL_BOT_EVENT_MINUTES Целое число, минуты 2 Обработка ботом событий диалога.
KAFKA_TTL_AI_BOT_REPLY_MINUTES Целое число, минуты 5 Получение ответа ИИ-бота. Срок должен с запасом превышать время ответа модели (до 2 минут).
KAFKA_TTL_PROMPTER_HINTS_MINUTES Целое число, минуты 2 Получение подсказок суфлёра для оператора.
KAFKA_TTL_DEPARTMENT_STATE_SECONDS Целое число, секунды 60 Пересчёт состояния отдела (см. DEPARTMENT_STATE_DEBOUNCE_SECONDS).
KAFKA_TTL_WORKING_AGENTS_RECOMPUTE_SECONDS Целое число, секунды 30 Пересчёт числа работающих операторов.
KAFKA_TTL_AGENT_STATUS_BROADCAST_SECONDS Целое число, секунды 60 Рассылка изменений данных оператора, например статуса, всем операторам онлайн.
KAFKA_TTL_DISCONNECT_AGENT_MINUTES Целое число, минуты 5 Отключение оператора от Webim.
KAFKA_TTL_DEVICE_PING_SECONDS Целое число, секунды 30 Обработка сигнала активности устройства оператора (см. DEVICE_PING_THROTTLE_SECONDS).
KAFKA_TTL_PAGE_ALIVE_SECONDS Целое число, секунды 60 Обработка открытия и закрытия страницы посетителем.
KAFKA_TTL_BUTTON_STATUS_MINUTES Целое число, минуты 5 Обновление изображений состояния кнопки чата в S3-хранилище.
KAFKA_TTL_FLUSH_INTERACTION_FIELDS_SECONDS Целое число, секунды 60 Запись в базу данных объединённых изменений: времени последней активности в диалоге, порядка диалогов, времени обновления данных посетителя.
KAFKA_TTL_MODEL_EVENT_MINUTES Целое число, минуты 10 Обработка событий изменения данных: обновлений для рабочих мест операторов и связанных с ними действий.
MODEL_EVENT_EPHEMERAL_TTL_SECONDS Целое число, секунды 10 Обработка событий изменения данных, которые не сохраняются в базе данных, например уведомлений о наборе текста.
KAFKA_TTL_FLUSH_MODEL_EVENT_MINUTES Целое число, минуты 2 Отправка объединённых событий изменения данных.
KAFKA_TTL_CHANNEL_WEBHOOK_MINUTES Целое число, минуты 5 Обработка входящего вебхука от внешнего канала.
KAFKA_TTL_TYPING_WEBHOOK_SECONDS Целое число, секунды 10 Обработка уведомления о наборе текста, полученного от внешнего канала.
KAFKA_TTL_STATS_FILL_ON_CHANGE_MINUTES Целое число, минуты 5 Обновление показателей реального времени для панели приборов после изменений диалогов и статусов операторов.
KAFKA_TTL_UI_RESOURCES_MINUTES Целое число, минуты 10 Перегенерация ресурсов и настроек виджета после изменения настроек.
KAFKA_TTL_RECHECK_BANS_MINUTES Целое число, минуты 5 Пересчёт блокировок посетителей после изменения правил блокировки.

Объединение частых обновлений

Частые изменения одного объекта объединяются: вместо отдельной задачи на каждое изменение выполняется одна задача за интервал с последними данными. Чем больше интервал, тем меньше нагрузка на базу данных и тем позже изменения становятся видны.

Параметр Тип По умолчанию Описание
TIMEOUT_CENTER_DISPATCH_COALESCE_SECONDS Целое число, секунды 1 Интервал объединения задач перепланирования тайм-аутов диалога.
INTERACTION_LAST_ACTIVITY_DEBOUNCE_SECONDS Целое число, секунды 10 Интервал объединения записей времени последней активности в диалоге.
VISITOR_LAST_UPDATED_DEBOUNCE_SECONDS Целое число, секунды 5 Интервал объединения записей времени последнего обновления данных посетителя.
INTERACTION_ORDER_DEBOUNCE_SECONDS Целое число, секунды 5 Интервал объединения записей порядка диалогов, по которому сортируется список диалогов в рабочем месте оператора.
DEPARTMENT_STATE_DEBOUNCE_SECONDS Целое число, секунды 60 Интервал объединения пересчётов состояния отдела для каждого языка. Первое изменение обрабатывается сразу, последующие в пределах интервала объединяются в один пересчёт в конце интервала.
WORKING_AGENTS_RECOMPUTE_DEBOUNCE_SECONDS Целое число, секунды 5 Интервал объединения пересчётов числа работающих операторов.
DEVICE_PING_THROTTLE_SECONDS Целое число, секунды 10 Как часто обрабатывается сигнал активности устройства оператора (браузера или мобильного приложения): не чаще одного раза за интервал.
KAFKA_THROTTLE_BUTTON_STATUS_SECONDS Целое число, секунды 60 Как часто обновляются изображения состояния кнопки чата (онлайн или офлайн) после смены статусов операторов: не чаще одного раза за интервал.
KAFKA_THROTTLE_STATS_FILL_ON_CHANGE_SECONDS Целое число, секунды 5 Интервал объединения обновлений показателей реального времени для панели приборов. Частоту обновлений также ограничивает настройка Constance DASHBOARD_REALTIME_UPDATE_INTERVAL (см. Статистика, поиск и выгрузки).
KAFKA_THROTTLE_UI_RESOURCES_SECONDS Целое число, секунды 30 Интервал объединения перегенераций ресурсов и настроек виджета.

Кэш

Чем больше срок хранения данных в кэше, тем меньше нагрузка на базу данных и тем позже изменения становятся видны пользователям.

Параметр Тип По умолчанию Описание
CONSTANCE_LOCAL_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения значений настроек Constance в памяти процесса. Определяет, через какое время изменение настройки Constance вступает в силу во всех процессах Webim.
TWO_TIER_CACHE_LOCAL_TTL_SECONDS Дробное число, секунды 60.0 Срок хранения в памяти процесса редко меняющихся данных: настроек, размещений, справочников. Эти данные кэшируются на двух уровнях — в памяти процесса и в Redis.
TWO_TIER_CACHE_REDIS_TTL_SECONDS Целое число, секунды 300 Срок хранения редко меняющихся данных в Redis.
TWO_TIER_CACHE_STAMPEDE_LOCK_TTL_SECONDS Целое число, секунды 5 Срок блокировки, которая не даёт множеству процессов одновременно загружать из базы данных одни и те же данные, когда их нет в кэше.
ONLINE_STATUS_CACHE_TIMEOUT Целое число, секунды 10 Срок хранения в кэше сведений о доступности операторов в отделах.
ACTIVE_INTERACTION_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше сведений об активном диалоге посетителя.
QUEUE_WAIT_TIME_INTERVAL_SECONDS Целое число, секунды 30 Как часто пересчитывается среднее время ожидания в очереди. Используется, если включена настройка Constance QUEUE_WAITING_TIME_NOTIFICATION или QUEUE_WAITING_TIME_API (см. Прочие настройки).
QUEUE_WAIT_TIME_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше рассчитанного среднего времени ожидания в очереди.
MESSAGE_CACHE_TTL_SECONDS Целое число, секунды 3600 Срок хранения в кэше сообщений диалогов, подготовленных для отправки клиентам.
SERIALIZER_MESSAGES_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения в кэше списков сообщений диалога, подготовленных для рабочего места оператора.
SERIALIZER_BROWSER_INFO_CACHE_TTL_SECONDS Целое число, секунды 3600 Срок хранения в кэше сведений о браузере посетителя.
SERIALIZER_VISIT_SESSION_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше подготовленных данных сессии посетителя.
VISITED_PAGE_CACHE_TTL_SECONDS Целое число, секунды 20 Срок хранения в кэше сведений о странице, открытой посетителем.
EPHEMERAL_TTL_SECONDS Целое число, секунды 3600 Срок хранения в Redis временных данных сессии посетителя, которые ещё не записаны в базу данных. Продлевается при каждом опросе сервера виджетом.
VISITOR_HAS_DEVICE_CACHE_TTL_SECONDS Целое число, секунды 300 Срок хранения в кэше признака наличия у посетителя устройства с токеном пуш-уведомлений.
VISITOR_TOPICS_CACHE_TTL_MINUTES Целое число, минуты 2 Срок хранения в кэше списка тематик, доступных посетителю.
VISITOR_DEPARTMENTS_CACHE_TTL_MINUTES Целое число, минуты 2 Срок хранения в кэше списка отделов, доступных посетителю.
VISITOR_DRAFT_CACHE_TTL_SECONDS Целое число, секунды 40 Срок хранения черновика сообщения посетителя — текста, который посетитель набирает, но ещё не отправил.
INTERACTION_AGENT_IDS_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения в кэше списка операторов, участвующих в диалоге.
DEPARTMENT_STATE_CACHE_TTL_MINUTES Целое число, минуты 1 Срок хранения в кэше состояния отдела.
WORKING_AGENTS_COUNT_CACHE_TTL_MINUTES Целое число, минуты 5 Срок хранения в кэше числа работающих операторов.
ACCEPT_CHATS_STATUSES_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения в кэше списка статусов, в которых оператор принимает диалоги.
AUTOMATIC_MESSAGES_RESOURCES_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения в кэше текстов автоматических сообщений.
BAN_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше сведений о блокировках посетителей.
CLOSE_CHATS_CHECK_CACHE_TTL_SECONDS Целое число, секунды 30 Срок хранения в кэше числа диалогов, которые будут закрыты при массовом закрытии.
THREADLOG_LOCATIONS_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше списка размещений для поиска по истории диалогов.
ABAC_ENTITY_CACHE_TTL_SECONDS Целое число, секунды 60 Срок хранения в кэше данных, по которым проверяются права доступа сотрудников.
ABAC_CONFIG_SNAPSHOT_TTL_SECONDS Целое число, секунды 2 Срок хранения в памяти процесса значений настроек Constance, которые учитываются при проверке прав доступа.
ABAC_CODEX_CACHE_TTL_MINUTES Целое число, минуты 5 Срок хранения в кэше правил доступа.
ABAC_TARIFF_SNAPSHOT_TTL_SECONDS Целое число, секунды 60 Срок хранения сведений о тарифных возможностях аккаунта, которые учитываются при проверке прав доступа.

Блокировки и планировщик

Параметр Тип По умолчанию Описание
INTERACTION_LOCK_TIMEOUT_SECONDS Целое число, секунды 30 Максимальное время удержания блокировки диалога при изменении его состояния. По истечении этого времени блокировка снимается автоматически, даже если процесс завершился, не сняв её.
INTERACTION_LOCK_ACQUIRE_TIMEOUT_SECONDS Целое число, секунды 10 Максимальное время ожидания блокировки диалога.
SCHEDULER_LEADER_LOCK_ENABLED Логический true Блокировка, которая гарантирует, что периодические задачи запускает только один экземпляр планировщика. Отключается только значением false. Отключайте блокировку, только если планировщик гарантированно запущен в одном экземпляре.
SCHEDULER_LOCK_KEY Строка kafka_periodic_scheduler:leader Ключ блокировки планировщика в Redis.
SCHEDULER_LOCK_TTL Целое число, секунды 15 Срок действия блокировки планировщика. Работающий экземпляр продлевает блокировку каждую секунду; если он остановился, другой экземпляр получает блокировку после истечения срока. Значение должно быть больше 1 секунды.
KAFKA_SCHEDULER_HEARTBEAT_INTERVAL_MINUTES Целое число, минуты 1 Как часто планировщик записывает в журнал сводку о своей работе.
PERIODIC_RUN_META_TTL_DAYS Целое число, дни 30 Срок хранения сведений о запусках периодических задач.
PERIODIC_TIMEOUT_CENTER_DISPATCH_INTERVAL_MINUTES Целое число, минуты 5 Интервал периодического перепланирования тайм-аутов всех активных диалогов. Страхует от пропущенных событий.

Отложенные задачи

Отложенные задачи выполняются в назначенное время: например, закрытие диалога по тайм-ауту или запись объединённых изменений. Наступление срока отслеживает процесс watchdog_redis_listener по событиям Redis.

Параметр Тип По умолчанию Описание
WATCHDOG_USE_DATABASE Логический True Сохранение отложенных задач в PostgreSQL в дополнение к Redis. Если Redis был недоступен или потерял данные, просроченные задачи запускаются по записям в базе данных. При False отложенные задачи хранятся только в Redis.
WATCHDOG_OVERDUE_THRESHOLD_SECONDS Целое число, секунды 30 Через сколько времени после назначенного срока невыполненная отложенная задача считается просроченной и запускается периодической проверкой. Действует при WATCHDOG_USE_DATABASE=True. За одну проверку запускается не более 500 задач.
WATCHDOG_TASK_MAX_AGE_DAYS Целое число, дни 7 Срок хранения в базе данных выполненных отложенных задач.
WATCHDOG_HEARTBEAT_INTERVAL_SECONDS Целое число, секунды 5 Как часто процесс watchdog_redis_listener записывает отметку о своей работе.
WATCHDOG_HEARTBEAT_TTL_MINUTES Целое число, минуты 5 Срок хранения отметки о работе процесса watchdog_redis_listener.
WATCHDOG_HEARTBEAT_LAG_THRESHOLD_SECONDS Целое число, секунды 30 Если последняя отметка о работе старше этого значения, проверка работоспособности /health и страница состояния системы сообщают, что процесс watchdog_redis_listener отстаёт или завис. По умолчанию значение равно шести интервалам WATCHDOG_HEARTBEAT_INTERVAL_SECONDS.

Объединяемые задачи

Повторные вызовы объединяемой задачи в пределах интервала выполняются одним запуском (см. раздел Объединение частых обновлений). Состояние таких задач хранится в Redis.

Параметр Тип По умолчанию Описание
COALESCING_USE_DATABASE Логический False Сохранение состояния объединяемых задач в PostgreSQL в дополнение к Redis, чтобы восстановить его после сбоя Redis.
COALESCING_RESCUE_INTERVAL_SECONDS Целое число, секунды 60 Интервал проверки, которая восстанавливает в Redis состояние объединяемых задач, сохранённых в PostgreSQL, например после сбоя Redis.
COALESCING_CLEANUP_INTERVAL_SECONDS Целое число, секунды 21600 Интервал удаления из PostgreSQL записей объединяемых задач, завершившихся ошибкой: по умолчанию 6 часов.
COALESCING_FAILED_RETENTION_SECONDS Целое число, секунды 86400 Срок хранения в PostgreSQL записей объединяемых задач, завершившихся ошибкой: по умолчанию 1 сутки.
KAFKA_COALESCE_INFLIGHT_GATE_TTL_SECONDS Целое число, секунды 60 Если процесс завершился между публикацией объединяемой задачи и её выполнением, повторные публикации задачи подавляются в течение этого срока, после чего задача публикуется снова.
KAFKA_COALESCE_REDIS_ALIVE_PING_TTL_SECONDS Целое число, секунды 60 Срок жизни служебной записи в Redis, по которой проверка восстановления определяет, что Redis не терял данные.
KAFKA_COALESCE_FLAG_EXECUTE_LOCK_TTL_SECONDS Целое число, секунды 60 Срок блокировки, которая не даёт выполнить объединяемую задачу дважды. Должен с запасом превышать время выполнения задачи: если процесс завершился, блокировка снимается по истечении срока.
KAFKA_COALESCE_PENDING_CACHE_TIMEOUT_SECONDS Целое число, секунды 5 Срок хранения в кэше последних данных объединяемой задачи до её выполнения.

Хранение служебных данных

Параметр Тип По умолчанию Описание
JOB_RETENTION_PERIOD_DAYS Целое число, дни 30 Срок хранения сведений о фоновых операциях: выгрузках BI-отчётов, перестроении BI-отчётов и поискового индекса. Сведения старше этого срока удаляются раз в сутки.