> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Links diretos

> Acesse diretamente páginas do ClickStack usando parâmetros de consulta de URL

As páginas do ClickStack podem ser abertas por meio de links diretos com parâmetros de consulta de URL, permitindo acessar diretamente uma busca, um dashboard ou um painel específico a partir de um sistema externo, como uma notificação de alerta, um runbook, um job de CI ou uma mensagem de chat.

Os exemplos nesta página usam `<YOUR_CLICKSTACK_URL>`. Substitua-o pela URL do seu ClickStack — por exemplo, `http://localhost:8080` para uma implantação local de código aberto ou `https://hyperdx.clickhouse.cloud` para o Managed ClickStack no ClickHouse Cloud.

<Note>
  Para facilitar a leitura, os exemplos mostram parâmetros de consulta sem codificação de URL. Ao criar links programaticamente, codifique cada valor de parâmetro de consulta para uso em URL.
</Note>

<Info>
  **Parâmetro de ID do serviço Managed ClickStack**

  Ao usar o Managed ClickStack no ClickHouse Cloud, os links devem incluir o parâmetro `?chcServiceId=` para identificar qual serviço do ClickHouse Cloud deve ser carregado caso o usuário autenticado que acessar o link esteja autorizado a usar mais de um serviço do ClickHouse Cloud.

  Exemplo: abrir a Busca em um serviço Cloud específico

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

<div id="search">
  ## Busca — `/search`
</div>

A principal visualização de busca de logs/traces. Consulte [Busca](/pt-BR/clickstack/features/search) para obter detalhes sobre a sintaxe de busca.

| Parâmetro       | Formato                                                                    | Descrição                                                                                                                                       |                                                                            |                                                                               |
| --------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `source`        | string                                                                     | A fonte em que pesquisar — aceita um ID ou um **nome** de fonte (por exemplo, `Logs`). Nesta página, há suporte apenas a fontes de Log e Trace. |                                                                            |                                                                               |
| `where`         | string                                                                     | Texto da consulta de filtro, na sintaxe Lucene ou SQL (consulte `whereLanguage`).                                                               |                                                                            |                                                                               |
| `whereLanguage` | `lucene`                                                                   | `sql`                                                                                                                                           | A linguagem de consulta em que `where` foi escrito.                        |                                                                               |
| `select`        | string                                                                     | Lista de colunas/expressões SQL a exibir na tabela de resultados.                                                                               |                                                                            |                                                                               |
| `filters`       | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | Filtros de facetas estruturados, aplicados além de `where`.                                                                                     |                                                                            |                                                                               |
| `orderBy`       | string                                                                     | Expressão de ordenação SQL para a tabela de resultados.                                                                                         |                                                                            |                                                                               |
| `mode`          | `results`                                                                  | `delta`                                                                                                                                         | `pattern`                                                                  | O modo de análise ativo. `delta` está disponível apenas para fontes de trace. |
| `isLive`        | `true`                                                                     | `false`                                                                                                                                         | Indica se o acompanhamento em tempo real está ativado (o padrão é `true`). |                                                                               |
| `traceId`       | string                                                                     | Abre diretamente uma visualização em cascata do trace com o ID de trace informado.                                                              |                                                                            |                                                                               |
| `from`, `to`    | milissegundos desde a epoch                                                | Intervalo de tempo absoluto. Se omitido, o padrão é os últimos 15 minutos.                                                                      |                                                                            |                                                                               |

Uma busca salva também pode ser aberta diretamente em `/search/<savedSearchId>`.

<div id="example-search-errors">
  ### Exemplo: Pesquise na fonte `Logs` por erros no serviço `checkout` em um intervalo de tempo
</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">
  ### Exemplo: acesse diretamente a visualização em cascata de um trace
</div>

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

<div id="saved-searches">
  ## Buscas salvas — `/search/list`
</div>

Lista de buscas salvas.

| Parâmetro | Formato | Descrição                                       |
| --------- | ------- | ----------------------------------------------- |
| `tag`     | string  | Filtra a lista para buscas salvas com esta tag. |

<div id="example-saved-searches-tag">
  ### Exemplo: Liste as buscas salvas com a tag `production`
</div>

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

<div id="dashboards">
  ## Dashboards — `/dashboards/<dashboardId>`
</div>

