Logs, trazas y métricas de ejemplo

Esta guía presenta tanto ClickStack Open Source como Managed ClickStack con un conjunto de datos de ejemplo.

La siguiente guía asume que ha completado la Guía de introducción para Managed ClickStack y que tiene las credenciales de conexión anotadas.

Selecciona tu servicio

Selecciona el servicio con Managed ClickStack en la página principal de ClickHouse Cloud.

Ve a la UI de ClickStack (HyperDX)

Selecciona ClickStack en el menú de la izquierda para ir a la UI de ClickStack, donde se te autenticará automáticamente.

Descargar datos de ejemplo

Para cargar la UI con datos de ejemplo, descargue el siguiente archivo:

Datos de ejemplo

# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz
# or
# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

Este archivo contiene logs, métricas y trazas de ejemplo de nuestra demo pública de OpenTelemetry, una sencilla tienda en línea con microservicios. Copia este archivo en el directorio que prefieras.

Cargar datos de ejemplo

Para cargar estos datos, simplemente los enviamos al endpoint HTTP del OTel collector de OpenTelemetry ya desplegado.

Ejecute el siguiente comando para enviar los datos al OTel collector:

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "loading ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    printf '%s\n' "$line" | curl -s -o /dev/null -X POST "$endpoint" \
    -H "Content-Type: application/json" \
    -H "authorization: ${CLICKSTACK_API_KEY}" \
    --data-binary @-
  done
done

Esto simula fuentes OTLP de logs, trazas y métricas que envían datos al OTel collector. En producción, estas fuentes pueden ser clientes en distintos lenguajes o incluso otras instancias de OTel collector.

Al volver a la vista Search, deberías ver que los datos han empezado a cargarse (ajusta el intervalo de tiempo a Last 1 hour si los datos no se muestran):

La carga de datos tardará unos minutos. Espera a que termine antes de continuar con los siguientes pasos.

Explorar sesiones

Supongamos que hemos recibido informes de que nuestros usuarios están teniendo problemas para pagar sus compras. Podemos ver su experiencia usando la función de session replay de HyperDX.

Selecciona Client Sessions en el menú de la izquierda.

Esta vista nos permite ver las sesiones del front-end de nuestra tienda de comercio electrónico. Las sesiones permanecen como Anonymous hasta que los usuarios pasan por caja e intentan completar una compra.

Ten en cuenta que algunas sesiones con correos electrónicos tienen un error asociado, lo que podría confirmar los informes de transacciones fallidas.

Selecciona una traza con un fallo y un correo electrónico asociado. La vista siguiente nos permite reproducir la sesión del usuario y revisar el problema. Pulsa play para ver la sesión.

La reproducción muestra al usuario navegando por el sitio y añadiendo artículos al carrito. Si quieres, puedes avanzar hasta un punto posterior de la sesión donde intenta completar el pago.

El usuario no pudo realizar el pedido, sin que hubiera ningún error evidente. Desplázate hasta la parte inferior del panel izquierdo, que contiene los eventos de red y de consola del navegador del usuario. Verás que se produjo un error 500 al hacer una llamada a /api/checkout.

Selecciona este error 500. Ni Overview ni Column Values indican el origen del problema, más allá de que el error es inesperado, lo que provoca un Internal Error.

Explorar trazas

Ve a la pestaña Trace para ver la traza distribuida completa.

Desplázate por la traza hasta ver el origen del error: el span del servicio checkout. Selecciona el span del servicio Payment.

Selecciona la pestaña Column Values y desplázate hacia abajo. Podemos ver que el problema está relacionado con una caché llena.

Al volver hacia arriba en la traza, vemos que los logs están correlacionados con el span gracias a la configuración anterior. Esto aporta más contexto.

Hemos comprobado que se está llenando una caché en el servicio Payment, lo que impide que los pagos se completen.

Explorar logs

Para obtener más detalles, podemos volver a Search:

Selecciona Logs en las fuentes y aplica un filtro al servicio payment.

Podemos ver que, aunque el problema es reciente, el número de pagos afectados es elevado. Además, parece que una caché relacionada con los pagos con Visa está causando problemas.

Métricas del gráfico

Aunque claramente se ha introducido un error en el código, podemos usar métricas para confirmar el tamaño de la caché. Ve a la vista Chart Explorer.

Selecciona Metrics como fuente de datos. Completa el generador de gráficos para representar el Maximum de visa_validation_cache.size (Gauge) y pulsa el botón play. La caché fue aumentando claramente hasta alcanzar un tamaño máximo, tras lo cual se generaron errores.

El siguiente ejemplo asume que ha iniciado ClickStack Open Source usando la imagen todo en uno y ha copiado la API key de ingesta.

Ve a la UI de ClickStack (HyperDX)

Visita http://localhost:8080 para acceder a la UI de ClickStack.

Copiar la API key de ingesta

Ve a Team Settings y copia la Ingestion API Key de la sección API Keys. Esta API key garantiza que la ingestión de datos a través del collector de OpenTelemetry sea segura.

Descargar datos de ejemplo

Para cargar la UI con datos de ejemplo, descargue el siguiente archivo:

Datos de ejemplo

# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz
# or
# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

Cargar datos de ejemplo

Para cargar estos datos, basta con enviarlos al endpoint HTTP del collector de OpenTelemetry (OTel) desplegado.

Primero, exporte la API key que copió anteriormente.

# export API key
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

Ejecute el siguiente comando para enviar los datos al OTel collector:

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "loading ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    printf '%s\n' "$line" | curl -s -o /dev/null -X POST "$endpoint" \
    -H "Content-Type: application/json" \
    -H "authorization: ${CLICKSTACK_API_KEY}" \
    --data-binary @-
  done
done

Al volver a la vista Search, deberías ver que los datos han empezado a cargarse (ajusta el intervalo de tiempo a Last 1 hour si los datos no se muestran):

La carga de datos tardará unos minutos. Espera a que termine antes de continuar con los siguientes pasos.

Explorar sesiones

Supongamos que hemos recibido informes de usuarios que tienen problemas para pagar sus compras. Podemos ver su experiencia usando las capacidades de session replay de HyperDX.

Selecciona Client Sessions en el menú de la izquierda.

Ten en cuenta que algunas sesiones con direcciones de correo electrónico tienen un error asociado, lo que podría confirmar los informes de transacciones fallidas.

Selecciona un trace con un fallo y una dirección de correo electrónico asociada. La vista siguiente nos permite reproducir la sesión del usuario y revisar su problema. Pulsa play para ver la sesión.

La reproducción muestra al usuario navegando por el sitio y añadiendo artículos al carrito. No dudes en avanzar hasta un punto posterior de la sesión, donde intenta completar el pago.

El usuario no pudo completar el pedido, sin ningún error evidente. Desplázate hasta la parte inferior del panel izquierdo, que contiene los eventos de Network y Console del navegador del usuario. Verás que se produjo un error 500 al hacer una llamada a /api/checkout.

Selecciona este error 500. Ni Overview ni Column Values indican el origen del problema, más allá de que el error es inesperado y provoca un Internal Error.