RousselTMLEARNING

TP · ClickStack: del descubrimiento a la maestría

Práctica: instalar ClickStack y enviar los primeros datos con corrección

La corrección está integrada en el TP (Ver los recuadros verdes)

Lo que vas a aprender en este TP
  • Desplegar el contenedor todo en uno con volúmenes
  • Usar la clave de ingesta
  • Enviar trazas y logs por OTLP
  • Buscar por propiedades y en SQL
  • Comprobar la persistencia

Introducción #

Lo que vas a aprender en esta sección
  • Desplegar el contenedor todo en uno con volúmenes
  • Usar la clave de ingesta
  • Enviar trazas y logs por OTLP
  • Buscar por propiedades y en SQL
  • Comprobar la persistencia

Contexto. Evalúas ClickStack para tu equipo. Necesitas una instancia de demostración que conserve sus datos de un día para otro y datos realistas que mostrar.

Requisitos: un equipo con Docker (4 GB de memoria libre), curl y jq  ·  Duración estimada: 45 min

Una instancia de ClickStack persistente alimentada con trazas y logs, explorada por búsqueda y en SQL.

Puesta en marcha #

Pasos guiados, con su corrección.

  1. 1. Lanzar ClickStack

    ¿Por qué? Sin volúmenes, todo se perdería al eliminar el contenedor.

    Arranca el contenedor clickhouse/clickstack-all-in-one con los tres volúmenes (MongoDB, datos y logs de ClickHouse) en una red Docker obs.
    Ver la corrección
    docker network create obs 2>/dev/null
    mkdir -p .volumes/db .volumes/ch_data .volumes/ch_logs
    docker run -d --name clickstack --network obs --restart unless-stopped \
      -p 8080:8080 -p 4317:4317 -p 4318:4318 \
      -v "$(pwd)/.volumes/db:/data/db" \
      -v "$(pwd)/.volumes/ch_data:/var/lib/clickhouse" \
      -v "$(pwd)/.volumes/ch_logs:/var/log/clickhouse-server" \
      clickhouse/clickstack-all-in-one:latest
    docker logs -f clickstack     # esperar a que responda la interfaz, luego Ctrl+C
    curl -sI http://localhost:8080 | head -1
  2. 2. Crear la cuenta y obtener la clave de ingesta

    ¿Por qué? El colector rechaza los envíos sin clave.

    Abre http://localhost:8080, crea la primera cuenta y copia la clave desde Team Settings › API Keys en una variable.
    Ver la corrección
    export KEY='<clave copiada de Team Settings › API Keys>'
    # prueba: sin la clave, el envío OTLP HTTP se rechaza (401 esperado)
    curl -s -o /dev/null -w '%{http_code}\n' -X POST http://localhost:4318/v1/logs -H 'Content-Type: application/json' -d '{}'
  3. 3. Enviar trazas y logs

    ¿Por qué? telemetrygen produce telemetría OTLP realista sin escribir una aplicación.

    Envía trazas para los servicios boutique y paiement (con errores), y luego logs de información y de error.
    Ver la corrección
    T='ghcr.io/open-telemetry/opentelemetry-collector-contrib/telemetrygen:latest'
    for s in boutique paiement; do
      docker run --rm --network obs $T traces --otlp-endpoint clickstack:4317 --otlp-insecure \
        --duration 30s --rate 20 --service $s --otlp-header "authorization=\"$KEY\""
    done
    docker run --rm --network obs $T traces --otlp-endpoint clickstack:4317 --otlp-insecure \
      --duration 10s --rate 5 --service paiement --status-code Error --otlp-header "authorization=\"$KEY\""
    docker run --rm --network obs $T logs --otlp-endpoint clickstack:4317 --otlp-insecure --duration 20s --rate 10 \
      --service boutique --body 'commande validée' --severity-text Info --severity-number 9 --otlp-header "authorization=\"$KEY\""
    docker run --rm --network obs $T logs --otlp-endpoint clickstack:4317 --otlp-insecure --duration 20s --rate 2 \
      --service paiement --body 'timeout banque' --severity-text Error --severity-number 17 --otlp-header "authorization=\"$KEY\"" 
  4. 4. Buscar y correlacionar

    ¿Por qué? La búsqueda por propiedades cubre la mayoría de las necesidades.

    En Search, fuente Logs: encuentra los errores de paiement y luego la expresión exacta "timeout banque". Fuente Traces: filtra los spans con error y abre una cascada. Por último, pasa al modo SQL.
    Ver la corrección
    service:paiement level:error
    "timeout banque"
    -level:info service:boutique
    # Trazas
    service:paiement StatusCode:Error
    # Modo SQL (condición WHERE)
    ServiceName = 'paiement' AND SeverityText = 'Error'
  5. 5. Comprobar en SQL y probar la persistencia

    ¿Por qué? Una demo que pierde sus datos al reiniciar no convence a nadie.

    Cuenta los logs y spans por servicio con clickhouse-client, elimina y vuelve a crear el contenedor, y comprueba que las cifras y tu cuenta siguen ahí.
    Ver la corrección
    q() { docker exec clickstack clickhouse-client --query "$1"; }
    q "SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName"
    q "SELECT ServiceName, countIf(StatusCode = 'Error') AS errores, count() FROM otel_traces GROUP BY ServiceName"
    docker rm -f clickstack
    # volver a lanzar el docker run del paso 1 y luego:
    q "SELECT count() FROM otel_logs"     # mismo total que antes; el acceso a la interfaz sigue funcionando

