ClickStack FAQ

Часто задаваемые вопросы об оповещениях, панелях мониторинга, детализации и поиске метрик в ClickStack.

На этой странице собраны ответы на часто задаваемые вопросы о возможностях ClickStack, включая оповещения, панели мониторинга, детализацию и поиск метрик.

​

Оповещения

Какие типы оповещений поддерживает ClickStack?

ClickStack поддерживает два типа оповещений:

• Оповещения по поиску — отправляют уведомления, когда количество совпадающих результатов журналов или трассировок в заданном временном окне превышает порог или опускается ниже него.
• Оповещения по диаграммам панели мониторинга — отправляют уведомления, когда метрика, отображаемая на плитке панели мониторинга, пересекает заданный порог.

Оба типа оповещений используют статические пороговые условия. Подробности см. в разделе Оповещения.

Можно ли настраивать оповещения по сложным условиям метрик, таким как отношения, p95/p99 или формулы с несколькими метриками?

Отношения двух метрик, а также значения p95 и p99 можно отображать на плитке панели мониторинга с помощью интерфейса конструктора диаграмм. После этого для таких плиток можно создавать пороговые оповещения.

Однако ClickStack в настоящее время не поддерживает:

• Оповещения на основе пользовательских SQL-запросов для метрик.
• Правила оповещений с несколькими условиями или несколькими метриками, объединёнными в одно оповещение.
• Динамические условия оповещений или условия на основе обнаружения аномалий (обнаружение аномалий планируется).

Если вам нужно настроить оповещение для сложной метрики, рекомендуется сначала создать визуализацию в виде диаграммы на панели мониторинга, а затем привязать к этой диаграмме пороговое оповещение.

Можно ли использовать materialized view для оповещений?

ClickStack автоматически использует materialized view для оповещений там, где это применимо. Однако materialized view в настоящее время не поддерживаются для источников данных метрик OpenTelemetry. Для метрик ClickStack лучше всего работает со схемой метрик OpenTelemetry для ClickHouse по умолчанию. Подробнее о materialized view см. в разделе Materialized views.

​

Панели мониторинга и детализация

Поддерживает ли ClickStack параметризованные панели мониторинга или переменные панелей мониторинга?

ClickStack поддерживает настраиваемые выпадающие фильтры на панелях мониторинга, которые заполняются данными из ClickHouse. Эти фильтры позволяют динамически ограничивать все плитки на панели мониторинга конкретным значением (например, именем сервиса, средой или хостом).

В настоящее время ClickStack не поддерживает повторно используемые переменные панелей мониторинга в стиле шаблонных переменных Grafana. Поскольку ClickStack использует ClickHouse как единственный источник данных, возможности детализации и фильтрации доступны нативно, без дополнительного слоя абстракции переменных.

Подробнее о создании панелей мониторинга и применении фильтров см. в разделе Панели мониторинга.

Какие возможности детализации доступны?

ClickStack поддерживает следующие сценарии детализации:

• Фильтрация на уровне панели мониторинга — фильтры Lucene или SQL, а также изменения временного диапазона, заданные на уровне панели мониторинга, применяются ко всем плиткам.
• Пользовательские фильтры панели мониторинга — пользовательские панели мониторинга поддерживают явные элементы управления фильтрами, которые заполняются значениями из ваших данных и позволяют пользователям ограничивать все плитки без ручного написания запросов.
• Переход к событиям по клику — при щелчке по данным в плитке панели мониторинга и выборе View Events выполняется переход на страницу Search с соответствующими фильтрами для данных журналов и трассировок.
• Предустановленные сценарии детализации на панелях мониторинга — панели мониторинга Services, ClickHouse и Kubernetes включают более развитую встроенную навигацию для детализации между вкладками.

Многоуровневая детализация с одной пользовательской панели мониторинга на другую (панель мониторинга → панель мониторинга → детальное представление) в настоящее время не поддерживается.

Детализация View Events лучше всего работает с данными журналов и трассировок. Поскольку данные метрик нельзя просматривать на странице Search, переход из плитки метрик вместо этого будет вести к журналам за период, близкий к выбранному моменту времени.

​

Поиск метрик

Есть ли интерфейс для просмотра и поиска метрик?

Имена метрик можно просматривать через раскрывающийся список имен метрик в конструкторе диаграмм. После выбора метрики панель Metric Attribute Explorer отображает описание метрики, единицы измерения и доступные атрибуты вместе с их значениями. Это позволяет просматривать атрибуты и добавлять их в качестве фильтров или полей для группировки прямо из этой панели.

В настоящее время отдельной страницы для поиска метрик, аналогичной поиску журналов, нет. Улучшение средств поиска метрик — одно из активных направлений разработки.

Предполагается ли, что в долгосрочной перспективе поиск метрик будет выполняться через SQL?

Нет. Хотя сегодня для поиска метрик можно использовать SQL-запросы, это не тот подход, который планируется использовать в долгосрочной перспективе. Более удобные инструменты для поиска метрик сейчас активно разрабатываются.

​

Дополнительные материалы

• Оповещения — поисковые оповещения, оповещения по диаграммам на панели мониторинга и интеграции с вебхуками.
• Панели мониторинга — создание визуализаций, сборка панелей мониторинга и применение фильтров.
• Поиск — выполнение запросов к журналам и трассировкам с использованием синтаксиса Lucene и SQL.
• Схемы — схемы данных OpenTelemetry для журналов, трассировок и метрик.
• Архитектура — компоненты ClickStack и то, как они связаны между собой.