Виджет выводит одно число на основе SQL-запроса только для чтения к ClickHouse. Для числа можно задать единицу измерения и пороговое значение. Запрос должен возвращать одну строку: виджет отображает значение первого столбца.
Пример корректного запроса для виджета:
SELECT count() AS value
FROM events
WHERE timestamp >= {{from}} AND timestamp < {{to}}Конфигурация
| Название | Обязательность | Описание | Значение по умолчанию |
|---|---|---|---|
| Запрос | Да | SQL-запрос только для чтения. Используйте {{from}} и {{to}} для подстановки интервала | — |
| База данных | Нет | Название базы ClickHouse, передаётся в заголовке X-ClickHouse-Database | — |
| Интервал по умолчанию | Нет | Интервал, используемый при открытии виджета и при обновлении, если в параметрах запроса интервал не задан | Последний час |
| Количество цифр после запятой | Нет | Точность отображения полученного значения | — |
| Единица измерения | Нет | Постфикс, с которым отображается полученное значение | — |
| Отображать пороговое значение | Нет | Отображает <METRIC_VALUE> / <THRESHOLD>, где <METRIC_VALUE> — текущее значение метрики, а <THRESHOLD> — настроенный порог | false |
| Пороговое значение | Нет | Пороговое значение | — |
| Меньшее значение считается лучше | Нет | Метрика считается «хорошей», когда её значение ниже заданного порогового значения | false |
| Порог предупреждения (%) | Нет | Граница между красным и оранжевым цветами. Если значение метрики превышает этот процент от порога, оно получит оранжевый цвет | 60 |
| Порог успеха (%) | Нет | Граница между оранжевым и зелёным цветами. Если значение метрики превышает этот процент от порога, оно получит зелёный цвет | 90 |
Авторизация
Конфигурация авторизации описана в разделе «Внешние сервисы».