> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Прямые ссылки на страницы ClickStack с параметрами запроса URL

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

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

<Note>
  Для удобства чтения в примерах параметры запроса показаны без URL-кодирования. При программном создании ссылок выполняйте URL-кодирование значения каждого параметра запроса.
</Note>

<Info>
  **Параметр ID сервиса Управляемый ClickStack**

  При использовании Управляемого ClickStack в ClickHouse Cloud ссылки должны содержать параметр `?chcServiceId=`, чтобы указать, какой сервис ClickHouse Cloud следует открыть, если аутентифицированный пользователь, переходящий по ссылке, имеет доступ к нескольким сервисам ClickHouse Cloud.

  Пример: откройте поиск для определенного сервиса ClickHouse Cloud

  ```text theme={null}
  https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123
  ```
</Info>

<div id="search">
  ## Поиск — `/search`
</div>

Основное представление для поиска журналов и трассировок. Подробнее о синтаксисе поиска см. в разделе [Поиск](/docs/ru/clickstack/features/search).

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

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

<div id="example-search-errors">
  ### Пример: поиск ошибок сервиса `checkout` в источнике `Logs` за указанный временной диапазон
</div>

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

<div id="example-search-trace">
  ### Пример: переход сразу к представлению трассировки в виде водопада
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4
```

<div id="saved-searches">
  ## Сохранённые поиски — `/search/list`
</div>

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

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

<div id="example-saved-searches-tag">
  ### Пример: список сохранённых поисков с тегом `production`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/search/list?tag=production
```

<div id="dashboards">
  ## Панели мониторинга — `/dashboards/<dashboardId>`
</div>

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

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

<div id="example-dashboard-highlight">
  ### Пример: открыть панель мониторинга за указанный временной диапазон с выделенной плиткой
</div>

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

```text theme={null}
<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1
```

<div id="dashboards-list">
  ## Список панелей мониторинга — `/dashboards/list`
</div>

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

<div id="example-dashboards-list-tag">
  ### Пример: вывод панелей мониторинга с тегом `infra`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra
```

<div id="chart-explorer">
  ## Chart Explorer — `/chart`
</div>

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

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

<div id="example-chart-config">
  ### Пример: откройте конфигурацию диаграммы задержки p99 за выбранный временной диапазон
</div>

```text theme={null}
<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"}
```

<div id="alerts">
  ## Оповещения — `/alerts`
</div>

Подробнее о создании оповещений и управлении ими см. в разделе [Оповещения](/docs/ru/clickstack/features/alerts).

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

<div id="example-alerts-filter">
  ### Пример: список оповещений с тегом `on-call`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/alerts?tag=on-call
```

<div id="session-replay">
  ## Воспроизведение сеанса — `/sessions`
</div>

Просмотр и воспроизведение сеансов. Подробнее см. в разделе [Воспроизведение сеанса](/docs/ru/clickstack/features/session-replay).

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

<div id="example-sessions-time-range">
  ### Пример: Просмотр воспроизведений сеансов за выбранный временной диапазон
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000
```

<div id="example-sessions-open">
  ### Пример: Откройте конкретное воспроизведение сеанса за записанный временной диапазон
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000
```

<div id="service-map">
  ## Карта сервисов — `/service-map`
</div>

Подробные сведения см. в разделе [Карта сервисов](/docs/ru/clickstack/service-maps).

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

<div id="example-service-map">
  ### Пример: просмотр карты сервисов за временной диапазон
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000
```

<div id="services">
  ## Сервисы — `/services`
</div>

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

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

<div id="example-services-database">
  ### Пример: просмотр панели мониторинга базы данных сервиса за указанный временной диапазон
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000
```

<div id="example-services-errors">
  ### Пример: просмотр панели мониторинга ошибок сервиса
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments
```

<div id="kubernetes">
  ## Kubernetes — `/kubernetes`
</div>

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

<div id="example-kubernetes-pod">
  ### Пример: откройте панель сведений о конкретном поде
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p
```

<div id="notebooks">
  ## Блокноты — `/notebook/<notebookId>`
</div>

<Info>
  **Только в Управляемом ClickStack**

  Блокноты доступны только в развертываниях Управляемого ClickStack. Подробнее см. в разделе [ИИ-блокноты](/docs/ru/clickstack/notebooks).
</Info>

<div id="example-notebook-open">
  ### Пример: откройте конкретный блокнот в указанном сервисе ClickHouse Cloud
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123
```