Тайм-ауты, кэш и фоновые задачи
Сроки действия токенов авторизации, сроки актуальности фоновых задач, интервалы объединения частых обновлений, сроки хранения данных в кэше, параметры блокировок, планировщика и отложенных задач. Значения по умолчанию подобраны для типичной нагрузки; меняйте их только по рекомендации технической поддержки 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-отчётов и поискового индекса. Сведения старше этого срока удаляются раз в сутки. |