TP : Ingérer, transformer et échantillonner des traces vers Tempo

Ce que vous allez apprendre dans ce TP

• Recevoir des traces OTLP
• Enrichir les spans
• Appliquer un tail sampling
• Exporter vers Tempo

Introduction #

Ce que vous allez apprendre dans cette section

• Recevoir des traces OTLP
• Enrichir les spans
• Appliquer un tail sampling
• Exporter vers Tempo

Contexte. Les équipes veulent du tracing distribué, mais conserver 100 % des traces coûterait trop cher. Vous mettez en place un pipeline qui reçoit, enrichit et échantillonne intelligemment les traces avant de les envoyer à Tempo.

Prérequis : TP « Premier pipeline » réalisé, notions OpenTelemetry  ·  Durée estimée : 45 min

Vous allez ajouter un service Tempo à la stack Docker Compose puis construire un pipeline de traces : receiver → processors → exporter.

Préparer Tempo #

Un backend de traces minimal.

1. 1. Configurer et démarrer Tempo

   Pourquoi ? Tempo est le backend qui stocke les traces : il faut un récepteur OTLP et un stockage avant de pouvoir y envoyer quoi que ce soit.

   Écrivez un fichier tempo.yaml minimal (récepteur OTLP gRPC, stockage local) et ajoutez le service tempo au Compose.

Le pipeline de traces #

Récepteur, processeurs et exportateur otelcol.

1. 2. Recevoir les traces

   Pourquoi ? Alloy joue le rôle de point d'entrée unique : les applications ne connaissent qu'un endpoint OTLP et ignorent où vont les traces.

   Déclarez un otelcol.receiver.otlp dont la sortie traces alimente un processeur d'attributs.

2. 3. Enrichir les spans

   Pourquoi ? Ajouter l'environnement à chaque span permet ensuite de filtrer les traces par environnement sans modifier le code des applications.

   Ajoutez l'attribut deployment.environment="lab" à chaque span avec otelcol.processor.attributes.

3. 4. Appliquer un tail sampling

   Pourquoi ? Les erreurs et les traces lentes sont celles qu'on cherche réellement ; en garder 100 % et seulement 10 % du reste réduit fortement le volume sans perdre l'essentiel.

   Conservez 100 % des traces en erreur et 10 % des autres. Pourquoi un échantillonnage « tail » plutôt que « head » pour garder les erreurs ?

4. 5. Exporter vers Tempo et vérifier

   Pourquoi ? Un exporter sans TLS convient au laboratoire mais pas à la production : le vérifier de bout en bout avec des traces générées valide le chemin complet.

   Exportez en OTLP vers tempo:4317 (sans TLS dans ce lab), générez des traces avec telemetrygen puis retrouvez-les dans Grafana (source de données Tempo).

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