# Статистика, поиск и выгрузки

Настройки статистики и панели приборов, BI на ClickHouse, полнотекстового поиска по истории, выгрузок и страницы «Фоновые задачи».

Как читать таблицы и редактировать значения, описано в разделе [Настройки в Constance](https://webim.ru/kb/11.0/settings/constance/).

## Аналитика и статистика { #analytics }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `DEFAULT_HISTORY_DATE_RANGE` | Длительность | 1 день<br>`1 00:00:00` | Период, за который по умолчанию показывается история диалогов. |
| `THREAD_REPORT_COUNT_LIMIT` | Целое число | 10 000 | Максимальное количество диалогов, которое подсчитывается в истории и отчётах. |
| `MAX_SEARCH_DATE_RANGE_DAYS` | Целое число | 90 | Максимальный период в днях, в пределах которого выполняется полнотекстовый поиск по истории диалогов. |
| `GOOGLE_ANALYTICS` | Логический | Включено | Отправляет события виджета в Google Analytics, если на сайте подключён счётчик. |
| `YANDEX_METRIKA_COUNTER_ID` | Целое число или пусто | Не задано | Номер счётчика Яндекс Метрики, в который виджет отправляет события. Пустое значение — события не отправляются. |
| `ES_POPULATION_DEPTH` | Длительность | 90 дней<br>`90 00:00:00` | Глубина индексации диалогов в поисковом движке (OpenSearch или Elasticsearch): диалоги старше этого периода не индексируются и не находятся полнотекстовым поиском. |
| `ES_INDEX_BATCH_SIZE` | Целое число | 500 | Количество диалогов, индексируемых в поисковом движке за один запуск фоновой задачи. Чем больше значение, тем реже обращения к очереди; чем меньше, тем быстрее диалог появляется в поиске. |
| `ES_INDEX_MIN_INTERVAL` | Длительность | 15 секунд<br>`00:00:15` | Интервал между запусками фоновой индексации диалогов. Определяет минимальную задержку появления диалога в поиске. |
| `ES_INDEX_MAX_ATTEMPTS` | Целое число | 3 | Количество неудачных попыток индексации, после которого диалог исключается из индексации до ручного разбора. |
| `ANGULAR_THREAD_DETAIL` | Логический | Включено | Открывает протокол диалога (`/history/<id>`) в новом интерфейсе вместо прежнего. |
| `ANALYTICS_V2_DASHBOARD` | Логический | Включено | Включает доступ к новой панели приборов.<br>Зависит от тарифной возможности `report_configs`: без неё действует значение «Выключено». |
| `ANALYTICS_V2_STATS` | Логический | Включено | Включает доступ к новой статистике.<br>Зависит от тарифной возможности `report_configs`: без неё действует значение «Выключено». |
| `ANALYTICS_V2_BUILDER` | Логический | Включено | Включает доступ к редактору отчётов и метрик.<br>Зависит от тарифной возможности `report_configs`: без неё действует значение «Выключено». |
| `ANALYTICS_V2_REPORT_CACHE_TTL` | Длительность | 1 день<br>`1 00:00:00` | Время хранения результатов отчётов в Redis. |
| `ANALYTICS_V2_REPORT_MAX_ACTIVE` | Целое число | 5 | Максимальное количество одновременно формируемых отчётов для одного сотрудника. |
| `ANALYTICS_V2_ONLY_THREADS_WITH_VISITOR_MESSAGE_DEFAULT` | Логический | Выключено | Значение по умолчанию фильтра «Учитывать только диалоги с сообщением посетителя» в отчётах. |
| `ANALYTICS_V2_ONLY_THREADS_WITH_VISITOR_MESSAGE_DASHBOARD_DEFAULT` | Логический | Выключено | Значение по умолчанию фильтра «Учитывать только диалоги с сообщением посетителя» на панели приборов. |
| `DASHBOARD_REALTIME_UPDATE_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал обновления показателей реального времени на панели приборов. |
| `DASHBOARD_PREV_PERIODS_UPDATE_INTERVAL` | Длительность | 30 секунд<br>`00:00:30` | Интервал обновления показателей за прошедшие периоды на панели приборов. |
| `BI_POPULATION_DEPTH` | Длительность | 90 дней<br>`90 00:00:00` | Глубина выгрузки диалогов в ClickHouse для BI: диалоги старше этого периода не выгружаются. |
| `BI_LIVE_REFRESH_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал обновления таблиц показателей реального времени BI в ClickHouse. |
| `BI_LIVE_BATCH_SIZE` | Целое число | 5000 | Максимальное количество объектов, обрабатываемых за один цикл обновления таблиц реального времени BI. |
| `BI_DIM_SYNC_INTERVAL` | Длительность | 5 минут<br>`00:05:00` | Интервал синхронизации справочников (сотрудники, отделы и т. п.) в ClickHouse для BI. |
| `BI_TIME_WINDOWS` | JSON-массив | `["15m", "1h"]` | Временные окна для показателей реального времени BI. Элемент — число и единица: `m` (минуты) или `h` (часы).<br>Пример: `["15m", "1h"]`. |
| `BI_REARCHIVE_BATCH_SIZE` | Целое число | 100 | Количество диалогов в одном пакете при повторной выгрузке изменённых диалогов в ClickHouse. |
| `BI_REARCHIVE_MIN_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал повторной выгрузки изменённых диалогов в ClickHouse. Определяет максимальную задержку появления изменений в BI. |
| `BI_REARCHIVE_MAX_ATTEMPTS` | Целое число | 5 | Количество неудачных попыток повторной выгрузки, после которого диалог исключается из выгрузки до ручного разбора. |
| `BI_TABLE_MAX_COLUMNS` | Целое число | 10 | Максимальное количество колонок в табличном запросе BI. |
| `BI_TABLE_PAGE_SIZE` | Целое число | 100 | Количество строк на странице в табличных запросах BI. |
| `ANALYTICS_V2_CLICKHOUSE_STATS` | Логический | Включено | В Webim 11.0 расчёт статистики на ClickHouse включён всегда; значение параметра не влияет на расчёт статистики. Параметр по-прежнему читается бэкендом (в том числе в контексте доступа) и учитывается при миграции со старой настройки. |
| `FULFILL_CATEGORIES_IN_REPORT_EXPORT` | Логический | Выключено | Выводит все категории, включая категории без диалогов, при сохранении отчёта с группировкой по категориям. |
| `USE_GEO_COUNTRY_NAME` | Логический | Выключено | Сохраняет для новых диалогов страну, определённую по IP-адресу посетителя. При выключенной настройке страна не сохраняется. Требует базы геолокации (параметр `GEO_DB_PATH` файла `.env`, см. [Основные параметры и безопасность](https://webim.ru/kb/11.0/settings/env/general.html#mode)). |
| `ANALYTICS_V2_REPORT_SET` | Строка | `new` | Набор предустановленных отчётов и метрик. Допустимые значения: `new` — переработанный набор, `legacy` — набор прежней статистики. |
| `ANALYTICS_V2_WEB_REPORT_ROWS_LIMIT` | Целое число | 1000 | Количество строк отчёта, показываемых в таблице на странице; остальные строки доступны в выгрузке. Значение `0` снимает ограничение. |
| `ANALYTICS_V2_MAX_REPORT_ROWS` | Целое число | 10 | Количество строк в таблице виджета панели приборов, после которого появляется вертикальная прокрутка. |
| `ANALYTICS_V2_REPORT_QUERY_TIMEOUT` | Длительность | 1 минута<br>`00:01:00` | Максимальное время выполнения одного запроса отчёта к ClickHouse. |
| `ANALYTICS_V2_REPORT_CONCURRENCY` | Целое число | 3 | Количество отчётов пакета, которые рассчитываются одновременно. Допустимые значения — от `1` до `7`. |
| `ANALYTICS_V2_VALIDATE_ON_TICK` | Логический | Включено | Диагностическая настройка. После каждой выгрузки сверяет обращения в PostgreSQL и ClickHouse за последние двое суток и записывает расхождения в журнал. |
| `ANALYTICS_V2_PREDEFINED_CACHE_TTL` | Длительность | 1 час<br>`01:00:00` | Время кэширования предустановленных данных отчётов. |
| `ANALYTICS_V2_DATA_CACHE_TTL` | Длительность | 5 минут<br>`00:05:00` | Время кэширования метрик, конфигураций отчётов, групп и панелей приборов. |
| `ANALYTICS_V3_DASHBOARD` | Логический | Выключено | Включает панель приборов BI версии 3. |
| `DEFAULT_DASHBOARD_VERSION` | Строка | `v2` | Версия панели приборов, которая открывается по умолчанию. Допустимые значения: `v2`, `v3`. |

## Использование read-реплики БД { #read-replica }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `ANALYTICS_V2_USE_REPLICA` | Логический | Включено | Читает данные для выгрузки статистики в ClickHouse из реплики PostgreSQL для чтения. Работает, только если задан параметр `DATABASE_REPLICA_URL` файла `.env` (см. [PostgreSQL](https://webim.ru/kb/11.0/settings/env/postgresql.html#replica)); иначе данные читаются из основной базы. |
| `BI_USE_REPLICA` | Логический | Включено | Читает данные для выгрузки BI в ClickHouse из реплики PostgreSQL для чтения. Работает, только если задан параметр `DATABASE_REPLICA_URL` файла `.env`. |
| `ES_USE_REPLICA` | Логический | Включено | Читает данные для индексации диалогов в поисковом движке из реплики PostgreSQL для чтения. Работает, только если задан параметр `DATABASE_REPLICA_URL` файла `.env`. |

## Экспорт { #export }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `MAX_CONCURRENT_EXPORTS` | Целое число | 3 | Максимальное количество одновременных выгрузок для одного сотрудника. |
| `EXPORT_VISITORS_BATCH_SIZE` | Целое число | 2000 | Количество посетителей в одном пакете при выгрузке посетителей в CSV. |
| `EXPORT_CACHE_TTL` | Длительность | 1 час<br>`01:00:00` | Время хранения готовых файлов выгрузки. |
| `MAX_EXPORT_SIZE` | Целое число | 52 428 800 (50 МБ) | Максимальный размер файла выгрузки в байтах. |
| `MAX_EXPORT_VISITORS` | Целое число | 500 000 | Максимальное количество посетителей в одной выгрузке. |
| `MAX_EXPORT_CHATS` | Целое число | 50 000 | Максимальное количество диалогов в одной выгрузке. |

## Фоновые задачи { #background-tasks }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `JOB_STALE_TIMEOUT` | Длительность | 10 минут<br>`00:10:00` | Время без признаков работы, после которого выполняющаяся фоновая задача считается зависшей. |
| `JOB_LIST_LOOKBACK` | Длительность | 7 дней<br>`7 00:00:00` | Период, за который показываются задачи на странице «Фоновые задачи». |
| `JOB_HIDDEN_TYPES` | Список строк | `["stats_report"]` | Типы задач, которые не показываются на странице «Фоновые задачи». |

---

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