`, если выбрано значение переменной, и в `1=1` в противном случае. |
Значения переменной также можно подставлять напрямую как `$name` или `${name}`, указав необязательный формат: `${name:sqlstring}` (по умолчанию), `${name:csv}` или `${name:regex}`. В формате по умолчанию прямая ссылка до выбора значения отображается как `NULL`, поэтому везде, где ожидается предикат, используйте указанные выше макросы.
## Как результаты запроса отображаются на диаграмме
ClickStack автоматически сопоставляет столбцы результатов с элементами диаграммы в зависимости от типов столбцов. Правила сопоставления зависят от типа диаграммы.
### Линейные диаграммы и столбчатые диаграммы с накоплением
| Роль | Тип столбца | Описание |
| ------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------- |
| **Временная метка** | Первый столбец `Date` или `DateTime` | Используется как ось X. |
| **Значение серии** | Все числовые столбцы | Каждый числовой столбец отображается как отдельная серия. Обычно это агрегированные значения. |
| **Названия групп** | Столбцы String, Map или Array | Необязательно. Строки с разными значениями групп отображаются как отдельные серии. |
### Круговая диаграмма
| Роль | Тип столбца | Описание |
| -------------------- | ---------------------------------- | -------------------------------------------------------------------- |
| **Значение сектора** | Первый числовой столбец | Определяет размер каждого сектора. |
| **Метка сектора** | Столбцы типа String, Map или Array | Необязательно. Каждое уникальное значение становится меткой сектора. |
### Числовая диаграмма
| Роль | Тип столбца | Описание |
| --------- | ----------------------- | ----------------------------------------------------------------- |
| **Число** | Первый числовой столбец | Отображается значение из первой строки первого числового столбца. |
### Табличная диаграмма
Все столбцы результатов отображаются непосредственно в виде столбцов таблицы.
## Примеры
**Требуется доступ к системной таблице**
Если вы запускаете следующие примеры на [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com), необходимо указать `otel_v2.otel_logs` или `otel_v2.otel_traces`.
### Линейная диаграмма — количество логов по сервисам во времени
Этот запрос подсчитывает количество событий логов для каждого сервиса, группируя их по временным интервалам в соответствии с детализацией панели мониторинга.
```sql theme={null}
SELECT
toStartOfInterval(TimestampTime, INTERVAL {intervalSeconds:Int64} second) AS ts,
ServiceName,
count() AS count
FROM otel_logs
WHERE TimestampTime >= fromUnixTimestamp64Milli({startDateMilliseconds:Int64})
AND TimestampTime < fromUnixTimestamp64Milli({endDateMilliseconds:Int64})
AND $__filters
GROUP BY ServiceName, ts
ORDER BY ts ASC
```
* `ts` (DateTime) используется как временная метка на оси X.
* `count` (числовое значение) отображается как значение серии.
* `ServiceName` (строка) создает отдельную линию для каждого сервиса.
### Линейная диаграмма — с использованием макросов
Тот же запрос с использованием макросов для краткости:
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
ServiceName,
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND $__filters
GROUP BY ServiceName, ts
ORDER BY ts ASC
```
### Линейный график — использование переменных панели мониторинга
Для панели мониторинга с переменной `service`, связанной с `ServiceName`, и переменной `severity`, связанной с `SeverityText`, этот запрос ограничивает диаграмму текущим выбранным сервисом и исключает выбранные уровни серьёзности. Если для переменной не выбрано значение, оба макроса разворачиваются в `1=1`, поэтому до выбора значения пользователем диаграмма отображается без фильтрации.
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND $__filter(ServiceName, $service)
AND $__conditionalAll(SeverityText NOT IN ($severity), $severity)
GROUP BY ts
ORDER BY ts ASC
```
### Столбчатая диаграмма с накоплением — количество ошибок по уровням серьёзности
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
lower(SeverityText),
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND lower(SeverityText) IN ('error', 'warn')
AND $__filters
GROUP BY SeverityText, ts
ORDER BY ts ASC
```
### Табличная диаграмма — 10 конечных точек с наибольшей задержкой
```sql theme={null}
SELECT
SpanName AS endpoint,
avg(Duration) / 1000 AS avg_duration_ms,
count() AS request_count
FROM otel_traces
WHERE $__timeFilter(Timestamp)
AND $__filters
GROUP BY SpanName
ORDER BY avg_duration_ms DESC
LIMIT 10
```
### Круговая диаграмма — распределение запросов по сервисам
```sql theme={null}
SELECT
ServiceName,
count() AS request_count
FROM otel_traces
WHERE $__timeFilter(Timestamp)
AND $__filters
GROUP BY ServiceName
```
* `request_count` (числовое значение) определяет размер каждого сегмента.
* `ServiceName` (строка) задает метку каждого сегмента.
### Числовая диаграмма — общее число ошибок
```sql theme={null}
SELECT
count() AS total_errors
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND SeverityText = 'error'
AND $__filters
```
Отображается числовое значение `total_errors` из первой строки.
## Примечания
* Визуализации на основе SQL выполняются во включенном режиме `readonly` — разрешены только запросы `SELECT`.
* Визуализации на основе SQL должны содержать ровно один SQL-запрос — несколько запросов не поддерживаются.
* Редактор SQL предлагает автодополнение как для параметров запроса, так и для макросов.
* Чтобы фильтры панели мониторинга применялись к визуализациям на основе SQL, необходимо выбрать Source. Для корректной фильтрации Source должен соответствовать таблице, к которой обращается запрос.
* Для переменных панели мониторинга Source не требуется — значения берутся из выпадающих списков фильтров панели мониторинга, а не из собственного Source блока.
* Оповещения для SQL-блока, ссылающегося на переменную панели мониторинга, вычисляются для каждой переменной в пустом состоянии, а не со значениями, выбранными на панели мониторинга.