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
Le trilemme de l'observabilité : coût, exhaustivité et performance, et comment les solutions le résolvent
Comprendre le trilemme de l'observabilité (coût, exhaustivité des données, performance des requêt...
OpenTelemetry y Elasticsearch: compatibilidad y arquitectura
Enviar OpenTelemetry a Elasticsearch: Collector y exportador elasticsearch, endpoint OTLP gestion...
OpenTelemetry Collector, Grafana Alloy et Bindplane : comparer trois approches des pipelines de télémétrie
Comparatif détaillé de trois façons de gérer des pipelines de télémétrie : l'OpenTelemetry Collec...
SigNoz : architecture et installation
Les composants de SigNoz (collecteur OpenTelemetry, ClickHouse, service de requêtes, interface, a...
Observabilité sur AWS : CloudWatch, X-Ray, Application Signals, ADOT, Managed Prometheus et Grafana
Panorama complet de l'observabilité sur AWS : composants CloudWatch (métriques, logs, alarmes, Ap...
Architecture OpenTelemetry : Comprendre les 3 niveaux
Plongée au cœur de l'architecture OpenTelemetry. Apprenez comment les données circulent de l'appl...
La stack LGTM (Loki, Grafana, Tempo, Mimir) : architecture et mise en place
La stack LGTM de Grafana Labs : Loki pour les logs, Grafana pour la visualisation, Tempo pour les...
Observabilité sur Google Cloud : Cloud Monitoring, Logging, Trace, Profiler et Managed Prometheus
Panorama complet de Google Cloud Observability : Cloud Monitoring, Cloud Logging (routeur, récept...
OTLP expliqué : comprendre le protocole OpenTelemetry
Découvrez le protocole OTLP expliqué simplement. Comprendre les différences entre gRPC et HTTP po...