Bonnes pratiques du tracing distribué avec Jaeger

1. Instrumenter #

Des traces lisibles.

Règles #

• OpenTelemetry partout (SDK ou auto-instrumentation), jamais de client propriétaire.
• Un service.name stable et des attributs de ressource (service.version, deployment.environment).
• Noms de spans à faible cardinalité (GET /commandes/{id}, pas l'URL complète).
• Attributs métier utiles au diagnostic, sans données personnelles.
• Propagation W3C sur tous les services, y compris les files de messages.

2. Exploiter #

Coût et fiabilité.

Réglages #

• Tail sampling qui garde erreurs et traces lentes.
• Rétention de 7 à 14 jours, index journaliers.
• Kafka en tampon au-delà de quelques milliers de spans par seconde.
• Alertes sur les spans refusés ou non exportés.
• Liens depuis les logs (trace_id) et les métriques (exemplars) vers Jaeger.

Schéma de référence et vérification rapide #

Check-list.

Check-list #

1. SDK OpenTelemetry et propagation W3C
2. Jaeger v2 avec stockage persistant
3. Échantillonnage défini
4. SPM activé
5. Rétention et nettoyage des index
6. Supervision des collecteurs