RousselTMLEARNING

Article · ClickStack : de la découverte à l'expertise

Installer et déployer ClickStack

1. Choisir un mode de déploiement #

Du poste de développement à la production.

Les options #

Disponible dans : ✓ Open source ✓ Managed ClickStack Managed ClickStack : ClickHouse Cloud

Modes de déploiement
ModePourLimite
Tout-en-undécouvrir, démontrer, développerun seul conteneur : ni mise à l'échelle, ni isolation ; données perdues sans volumes
Docker Composepetite équipe, recette, mono-serveurpas de haute disponibilité
Helmproduction sur KubernetesClickHouse à exploiter (ou externe)
Managed ClickStackne pas exploiter ClickHouse ni l'interfacebêta en 2026 ; données dans ClickHouse Cloud

2. Le conteneur tout-en-un #

ClickHouse, interface, collecteur et MongoDB ensemble.

Avec persistance #

mkdir -p .volumes/db .volumes/ch_data .volumes/ch_logs
docker run -d --name clickstack --restart unless-stopped \
  -p 8080:8080 -p 4317:4317 -p 4318:4318 \
  -v "$(pwd)/.volumes/db:/data/db" \
  -v "$(pwd)/.volumes/ch_data:/var/lib/clickhouse" \
  -v "$(pwd)/.volumes/ch_logs:/var/log/clickhouse-server" \
  clickhouse/clickstack-all-in-one:latest
# http://localhost:8080 : créer le premier compte (les sources de la base intégrée sont créées à ce moment)
VolumeContenu
/data/dbMongoDB : comptes, dashboards, alertes
/var/lib/clickhousedonnées ClickHouse (la télémétrie)
/var/log/clickhouse-serverjournaux de ClickHouse
Attention : Sans volumes, tout est perdu à la suppression du conteneur. Même avec, ce mode ne convient pas à la production : tous les processus partagent les mêmes ressources et ne peuvent être ni dimensionnés ni surveillés séparément.

Changer les ports #

Seul le côté hôte change : -p 4999:4318 publie l'OTLP HTTP sur le port 4999. Changer les ports de l'interface (8080) ou de l'API (8000) demande aussi d'ajuster les variables correspondantes.

3. Docker Compose #

Un conteneur par composant.

Démarrer #

git clone https://github.com/ClickHouse/ClickStack.git && cd ClickStack
cat .env | grep -E 'IMAGE|PORT|VERSION'     # versions des images, ports de l'interface, de l'API et d'OpAMP
docker compose up -d
docker compose ps                            # app (interface + API), otel-collector, clickhouse, db (MongoDB)

Variables utiles (.env) #

VariableRôle
IMAGE_VERSION, CODE_VERSIONversion des images (fixez-la plutôt que latest)
HYPERDX_APP_PORTport de l'interface (8080)
HYPERDX_API_PORTport de l'API (8000)
HYPERDX_OPAMP_PORTport OpAMP de pilotage du collecteur (4320)
HYPERDX_APP_URLadresse publique de l'interface (liens dans les alertes)
HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASEbase ClickHouse des tables de télémétrie

Utiliser ClickHouse Cloud #

Retirez le service ClickHouse du Compose (et ses depends_on), puis donnez au collecteur l'adresse HTTPS (port 8443) et les identifiants du service. Créez ensuite la connexion dans l'interface (Team Settings) et les sources.

# Collecteur ClickStack vers un service ClickHouse Cloud (au lieu de la base locale)
otel-collector:
  image: clickhouse/clickstack-otel-collector:2
  environment:
    CLICKHOUSE_ENDPOINT: 'https://<service>.<région>.aws.clickhouse.cloud:8443'
    CLICKHOUSE_USER: 'otel_writer'
    CLICKHOUSE_PASSWORD: '${CH_PASSWORD}'
    HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASE: 'default'
    OPAMP_SERVER_URL: 'http://app:4320'
  ports: ['4317:4317', '4318:4318', '13133:13133']

