Envoyer des traces
Cette page explique comment instrumenter chaque source de données prise en charge afin qu'elle envoie des traces OpenTelemetry à Mistral. Une fois les traces transmises, vous pouvez les explorer dans l'Explorateur de traces.
L'envoi de traces nécessite uniquement une clé API Mistral valide : aucun critère d'activation ou rôle spécial n'est requis.
Couverture par intégration
| Intégration | Activation | Appels LLM | Appels d'outils | Étendues d'agent |
|---|---|---|---|---|
| SDK Mistral (Python) | Activation acte par acte (configure_telemetry) | Oui | Manuelle, via get_telemetry_tracer | Oui |
| SDK Mistral (TypeScript) | Activation acte par acte (configureTelemetry) | Oui | Manuelle, via getTelemetryTracer | Oui |
| workflow | Automatique (OTEL_ENABLED=true sur le service) | Oui | Oui | Non applicable |
| CLI Vibe Code | Activation acte par acte (enable_otel = true) | Oui | Oui | Oui |
| Vibe Work | option Admin dans Studio | Oui | Oui | Oui |
Toutes les sources ci-dessus masquent les passages côté client avant l'export par défaut. Consultez Masquage des données pour examiner la politique ou modifier les éléments masqués.
Les produits Mistral suivants n'envoient pas encore de traces :
- Vibe Code Web (basé sur navigateur)
- Bac à sable AI Studio
Activer le traçage
Prérequis : SDK Mistral Python avec l'extra telemetry. Les exemples de code nécessitent mistralai[telemetry] >= 2.4.13.
L'observabilité est en Private Preview et l'intégration du SDK évolue rapidement, nous recommandons d'utiliser la dernière version du SDK.
uv add "mistralai[telemetry]"Pour plus de détails, consultez le README d'observabilité du SDK et les exemples.
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)Après cet appel, le SDK génère automatiquement des traces pour tous les appels LLM, les embeddings, les opérations d'agent, les complétions FIM et les requêtes OCR.
Ajouter manuellement des étendues pour les outils :
Les appels d'outils au sein de votre application ne sont pas traçables automatiquement. Utilisez get_telemetry_tracer pour les ajouter :
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry, get_telemetry_tracer
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
tracer = get_telemetry_tracer(client, "my-agent")
with tracer.start_as_current_span("invoke_agent"):
response = client.chat.complete(
model="mistral-small-latest",
messages=[{"role": "user", "content": "Search for recent news."}],
)
with tracer.start_as_current_span("execute_tool web_search") as tool_span:
tool_span.set_attribute("gen_ai.tool.name", "web_search")
tool_span.set_attribute("gen_ai.tool.call.arguments", "recent news")
# run your tool hereVérifier que les traces arrivent
Après avoir activé l'instrumentation, effectuez une ou plusieurs requêtes via votre application, puis ouvrez l'Explorateur de traces dans Studio. Les traces apparaissent généralement en quelques secondes.
Si vous ne voyez aucune trace, vérifiez les points suivants :
- Votre clé API appartient à un espace de travail Enterprise avec l'Observabilité activée.
- Vous avez appelé
configure_telemetry(client)(ou l'équivalent TypeScript) avant d'effectuer des appels API. - Votre rôle dans l'espace de travail est Admin d'Organisation, Admin d'espace de travail ou Visionneuse Observabilité.