> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/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>

Основное представление для поиска журналов и трассировок. Подробнее о синтаксисе поиска см. в разделе [Поиск](/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`), чтобы открыть временную несохранённую панель мониторинга. Подробнее о создании панелей мониторинга см. в разделе [Панели мониторинга](/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>

Подробнее о создании оповещений и управлении ими см. в разделе [Оповещения](/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>

Просмотр и воспроизведение сеансов. Подробнее см. в разделе [Воспроизведение сеанса](/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>

Подробные сведения см. в разделе [Карта сервисов](/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. Подробнее см. в разделе [ИИ-блокноты](/ru/clickstack/notebooks).
</Info>

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

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