TP : Instrumenter une application Python vers Jaeger

Ce que vous allez apprendre dans ce TP

• Auto-instrumenter une application
• Ajouter des spans et attributs
• Rechercher par tag

Introduction #

Ce que vous allez apprendre dans cette section

• Auto-instrumenter une application
• Ajouter des spans et attributs
• Rechercher par tag

Contexte. Votre équipe développe une API Python sans aucune trace. Vous l'instrumentez sans réécrire le code, puis ajoutez le contexte métier.

Prérequis : TP précédent terminé, Python 3  ·  Durée estimée : 45 min

Une API Python tracée de bout en bout.

Mise en place #

Étapes guidées, avec leur correction.

1. 1. Écrire l'API

   Pourquoi ? Une API qui appelle un service externe produit une trace à plusieurs spans.

   Créez app.py avec une route qui appelle httpbin.

2. 2. Auto-instrumenter

   Pourquoi ? opentelemetry-instrument ajoute les instrumentations Flask et requests sans toucher au code.

   Installez la distribution OpenTelemetry et lancez l'application instrumentée.

3. 3. Générer et observer

   Pourquoi ? Chaque appel crée une trace serveur (Flask) avec un span client (requests).

   Appelez la route une vingtaine de fois et ouvrez une trace du service stock.

4. 4. Ajouter un span métier

   Pourquoi ? Les spans automatiques ne disent rien du métier : un span et des attributs le complètent.

   Ajoutez un span verifier_stock avec l'attribut produit.id autour de l'appel externe.

5. 5. Rechercher par tag

   Pourquoi ? Retrouver la trace d'un produit précis, comme le ferait le support.

   Relancez l'application, refaites des appels et cherchez dans Jaeger les traces avec le tag produit.id=7 et une durée minimale de 1 s.

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