Links diretos

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.

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.

Parâmetro de ID do serviço Managed ClickStackAo 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

https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123

Busca — `/search`

A principal visualização de busca de logs/traces. Consulte Busca 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>.

Exemplo: Pesquise na fonte `Logs` por erros no serviço `checkout` em um intervalo de tempo

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

Exemplo: acesse diretamente a visualização em cascata de um trace

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

Buscas salvas — `/search/list`

Lista de buscas salvas.

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

Exemplo: Liste as buscas salvas com a tag `production`

<YOUR_CLICKSTACK_URL>/search/list?tag=production

Dashboards — `/dashboards/<dashboardId>`

Um dashboard salvo. Omita <dashboardId> (/dashboards) para abrir um dashboard temporário, não salvo. Consulte Dashboards 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.

Exemplo: Abrir um dashboard em um intervalo de tempo com um tile destacado

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

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

Lista de dashboards — `/dashboards/list`

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

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

Chart Explorer — `/chart`

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.

Exemplo: abrir a configuração de um gráfico de latência p99 para um intervalo de tempo

<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"}

Alertas — `/alerts`

Consulte Alertas 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.

Exemplo: Listar alertas com a tag `on-call`

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

Reprodução de sessão — `/sessions`

Navegação e reprodução de sessões. Consulte Reprodução de sessão 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`).

Exemplo: Navegue pelas reproduções de sessão em um intervalo de tempo

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

Exemplo: Abra uma reprodução de sessão específica no intervalo de tempo registrado

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

Mapa de serviços — `/service-map`

Consulte Mapa de serviços 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.

Exemplo: Visualize o mapa de serviços em um intervalo de tempo

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

Serviços — `/services`

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.

Exemplo: Visualize o dashboard do banco de dados de um serviço em um período

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

Exemplo: Visualize o dashboard de erros de um serviço

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

Kubernetes — `/kubernetes`

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.

Exemplo: abra o painel de detalhes de um pod do Kubernetes específico

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

Notebooks — `/notebook/<notebookId>`

Disponível apenas no Managed ClickStackOs Notebooks estão disponíveis apenas em implantações do Managed ClickStack. Consulte AI Notebooks para obter detalhes sobre o recurso.

Exemplo: Abra um notebook específico em um serviço do Cloud

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

Get started

Features

Managing ClickStack

Guides

Integration partners

Busca — `/search`

Exemplo: Pesquise na fonte `Logs` por erros no serviço `checkout` em um intervalo de tempo

Exemplo: acesse diretamente a visualização em cascata de um trace

Buscas salvas — `/search/list`

Exemplo: Liste as buscas salvas com a tag `production`

Dashboards — `/dashboards/<dashboardId>`

Exemplo: Abrir um dashboard em um intervalo de tempo com um tile destacado

Lista de dashboards — `/dashboards/list`

Chart Explorer — `/chart`

Exemplo: abrir a configuração de um gráfico de latência p99 para um intervalo de tempo

Alertas — `/alerts`

Exemplo: Listar alertas com a tag `on-call`

Reprodução de sessão — `/sessions`

Exemplo: Navegue pelas reproduções de sessão em um intervalo de tempo

Exemplo: Abra uma reprodução de sessão específica no intervalo de tempo registrado

Mapa de serviços — `/service-map`

Exemplo: Visualize o mapa de serviços em um intervalo de tempo

Serviços — `/services`

Exemplo: Visualize o dashboard do banco de dados de um serviço em um período

Exemplo: Visualize o dashboard de erros de um serviço

Kubernetes — `/kubernetes`

Exemplo: abra o painel de detalhes de um pod do Kubernetes específico

Notebooks — `/notebook/<notebookId>`

Exemplo: Abra um notebook específico em um serviço do Cloud

​Busca — /search

​Exemplo: Pesquise na fonte Logs por erros no serviço checkout em um intervalo de tempo

​Exemplo: acesse diretamente a visualização em cascata de um trace

​Buscas salvas — /search/list

​Exemplo: Liste as buscas salvas com a tag production

​Dashboards — /dashboards/<dashboardId>

​Exemplo: Abrir um dashboard em um intervalo de tempo com um tile destacado

​Lista de dashboards — /dashboards/list

​Exemplo: Listar dashboards com a tag infra

​Chart Explorer — /chart

​Exemplo: abrir a configuração de um gráfico de latência p99 para um intervalo de tempo

​Alertas — /alerts

​Exemplo: Listar alertas com a tag on-call

​Reprodução de sessão — /sessions

​Exemplo: Navegue pelas reproduções de sessão em um intervalo de tempo

​Exemplo: Abra uma reprodução de sessão específica no intervalo de tempo registrado

​Mapa de serviços — /service-map

​Exemplo: Visualize o mapa de serviços em um intervalo de tempo

​Serviços — /services

​Exemplo: Visualize o dashboard do banco de dados de um serviço em um período

​Exemplo: Visualize o dashboard de erros de um serviço

​Kubernetes — /kubernetes

​Exemplo: abra o painel de detalhes de um pod do Kubernetes específico

​Notebooks — /notebook/<notebookId>

​Exemplo: Abra um notebook específico em um serviço do Cloud

Busca — `/search`

Exemplo: Pesquise na fonte `Logs` por erros no serviço `checkout` em um intervalo de tempo

Exemplo: acesse diretamente a visualização em cascata de um trace

Buscas salvas — `/search/list`

Exemplo: Liste as buscas salvas com a tag `production`

Dashboards — `/dashboards/<dashboardId>`

Exemplo: Abrir um dashboard em um intervalo de tempo com um tile destacado

Lista de dashboards — `/dashboards/list`

Exemplo: Listar dashboards com a tag `infra`

Chart Explorer — `/chart`

Exemplo: abrir a configuração de um gráfico de latência p99 para um intervalo de tempo

Alertas — `/alerts`

Exemplo: Listar alertas com a tag `on-call`

Reprodução de sessão — `/sessions`

Exemplo: Navegue pelas reproduções de sessão em um intervalo de tempo

Exemplo: Abra uma reprodução de sessão específica no intervalo de tempo registrado

Mapa de serviços — `/service-map`

Exemplo: Visualize o mapa de serviços em um intervalo de tempo

Serviços — `/services`

Exemplo: Visualize o dashboard do banco de dados de um serviço em um período

Exemplo: Visualize o dashboard de erros de um serviço

Kubernetes — `/kubernetes`

Exemplo: abra o painel de detalhes de um pod do Kubernetes específico

Notebooks — `/notebook/<notebookId>`

Exemplo: Abra um notebook específico em um serviço do Cloud