Индексы

Индекс — это специализированная таблица в БД ClickHouse, предназначенная для хранения и ускоренного поиска на экране «События и логи», а также как основа для построения метрик-бриджей.

При выборе индекса на экране «События и логи»:

• список доступных потоков ограничивается потоками, входящими в индекс
• поиск и статистика строятся по данным индекса в рамках глубины его хранения
• состав и типы полей берутся из индексной таблицы

Обзор экрана

Отдельного пункта меню для индексов нет.
Попасть на экран можно с экрана «События и логи» или из карточки любого метрик-бриджа.

доступ к разделу и его содержимому

регулируется ролевой моделью: права зависят от наличия прав на просмотр/редактирование потоков данных

На экране представлены следующие данные и элементы управления:

• Список сохраненных индексов
• Карточка индекса с основной информацией и данными по связанным сущностям: картам логов и метрик-бриджам
• Статистика: размер индексной таблицы и количество записей в ней
• Кнопки + Создать индекс и Удалить

Список индексов

• Содержит сохраненные индексы текущей рабочей группы
• Клик по любому индексу открывает его карточку
• Поисковая строка поддерживает поиск по названию индекса и по его id

Создание индекса

1. В правом верхнем углу экрана нажмите + Создать индекс
2. Заполните параметры:
   • Название — должно быть уникальным в рамках рабочей группы
   • Глубина хранения — фиксированная и равна 90 дням
   • Предзаполнение — фиксированное и равно 90 дням
   • Потоки данных
     • Доступны только потоки типа «События и логи» текущей РГ
     • Можно выбрать несколько потоков одновременно
     • Поисковая строка работает по названию, описанию и id потока
     • Система автоматически проверяет наличие хотя бы одного события в каждом потоке
   • Поля
     Список полей подгружается автоматически после выбора потоков данных и может содержать до 100 наиболее релевантных полей, которые сортируются сначала от новых к старым, затем по алфавиту.
     • Допускается включение не более 15 полей в индекс
     • Тип каждого поля определяется автоматически
     • У выбранных полей можно задать собственные значения по умолчанию или оставить стандартные
     Выбирайте действительно релевантные поля: это повышает скорость поиска
3. Нажмите Создать

Индекс создается в БД, появляется в списке, сразу начинает принимать новые события и становится доступен для карт логов и метрик-бриджей.

При этом запускается предзаполнение историческими данными по полю aggregatedAt, начиная от момента создания в порядке убывания времени.

Во время предзаполнения в списке индексов отображается прогресс выполнения в %.

глубина хранения и предзаполнение всегда равны 90 дням

При возникновении ошибки

Во время предзаполнения рядом с названием индекса появляется соответствующая иконка.
При наведении на нее выводится подсказка об ошибке.

Типы полей и форматы дат

Типы полей определяются автоматически по данным выбранных потоков и фиксируются в схеме индексной таблицы.

• Если для одного и того же поля в разных логах встречаются смешанные типы значений (например, number и date), то тип поля будет установлен как string
• Если для одного поля встречаются значения int и float, то тип будет определен как float
• Все определяемые форматы дат будут распознаны как date
• Массив со смешанными типами элементов получит тип string
• При появлении нового значения, которое не соответствует ранее определенному типу поля, тип будет переопределен в соответствии с правилами выше, а значение будет заменено на значение по умолчанию для данного поля

Поле будет распознано как дата/время, если значение соответствует одному из форматов:

• 2025-07-19
• 07/19/2025
• 07/19/25
• July 19, 2025
• 2025-07-19T14:30
• 2025-07-19T14:30:45
• 2025-07-19T14:30:45.123
• 2025-07-19T14:30:45Z
• 2025-07-19T14:30:45+03:00
• 2025-07-19T14:30:45-05:00

Значения по умолчанию для полей

• date — текущая дата в формате ДД.ММ.ГГГГ
• datetime — текущие дата и время в формате ДД.ММ.ГГГГ ЧЧ.ММ
• string — пустая строка (в карточке индекса отображается как дефис)
• int / float — 0
  Некорректные значения будут сброшены в 0, а ведущие нули будут отброшены
• boolean — false
• array — значение по умолчанию не задается. Если элементы массива разных типов, массив будет задан с типом string

Карточка индекса

Карточка индекса открывается по клику на его название в списке.

В верхней части карточки находится название индекса и статистика по нему: количество записей и размер таблицы.

Карточка содержит вкладки:

• Основная информация

  • Название
  • Потоки данных
  • Глубина хранения (фиксированная: 90 дней)
  • Таблица полей: список выбранных индексируемых полей с указанием их типов и значений по умолчанию

• Связанные карты логов

  • Представлен список созданных на основе индекса карт логов (при их наличии)
  • В заголовке вкладки указано общее количество связанных карт

• Связанные метрик-бриджи

  • Представлен список созданных на основе индекса метрик-бриджей (при их наличии)
  • В заголовке вкладки указано общее количество связанных метрик-бриджей

  

к одному индексу может быть привязано множество карт логов и метрик-бриджей

Редактирование индекса

Редактирование доступно из карточки индекса и единственным изменяемым параметром является название индекса.

1. Укажите новое название
2. Нажмите Сохранить изменения

Удаление индекса

Удаление индекса возможно только если он не связан ни с одной из сущностей - метрик-бриджами и/или картами логов. Если связанные сущности существуют, то необходимо сначала удалить их.

1. В правом верхнем углу карточки индекса нажмите на кнопку Удалить
2. Подтвердите удаление в появившемся окне

Успешное удаление сопровождается соответствующим уведомлением.