Représenter chaque requête comme une trace complète
J'attribue un identifiant unique à tout le parcours utilisateur et je représente les opérations importantes sous forme de spans :- réception de la demande, contexte utilisateur et workflow choisi ;
- transformation de requête et périmètre des sources ;
- candidats du retrieval, filtres et reranking ;
- appels de modèle avec configuration, tokens et latence ;
- appels d'outils avec entrées validées et résultats structurés ;
- contrôles de sécurité, privacy et autorisation ;
- réponse finale, citations, fallback et feedback utilisateur.
Combiner signaux opérationnels, qualité et résultat
Les métriques d'infrastructure restent nécessaires : volume, erreurs, saturation et percentiles de latence. Les workflows LLM ajoutent d'autres dimensions :| Dimension | Signaux utiles | Valeur pour le diagnostic |
|---|---|---|
| Exécution | Retries, routage, fallback, état final | Révèle l'orchestration défaillante |
| Preuves | Couverture du retrieval, citations, fraîcheur | Sépare données et recherche |
| Qualité | Groundedness, tâche réussie, correction experte | Indique si le résultat est acceptable |
| Efficacité | Tokens, appels, cache, coût par tâche | Relie dépense et travail réussi |
| Sécurité | Blocages, redaction, escalade, autorisation | Expose le comportement des contrôles |
| Produit | Reformulations, abandon, résultat accepté | Relie qualité technique et usage |
Préserver le diagnostic sans tout collecter
Les prompts, documents récupérés et réponses peuvent contenir des données personnelles, confidentielles ou réglementées. L'instrumentation doit donc appliquer la minimisation :- classifier les champs avant de les instrumenter ;
- masquer ou hacher les attributs sensibles lorsque c'est possible ;
- séparer les métadonnées opérationnelles des payloads protégés ;
- définir accès et rétention selon la classe de données ;
- échantillonner le contenu uniquement pour un objectif de diagnostic défini ;
- préserver les permissions utilisateur et source dans l'accès aux traces.
Construire des alertes autour des décisions et des clusters d'échecs
Une alerte doit identifier une action, pas seulement un mouvement de métrique. Son contenu utile inclut le workflow et le segment affectés, les versions candidate et baseline, la taille de l'échantillon, des traces représentatives, la couche probablement en cause, l'owner et la réponse sûre. Les politiques varient selon l'échec :- une violation déterministe de sécurité ou d'autorisation peut exiger un blocage immédiat ;
- une panne d'intégration peut activer un fallback en lecture seule ;
- une régression de release peut arrêter le rollout ;
- une dérive progressive de qualité peut déclencher une enquête et la mise à jour du dataset ;
- une hausse de coût sans amélioration du résultat peut conduire à revoir routage ou prompt.