RousselTMLEARNING

Observabilité

Installer et déployer ClickStack : tout-en-un, Docker Compose, Helm et ClickHouse Cloud

Déployer ClickStack selon le besoin : conteneur tout-en-un avec persistance, Docker Compose et ses variables, chart Helm v2 (ClickHouse interne ou externe, collecteur externe, interface seule), ClickHouse Cloud (ClickHouse Observability, option self-managed), liste de contrôle de production.

1. Choisir un mode de déploiement #

Du poste de développement à la production.

Les options #

Disponible dans : ✓ Open source ✓ ClickHouse Cloud ClickHouse Observability et option self-managed

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)
ClickHouse Observabilityne rien exploiter : endpoint OTLP, base et interface managésbêta publique (novembre 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. ClickHouse Cloud et production #

Choisir et vérifier.

ClickHouse Observability #

Dans ClickHouse Cloud, deux possibilités. ClickHouse Observability (tout managé, bêta publique) fournit un endpoint OTLP managé : vos SDK et agents pointent dessus, et ClickHouse gère schémas, mise à l'échelle et interface. L'option self-managed (l'ancien Managed ClickStack) active l'interface sur votre service : vous déployez votre collecteur OpenTelemetry et réglez vous-même base et schémas. BYOC (la base dans votre compte cloud, opérée par ClickHouse) et ClickHouse Private (votre infrastructure, jusqu'aux environnements isolés) complètent l'offre.

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 (ClickHouse Observability est en bêta publique), consultez la documentation de ClickHouse avant de vous appuyer sur un détail.

6. Démarrer avec ClickHouse Observability #

Le mode tout managé.

Les étapes #

  1. Créez un service ClickHouse Cloud (l'essai gratuit fournit des crédits) et ouvrez ClickHouse Observability depuis le menu du service.
  2. Récupérez l'adresse de l'endpoint OTLP managé et sa clé, puis pointez-y vos SDK et agents (variables OTEL_EXPORTER_OTLP_ENDPOINT et OTEL_EXPORTER_OTLP_HEADERS).
  3. Pour des logs déjà présents dans Kafka ou S3, créez un ClickPipe plutôt qu'un collecteur supplémentaire.
  4. Réglez l'interface : heures en UTC (préférences utilisateur), sources reliées entre elles (logs, traces, métriques, sessions) pour activer la corrélation.
  5. Pour migrer depuis Datadog, un récepteur Datadog permet de garder les agents existants le temps de la transition.
Bonne Pratique : Pour s'entraîner sans rien instrumenter, le workshop public de ClickHouse (TP de ce chapitre « Explorer ») génère en SQL un mois de télémétrie réaliste dans votre propre service.

Articles liés

IA et agents SRE avec ClickStack : AI Notebooks, serveur MCP, ClickHouse Agents et gouvernance

Enquêter avec l'IA dans ClickStack : AI Notebooks, serveur MCP de ClickStack pour Claude Code, Cursor ou VS C…

Retours d'expérience ClickHouse pour l'observabilité : LogHouse, Qonto et Ringover

Trois façons d'utiliser ClickHouse pour l'observabilité, présentées à Paris en novembre 2026 : LogHouse chez …

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êtes), ses tro…

Pour aller plus loin

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 !