Nivel de dificultad : ●●○○○ (2/5)

Mi seguimiento

  • ⏱ Duración estimada : ≈ 45 min

Inicia sesión para seguir tu progreso y tomar notas. Iniciar sesión

💬 Preguntas sobre esta lección

Todavía no hay preguntas: sé el primero en pedir ayuda o compartir tu configuración.

Hacer una pregunta sobre esta lección →

Artículos recomendados

ClickStack : architecture, composants et offres (ClickHouse, HyperDX, OpenTelemetry)

ClickStack, la pile d'observabilité officielle de ClickHouse : rôle de ClickHouse, de l'interface...

Installer et déployer ClickStack : tout-en-un, Docker Compose, Helm et Managed ClickStack

Déployer ClickStack selon le besoin : conteneur tout-en-un avec persistance, Docker Compose et se...

Envoyer la télémétrie à ClickStack : SDK OpenTelemetry, collecteurs, logs, Kubernetes et sessions navigateur

Alimenter ClickStack : clé d'ingestion, variables OpenTelemetry des SDK, relais par un collecteur...

Bonnes pratiques SigNoz, ClickStack et ClickHouse pour l'observabilité

Bonnes pratiques pour l'observabilité sur ClickHouse avec SigNoz ou ClickStack : instrumentation ...

Explorer avec l'interface ClickStack : sources, recherche, traces, sessions et SQL

Utiliser l'interface ClickStack (HyperDX) : sources de données, syntaxe de recherche par propriét...

Alertes et dashboards dans ClickStack

Construire des graphiques et des dashboards dans ClickStack, créer des alertes sur une recherche ...

Exploiter ClickHouse pour ClickStack : dimensionnement, réplication, surveillance, sécurité et sauvegarde

Faire tourner ClickHouse en production pour l'observabilité : estimer le volume et le disque, rép...

L'observabilité sur ClickHouse : pourquoi une base colonne change la donne

Pourquoi de plus en plus de plateformes d'observabilité stockent logs, traces et métriques dans C...

Exploiter une plateforme d'observabilité sur ClickHouse et choisir son outil

Exploiter ClickHouse pour la télémétrie (réplication, disques, fusions, stockage objet, supervisi...

Apoyar

♥ APOYAR

Apoya RousselTM Learning

Los cursos, artículos, prácticas y certificados siguen siendo gratuitos y sin publicidad intrusiva. Una contribución libre, por el importe que elijas, financia el alojamiento, los entornos de prácticas y nuevos contenidos.

Contribuir con PayPal Importe libre · tarjeta o cuenta PayPalMás información
QR code PayPal
O escanea este código QR con tu teléfono

¡Gracias, cada contribución cuenta!