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.
Le traçage est désactivé par défaut. Aucune trace n’est envoyée tant que vous ne l’avez pas activé pour chaque source, comme décrit dans Activer le traçage. Pour bloquer les traces dans toute votre organisation, un Admin de l’organisation peut désactiver l’observabilité.
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 |
| Vibe Work | Activation acte par acte (interrupteur réservé aux Admin dans Studio) | Oui | Oui | Oui |
| Managed Agents | Automatique (activé par défaut dans le worker de l'Agents SDK ; AGENTS_SDK_STUDIO_TRACING_ENABLED=0 le désactive) | 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 de traces :
- Vibe Code CLI
- Vibe Code Web
- Playground de 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 Public 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 hereDésactiver l’observabilité pour votre organisation
Les Admin de l’organisation peuvent désactiver l’observabilité pour toute l’organisation. Utilisez cette option si votre organisation ne souhaite pas que des données de traçage soient collectées ou consultées.
Pour désactiver l’observabilité, ouvrez la page Observabilité dans la console d’administration et désactivez l’interrupteur Observabilité.
La désactivation de l’observabilité au niveau de l’organisation s’applique à tous ses espaces de travail. Les paramètres propres aux espaces de travail, comme le Traçage des conversations, et toute instrumentation que vous avez configurée restent sans effet jusqu’à ce qu’un Admin de l’organisation réactive l’interrupteur.
Vé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 Entreprise où l’Observabilité est activée, et aucun Admin de l’organisation n’a désactivé l’observabilité pour l’organisation.
- 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é.