Enlaces profundos

Puedes abrir páginas de ClickStack mediante enlaces profundos con parámetros de consulta de URL para ir directamente a una búsqueda, un dashboard o un panel específicos desde un sistema externo (una notificación de alerta, un runbook, un job de CI, un mensaje de chat, entre otros). Los ejemplos de esta página usan <YOUR_CLICKSTACK_URL>. Sustitúyelo por la URL de tu ClickStack; por ejemplo, http://localhost:8080 para una implementación local de código abierto o https://hyperdx.clickhouse.cloud para Managed ClickStack en ClickHouse Cloud.

Los ejemplos muestran parámetros de consulta sin codificación de URL para facilitar la lectura. Al construir enlaces mediante programación, codifica en URL el valor de cada parámetro de consulta.

Parámetro de ID de servicio de Managed ClickStackAl usar Managed ClickStack en ClickHouse Cloud, los enlaces deben incluir un parámetro ?chcServiceId= para identificar qué servicio de ClickHouse Cloud debe cargarse si el usuario autenticado que sigue el enlace está autorizado a usar más de un servicio de ClickHouse Cloud.Ejemplo: abrir Búsqueda en un servicio de Cloud específico

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

Búsqueda — `/search`

La vista principal para buscar logs y trazas. Consulta Búsqueda para obtener más información sobre la sintaxis de búsqueda.

Parámetro	Formato	Descripción
`source`	string	La fuente en la que se realizará la búsqueda; acepta un ID de fuente o el nombre de una fuente (p. ej., `Logs`). Esta página solo admite fuentes de Log y Trace.
`where`	string	Texto de la consulta de filtro, con sintaxis Lucene o SQL (consulta `whereLanguage`).
`whereLanguage`	`lucene`	`sql`	El lenguaje de consulta en el que se escribe `where`.
`select`	string	Lista de columnas o expresiones SQL que se mostrará en la tabla de resultados.
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Filtros de facetas estructurados que se aplican además de `where`.
`orderBy`	string	Expresión de ordenación SQL para la tabla de resultados.
`mode`	`results`	`delta`	`pattern`	El modo de análisis activo. `delta` solo está disponible para fuentes de trazas.
`isLive`	`true`	`false`	Indica si el seguimiento en tiempo real está habilitado (el valor predeterminado es `true`).
`traceId`	string	Abre directamente una vista waterfall de la traza correspondiente al ID de traza indicado.
`from`, `to`	milisegundos desde epoch	Intervalo de tiempo absoluto. Si se omite, el valor predeterminado es los últimos 15 minutos.

También se puede abrir una búsqueda guardada directamente en /search/<savedSearchId>.

Ejemplo: Busque errores en la fuente `Logs` del servicio `checkout` dentro de un intervalo de tiempo

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

Ejemplo: Ir directamente a la vista waterfall de la traza

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

Búsquedas guardadas — `/search/list`

La lista de búsquedas guardadas.

Parámetro	Formato	Descripción
`tag`	string	Filtra la lista para mostrar las búsquedas guardadas con esta etiqueta.

Ejemplo: Mostrar las búsquedas guardadas con la etiqueta `production`

<YOUR_CLICKSTACK_URL>/search/list?tag=production

Dashboards — `/dashboards/<dashboardId>`

Un dashboard guardado. Omita <dashboardId> (/dashboards) para abrir un dashboard temporal sin guardar. Consulte Dashboards para obtener más información sobre cómo crear dashboards.

Parámetro	Formato	Descripción
`from`, `to`	milisegundos desde la época	Intervalo de tiempo aplicado a todos los mosaicos. Si se omite, se usan de forma predeterminada los últimos 15 minutos.
`where`	cadena	Texto de consulta del filtro a nivel de dashboard, aplicado a todos los mosaicos.
`whereLanguage`	`lucene`	`sql`	Lenguaje de consulta en el que está escrito `where`.
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Valores de filtro estructurados del dashboard que seleccionan dos elementos en el menú desplegable del filtro `ServiceName`.
`granularity`	`auto`	`30 second`	`1 minute`	`5 minute`	`10 minute`	`15 minute`	`30 minute`	`1 hour`	`12 hour`	`1 day`	`7 day`	Tamaño del bucket para los mosaicos de series temporales. `auto` selecciona un tamaño de bucket según el intervalo de tiempo seleccionado.
`highlightedTileId`	cadena	Desplaza la vista hasta un mosaico específico y lo resalta; resulta útil al enlazar desde una alerta.

Ejemplo: Abrir un dashboard para un intervalo de tiempo con un mosaico resaltado

Resulta útil para vincular desde una notificación de alerta directamente al mosaico que la activó.

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

Lista de dashboards — `/dashboards/list`

