RousselTMLEARNING

Observabilité

Alertes et dashboards dans ClickStack

Construire des graphiques et des dashboards dans ClickStack, créer des alertes sur une recherche ou un graphique, les envoyer vers Slack ou un webhook, et les fiabiliser ; avec les requêtes SQL équivalentes et l'option Grafana.

1. Graphiques #

Agréger n'importe quel champ.

Construire un graphique #

Disponible dans : ✓ Open source ✓ Managed ClickStack

Un graphique part d'une source et d'une recherche, puis applique une agrégation (nombre, somme, moyenne, minimum, maximum, centiles, valeurs distinctes) sur un champ, éventuellement regroupée par un autre (service, route, code HTTP).

GraphiqueSource et rechercheAgrégation
Erreurs par serviceLogs · level:errnombre, groupé par ServiceName
Latence p95 par routeTraces · service:checkoutcentile 95 de Duration, groupé par http.route
Utilisateurs actifsSessionsvaleurs distinctes de l'identifiant d'utilisateur
Codes HTTPLogs · service webnombre, groupé par http.status_code

2. Dashboards #

Rassembler les graphiques utiles.

Bonnes pratiques #

  • Un dashboard par service ou parcours, construit autour des signaux RED : taux de requêtes, erreurs, durée.
  • Des filtres globaux (environnement, service) appliqués à tous les graphiques du dashboard.
  • Des tableaux de recherche (derniers logs d'erreur) à côté des courbes, pour passer directement au détail.
  • Les dashboards sont stockés dans MongoDB : sauvegardez-la, ou exportez la définition des dashboards importants.

Et Grafana ? #

Le plugin ClickHouse de Grafana interroge les mêmes tables en SQL : utile si l'équipe vit déjà dans Grafana ou veut mélanger ClickHouse avec Prometheus. Les deux interfaces peuvent coexister sur les mêmes données.

-- Panneau Grafana (plugin ClickHouse) : erreurs par service, par minute
SELECT $__timeInterval(Timestamp) AS time, ServiceName, count() AS erreurs
FROM otel_logs
WHERE $__timeFilter(Timestamp) AND SeverityText ILIKE 'err%'
GROUP BY time, ServiceName ORDER BY time

3. Alertes #

Être prévenu, pas submergé.

Deux types #

Alerte sur…Exemple
une recherche enregistréeplus de 50 logs service:checkout level:err en 5 minutes
un graphiquelatence p95 de checkout au-dessus de 800 ms sur 10 minutes
l'absence de donnéesaucun log du service de paiement depuis 10 minutes (seuil « en dessous de 1 »)

Chaque alerte a un intervalle d'évaluation, un seuil (au-dessus ou en dessous) et des destinations : Slack, e-mail, webhook générique (vers Grafana IRM, PagerDuty, Opsgenie…). Le message contient un lien vers la recherche ou le graphique, d'où l'importance de HYPERDX_APP_URL.

Fiabiliser #

  • Alertez sur des symptômes visibles par l'utilisateur (erreurs, latence) plutôt que sur chaque log d'erreur.
  • Choisissez une fenêtre assez longue pour ignorer un pic isolé (5 à 10 minutes) et un seuil fondé sur l'historique.
  • Ajoutez une alerte d'absence de données sur les services critiques : un collecteur arrêté ne déclenche aucune alerte d'erreur.
  • Testez chaque alerte en provoquant la condition en recette, et vérifiez le lien du message.
Attention : Les alertes dépendent de l'interface (évaluation) et de MongoDB (définitions) : en auto-hébergé, surveillez ces deux composants, sinon les alertes s'arrêtent sans bruit.

Commandes à connaître #

Commandes à connaître
  • HYPERDX_APP_URL : adresse utilisée dans les liens des alertes
  • level:err service:checkout : recherche à transformer en alerte
  • $__timeFilter(Timestamp) : filtre de période du plugin ClickHouse de Grafana
  • mongodump --db hyperdx : sauvegarder dashboards et alertes (auto-hébergé)

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.

Articles liés

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…

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 ses variables,…

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 existant, l…

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 !