Um dashboard salvo. Omita `<dashboardId>` (`/dashboards`) para abrir um dashboard temporário, não salvo. Consulte [Dashboards](/pt-BR/clickstack/features/dashboards/overview) para saber como criar dashboards.

| Parâmetro           | Formato                                                                    | Descrição                                                                                                            |                                                 |            |             |             |             |          |           |         |         |                                                                                                                                   |
| ------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ---------- | ----------- | ----------- | ----------- | -------- | --------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `from`, `to`        | milissegundos desde a epoch                                                | Intervalo de tempo aplicado a todos os tiles. Se omitido, o padrão é os últimos 15 minutos.                          |                                                 |            |             |             |             |          |           |         |         |                                                                                                                                   |
| `where`             | string                                                                     | Texto da consulta de filtro no nível do dashboard, aplicado a todos os tiles.                                        |                                                 |            |             |             |             |          |           |         |         |                                                                                                                                   |
| `whereLanguage`     | `lucene`                                                                   | `sql`                                                                                                                | Linguagem de consulta em que `where` é escrito. |            |             |             |             |          |           |         |         |                                                                                                                                   |
| `filters`           | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | Valores estruturados de filtro do dashboard que selecionam dois itens em uma lista suspensa do filtro `ServiceName`. |                                                 |            |             |             |             |          |           |         |         |                                                                                                                                   |
| `granularity`       | `auto`                                                                     | `30 second`                                                                                                          | `1 minute`                                      | `5 minute` | `10 minute` | `15 minute` | `30 minute` | `1 hour` | `12 hour` | `1 day` | `7 day` | Tamanho do bucket para tiles de séries temporais. `auto` seleciona um tamanho de bucket com base no intervalo de tempo escolhido. |
| `highlightedTileId` | string                                                                     | Rola até um tile específico e o destaca — útil ao vincular a partir de um alert.                                     |                                                 |            |             |             |             |          |           |         |         |                                                                                                                                   |

<div id="example-dashboard-highlight">
  ### Exemplo: Abrir um dashboard em um intervalo de tempo com um tile destacado
</div>

Útil para vincular uma notificação de alerta diretamente ao tile que a disparou.

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

<div id="dashboards-list">
  ## Lista de dashboards — `/dashboards/list`
</div>

| Parâmetro | Formato | Descrição                             |
| --------- | ------- | ------------------------------------- |
| `tag`     | string  | Filtra a lista de dashboards por tag. |

<div id="example-dashboards-list-tag">
  ### Exemplo: Listar dashboards com a tag `infra`
</div>

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

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

Um criador de gráficos ad hoc compartilháveis.