Parámetro	Formato	Descripción
`tag`	string	Filtra la lista de dashboards por etiqueta.

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

Chart Explorer — `/chart`

Un generador de gráficos ad hoc que se puede compartir.

Parámetro	Formato	Descripción
`config`	JSON	La configuración completa del gráfico (source, select, where, tipo de gráfico, etc.). Normalmente se genera mediante enlaces «Share» desde la aplicación, en lugar de escribirse manualmente.
`from`, `to`	milisegundos desde epoch	Intervalo de tiempo. Si se omite, se usan de forma predeterminada los últimos 15 minutos.

Ejemplo: Abrir la configuración de un gráfico de latencia p99 para un intervalo de tiempo

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

Consulta Alertas para obtener más información sobre cómo crear y gestionar alertas.

Parámetro	Formato	Descripción
`search`	string	Filtro de texto libre por nombre o descripción de la alerta.
`tag`	string	Filtra por etiqueta.
`creator`	string	Filtra por el nombre del creador de la alerta.

Ejemplo: Enumerar alertas con la etiqueta `on-call`

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

Reproducción de sesiones — `/sessions`

Exploración y reproducción de sesiones. Consulte Reproducción de sesiones para obtener información detallada sobre esta funcionalidad.

Parámetro	Formato	Descripción
`sessionSource`	string	ID o nombre de la fuente de sesiones.
`where`	string	Texto de la consulta de filtro para la lista de sesiones.
`whereLanguage`	`lucene`	`sql`	Lenguaje de consulta en el que se escribe `where`.
`from`, `to`	milisegundos desde el epoch	Intervalo de tiempo de la lista de sesiones. Si se omite, se toman de forma predeterminada los últimos 15 minutos.
`sid`	string	Abre una sesión específica mediante su ID.
`sfrom`, `sto`	milisegundos desde el epoch	Ventana de tiempo de la sesión abierta (se usa con `sid`).

Ejemplo: Explore las reproducciones de sesión dentro de un intervalo de tiempo

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

Ejemplo: Abre una reproducción de sesión específica en el intervalo de tiempo en que se grabó

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

Mapa de servicios — `/service-map`

Consulta Mapa de servicios para obtener más información sobre esta funcionalidad.

Parámetro	Formato	Descripción
`source`	cadena	ID o nombre de la fuente de trazas.
`samplingFactor`	entero	Divisor de muestreo de trazas (`1` = 100 % de las trazas, `2` = 50 %, `4` = 25 %, etc.).
`from`, `to`	milisegundos desde epoch	Intervalo de tiempo. Si se omiten, se usan de forma predeterminada los últimos 15 minutos.

Ejemplo: Visualice el mapa de servicios para un intervalo de tiempo

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

Servicios — `/services`

Dashboards de HTTP, bases de datos y errores por servicio.

Parámetro	Formato	Descripción
`tab`	`http`	`database`	`errors`	Subpestaña del dashboard de servicio que se muestra. Valor predeterminado: `http`
`source`	string	ID de la fuente de trazas.
`service`	string	Nombre del servicio seleccionado.
`where`	string	Texto de la consulta de filtro.
`whereLanguage`	`lucene`	`sql`	Lenguaje de consulta en el que está escrito `where` (en esta página, el valor predeterminado es `sql`).
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Valores de la barra de filtros del dashboard.
`from`, `to`	milisegundos desde la época	Intervalo de tiempo. Si se omite, el valor predeterminado corresponde a los últimos 15 minutos.

Ejemplo: Consulte el dashboard de la base de datos de un servicio para un intervalo de tiempo

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

Ejemplo: Ver el dashboard de errores de un servicio

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

Kubernetes — `/kubernetes`

Parámetro	Formato	Descripción
`logSource`, `metricSource`	cadena	ID de las fuentes de logs y métricas. Si solo se proporciona una, la otra toma de forma predeterminada una fuente correlacionada.
`tab`	p. ej., `pods`, `nodes`, `namespaces`	Subvista activa.
`q`	cadena	Consulta de Lucene para la lista de recursos.
`podName`, `nodeName`, `namespaceName`	cadena	Abre el panel de detalles de un pod, nodo o espacio de nombres específico.
`from`, `to`	milisegundos desde la época	Intervalo de tiempo. Si se omite, se establece de forma predeterminada en los últimos 15 minutos.

Ejemplo: Abra el panel de detalles de un pod de Kubernetes concreto

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

Notebooks — `/notebook/<notebookId>`

Solo disponible en Managed ClickStackNotebooks solo están disponibles en implementaciones de Managed ClickStack. Consulta AI Notebooks para obtener más información sobre esta funcionalidad.

Ejemplo: Abrir un notebook específico en un servicio de Cloud concreto

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

Get started

Features

Managing ClickStack

Guides

Integration partners

