La correction est intégrée au TP (Voir les encadrés de couleur vert)
Ce que vous allez apprendre dans ce TP
- Déployer le conteneur tout-en-un avec volumes
- Utiliser la clé d'ingestion
- Envoyer traces et logs en OTLP
- Rechercher par propriétés et en SQL
- Vérifier la persistance
Introduction #
Ce que vous allez apprendre dans cette section
- Déployer le conteneur tout-en-un avec volumes
- Utiliser la clé d'ingestion
- Envoyer traces et logs en OTLP
- Rechercher par propriétés et en SQL
- Vérifier la persistance
Contexte. Vous évaluez ClickStack pour votre équipe. Il faut une instance de démonstration qui garde ses données d'un jour à l'autre et des données réalistes à montrer.
Prérequis : un poste avec Docker (4 Go de mémoire libre), curl et jq · Durée estimée : 45 min
Une instance ClickStack persistante alimentée en traces et en logs, explorée par recherche et en SQL.Mise en place #
Étapes guidées, avec leur correction.
1. Lancer ClickStack
Pourquoi ? Sans volumes, tout serait perdu à la suppression du conteneur.
Démarrez le conteneurclickhouse/clickstack-all-in-oneavec les trois volumes (MongoDB, données et journaux ClickHouse) sur un réseau Dockerobs.Voir la correction
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 # attendre que l'interface réponde, puis Ctrl+C curl -sI http://localhost:8080 | head -12. Créer le compte et récupérer la clé d'ingestion
Pourquoi ? Le collecteur refuse les envois sans clé.
Ouvrezhttp://localhost:8080, créez le premier compte, puis copiez la clé depuis Team Settings › API Keys dans une variable.Voir la correction
export KEY='<clé copiée dans Team Settings › API Keys>' # test : sans la clé, l'envoi OTLP HTTP est refusé (401 attendu) curl -s -o /dev/null -w '%{http_code}\n' -X POST http://localhost:4318/v1/logs -H 'Content-Type: application/json' -d '{}'3. Envoyer des traces et des logs
Pourquoi ? telemetrygen produit de la télémétrie OTLP réaliste sans écrire d'application.
Envoyez des traces pour les servicesboutiqueetpaiement(dont des erreurs), puis des logs d'information et d'erreur.Voir la correction
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. Rechercher et corréler
Pourquoi ? La recherche par propriétés couvre l'essentiel des besoins.
Dans Search, source Logs : trouvez les erreurs depaiement, puis l'expression exacte"timeout banque". Source Traces : filtrez les spans en erreur et ouvrez une cascade. Passez enfin en mode SQL.Voir la correction
service:paiement level:error "timeout banque" -level:info service:boutique # Traces service:paiement StatusCode:Error # Mode SQL (condition WHERE) ServiceName = 'paiement' AND SeverityText = 'Error'5. Vérifier en SQL et tester la persistance
Pourquoi ? Une démo qui perd ses données au redémarrage ne convainc personne.
Comptez les logs et les spans par service avecclickhouse-client, supprimez puis recréez le conteneur, et vérifiez que les chiffres et votre compte sont toujours là.Voir la correction
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 erreurs, count() FROM otel_traces GROUP BY ServiceName" docker rm -f clickstack # relancer la commande docker run de l'étape 1, puis : q "SELECT count() FROM otel_logs" # même total qu'avant ; la connexion à l'interface fonctionne toujours
Niveau de difficulté : ●●○○○ (2/5)
Mon suivi
Connectez-vous pour suivre votre progression et prendre des notes. Se connecter
💬 Questions sur cette leçon
Aucune question pour l'instant : soyez le premier à demander de l'aide ou à partager votre configuration.
Articles recommandés
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...
Installer OpenObserve et ingérer ses premières données
Installer OpenObserve avec Docker Compose ou le binaire, le configurer par ses variables ZO_*, en...
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 ...
Bonnes pratiques SigNoz, ClickStack et ClickHouse pour l'observabilité
Bonnes pratiques pour l'observabilité sur ClickHouse avec SigNoz ou ClickStack : instrumentation ...
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...
Envoyer ses logs, métriques et traces vers OpenObserve
Les points de réception d'OpenObserve : JSON, bulk, OTLP avec le Collector OpenTelemetry, Prometh...