RousselTMLEARNING

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

TP final : Une plateforme ClickStack prête pour la production

Ce que vous allez apprendre dans ce TP
  • Déployer ClickStack en Docker Compose
  • Relayer des logs de fichiers sans perte
  • Séparer écriture et lecture dans ClickHouse
  • Régler rétention et agrégats
  • Sauvegarder et restaurer
  • Valider la liste de contrôle

Introduction #

Ce que vous allez apprendre dans cette section
  • Déployer ClickStack en Docker Compose
  • Relayer des logs de fichiers sans perte
  • Séparer écriture et lecture dans ClickHouse
  • Régler rétention et agrégats
  • Sauvegarder et restaurer
  • Valider la liste de contrôle

Contexte. La démonstration a convaincu : ClickStack doit maintenant recevoir les journaux du frontal nginx sans en perdre, avec des accès séparés, une rétention maîtrisée et des sauvegardes vérifiées, avant la revue de mise en production.

Prérequis : un poste avec Docker (4 Go de mémoire libre), curl et jq, git  ·  Durée estimée : 90 min

Une pile ClickStack en Compose, un collecteur de bordure résistant aux coupures, des comptes séparés, une rétention par table, une sauvegarde restaurable et une liste de contrôle validée.

Mise en place #

Étapes guidées, avec leur correction.

  1. 1. Déployer ClickStack en Compose

    Pourquoi ? Un conteneur par composant : chacun se surveille, se redémarre et se dimensionne séparément.

    Clonez le dépôt ClickStack, fixez la version des images dans .env, démarrez, créez le compte et exportez la clé d'ingestion. Repérez le nom du service ClickHouse.
  2. 2. Un collecteur de bordure pour nginx

    Pourquoi ? La file persistante garde les logs si ClickStack est indisponible.

    Écrivez edge.yaml, générez un fichier de logs nginx, puis lancez un collecteur contrib sur le réseau du Compose.
  3. 3. Tester la résistance aux coupures

    Pourquoi ? Une plateforme d'observabilité qui perd des logs pendant un incident ne sert à rien.

    Arrêtez le collecteur ClickStack, ajoutez 200 lignes, redémarrez-le, puis vérifiez que le total atteint 700 lignes nginx.
  4. 4. Séparer les comptes et limiter les lecteurs

    Pourquoi ? Un analyste ne doit ni écrire, ni saturer la base avec une requête sans limite.

    Créez un compte en lecture seule avec un profil de limites, et vérifiez qu'il ne peut pas supprimer de table.
  5. 5. Rétention et agrégat des codes HTTP

    Pourquoi ? Les logs bruts coûtent cher ; leur agrégat se garde longtemps pour presque rien.

    Fixez 14 jours sur otel_logs et 7 jours sur otel_traces, puis créez une vue matérialisée qui compte les requêtes nginx par minute et par code HTTP, gardée 400 jours.
  6. 6. Sauvegarder ClickHouse et MongoDB

    Pourquoi ? Une sauvegarde non restaurée n'est qu'une hypothèse.

    Ajoutez un disque de sauvegarde à ClickHouse (fichier monté dans config.d et volume /backups via un docker-compose.override.yml), sauvegardez otel_logs, restaurez-la sous un autre nom et comparez. Sauvegardez MongoDB avec mongodump.
  7. 7. Dérouler la liste de contrôle

    Pourquoi ? La revue de mise en production demande des preuves, pas des impressions.

    Collectez les preuves : envois en échec du collecteur, parts par table, requêtes lentes, TTL, puis créez dans l'interface une alerte d'absence de logs nginx. Notez ce qui manque encore pour la production (réplication, TLS, authentification unique).

Niveau de difficulté : ●●●●○ (4/5)

Mon suivi

  • ⏱ Durée estimée : ≈ 1 h 30

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

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

Déployer ClickStack selon le besoin : conteneur tout-en-un avec persistance, Docker Compose et se...

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

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

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

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

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

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

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

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

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

Alertes et dashboards dans ClickStack

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

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 !