RousselTMLEARNING

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

TP : Dashboard de service et alertes avec correction

La correction est intégrée au TP (Voir les encadrés de couleur vert)

Ce que vous allez apprendre dans ce TP
  • Construire des graphiques agrégés
  • Assembler un dashboard filtrable
  • Créer une alerte sur une recherche enregistrée
  • Créer une alerte d'absence de données
  • Vérifier les notifications

Introduction #

Ce que vous allez apprendre dans cette section
  • Construire des graphiques agrégés
  • Assembler un dashboard filtrable
  • Créer une alerte sur une recherche enregistrée
  • Créer une alerte d'absence de données
  • Vérifier les notifications

Contexte. Le service de paiement a connu deux incidents découverts par des clients. L'équipe veut un écran de suivi et être prévenue avant eux, y compris si le service cesse d'envoyer ses logs.

Prérequis : un poste avec Docker (4 Go de mémoire libre), curl et jq, l'instance du TP 1  ·  Durée estimée : 60 min

Un dashboard de quatre graphiques, deux alertes testées et leurs notifications reçues par le webhook.

Mise en place #

Étapes guidées, avec leur correction.

  1. 1. Générer du trafic et un récepteur de webhooks

    Pourquoi ? Une alerte se teste sur des données qui arrivent en continu.

    Reprenez l'instance du TP 1 (variable KEY), lancez deux générateurs en arrière-plan et un récepteur de webhooks.
    Voir la correction
    T='ghcr.io/open-telemetry/opentelemetry-collector-contrib/telemetrygen:latest'; H="authorization=\"$KEY\""
    # trafic continu : 2 services, erreurs de paiement en continu, pendant 15 minutes
    docker run -d --name trafic-ok  --network obs $T traces --otlp-endpoint clickstack:4317 --otlp-insecure --duration 15m --rate 10 --service boutique --otlp-header "$H"
    docker run -d --name trafic-err --network obs $T logs --otlp-endpoint clickstack:4317 --otlp-insecure --duration 15m --rate 1 \
      --service paiement --body 'timeout banque' --severity-text Error --severity-number 17 --otlp-header "$H"
    # récepteur de webhooks : affiche chaque requête reçue
    docker run -d --name hook --network obs -p 8090:8080 mendhak/http-https-echo:latest
  2. 2. Construire les graphiques

    Pourquoi ? Les signaux RED (taux, erreurs, durée) résument l'état d'un service.

    Dans Chart Explorer, créez : spans par service (nombre, groupé par ServiceName) ; latence p95 (traces, centile 95 de Duration) ; logs d'erreur par service ; tableau des derniers logs d'erreur.
    Voir la correction
    # Graphique             Source  Recherche       Agrégation              Groupé par
    # Débit                 Traces  (vide)          Count                   ServiceName
    # Latence p95           Traces  SpanKind:Server 95th percentile Duration ServiceName
    # Erreurs               Logs    level:error     Count                   ServiceName
    # Derniers incidents    Logs    level:error     (tableau de recherche)
    # Contrôle en SQL de la latence p95 affichée :
    docker exec clickstack clickhouse-client --query "SELECT ServiceName, quantile(0.95)(Duration)/1e6 AS p95_ms FROM otel_traces WHERE Timestamp > now() - INTERVAL 15 MINUTE GROUP BY ServiceName"
  3. 3. Assembler le dashboard

    Pourquoi ? Un écran unique évite de reconstruire les graphiques à chaque incident.

    Créez le dashboard Paiement et boutique, ajoutez les quatre graphiques, puis un filtre global sur ServiceName. Vérifiez que filtrer sur paiement met à jour tous les graphiques.
    Voir la correction
    # Disposition conseillée : Débit | Latence p95 (ligne 1), Erreurs | Derniers incidents (ligne 2)
    # Filtre global du dashboard :
    ServiceName:paiement
  4. 4. Alerter sur les erreurs

    Pourquoi ? Le seuil se fonde sur ce qu'on observe : ici environ 60 erreurs toutes les 5 minutes.

    Enregistrez la recherche service:paiement level:error, créez une alerte « au-dessus de 30 en 5 minutes » vers un webhook générique pointant sur http://hook:8080/alerte, puis lisez les journaux du récepteur.
    Voir la correction
    # Team Settings › Webhooks : URL http://hook:8080/alerte (le conteneur ClickStack et « hook » sont sur le réseau obs)
    # Search › Save › Alerts : Above 30, window 5m, destination = ce webhook
    docker logs --since 10m hook | grep -A20 '"path": "/alerte"'   # notification reçue, avec le lien vers la recherche
  5. 5. Alerter sur l'absence de données

    Pourquoi ? Un service arrêté n'émet plus d'erreurs : seule une alerte d'absence le détecte.

    Créez une alerte « en dessous de 1 en 5 minutes » sur la recherche service:boutique, arrêtez le générateur trafic-ok et attendez la notification. Nettoyez ensuite.
    Voir la correction
    docker stop trafic-ok
    # 5 à 6 minutes plus tard :
    docker logs --since 10m hook | grep -c '/alerte'
    docker rm -f trafic-ok trafic-err hook

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

Mon suivi

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

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

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

Alertes et dashboards dans ClickStack

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

Utiliser SigNoz : APM, traces, logs, dashboards et alertes

Exploiter SigNoz au quotidien : vue APM des services, explorateur de traces et de logs, query bui...

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

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

Alertes, connecteurs et SLO dans Kibana

Créer des règles d'alerte dans Kibana (requête Elasticsearch, ES|QL, seuil personnalisé, logs), c...

Application Observability dans Grafana Cloud

Application Observability dans Grafana Cloud : métriques RED à partir des traces, carte des servi...

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

OpenSearch Dashboards, alertes et observabilité

Explorer ses données dans OpenSearch Dashboards, créer des moniteurs d'alerte et découvrir Trace ...

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

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 !