Redis
Подключение к Redis, отказоустойчивая конфигурация с Redis Sentinel, пулы соединений и тайм-ауты сокетов. Redis используется для кэша, очередей обновлений интерфейса, блокировок и временных данных посетителей.
Как изменить параметры и применить изменения, описано в разделе Параметры .env.
Подключение
| Параметр | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
REDIS_CACHE_LOCATION |
URL | Не задано | Да | Адрес подключения к Redis в формате redis://[:<пароль>@]<хост>:<порт>/<номер базы>. Для TLS-подключения используйте схему rediss://. Адрес используется для всех подключений Webim к Redis.Пример: redis://:<пароль>@redis.example.local:6379/1. |
REDIS_SSL_CA_LOCATION |
Путь к файлу | Пусто | Нет | Путь к сертификату удостоверяющего центра (PEM) для проверки сертификата Redis при подключении по схеме rediss://. Если не задан, используется системное хранилище сертификатов. |
REDIS_SENTINEL_HOSTS |
Список через запятую | Пусто | Нет | Адреса узлов Redis Sentinel в формате <хост>:<порт>, например sentinel1.example.local:26379,sentinel2.example.local:26379. Если список задан, адрес основного узла Redis запрашивается у Sentinel, а хост и порт из REDIS_CACHE_LOCATION не используются; номер базы, учётные данные и схема берутся из REDIS_CACHE_LOCATION. При схеме rediss:// TLS применяется и к узлам Sentinel. |
REDIS_SENTINEL_SERVICE |
Строка | mymaster |
Нет | Имя группы основного узла, которую отслеживает Sentinel. |
REDIS_SENTINEL_PASSWORD |
Строка | Пусто | Нет | Пароль для подключения к узлам Sentinel, если он отличается от пароля Redis. |
REDIS_SENTINEL_MASTER_HOST_OVERRIDE |
Строка | Пусто | Нет | Только для разработки: подменяет адрес основного узла, полученный от Sentinel. При DEBUG=False Webim с этим параметром не запускается. |
REDIS_HEALTH_CHECK_INTERVAL |
Целое число, секунды | 30 |
Нет | Если соединение простаивало дольше этого интервала, перед следующей командой проверяется его работоспособность. |
REDIS_TCP_KEEPIDLE |
Целое число, секунды | 60 |
Нет | Время простоя TCP-соединения до первой проверки keepalive. |
REDIS_TCP_KEEPINTVL |
Целое число, секунды | 10 |
Нет | Интервал между проверками keepalive. |
REDIS_TCP_KEEPCNT |
Целое число | 3 |
Нет | Число неудачных проверок keepalive, после которого соединение считается разорванным. |
Пулы соединений
Пулы создаются в каждом процессе Webim. Общее число соединений к Redis — сумма по всем пулам и процессам; оно должно укладываться в лимит maxclients сервера Redis.
| Параметр | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
REDIS_CACHE_MAX_CONNECTIONS |
Целое число | 6 |
Нет | Максимальное число соединений основного кэша в процессе. |
REDIS_JSON_CACHE_MAX_CONNECTIONS |
Целое число | 6 |
Нет | Максимальное число соединений кэша данных в формате JSON в процессе. |
REDIS_CACHE_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения к Redis для кэша. |
REDIS_CACHE_SOCKET_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут ответа Redis на команду кэша. |
REDIS_CONNECTION_POOL_MAX_CONNECTIONS |
Целое число | 10 |
Нет | Максимальное число соединений синхронного пула для очередей обновлений интерфейса. |
REDIS_CONNECTION_POOL_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения синхронного пула. |
REDIS_CONNECTION_POOL_SOCKET_TIMEOUT |
Целое число, секунды | 40 |
Нет | Тайм-аут ответа Redis в синхронном пуле. Должен быть больше длительности длинного опроса (30 секунд). |
ASYNC_REDIS_CACHE_MAX_CONNECTIONS |
Целое число | 512 |
Нет | Максимальное число соединений асинхронного кэша в процессе. |
ASYNC_REDIS_CACHE_POOL_TIMEOUT |
Дробное число, секунды | 5.0 |
Нет | Максимальное время ожидания свободного соединения асинхронного кэша. |
ASYNC_REDIS_CACHE_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения асинхронного кэша. |
ASYNC_REDIS_CACHE_SOCKET_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут ответа Redis для асинхронного кэша. |
ASYNC_REDIS_CACHE_DEFAULT_TIMEOUT |
Целое число, секунды | 300 |
Нет | Срок хранения записей асинхронного кэша, если для записи не задан собственный срок. |
ASYNC_JSON_CACHE_MAX_CONNECTIONS |
Целое число | 20 |
Нет | Максимальное число соединений асинхронного кэша данных в формате JSON. |
ASYNC_JSON_CACHE_POOL_TIMEOUT |
Дробное число, секунды | 5.0 |
Нет | Максимальное время ожидания свободного соединения асинхронного кэша данных в формате JSON. |
ASYNC_JSON_CACHE_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения асинхронного кэша данных в формате JSON. |
ASYNC_JSON_CACHE_SOCKET_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут ответа Redis для асинхронного кэша данных в формате JSON. |
STREAM_REDIS_POOL_MAX_CONNECTIONS |
Целое число | 256 |
Нет | Максимальное число соединений асинхронного пула для очередей обновлений интерфейса. На установках с небольшим числом процессов значение можно уменьшить. |
REDIS_STREAM_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения пула очередей обновлений. Тайм-аут ответа для этого пула не задаётся: длинный опрос держит соединение до 30 секунд. |
STREAM_UPDATES_MAXLEN |
Целое число | 10000 |
Нет | Максимальная длина очереди обновлений интерфейса одного сотрудника в Redis. Более старые записи удаляются. |
EPHEMERAL_REDIS_POOL_TIMEOUT |
Дробное число, секунды | 5.0 |
Нет | Максимальное время ожидания соединения пула временных данных посетителей. |
EPHEMERAL_REDIS_SOCKET_CONNECT_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут подключения пула временных данных посетителей. |
EPHEMERAL_REDIS_SOCKET_TIMEOUT |
Целое число, секунды | 5 |
Нет | Тайм-аут ответа Redis для пула временных данных посетителей. |