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

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

Как изменить параметры и применить изменения, описано в разделе [Параметры .env](https://webim.ru/kb/11.0/settings/env/). Все параметры на этой странице необязательные.

## Авторизация сотрудников { #auth }

Сроки действия токенов авторизации отсчитываются от последней активности сотрудника: пока сотрудник работает в **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` | Минимальный интервал между запусками синхронизации с системой единого входа вручную. |

## Сроки актуальности фоновых задач { #kafka-tasks }

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

Сроки актуальности задач индексации поиска описаны в разделе [Поиск и проверка текста](https://webim.ru/kb/11.0/settings/env/search.html#search), задач BI-отчётов — в разделе [ClickHouse и аналитика](https://webim.ru/kb/11.0/settings/env/clickhouse.html#bi).

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `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` | Перепланирование тайм-аутов диалога (см. [Таймауты диалогов](https://webim.ru/kb/11.0/settings/constance/chats.html#chat-timeouts)). |
| `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` | Пересчёт блокировок посетителей после изменения правил блокировки. |

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

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

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `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` (см. [Статистика, поиск и выгрузки](https://webim.ru/kb/11.0/settings/constance/analytics.html)). |
| `KAFKA_THROTTLE_UI_RESOURCES_SECONDS` | Целое число, секунды | `30` | Интервал объединения перегенераций ресурсов и настроек виджета. |

## Кэш { #cache }

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

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `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` (см. [Прочие настройки](https://webim.ru/kb/11.0/settings/constance/misc.html)). |
| `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` | Срок хранения сведений о тарифных возможностях аккаунта, которые учитываются при проверке прав доступа. |

## Блокировки и планировщик { #locks }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `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 }

Отложенные задачи выполняются в назначенное время: например, закрытие диалога по тайм-ауту или запись объединённых изменений. Наступление срока отслеживает процесс `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`. |

## Объединяемые задачи { #coalescing }

Повторные вызовы объединяемой задачи в пределах интервала выполняются одним запуском (см. раздел [Объединение частых обновлений](#debounce)). Состояние таких задач хранится в 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` | Срок хранения в кэше последних данных объединяемой задачи до её выполнения. |

## Хранение служебных данных { #misc }

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

---

Источник: https://webim.ru/kb/11.0/settings/env/timeouts.html