| Parâmetro    | Formato                     | Descrição                                                                                                                                                                   |
| ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config`     | JSON                        | A configuração completa do gráfico (source, select, where, tipo de gráfico etc.). Normalmente gerada por links de "Share" no aplicativo, em vez de ser escrita manualmente. |
| `from`, `to` | milissegundos desde a epoch | Intervalo de tempo. Se omitido, o padrão são os últimos 15 minutos.                                                                                                         |

<div id="example-chart-config">
  ### Exemplo: abrir a configuração de um gráfico de latência p99 para um intervalo de tempo
</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">
  ## Alertas — `/alerts`
</div>

Consulte [Alertas](/pt-BR/clickstack/features/alerts) para saber como criar e gerenciar alertas.

| Parâmetro | Formato | Descrição                                               |
| --------- | ------- | ------------------------------------------------------- |
| `search`  | string  | Filtro de texto livre pelo nome ou descrição do alerta. |
| `tag`     | string  | Filtra por tag.                                         |
| `creator` | string  | Filtra pelo nome do criador do alerta.                  |

<div id="example-alerts-filter">
  ### Exemplo: Listar alertas com a tag `on-call`
</div>

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

<div id="session-replay">
  ## Reprodução de sessão — `/sessions`
</div>

Navegação e reprodução de sessões. Consulte [Reprodução de sessão](/pt-BR/clickstack/features/session-replay) para obter detalhes do recurso.

| Parâmetro       | Formato                     | Descrição                                                                               |                                                    |
| --------------- | --------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------- |
| `sessionSource` | string                      | ID ou nome da fonte de sessão.                                                          |                                                    |
| `where`         | string                      | Texto da consulta de filtro aplicado à lista de sessões.                                |                                                    |
| `whereLanguage` | `lucene`                    | `sql`                                                                                   | Linguagem de consulta em que `where` está escrito. |
| `from`, `to`    | milissegundos desde a epoch | Intervalo de tempo da lista de sessões. Se omitido, o padrão são os últimos 15 minutos. |                                                    |
| `sid`           | string                      | Abre uma sessão específica pelo ID.                                                     |                                                    |
| `sfrom`, `sto`  | milissegundos desde a epoch | Janela de tempo da sessão aberta (usada com `sid`).                                     |                                                    |

<div id="example-sessions-time-range">
  ### Exemplo: Navegue pelas reproduções de sessão em um intervalo de tempo
</div>

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

<div id="example-sessions-open">
  ### Exemplo: Abra uma reprodução de sessão específica no intervalo de tempo registrado
</div>

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

<div id="service-map">
  ## Mapa de serviços — `/service-map`
</div>

Consulte [Mapa de serviços](/pt-BR/clickstack/service-maps) para obter detalhes do recurso.

| Parâmetro        | Formato                     | Descrição                                                                         |
| ---------------- | --------------------------- | --------------------------------------------------------------------------------- |
| `source`         | string                      | ID ou nome da fonte de traces.                                                    |
| `samplingFactor` | inteiro                     | Divisor de sampling de traces (`1` = 100% dos traces, `2` = 50%, `4` = 25% etc.). |
| `from`, `to`     | milissegundos desde a epoch | Intervalo de tempo. Se omitido, o padrão é os últimos 15 minutos.                 |

<div id="example-service-map">
  ### Exemplo: Visualize o mapa de serviços em um intervalo de tempo
</div>

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

<div id="services">
  ## Serviços — `/services`
</div>

Dashboards por serviço de HTTP, banco de dados e erros.

| Parâmetro       | Formato                                                                    | Descrição                                                         |                                                                                 |                                                        |
| --------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `tab`           | `http`                                                                     | `database`                                                        | `errors`                                                                        | Subaba exibida no dashboard do serviço. Padrão: `http` |
| `source`        | string                                                                     | ID da fonte de traces.                                            |                                                                                 |                                                        |
| `service`       | string                                                                     | Nome do serviço selecionado.                                      |                                                                                 |                                                        |
| `where`         | string                                                                     | Texto da consulta de filtro.                                      |                                                                                 |                                                        |
| `whereLanguage` | `lucene`                                                                   | `sql`                                                             | Linguagem de consulta em que `where` é escrito (o padrão nesta página é `sql`). |                                                        |
| `filters`       | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | Valores da barra de filtros do dashboard.                         |                                                                                 |                                                        |
| `from`, `to`    | milissegundos desde a epoch                                                | Intervalo de tempo. Se omitido, o padrão é os últimos 15 minutos. |                                                                                 |                                                        |

<div id="example-services-database">
  ### Exemplo: Visualize o dashboard do banco de dados de um serviço em um período
</div>

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

<div id="example-services-errors">
  ### Exemplo: Visualize o dashboard de erros de um serviço
</div>

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

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

| Parâmetro                              | Formato                            | Descrição                                                                                                          |
| -------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `logSource`, `metricSource`            | string                             | IDs das fontes de logs e métricas. Quando apenas uma é fornecida, a outra usa por padrão uma fonte correlacionada. |
| `tab`                                  | ex.: `pods`, `nodes`, `namespaces` | Subvisualização ativa.                                                                                             |
| `q`                                    | string                             | Consulta Lucene para a lista de recursos.                                                                          |
| `podName`, `nodeName`, `namespaceName` | string                             | Abre o painel de detalhes de um pod do Kubernetes, nó ou espaço de nomes específico.                               |
| `from`, `to`                           | milissegundos desde o epoch        | Intervalo de tempo. Se omitido, o padrão são os últimos 15 minutos.                                                |

<div id="example-kubernetes-pod">
  ### Exemplo: abra o painel de detalhes de um pod do Kubernetes específico
</div>

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

<div id="notebooks">
  ## Notebooks — `/notebook/<notebookId>`
</div>

<Info>
  **Disponível apenas no Managed ClickStack**

  Os Notebooks estão disponíveis apenas em implantações do Managed ClickStack. Consulte [AI Notebooks](/pt-BR/clickstack/notebooks) para obter detalhes sobre o recurso.
</Info>

<div id="example-notebook-open">
  ### Exemplo: Abra um notebook específico em um serviço do Cloud
</div>

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