- Static threshold: срабатывает, когда значение пересекает заданное вами число. Этот режим используется по умолчанию; именно он описан на этой странице.
- Anomaly detection (только в Управляемом ClickStack): срабатывает, когда значение выходит за пределы ожидаемого диапазона, вычисляемого по недавней истории. См. Оповещения об аномалиях.
- Оповещения на основе поиска
Оповещения на основе поиска позволяют отправлять уведомления на основе результатов сохраненного поиска. Они помогают выявлять случаи, когда определенные события или шаблоны возникают чаще (или реже), чем ожидалось.
Оповещение срабатывает, когда количество совпадающих результатов в пределах заданного временного окна либо превышает, либо опускается ниже указанного порога.
Чтобы создать оповещение на основе поиска:
Чтобы для поиска можно было создать оповещение, поиск должен быть сохранен. Вы можете либо создать оповещение для уже существующего сохраненного поиска, либо сохранить поиск в процессе создания оповещения. В примере ниже предполагается, что поиск не сохранен.
1
Откройте диалог создания оповещения
Начните с ввода поиска и нажмите кнопку 
Alerts в правом верхнем углу страницы Search.
2
Создайте оповещение
В панели создания оповещения вы можете:
- Задать имя для сохраненного поиска, связанного с оповещением.
- Установить порог и указать, сколько раз он должен быть достигнут в течение заданного периода. Пороги также можно использовать как верхние или нижние границы. Период здесь также определяет, как часто будет срабатывать оповещение.
- Указать значение
grouped by. Это позволяет применять к поиску агрегацию, например поServiceName, и тем самым запускать несколько оповещений на основе одного и того же поиска. - Выбрать пункт назначения вебхука для уведомлений. Вы можете добавить новый вебхук прямо из этого представления. Подробности см. в разделе Добавление вебхука.


- Оповещения для диаграмм на панели мониторинга
Оповещения для диаграмм на панели мониторинга добавляют возможность настраивать оповещения прямо на диаграммах.
Вы можете создать оповещение на основе диаграммы напрямую из сохранённой панели мониторинга, используя полноценные SQL-агрегации и функции ClickHouse для сложных вычислений.
Когда метрика пересекает заданный порог, оповещение срабатывает автоматически, позволяя отслеживать KPI, задержки и другие ключевые метрики во времени.
Чтобы создать оповещение для визуализации на панели мониторинга, панель мониторинга должна быть сохранена.
1
Откройте диалог редактирования диаграммы
Откройте меню настроек диаграммы и нажмите кнопку оповещения. Откроется диалог редактирования диаграммы.

2
Добавьте оповещение
Выберите Add Alert.

3
Задайте условия оповещения
Задайте условие (
Вы можете добавить новый вебхук прямо из этого окна. Подробности см. в разделе Добавление вебхука.
>=, >, <=, <, =, !=, <= x >=, > or <), порог, длительность и вебхук. Длительность здесь также определяет, как часто будет срабатывать оповещение.
Добавление вебхука
При создании оповещения можно либо использовать существующий вебхук, либо создать новый. После создания вебхук будет доступен для повторного использования в других оповещениях. Вебхук можно создать для разных типов сервисов, включая Slack и PagerDuty, а также для универсальных конечных точек. Например, рассмотрим создание оповещения для диаграммы ниже. Прежде чем указать вебхук, пользователь может выбратьAdd New Webhook.


- Slack: отправка уведомлений напрямую в канал через вебхук или API.
- PagerDuty: маршрутизация инцидентов для дежурных команд через API PagerDuty.
- Вебхук: подключение оповещений к любой пользовательской системе или процессу через универсальный вебхук.
Интеграции только в ClickHouse CloudИнтеграции через Slack API и PagerDuty поддерживаются только в ClickHouse Cloud.
- URL вебхука. Например:
https://hooks.slack.com/services/<unique_path>. Подробности см. в документации Slack.
- Токен бота Slack. Подробности см. в документации Slack.
- Ключ интеграции PagerDuty. Подробности см. в документации PagerDuty.
- URL вебхука
- Заголовки вебхука (необязательно)
- Тело вебхука (необязательно). Сейчас в теле поддерживаются переменные шаблона
{{title}},{{body}}и{{link}}.
Управление оповещениями
Оповещениями можно централизованно управлять через панель оповещений в левой части интерфейса HyperDX.

- Красная полоса: во время этой проверки пороговое условие было выполнено, и оповещение сработало (уведомление отправлено)
- Зелёная полоса: оповещение было проверено, но пороговое условие не выполнилось (уведомление не отправлено)
Удаление оповещения
Чтобы удалить оповещение, откройте диалог редактирования для соответствующего поиска или диаграммы, затем выберите Remove Alert. В примере ниже кнопкаRemove Alert удалит оповещение с диаграммы.

