[Artículo] ClickStack y HyperDX

1. Présentation #

Une pile intégrée.

Les briques #

Architecture ClickStack — Les trois briques sont fournies et configurées ensemble.

ClickStack est la pile d'observabilité proposée par ClickHouse : un OpenTelemetry Collector préconfiguré, ClickHouse avec un schéma optimisé, et HyperDX, une interface de recherche et d'analyse rachetée par ClickHouse. Elle vise une expérience proche des outils commerciaux, en open source.

2. Installer #

Tout-en-un ou séparé.

All-in-one #

docker run -d --name clickstack \
  -p 8080:8080 -p 4317:4317 -p 4318:4318 \
  docker.hyperdx.io/hyperdx/hyperdx-all-in-one
# Interface : http://localhost:8080 (création du compte au premier accès)

La clé d'ingestion (API key) affichée dans les paramètres de l'équipe doit être envoyée par les SDK dans l'en-tête authorization.

export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
export OTEL_EXPORTER_OTLP_HEADERS="authorization=<cle_ingestion>"
export OTEL_SERVICE_NAME=front

Production #

En production, on sépare les briques : ClickHouse (ou ClickHouse Cloud) répliqué, des Collectors dimensionnés pour l'ingestion, et HyperDX connecté à ClickHouse. Un chart Helm est fourni.

Erreur Courante : L'image tout-en-un stocke tout dans un seul conteneur : parfaite pour un essai, inadaptée à des données que l'on veut conserver.

3. Utiliser HyperDX #

Chercher et corréler.

Fonctions #

Fonction	Usage
Recherche	Syntaxe de type Lucene (`level:error service:checkout "timeout"`) ou SQL
Traces	Chronologie, spans, logs associés à chaque span
Sessions	Rejeu des sessions navigateur (avec le SDK navigateur), reliées aux traces back-end
Graphes et dashboards	Agrégations sur n'importe quel champ
Alertes	Sur recherches et graphes

Bonne Pratique : Le passage d'un log à sa trace, puis à la session navigateur qui l'a provoquée, est le point fort de la pile : instrumentez front et back avec OpenTelemetry pour en profiter.

ClickStack y HyperDX