Traçage manuel
Alors que le traçage automatique de MLflow offre une observabilité instantanée pour les frameworks pris en charge, le traçage manuel vous donne un contrôle complet sur la façon dont vos applications GenAI sont instrumentées. Cette flexibilité est essentielle pour créer des applications prêtes pour la production qui nécessitent des capacités de monitoring et de debugging détaillées.
Quand utiliser le traçage manuel
Le traçage manuel est le bon choix lorsque vous avez besoin de :
Contrôle granulaire de la structure des traces
- Définissez exactement les parties de votre code à tracer.
- Créer des hiérarchies de spans personnalisées
- Contrôler les limites et les relations des étendues
Instrumentation de framework personnalisée
- Instrumenter les frameworks propriétaires ou internes
- Ajouter le suivi aux wrappers LLM personnalisés
- Prise en charge de nouvelles bibliothèques avant l'intégration officielle
Scénarios de workflows avancés
- Opérations multithreadées ou asynchrones
- Réponses en streaming avec agrégation personnalisée
- Opérations imbriquées complexes
- Métadonnées de trace personnalisées et attributs
Quelle API dois-je utiliser ?
Choisissez la bonne approche de traçage manuel pour vos besoins :
Fonctionnalité | |||
|---|---|---|---|
Cas d'usage | Tracez des fonctions entières avec un décorateur d'une ligne. Modifications de code minimales requises. | Tracez des blocs de code arbitraires au sein des fonctions pour un contrôle précis. | Contrôle direct sur le cycle de vie des traces pour les scénarios complexes. |
Parent-enfant automatique | Oui | Oui | Non - gestion manuelle |
Gestion des exceptions | Automatic | Automatic | Manuel |
Fonctionne avec Auto-trace | Oui | Oui | Non |
Sécurité des threads | Automatic | Automatic | Manuel |
ID de trace personnalisés | Non | Non | Oui |