RousselTMLEARNING

Artículo · ClickStack: del descubrimiento a la maestría

Arquitectura de ClickStack

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.

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.

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

Mi seguimiento

  • ⏱ Duración estimada : ≈ 5 min

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.

Hacer una pregunta sobre esta lecció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...

Apoyar

♥ APOYAR

Apoya RousselTM Learning

Los cursos, artículos, prácticas y certificados siguen siendo gratuitos y sin publicidad intrusiva. Una contribución libre, por el importe que elijas, financia el alojamiento, los entornos de prácticas y nuevos contenidos.

Contribuir con PayPal Importe libre · tarjeta o cuenta PayPalMás información
QR code PayPal
O escanea este código QR con tu teléfono

¡Gracias, cada contribución cuenta!