Traçage Phoenix

Guide complet pour instrumenter les applications LLM avec le traçage OpenInference dans Phoenix. Contient des fichiers de référence couvrant la configuration, l'instrumentation, les types de spans et le déploiement en production.

Quand l'utiliser

Consultez ces directives quand :

• Vous configurez le traçage Phoenix (Python ou TypeScript)
• Vous créez des spans personnalisés pour les opérations LLM
• Vous ajoutez des attributs suivant les conventions OpenInference
• Vous déployez le traçage en production
• Vous interrogez et analysez les données de traçage

Catégories de référence

Référence rapide

1. Setup (COMMENCEZ ICI)

• setup-python - Installer arize-phoenix-otel, configurer l'endpoint
• setup-typescript - Installer @arizeai/phoenix-otel, configurer l'endpoint

2. Instrumentation

• instrumentation-auto-python - Auto-instrumenter OpenAI, LangChain, etc.
• instrumentation-auto-typescript - Auto-instrumenter les frameworks supportés
• instrumentation-manual-python - Spans personnalisés avec décorateurs
• instrumentation-manual-typescript - Spans personnalisés avec wrappers

3. Types de spans (avec schémas d'attributs complets)

• span-llm - Appels API LLM (modèle, tokens, messages, coût)
• span-chain - Workflows et pipelines multi-étapes
• span-retriever - Récupération de documents (documents, scores)
• span-tool - Appels de fonction/API (nom, paramètres)
• span-agent - Agents de raisonnement multi-étapes
• span-embedding - Génération de vecteurs
• span-reranker - Réclassement de documents
• span-guardrail - Vérifications de sécurité
• span-evaluator - Évaluation LLM

4. Organisation

• projects-python / projects-typescript - Grouper les traces par application
• sessions-python / sessions-typescript - Suivre les conversations

5. Enrichissement

• metadata-python / metadata-typescript - Attributs personnalisés

6. Production (CRITIQUE)

• production-python / production-typescript - Traitement par batch, masquage de PII

7. Feedback

• annotations-overview - Concepts de feedback
• annotations-python / annotations-typescript - Ajouter du feedback aux spans

Fichiers de référence

• fundamentals-overview - Bases des traces, spans, attributs
• fundamentals-required-attributes - Champs obligatoires par type de span
• fundamentals-universal-attributes - Attributs communs (user.id, session.id)
• fundamentals-flattening - Règles d'aplatissement JSON
• attributes-messages - Format de message de chat
• attributes-metadata - Schéma de métadonnées personnalisées
• attributes-graph - Attributs de workflow agent
• attributes-exceptions - Suivi des erreurs

Workflows courants

• Démarrage rapide : setup-{lang} → instrumentation-auto-{lang} → Vérifier Phoenix
• Spans personnalisés : setup-{lang} → instrumentation-manual-{lang} → span-{type}
• Suivi de session : sessions-{lang} pour les patrons de groupage de conversations
• Production : production-{lang} pour le batching, le masquage et le déploiement

Comment utiliser cette compétence

Patrons de navigation :

# Par préfixe de catégorie
references/setup-*              # Installation et configuration
references/instrumentation-*    # Traçage auto et manuel
references/span-*               # Spécifications de type de span
references/sessions-*           # Suivi de session
references/production-*         # Déploiement en production
references/fundamentals-*       # Concepts fondamentaux
references/attributes-*         # Spécifications d'attributs

# Par langage
references/*-python.md          # Implémentations Python
references/*-typescript.md      # Implémentations TypeScript

Ordre de lecture :

1. Commencez avec setup-{lang} pour votre langage
2. Choisissez instrumentation-auto-{lang} OU instrumentation-manual-{lang}
3. Consultez les fichiers span-{type} selon les besoins pour des opérations spécifiques
4. Consultez les fichiers fundamentals-* pour les spécifications d'attributs

Références

Documentation Phoenix :

• Documentation Phoenix
• Spécification OpenInference

Documentation API Python :

• Package OTEL Python - Référence API arize-phoenix-otel
• Package Client Python - Référence API arize-phoenix-client

Documentation TypeScript :

• Packages TypeScript - @arizeai/phoenix-otel, @arizeai/phoenix-client et autres packages TypeScript