Перейти к содержанию

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

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

Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.

Аналитика и статистика

Параметр Тип По умолчанию Описание
DEFAULT_HISTORY_DATE_RANGE Длительность 1 день
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 дней
90 00:00:00
Глубина индексации диалогов в поисковом движке (OpenSearch или Elasticsearch): диалоги старше этого периода не индексируются и не находятся полнотекстовым поиском.
ES_INDEX_BATCH_SIZE Целое число 500 Количество диалогов, индексируемых в поисковом движке за один запуск фоновой задачи. Чем больше значение, тем реже обращения к очереди; чем меньше, тем быстрее диалог появляется в поиске.
ES_INDEX_MIN_INTERVAL Длительность 15 секунд
00:00:15
Интервал между запусками фоновой индексации диалогов. Определяет минимальную задержку появления диалога в поиске.
ES_INDEX_MAX_ATTEMPTS Целое число 3 Количество неудачных попыток индексации, после которого диалог исключается из индексации до ручного разбора.
ANGULAR_THREAD_DETAIL Логический Включено Открывает протокол диалога (/history/<id>) в новом интерфейсе вместо прежнего.
ANALYTICS_V2_DASHBOARD Логический Включено Включает доступ к новой панели приборов.
Зависит от тарифной возможности report_configs: без неё действует значение «Выключено».
ANALYTICS_V2_STATS Логический Включено Включает доступ к новой статистике.
Зависит от тарифной возможности report_configs: без неё действует значение «Выключено».
ANALYTICS_V2_BUILDER Логический Включено Включает доступ к редактору отчётов и метрик.
Зависит от тарифной возможности report_configs: без неё действует значение «Выключено».
ANALYTICS_V2_REPORT_CACHE_TTL Длительность 1 день
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 минута
00:01:00
Интервал обновления показателей реального времени на панели приборов.
DASHBOARD_PREV_PERIODS_UPDATE_INTERVAL Длительность 30 секунд
00:00:30
Интервал обновления показателей за прошедшие периоды на панели приборов.
BI_POPULATION_DEPTH Длительность 90 дней
90 00:00:00
Глубина выгрузки диалогов в ClickHouse для BI: диалоги старше этого периода не выгружаются.
BI_LIVE_REFRESH_INTERVAL Длительность 1 минута
00:01:00
Интервал обновления таблиц показателей реального времени BI в ClickHouse.
BI_LIVE_BATCH_SIZE Целое число 5000 Максимальное количество объектов, обрабатываемых за один цикл обновления таблиц реального времени BI.
BI_DIM_SYNC_INTERVAL Длительность 5 минут
00:05:00
Интервал синхронизации справочников (сотрудники, отделы и т. п.) в ClickHouse для BI.
BI_TIME_WINDOWS JSON-массив ["15m", "1h"] Временные окна для показателей реального времени BI. Элемент — число и единица: m (минуты) или h (часы).
Пример: ["15m", "1h"].
BI_REARCHIVE_BATCH_SIZE Целое число 100 Количество диалогов в одном пакете при повторной выгрузке изменённых диалогов в ClickHouse.
BI_REARCHIVE_MIN_INTERVAL Длительность 1 минута
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, см. Основные параметры и безопасность).
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 минута
00:01:00
Максимальное время выполнения одного запроса отчёта к ClickHouse.
ANALYTICS_V2_REPORT_CONCURRENCY Целое число 3 Количество отчётов пакета, которые рассчитываются одновременно. Допустимые значения — от 1 до 7.
ANALYTICS_V2_VALIDATE_ON_TICK Логический Включено Диагностическая настройка. После каждой выгрузки сверяет обращения в PostgreSQL и ClickHouse за последние двое суток и записывает расхождения в журнал.
ANALYTICS_V2_PREDEFINED_CACHE_TTL Длительность 1 час
01:00:00
Время кэширования предустановленных данных отчётов.
ANALYTICS_V2_DATA_CACHE_TTL Длительность 5 минут
00:05:00
Время кэширования метрик, конфигураций отчётов, групп и панелей приборов.
ANALYTICS_V3_DASHBOARD Логический Выключено Включает панель приборов BI версии 3.
DEFAULT_DASHBOARD_VERSION Строка v2 Версия панели приборов, которая открывается по умолчанию. Допустимые значения: v2, v3.

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

Параметр Тип По умолчанию Описание
ANALYTICS_V2_USE_REPLICA Логический Включено Читает данные для выгрузки статистики в ClickHouse из реплики PostgreSQL для чтения. Работает, только если задан параметр DATABASE_REPLICA_URL файла .env (см. PostgreSQL); иначе данные читаются из основной базы.
BI_USE_REPLICA Логический Включено Читает данные для выгрузки BI в ClickHouse из реплики PostgreSQL для чтения. Работает, только если задан параметр DATABASE_REPLICA_URL файла .env.
ES_USE_REPLICA Логический Включено Читает данные для индексации диалогов в поисковом движке из реплики PostgreSQL для чтения. Работает, только если задан параметр DATABASE_REPLICA_URL файла .env.

Экспорт

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

Фоновые задачи

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