4. Kubernetes avec Helm #

Le chart clickstack (v2).

Scénarios #

ScénarioRéglages
Pile complètevaleurs par défaut : ClickHouse (géré par opérateur), collecteur, interface
ClickHouse externeclickhouse.enabled: false et connexion par hyperdx.defaultConnections ou un Secret existant
Collecteur externeotel-collector.enabled: false et hyperdx.otelExporterEndpoint
Interface seuleClickHouse et collecteur désactivés, connexion vers l'existant
# Ajouter le dépôt Helm de ClickStack (URL indiquée dans la documentation « Helm »), puis :
helm install my-clickstack clickstack/clickstack -n observability --create-namespace -f values.yaml

# values.yaml : ClickHouse externe (par exemple ClickHouse Cloud), collecteur fourni par le chart
clickhouse:
  enabled: false                 # ne pas déployer la base intégrée (gérée par opérateur)
hyperdx:
  defaultConnections: |          # connexion de l'interface à votre ClickHouse (ou un Secret existant)
    [{ "name": "prod", "host": "https://<service>:8443", "username": "hyperdx", "password": "…" }]
otel-collector:
  enabled: true
À savoir : Le chart v1 (modèles intégrés) est en maintenance : la documentation fournit un guide de passage à la v2. Placez les mots de passe dans un Secret (hyperdx.useExistingConfigSecret) plutôt que dans values.yaml.

5. Managed ClickStack et production #

Choisir et vérifier.

Managed ClickStack #

Dans ClickHouse Cloud, activez ClickStack sur un service : l'interface apparaît dans la console, avec son contrôle d'accès. Il ne reste qu'à déployer un collecteur OpenTelemetry près de vos applications, qui écrit dans le service. C'est l'option la plus simple si les données peuvent être hébergées dans ClickHouse Cloud.

Liste de contrôle de production #

  • ClickHouse répliqué (au moins deux répliques et ClickHouse Keeper) ou ClickHouse Cloud ; disques rapides, stockage objet pour les données froides.
  • Collecteurs dimensionnés pour l'ingestion, plusieurs instances derrière un répartiteur, et une file tampon si nécessaire.
  • MongoDB sauvegardée (dashboards et alertes) ; TLS sur l'interface et sur les points d'entrée OTLP exposés.
  • Rétention (TTL) définie par table et surveillance de ClickHouse lui-même (voir la leçon d'exploitation).
  • Versions d'images fixées et montées de version testées en recette.

Commandes à connaître #

Commandes à connaître
  • docker run … clickhouse/clickstack-all-in-one:latest : tout-en-un
  • docker compose up -d : pile séparée
  • helm install my-clickstack clickstack/clickstack -f values.yaml : déploiement Kubernetes
  • curl -s http://localhost:13133 : santé du collecteur
  • docker logs clickstack | tail : journaux du conteneur tout-en-un

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.

📄 Installer et déployer ClickStack : tout-en-un, Docker Compose, Helm et Managed ClickStack →

Mon suivi

  • ⏱ Durée estimée : ≈ 10 min

Connectez-vous pour suivre votre progression et prendre des notes. Se connecter

💬 Questions sur cette leçon

Aucune question pour l'instant : soyez le premier à demander de l'aide ou à partager votre configuration.

Poser une question sur cette leçon →

Articles recommandés

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

ClickStack, la pile d'observabilité officielle de ClickHouse : rôle de ClickHouse, de l'interface...

Bonnes pratiques SigNoz, ClickStack et ClickHouse pour l'observabilité

Bonnes pratiques pour l'observabilité sur ClickHouse avec SigNoz ou ClickStack : instrumentation ...

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

SigNoz : architecture et installation

Les composants de SigNoz (collecteur OpenTelemetry, ClickHouse, service de requêtes, interface, a...

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

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

Alertes et dashboards dans ClickStack

Construire des graphiques et des dashboards dans ClickStack, créer des alertes sur une recherche ...

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

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

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 !