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.

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

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.

​

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	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 ClickStack

Os 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