Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Links diretos

View as MarkdownEdit this pageReport an issueSet up docs MCP

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.

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
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
isLive true false
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
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
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.

Exemplo: Listar dashboards com a tag infra

<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
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
source string ID da fonte de traces.
service string Nome do serviço selecionado.
where string Texto da consulta de filtro.
whereLanguage lucene 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>

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

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