TP : Instrumenter une application Python avec OpenTelemetry

Ce que vous allez apprendre dans ce TP

• Auto-instrumenter une API
• Ajouter un span manuel
• Retrouver la trace

L'application #

Ce que vous allez apprendre dans cette section

• Auto-instrumenter une API
• Ajouter un span manuel
• Retrouver la trace

Contexte. Une petite API Python n'émet encore aucune trace. Vous l'instrumentez avec OpenTelemetry, sans réécrire sa logique, puis vous ajoutez un span métier pour mesurer une étape précise (calcul de remise).

Prérequis : TP précédent (Tempo), Python 3  ·  Durée estimée : 40 min

Une API qui appelle une seconde API.

1. 1. Créer l'application

   Pourquoi ? Une application minimale suffit pour s'exercer ; l'important est de voir comment l'instrumentation s'ajoute sans modifier les routes.

   Écrivez une application Flask avec une route /commande qui attend 100 ms.

2. 2. Auto-instrumenter

   Pourquoi ? L'auto-instrumentation crée automatiquement des spans pour les requêtes HTTP : c'est le moyen le plus rapide d'obtenir une première visibilité.

   Installez les paquets OpenTelemetry et lancez l'application avec l'agent.

3. 3. Ajouter un span manuel

   Pourquoi ? Les spans manuels apportent le contexte métier que l'auto-instrumentation ne peut pas deviner (remise, type de client).

   Ajoutez un span calcul_remise avec un attribut remise.pourcent.

4. 4. Retrouver la trace

   Pourquoi ? Filtrer par nom et durée montre comment isoler une opération lente parmi des milliers de traces.

   Cherchez les traces dont le span calcul_remise dure plus de 50 ms.

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