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. Lanzar ClickStack
¿Por qué? Sin volúmenes, todo se perdería al eliminar el contenedor.
Arranca el contenedorclickhouse/clickstack-all-in-onecon los tres volúmenes (MongoDB, datos y logs de ClickHouse) en una red Dockerobs.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 -12. Crear la cuenta y obtener la clave de ingesta
¿Por qué? El colector rechaza los envíos sin clave.
Abrehttp://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. Enviar trazas y logs
¿Por qué? telemetrygen produce telemetría OTLP realista sin escribir una aplicación.
Envía trazas para los serviciosboutiqueypaiement(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. Buscar y correlacionar
¿Por qué? La búsqueda por propiedades cubre la mayoría de las necesidades.
En Search, fuente Logs: encuentra los errores depaiementy 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. 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 conclickhouse-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
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.
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...