Este artículo está disponible en francés.
1. Ce qu'est ClickStack #
Une pile intégrée sur ClickHouse.
Le principe #
Disponible dans : ✓ Open source ✓ Managed ClickStack open source · aussi proposé managé dans ClickHouse Cloud
ClickStack est la pile d'observabilité publiée par ClickHouse depuis 2025. Elle réunit trois briques déjà configurées pour fonctionner ensemble : un collecteur OpenTelemetry qui reçoit logs, traces, métriques et sessions, ClickHouse qui les stocke dans des tables optimisées, et une interface (issue de HyperDX, racheté par ClickHouse en 2025) pour chercher, corréler, visualiser et alerter.
Pourquoi ClickHouse ? #
- Compression : la télémétrie, très répétitive, se compresse souvent 10 à 20 fois en stockage colonne.
- Haute cardinalité : filtrer par
trace_id,user_idoupodne coûte pas plus qu'un autre champ, contrairement aux systèmes à labels. - SQL : tout ce que l'interface ne fait pas se fait en SQL, avec jointures vers vos données métier.
- Un seul moteur pour logs, traces, métriques et sessions : une seule base à exploiter et à sauvegarder.
2. Les composants et le circuit des données #
Qui fait quoi.
Architecture #
| Composant | Rôle | Ports |
|---|---|---|
| Collecteur OpenTelemetry (distribution ClickStack) | reçoit l'OTLP, vérifie la clé d'ingestion, regroupe et écrit dans ClickHouse | 4317 (gRPC), 4318 (HTTP), 13133 (santé), 8888 (métriques), 24225 (Fluentd) |
| ClickHouse | stocke les événements dans otel_logs, otel_traces, otel_metrics_*, hyperdx_sessions | 8123 (HTTP), 9000 (natif) |
| Interface ClickStack (HyperDX) | recherche, traces, sessions, dashboards, alertes ; interroge ClickHouse en SQL | 8080 (interface), 8000 (API), 4320 (OpAMP) |
| MongoDB | état de l'application : utilisateurs, dashboards, alertes, recherches enregistrées (pas les données de télémétrie) | 27017 |
Le parcours d'un événement #
- L'application envoie un span ou une ligne de log en OTLP au collecteur, avec la clé d'ingestion dans l'en-tête
authorization. - Le collecteur regroupe les événements et les insère par lots dans ClickHouse (de gros lots, comme ClickHouse les aime).
- L'interface traduit une recherche (
level:err service:checkout) en requête SQL sur la table de la source, et affiche le résultat. - Les dashboards et alertes sont enregistrés dans MongoDB ; les alertes sont évaluées périodiquement en SQL.
À savoir : L'interface pilote aussi le collecteur par OpAMP (port 4320) : c'est elle qui lui fournit sa configuration, d'où la variable OPAMP_SERVER_URL du collecteur.3. Versions, licences et offres #
Ce qui a changé en 2026.
Repères #
- Images : publiées sous
clickhouse/clickstack-*(tout-en-un, collecteur…) ; les anciens nomsdocker.hyperdx.io/hyperdx/…etghcr.io/hyperdxio/…sont à remplacer. - Managed ClickStack (bêta depuis février 2026) : ClickHouse et l'interface sont hébergés dans ClickHouse Cloud, intégrés à sa console et à son contrôle d'accès ; vous n'exploitez plus que le collecteur. Pas de produit supplémentaire à acheter : la facturation suit l'infrastructure ClickHouse Cloud.
- Interface intégrée : depuis ClickHouse 26.2, l'interface ClickStack est distribuée dans le binaire de ClickHouse, pratique pour expérimenter en local.
- Licences : ClickHouse est sous licence Apache 2.0 et l'interface HyperDX est open source (licence MIT).
4. Forces et limites #
Pour bien la positionner.
Comparer #
| Point | ClickStack | Remarque |
|---|---|---|
| Coût de stockage | faible (compression, stockage objet possible) | dépend de la rétention choisie |
| Recherche plein texte | rapide sur des volumes importants | index de type « skip » plutôt qu'index inversé |
| Corrélation | logs, traces, métriques et sessions dans une même interface | nécessite des identifiants de trace propagés |
| Exploitation | une base ClickHouse à dimensionner et surveiller | sauf en Managed ClickStack |
| Écosystème | plus jeune que Grafana ou Elastic | fonctions en évolution rapide |
Commandes à connaître #
Commandes à connaître
docker run … clickhouse/clickstack-all-in-one:latest: pile complète en un conteneurcurl http://localhost:13133: santé du collecteurclickhouse-client --query "SHOW TABLES": tables créées par la pileOTEL_EXPORTER_OTLP_HEADERS=authorization=<clé>: clé d'ingestion pour les SDK
Sources #
Vérifié en novembre 2026 : ClickStack évolue vite (Managed ClickStack est en bêta), consultez la documentation de ClickHouse avant de vous appuyer sur un détail.
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
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...
Bonnes pratiques SigNoz, ClickStack et ClickHouse pour l'observabilité
Bonnes pratiques pour l'observabilité sur ClickHouse avec SigNoz ou ClickStack : instrumentation ...
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...
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...
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...
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...
Alertes et dashboards dans ClickStack
Construire des graphiques et des dashboards dans ClickStack, créer des alertes sur une recherche ...
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...
La télémétrie dans ClickHouse : schéma, SQL, vues matérialisées et rétention
La télémétrie dans ClickHouse : tables otel_logs, otel_traces, otel_metrics_* et hyperdx_sessions...