Preskúmaj: Vyhľadávaj a kontroluj produkčné stopy
Na tejto strane
Lekcia prepísaná 2. novembra 2026 na základe stránok Mistral Send traces a Explore traces a SDK
mistralaiverzie 3.7.0: Explorer sa zameriava na stopy OpenTelemetry dotazované pomocou jazyka vyhľadávacieho výrazu; staršia metódachat_completion_events.searchuž neexistuje. Zdroje: Send traces · Explore traces.
Explorer: Tvoje okno do produkcie
Trace Explorer je miesto, kde vyhľadávaš, filtruješ a kontroluješ každú stopu prechádzajúcu tvojimi aplikáciami umelej inteligencie. Nájdeš ho v Studiu pod Observability → Traces. Stopy sa tam však nezobrazia, pokiaľ ich najprv nepovolíš: sledovanie je predvolene vypnuté.
Odosielanie stôp
Pomocou Python SDK si nainštaluj rozšírenie telemetrie (mistralai[telemetry], verzia 2.4.13 alebo novšia) a potom ho povoľ na klientovi:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Od tohto momentu SDK automaticky sleduje volania modelov, vektory (embeddings), operácie agentov, dokončenia FIM a OCR. Volania tvojich vlastných nástrojov sa predvolene nesledujú: musíš pridať ich rozsahy (spans) pomocou trasovača SDK.
from mistralai.extra.observability import get_telemetry_tracer
tracer = get_telemetry_tracer(client, "agent-support")
with tracer.start_as_current_span("invoke_agent"):
response = client.chat.complete(
model="mistral-small-latest",
messages=[{"role": "user", "content": "What is the status of order 4521?"}],
)
with tracer.start_as_current_span("execute_tool order_tracking") as span_tool:
span_tool.set_attribute("gen_ai.tool.name", "order_tracking")
span_tool.set_attribute("gen_ai.tool.call.arguments", "4521")
# call your tool here
Iné zdroje sa správajú odlišne: Workflows sledujú každé vykonanie hneď, ako je na službe nastavené OTEL_ENABLED=true, zatiaľ čo Vibe Work sa aktivuje cez nastavenie administrátora v Studiu. TypeScript SDK ponúka configureTelemetry. Naopak, Vibe Code (CLI a Web) a Studio Playground stopy neodosielajú. Všetky zdroje pred exportom predvolene redigujú časť údajov; stránka Data redaction podrobne opisuje túto zásadu a spôsob jej úpravy.
Čo obsahuje stopa
Stopa je strom rozsahov (spans), kde každý rozsah predstavuje operáciu v reťazci:
| Pole | Obsah |
|---|---|
| Trace ID | Identifikátor celého reťazca vykonávania |
| Spans | Operácie: volania modelov, volania nástrojov, kroky workflow |
| Duration | Čas pre každý rozsah a celú stopu |
| Tokens | Vstupné a výstupné tokeny pre každé volanie modelu |
| Status | Úspech alebo chyba, vrátane chybovej správy |
| Source | Pôvodný produkt: SDK, Workflows, Vibe Work |
| Tags | Štítky aplikované SDK a automatické metadáta, ako je model |
Kliknutím na stopu otvoríš jej strom rozsahov; každý rozsah sa rozbalí a zobrazí vstup, výstup, latenciu a tokeny.
Jazyk vyhľadávania
Explorer prijíma jazyk výrazov: podmienky pre polia stôp kombinované pomocou AND, OR a NOT.
| Kategória | Operátory | Príklad |
|---|---|---|
| Porovnanie | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Vzorec | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Podreťazec | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Regulárny výraz | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Rozsah | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Zoznam | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Prítomnosť | EXISTS, NOT EXISTS | error_message EXISTS |
Dostupné polia zahŕňajú service_name, status_code (Ok alebo Error), duration_ns (v nanosekundách), error_message, start_time, models_used (zoznam) a akýkoľvek atribút rozsahu pomocou syntaxe zátvoriek: span_attributes['gen_ai.request.model']. Pre zoznamy funkcie has(models_used, 'mistral-medium-latest'), hasany(...) a hasall(...) dopĺňajú operátor CONTAINS.
# Všetky neúspešné stopy zo služby
service_name = 'agent-support' AND status_code = 'Error'
# Stopy dlhšie ako 5 sekúnd
duration_ns > 5000000000
# Stopy, ktoré volali konkrétny model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Ak vyhľadávanie nevráti žiadne výsledky, odstráň všetky podmienky okrem časového rozsahu a potom ich pridávaj späť jednu po druhej. Častou chybou je filtrovanie podľa status_code = 'Error', keď väčšina stôp úspešne prebehne.
Dotazovanie na stopy cez SDK
Rovnaké vyhľadávania môžeš vykonávať programovo v rámci časového rozsahu:
from datetime import datetime, timedelta, timezone
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
now = datetime.now(timezone.utc)
response = client.beta.observability.traces.search(
from_=now - timedelta(days=1),
to=now,
search_expression="service_name = 'agent-support' AND status_code = 'Error'",
page_size=50,
)
for trace in response.traces.results or []:
print(f"{trace.trace_id} {trace.root_span_name} : {trace.duration_ns / 1e9:.1f} s")
Odozva využíva stránkovanie založené na kurzore. Referencia API dokumentuje koncové body Traces a Spans (vyhľadávanie, jednotlivá stopa, možné polia a hodnoty, rozsahy stopy).
Pridávanie rozsahov do datasetu
Explorer slúži aj ako východiskový bod pre testovacie datasety. Zo stopy ponúka menu rozsahu možnosť Add span to dataset; v zobrazení Spans môžeš naraz vybrať až 500 položiek a namapovať každé pole rozsahu na pole záznamu. Táto funkcia súvisí s offline hodnoteniami, ktoré sú vyhradené pre organizácie Enterprise (Lekcia 15).
Kľúčové poznatky
- Sledovanie je predvolene vypnuté:
configure_telemetry(client)ho povoľuje pre Python SDK,OTEL_ENABLED=truepre Workflows - Volania modelov sa sledujú automaticky; volania nástrojov vyžadujú manuálne sledovanie pomocou
get_telemetry_tracer - Explorer filtruje stopy pomocou jazyka výrazov (
service_name,status_code,duration_ns,span_attributes['…']) - SDK poskytuje rovnakú vyhľadávaciu schopnosť:
client.beta.observability.traces.search(search_expression=...) - Zaujímavé rozsahy sa stanú záznamami datasetu jediným kliknutím alebo v dávkach po 500