Другие типы SQL-диаграмм (Table, Pie, Heatmap и т. д.) не поддерживают оповещения.
Создание SQL-оповещения
Чтобы создать оповещение для SQL-диаграммы:1
Создайте или откройте SQL-диаграмму на панели мониторинга
На сохранённой панели мониторинга либо создайте новую диаграмму в режиме SQL, либо откройте существующую SQL-диаграмму для редактирования.В качестве типа отображения выберите Line, Stacked Bar или Number.

2
Добавьте оповещение
В разделе оповещений редактора диаграммы выберите Add Alert. Настройте:
- Тип порога:
>=(больше или равно),>(больше),<=(меньше или равно),<(меньше),=(равно),!=(не равно),<= x >=(между), или> or <(вне диапазона) - Значение порога: Числовое значение для сравнения
- Interval: Как часто проверяется оповещение (1m, 5m, 15m, 30m, 1h, 6h, 12h или 1d). Это также задаёт временное окно для каждой проверки.
- Webhook: Канал уведомлений, который используется при срабатывании оповещения. См. Добавление вебхука.

3
Сохраните панель мониторинга
Сохраните панель мониторинга, чтобы активировать оповещение. После этого оповещение начнёт выполняться с настроенным интервалом.
- Столбец значения: В качестве значения оповещения используется последний числовой столбец в выражении
SELECT. Если запрос возвращает несколько числовых столбцов (например,count, avg_latency, p99_latency), с порогом сравнивается только последний из них (p99_latency). - Столбец временной метки: Для графиков временных рядов (Line и Stacked Bar) система определяет столбец Date/DateTime в результатах как временной бакет (то есть ось x на графике временного ряда). Значение в столбце значения для каждого временного бакета оценивается относительно порога независимо, и если значение в любом временном бакете превышает настроенный порог, оповещение сработает.
- Столбцы группировки: Любые столбцы, которые не являются числовыми и не содержат временную метку (например,
ServiceName,Environment), рассматриваются как измерения группировки. Если группы присутствуют, каждая уникальная комбинация значений групп отслеживается отдельно, и для неё формируется отдельное оповещение. ClickStack отправит оповещение для каждой группы, значение которой превышает настроенный порог. Группы доступны только для графиков временных рядов.
{intervalSeconds:Int64}, {intervalMilliseconds:Int64}, $__timeInterval(col) или $__timeInterval_ms(col)). Во время выполнения оповещения он будет заменён на период, настроенный для этого оповещения.
Запросы, используемые для оповещений, должны включать фильтр временного диапазона ({startDateMilliseconds:Int64} и {endDateMilliseconds:Int64} или $__timeFilter(col) и т. д.). Независимо от того, есть ли в запросе фильтр временного диапазона, запрос оповещения будет выполняться для периода, настроенного для этого оповещения. Если фильтр временного диапазона отсутствует, то при каждом выполнении запрос будет считывать весь временной диапазон, доступный в исходной таблице.
Создайте оповещение, если у какого-либо сервиса доля ошибок превышает 5%, при этом за период оповещения должно быть не менее 10 запросов, чтобы избежать лишних оповещений для сервисов с низким трафиком.
>= 5 (срабатывает, когда уровень ошибок достигает 5%)
В этом запросе ServiceName — нечисловой столбец и не временная метка, поэтому каждый сервис отслеживается как отдельная группа оповещения. Оповещение срабатывает независимо для каждого сервиса.
Обнаружение аномалий с помощью отстающего среднего (временной ряд)
Настройте оповещение так, чтобы оно срабатывало, если число ошибок превышает скользящее среднее более чем на два стандартных отклонения. Это помогает выявлять всплески относительно недавнего базового уровня, а не по фиксированному порогу.> 0 (срабатывает, когда число ошибок превышает скользящий базовый уровень)
Обратите внимание: запрос выбирает 30 интервалов до начала диапазона дат, чтобы инициализировать расчёты в скользящем окне, а затем фильтрует итоговый вывод, оставляя только период оценки.
Ниже приведены несколько распространённых сценариев оповещений, для которых можно использовать HyperDX:
Ошибки: Мы рекомендуем настроить оповещения для сохранённых поисков по умолчанию
All Error Events и HTTP Status >= 400, чтобы получать уведомления, когда
число ошибок становится слишком большим.
Медленные операции: Вы также можете настроить поиск медленных операций (например,
duration:>5000), а затем создать оповещение, если
таких медленных операций становится слишком много.
Пользовательские события: Вы также можете настроить оповещения для команд,
работающих с клиентами, чтобы они получали уведомления, когда регистрируются новые пользователи
или выполняется критически важное действие пользователя.
Необычные изменения: Если очевидного порога нет — например, когда число ошибок
различается в зависимости от сервиса или трафик меняется в течение дня, — используйте
оповещение об аномалиях, сгруппированное по
ServiceName.