Búsqueda — `/search`

Ejemplo: Busque errores en la fuente `Logs` del servicio `checkout` dentro de un intervalo de tiempo

Ejemplo: Ir directamente a la vista waterfall de la traza

Búsquedas guardadas — `/search/list`

Ejemplo: Mostrar las búsquedas guardadas con la etiqueta `production`

Dashboards — `/dashboards/<dashboardId>`

Ejemplo: Abrir un dashboard para un intervalo de tiempo con un mosaico resaltado

Lista de dashboards — `/dashboards/list`

Chart Explorer — `/chart`

Ejemplo: Abrir la configuración de un gráfico de latencia p99 para un intervalo de tiempo

Alertas — `/alerts`

Ejemplo: Enumerar alertas con la etiqueta `on-call`

Reproducción de sesiones — `/sessions`

Ejemplo: Explore las reproducciones de sesión dentro de un intervalo de tiempo

Ejemplo: Abre una reproducción de sesión específica en el intervalo de tiempo en que se grabó

Mapa de servicios — `/service-map`

Ejemplo: Visualice el mapa de servicios para un intervalo de tiempo

Servicios — `/services`

Ejemplo: Consulte el dashboard de la base de datos de un servicio para un intervalo de tiempo

Ejemplo: Ver el dashboard de errores de un servicio

Kubernetes — `/kubernetes`

Ejemplo: Abra el panel de detalles de un pod de Kubernetes concreto

Notebooks — `/notebook/<notebookId>`

Ejemplo: Abrir un notebook específico en un servicio de Cloud concreto

​Búsqueda — /search

​Ejemplo: Busque errores en la fuente Logs del servicio checkout dentro de un intervalo de tiempo

​Ejemplo: Ir directamente a la vista waterfall de la traza

​Búsquedas guardadas — /search/list

​Ejemplo: Mostrar las búsquedas guardadas con la etiqueta production

​Dashboards — /dashboards/<dashboardId>

​Ejemplo: Abrir un dashboard para un intervalo de tiempo con un mosaico resaltado

​Lista de dashboards — /dashboards/list

​Ejemplo: Listar dashboards con la etiqueta infra

​Chart Explorer — /chart

​Ejemplo: Abrir la configuración de un gráfico de latencia p99 para un intervalo de tiempo

​Alertas — /alerts

​Ejemplo: Enumerar alertas con la etiqueta on-call

​Reproducción de sesiones — /sessions

​Ejemplo: Explore las reproducciones de sesión dentro de un intervalo de tiempo

​Ejemplo: Abre una reproducción de sesión específica en el intervalo de tiempo en que se grabó

​Mapa de servicios — /service-map

​Ejemplo: Visualice el mapa de servicios para un intervalo de tiempo

​Servicios — /services

​Ejemplo: Consulte el dashboard de la base de datos de un servicio para un intervalo de tiempo

​Ejemplo: Ver el dashboard de errores de un servicio

​Kubernetes — /kubernetes

​Ejemplo: Abra el panel de detalles de un pod de Kubernetes concreto

​Notebooks — /notebook/<notebookId>

​Ejemplo: Abrir un notebook específico en un servicio de Cloud concreto

Búsqueda — `/search`

Ejemplo: Busque errores en la fuente `Logs` del servicio `checkout` dentro de un intervalo de tiempo

Ejemplo: Ir directamente a la vista waterfall de la traza

Búsquedas guardadas — `/search/list`

Ejemplo: Mostrar las búsquedas guardadas con la etiqueta `production`

Dashboards — `/dashboards/<dashboardId>`

Ejemplo: Abrir un dashboard para un intervalo de tiempo con un mosaico resaltado

Lista de dashboards — `/dashboards/list`

Ejemplo: Listar dashboards con la etiqueta `infra`

Chart Explorer — `/chart`

Ejemplo: Abrir la configuración de un gráfico de latencia p99 para un intervalo de tiempo

Alertas — `/alerts`

Ejemplo: Enumerar alertas con la etiqueta `on-call`

Reproducción de sesiones — `/sessions`

Ejemplo: Explore las reproducciones de sesión dentro de un intervalo de tiempo

Ejemplo: Abre una reproducción de sesión específica en el intervalo de tiempo en que se grabó

Mapa de servicios — `/service-map`

Ejemplo: Visualice el mapa de servicios para un intervalo de tiempo

Servicios — `/services`

Ejemplo: Consulte el dashboard de la base de datos de un servicio para un intervalo de tiempo

Ejemplo: Ver el dashboard de errores de un servicio

Kubernetes — `/kubernetes`

Ejemplo: Abra el panel de detalles de un pod de Kubernetes concreto

Notebooks — `/notebook/<notebookId>`

Ejemplo: Abrir un notebook específico en un servicio de Cloud concreto