RousselTMLEARNING

Artículo · ClickStack: del descubrimiento a la maestría

Instalar y desplegar ClickStack

Este artículo está disponible en francés.

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 →

Mi seguimiento

  • ⏱ Duración estimada : ≈ 10 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

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

Logstash: enriquecer, probar, supervisar y desplegar en Kubernetes

Enriquecer con translate, geoip y elasticsearch, consumir Kafka, probar los pipelines, supervisar...

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

Installer et configurer CrowdSec : paquets, Docker, acquisition

Installer CrowdSec avec les paquets ou Docker, comprendre ses fichiers, déclarer les logs à lire,...

Installer OpenObserve et ingérer ses premières données

Installer OpenObserve avec Docker Compose ou le binaire, le configurer par ses variables ZO_*, en...

Installer Zabbix et superviser son premier hôte

Installer Zabbix avec Docker Compose (serveur, PostgreSQL, interface web), installer l'agent 2 su...

Déployer et exploiter Mimir sur Kubernetes

Installer Mimir avec le chart Helm mimir-distributed, dimensionner les composants, superviser Mim...

OpenTelemetry sur Kubernetes : Operator, auto-instrumentation et Collector

Déployer OpenTelemetry sur Kubernetes : modes de déploiement du Collector (DaemonSet, Deployment,...

Observabilité sur Google Cloud : Cloud Monitoring, Logging, Trace, Profiler et Managed Prometheus

Panorama complet de Google Cloud Observability : Cloud Monitoring, Cloud Logging (routeur, récept...

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!