1. Présentation #
Une pile intégrée.
Les briques #
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=frontProduction #
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.
