RousselTMLEARNING

Article · SigNoz : de la découverte à l'expertise

Bonnes pratiques

1. Collecter #

Des données propres dès la source.

Instrumentation #

  • OpenTelemetry uniquement dans le code : l'interface (SigNoz, ClickStack, Grafana) reste remplaçable sans réinstrumenter.
  • service.name, service.version et deployment.environment.name sur toutes les ressources ; des noms de services stables et documentés.
  • Logs structurés (JSON) émis avec le contexte de trace : TraceId dans chaque log, c'est la clé de la corrélation.
  • Conventions sémantiques OpenTelemetry pour les attributs (http.route, db.system…) plutôt que des noms maison.

Collecteurs #

PratiquePourquoi
memory_limiter puis batch dans chaque pipelineprotéger le collecteur, insérer de gros lots dans ClickHouse
Agent par hôte ou DaemonSet, passerelle centraleenrichir près de la source, centraliser clés et filtrage
File persistante (file_storage)ne rien perdre pendant une indisponibilité de ClickHouse
Échantillonnage en queue (tail_sampling)garder toutes les erreurs et traces lentes, échantillonner le reste au-delà de quelques milliers de spans par seconde
Filtrer le bruit (filter)sondes de santé et logs de debug coûtent du disque sans valeur

2. Stocker #

ClickHouse bien réglé.

Règles #

  • Rétention par signal avec des TTL : par exemple traces 7 jours, logs 14 à 30 jours, agrégats 6 à 13 mois.
  • Stockage par niveaux : disques rapides pour les jours récents, stockage objet pour l'historique.
  • Vues matérialisées pour les dashboards de long terme (RED par minute), plutôt que de rescanner les données brutes.
  • Réplication (deux répliques et ClickHouse Keeper) et sauvegardes testées (BACKUP vers S3, restauration en recette).
  • Ne pas modifier à la main les tables créées par l'outil sans suivre sa documentation : les montées de version peuvent les recréer.

Surveiller la base #

Surveillez ClickHouse indépendamment de la plateforme qu'il héberge : nombre de parts, fusions, requêtes lentes (system.query_log), disque libre, retard de réplication. Si ClickHouse tombe, la plateforme d'observabilité tombe avec lui.

3. Exploiter au quotidien #

Rechercher, alerter, maîtriser les coûts.

Recherche et alertes #

  • Toujours borner la période et filtrer par service : ce sont les colonnes de la clé de tri.
  • Alertes sur les symptômes (taux d'erreurs, latence p95, absence de données), chacune avec un lien et une procédure.
  • Dashboards par service, autour des signaux RED, avec des filtres d'environnement.

Sécurité et coûts #

  • Comptes ClickHouse distincts : écriture pour les collecteurs, lecture limitée (profils de réglages) pour l'interface et les analystes.
  • Clés d'ingestion traitées comme des secrets ; TLS sur les points d'entrée OTLP exposés et sur l'interface ; authentification unique si disponible.
  • Pas de données personnelles dans les attributs (e-mails, jetons) : masquez-les dans le collecteur (processeurs attributes ou transform).
  • Suivre le volume par service chaque semaine : un service bavard se repère et se corrige vite.

Liste de contrôle et vérification #

Avant la mise en production.

Liste de contrôle #

PointVérification
Instrumentationchaque service a service.name et ses logs portent un TraceId
Collecteursotelcol_exporter_send_failed_* à zéro, file persistante configurée
RétentionSHOW CREATE TABLE montre un TTL sur chaque table
Haute disponibilitédeux répliques ou service managé ; collecteurs multiples
Sauvegardesrestauration testée ce trimestre (ClickHouse et base de l'application)
Alerteserreurs, latence et absence de données sur les services critiques, testées
Accèsinterface authentifiée, comptes ClickHouse séparés

Commandes à connaître #

Commandes à connaître
  • SELECT ServiceName, count() FROM otel_logs WHERE Timestamp > now() - INTERVAL 1 DAY GROUP BY ServiceName ORDER BY 2 DESC : volume par service
  • SHOW CREATE TABLE otel_traces : vérifier TTL et clé de tri
  • curl -s localhost:8888/metrics | grep send_failed : envois en échec du collecteur
  • BACKUP DATABASE … TO S3(…) : sauvegarde ClickHouse

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.

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

Mon suivi

  • ⏱ Durée estimée : ≈ 4 min

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

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

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

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

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

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

SigNoz : architecture et installation

Les composants de SigNoz (collecteur OpenTelemetry, ClickHouse, service de requêtes, interface, a...

Alertes et dashboards dans ClickStack

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

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

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

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 !