# Режимы подсчёта и обновления статистики

В Webim 11.0 отчёты **Статистики v2** строятся по данным в **ClickHouse**. Актуальность цифр зависит от того, как часто основная БД перекачивается в ClickHouse.

## Включение статистики на ClickHouse

ClickHouse-статистика в **Webim 11.0** включена всегда. Параметр Constance `ANALYTICS_V2_CLICKHOUSE_STATS` бэкенд читает (в том числе отдаёт в контекст доступа как `clickhouse_stats`), а скрипт миграции сопоставляет с ним старую настройку, но **значение параметра не влияет на расчёт статистики**. Доступ к разделу **Статистика v2** зависит от `ANALYTICS_V2_STATS` и тарифной возможности `report_configs` — см. [Аналитика и статистика](https://webim.ru/kb/11.0/settings/constance/analytics.html).

## Перекачка данных в 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-реплики БД](https://webim.ru/kb/11.0/settings/constance/analytics.html#read-replica).

## Хранение готовых отчётов

Сформированный отчёт (данные для просмотра и файл Excel) сохраняется во временном хранилище на срок `ANALYTICS_V2_REPORT_CACHE_TTL` (по умолчанию 1 сутки). После истечения срока отчёт в списке помечается как просроченный — его нужно сгенерировать заново.

---

Источник: https://webim.ru/kb/11.0/for-analytics/statistics/calculation-modes.html
