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

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...

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!