Режимы подсчёта и обновления статистики
В Webim 11.0 отчёты Статистики v2 строятся по данным в ClickHouse. Актуальность цифр зависит от того, как часто основная БД перекачивается в ClickHouse.
Включение статистики на ClickHouse
ClickHouse-статистика в Webim 11.0 включена всегда. Параметр Constance ANALYTICS_V2_CLICKHOUSE_STATS бэкенд читает (в том числе отдаёт в контекст доступа как clickhouse_stats), а скрипт миграции сопоставляет с ним старую настройку, но значение параметра не влияет на расчёт статистики. Доступ к разделу Статистика v2 зависит от ANALYTICS_V2_STATS и тарифной возможности report_configs — см. Аналитика и статистика.
Перекачка данных в ClickHouse
Данные из основной БД Webim (PostgreSQL) попадают в ClickHouse штатной фоновой задачей перекачки (populate_ch_stats в топике задач статистики). Перекачка:
-
выполняется периодически для каждого активного аккаунта (интервал задаётся на сервере, типичное значение — порядка 15 минут);
-
идёт инкрементально от сохранённого курсора — при повторных запусках переносятся новые и изменённые данные;
-
при первом запуске (курсора ещё нет) не загружает прошлую историю: курсор выставляется на текущий момент (с минутным перекрытием), и дальше переносятся только новые и изменённые данные.
Чтобы в ClickHouse появилась история за прошедший период, нужен отдельный запуск команды управления populate_clickhouse с указанием диапазона дат (on-premises / сопровождение стенда). Без этой первоначальной заливки отчёты по прошлым периодам будут неполными или пустыми. Ту же команду используют и для полной перезаливки выбранного периода при обслуживании.
На странице Отчёты индикатор состояния перекачки показывает, когда данные обновлялись в последний раз и идёт ли перекачка сейчас.
Данные реального времени для панели приборов
Отдельно от основной перекачки обновляются таблицы «среза» текущего онлайна (активные обращения и статусы операторов). Они нужны панели приборов и обновляются чаще (свой интервал на сервере; событийное обновление дополнительно ограничивается параметром Constance DASHBOARD_REALTIME_UPDATE_INTERVAL).
В эти таблицы попадают в основном активные обращения, а не полная история.
Чтение из реплики
Параметр Constance ANALYTICS_V2_USE_REPLICA (по умолчанию включён) позволяет читать данные для перекачки из реплики PostgreSQL для чтения, если задан DATABASE_REPLICA_URL в окружении сервера. Иначе данные читаются из основной базы. См. Использование read-реплики БД.
Хранение готовых отчётов
Сформированный отчёт (данные для просмотра и файл Excel) сохраняется во временном хранилище на срок ANALYTICS_V2_REPORT_CACHE_TTL (по умолчанию 1 сутки). После истечения срока отчёт в списке помечается как просроченный — его нужно сгенерировать заново.