Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Глубокие ссылки

View as MarkdownEdit this pageReport an issueSet up docs MCP

Страницы ClickStack можно открывать по глубоким ссылкам с параметрами запроса URL, чтобы сразу перейти к определенному поиску, панели мониторинга или панели из внешней системы (уведомления об оповещении, runbook, задачи CI, сообщения в чате и т. д.).

В примерах на этой странице используется <YOUR_CLICKSTACK_URL>. Замените его на URL вашего ClickStack — например, http://localhost:8080 для локального развертывания с открытым исходным кодом или https://hyperdx.clickhouse.cloud для Управляемого ClickStack в ClickHouse Cloud.

Основное представление для поиска журналов и трассировок. Подробнее о синтаксисе поиска см. в разделе Поиск.

Параметр Формат Описание
source string Источник, в котором выполняется поиск: принимает ID источника или его имя (например, Logs). На этой странице поддерживаются только источники Log и Trace.
where string Текст фильтрующего запроса в синтаксисе Lucene или SQL (см. whereLanguage).
whereLanguage lucene sql
select string Список SQL-столбцов и выражений для отображения в таблице результатов.
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] Структурированные фасетные фильтры, применяемые дополнительно к where.
orderBy string SQL-выражение сортировки для таблицы результатов.
mode results delta
isLive true false
traceId string Выполняет переход непосредственно к представлению trace waterfall для указанного ID трассировки.
from, to миллисекунды эпохи Абсолютный временной диапазон. Если не указано, по умолчанию используется последние 15 минут.

Сохранённый поиск также можно открыть напрямую по адресу /search/<savedSearchId>.

Пример: поиск ошибок сервиса checkout в источнике Logs за указанный временной диапазон

<YOUR_CLICKSTACK_URL>/search?source=Logs&from=1735689600000&to=1735693200000&where=level:error&filters=[{"type":"sql","condition":"ServiceName IN ('checkout')"}]

Пример: переход сразу к представлению трассировки в виде водопада

<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4

Сохранённые поиски — /search/list

Список сохранённых поисков.

Параметр Формат Описание
tag string Фильтрует список, оставляя сохранённые поиски с указанным тегом.

Пример: список сохранённых поисков с тегом production

<YOUR_CLICKSTACK_URL>/search/list?tag=production

Панели мониторинга — /dashboards/<dashboardId>

Сохранённая панель мониторинга. Не указывайте <dashboardId> (/dashboards), чтобы открыть временную несохранённую панель мониторинга. Подробнее о создании панелей мониторинга см. в разделе Панели мониторинга.

Параметр Формат Описание
from, to миллисекунды эпохи Временной диапазон, применяемый ко всем плиткам. Если не указан, по умолчанию используется диапазон за последние 15 минут.
where string Текст запроса фильтра на уровне панели мониторинга, применяемый ко всем плиткам.
whereLanguage lucene sql
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] Структурированные значения фильтра панели мониторинга, выбирающие два элемента в раскрывающемся списке фильтра ServiceName.
granularity auto 30 second
highlightedTileId string Прокручивает страницу до указанной плитки и выделяет её — полезно при переходе по ссылке из alert.

Пример: открыть панель мониторинга за указанный временной диапазон с выделенной плиткой

Полезно, если нужно перейти из уведомления об оповещении сразу к плитке, вызвавшей его.

<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1

Список панелей мониторинга — /dashboards/list

Параметр Формат Описание
tag string Фильтрация списка панелей мониторинга по тегу.

Пример: вывод панелей мониторинга с тегом infra

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

Chart Explorer — /chart

Конструктор диаграмм для разового использования с возможностью поделиться результатом.

Параметр Формат Описание
config JSON Полная конфигурация диаграммы (source, select, where, тип диаграммы и т. д.). Обычно создаётся с помощью ссылок «Share» в приложении, а не вручную.
from, to миллисекунды эпохи Временной диапазон. Если не указан, по умолчанию используется период за последние 15 минут.

Пример: откройте конфигурацию диаграммы задержки p99 за выбранный временной диапазон

<YOUR_CLICKSTACK_URL>/chart?granularity=auto&from=1785759381784&to=1785762981785&config={"name":"","select":[{"aggFn":"quantile","aggCondition":"","aggConditionLanguage":"lucene","valueExpression":"Duration","level":0.99,"alias":"p99"}],"where":"","whereLanguage":"lucene","displayType":"line","alignDateRangeToGranularity":true,"source":"68814eb5d40a9d0449afc1f2","connection":"68814b6fd40a9d0449afbe78","groupBy":"ServiceName"}

Оповещения — /alerts

Подробнее о создании оповещений и управлении ими см. в разделе Оповещения.

Параметр Формат Описание
search string Полнотекстовый фильтр по названию или описанию оповещения.
tag string Фильтр по тегу.
creator string Фильтр по имени создателя оповещения.

Пример: список оповещений с тегом on-call

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

Воспроизведение сеанса — /sessions

Просмотр и воспроизведение сеансов. Подробнее см. в разделе Воспроизведение сеанса.

Параметр Формат Описание
sessionSource string Идентификатор или имя источника сеансов.
where string Текст фильтрующего запроса для списка сеансов.
whereLanguage lucene sql
from, to миллисекунды эпохи Временной диапазон для списка сеансов. Если не указано, по умолчанию используются последние 15 минут.
sid string Открывает определённый сеанс по идентификатору.
sfrom, sto миллисекунды эпохи Временное окно открытого сеанса (используется с sid).

Пример: Просмотр воспроизведений сеансов за выбранный временной диапазон

<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000

Пример: Откройте конкретное воспроизведение сеанса за записанный временной диапазон

<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000

Карта сервисов — /service-map

Подробные сведения см. в разделе Карта сервисов.

Параметр Формат Описание
source string Идентификатор или имя источника трассировок.
samplingFactor целое число Делитель сэмплирования трассировок (1 = 100% трассировок, 2 = 50%, 4 = 25% и т. д.).
from, to миллисекунды эпохи Временной диапазон. Если не указан, по умолчанию используется диапазон за последние 15 минут.

Пример: просмотр карты сервисов за временной диапазон

<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000

Сервисы — /services

Панели мониторинга HTTP, базы данных и ошибок для отдельных сервисов.

Параметр Формат Описание
tab http database
source string Идентификатор источника трассировок.
service string Имя выбранного сервиса.
where string Текст запроса для фильтрации.
whereLanguage lucene sql
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] Значения панели фильтров панели мониторинга.
from, to миллисекунды эпохи Временной диапазон. Если не указаны, по умолчанию используются последние 15 минут.

Пример: просмотр панели мониторинга базы данных сервиса за указанный временной диапазон

<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000

Пример: просмотр панели мониторинга ошибок сервиса

<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments

Kubernetes — /kubernetes

Параметр Формат Описание
logSource, metricSource string Идентификаторы источников журналов и метрик. Если указан только один из них, другой по умолчанию соответствует коррелированному источнику.
tab например, pods, nodes, namespaces Активный подраздел.
q string Lucene-запрос для списка ресурсов.
podName, nodeName, namespaceName string Открывает панель сведений о конкретном поде, узле или пространстве имен.
from, to миллисекунды эпохи Временной диапазон. Если не указано, по умолчанию используются последние 15 минут.

Пример: откройте панель сведений о конкретном поде

<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p

Блокноты — /notebook/<notebookId>

Пример: откройте конкретный блокнот в указанном сервисе ClickHouse Cloud

<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123
Navigation