RousselTMLEARNING

Observabilité

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

ClickStack, la pile d'observabilité officielle de ClickHouse : rôle de ClickHouse, de l'interface (HyperDX), du collecteur OpenTelemetry et de MongoDB, circuit des données, OpAMP, licences, Managed ClickStack et interface intégrée à ClickHouse 26.2.

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.

ClickStack

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_id ou pod ne 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 #

Architecture de ClickStack
ComposantRôlePorts
Collecteur OpenTelemetry (distribution ClickStack)reçoit l'OTLP, vérifie la clé d'ingestion, regroupe et écrit dans ClickHouse4317 (gRPC), 4318 (HTTP), 13133 (santé), 8888 (métriques), 24225 (Fluentd)
ClickHousestocke les événements dans otel_logs, otel_traces, otel_metrics_*, hyperdx_sessions8123 (HTTP), 9000 (natif)
Interface ClickStack (HyperDX)recherche, traces, sessions, dashboards, alertes ; interroge ClickHouse en SQL8080 (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 #

  1. 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.
  2. Le collecteur regroupe les événements et les insère par lots dans ClickHouse (de gros lots, comme ClickHouse les aime).
  3. L'interface traduit une recherche (level:err service:checkout) en requête SQL sur la table de la source, et affiche le résultat.
  4. 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 noms docker.hyperdx.io/hyperdx/… et ghcr.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 #

PointClickStackRemarque
Coût de stockagefaible (compression, stockage objet possible)dépend de la rétention choisie
Recherche plein texterapide sur des volumes importantsindex de type « skip » plutôt qu'index inversé
Corrélationlogs, traces, métriques et sessions dans une même interfacenécessite des identifiants de trace propagés
Exploitationune base ClickHouse à dimensionner et surveillersauf en Managed ClickStack
Écosystèmeplus jeune que Grafana ou Elasticfonctions en évolution rapide

Commandes à connaître #

Commandes à connaître
  • docker run … clickhouse/clickstack-all-in-one:latest : pile complète en un conteneur
  • curl http://localhost:13133 : santé du collecteur
  • clickhouse-client --query "SHOW TABLES" : tables créées par la pile
  • OTEL_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.

Articles liés

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êtes), ses tro…

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 ses variables,…

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 existant, l…

Pour aller plus loin

Soutenir

♥ SOUTENIR

Soutenez RousselTM Learning

Les formations, articles, TP et attestations restent gratuits et sans publicité intrusive. Une contribution libre, du montant de votre choix, finance l’hébergement, les environnements de TP et l’écriture de nouveaux contenus.

Contribuer avec PayPal Montant libre · carte bancaire ou compte PayPalEn savoir plus
QR code PayPal
Ou scannez ce QR code avec votre téléphone

Merci, chaque contribution compte !