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.

Info - Parámetro de ID de servicio de Managed ClickStack

Al 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`
`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`
`isLive`	`true`	`false`
`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`
`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`
`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`
`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`
`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`
`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>`

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

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

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