Průzkumník: Vyhledávání a inspekce produkčních stop
Na této stránce
Lekce přepsána 2. listopadu 2026 na základě stránek Mistral Send traces a Explore traces a SDK
mistralaiverze 3.7.0: Průzkumník se zaměřuje na stopy OpenTelemetry dotazované pomocí vyhledávacího jazyka výrazů; zastaralá metodachat_completion_events.searchjiž neexistuje. Zdroje: Send traces · Explore traces.
Průzkumník: Tvé okno do produkce
Průzkumník stop (Trace Explorer) je místo, kde vyhledáváš, filtruješ a kontroluješ každou stopu procházející tvými aplikacemi s umělou inteligencí. Najdeš jej ve Studiu v sekci Observability → Traces. Stopy se zde však nezobrazí, pokud je nejprve nepovolíš: trasování je ve výchozím nastavení vypnuté.
Odesílání stop
Při použití Python SDK nainstaluj rozšíření pro telemetrii (mistralai[telemetry], verze 2.4.13 nebo novější) a poté jej povol 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 tohoto okamžiku SDK automaticky trasuje volání modelů, vnoření (embeddings), operace agentů, dokončování FIM a OCR. Volání tvých vlastních nástrojů nejsou ve výchozím nastavení trasována: musíš přidat jejich rozsahy (spans) pomocí trasovače 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
Jiné zdroje se chovají odlišně: Workflows trasují každé spuštění, jakmile je na službě nastaveno OTEL_ENABLED=true, zatímco Vibe Work se aktivuje prostřednictvím nastavení správce ve Studiu. TypeScript SDK nabízí configureTelemetry. Naproti tomu Vibe Code (CLI a Web) a Studio Playground stopy neodesílají. Všechny zdroje ve výchozím nastavení před exportem část dat redigují; stránka Data redaction podrobně popisuje tuto zásadu a způsob její úpravy.
Co stopa obsahuje
Stopa je strom rozsahů (spans), kde každý rozsah představuje operaci v řetězci:
| Pole | Obsah |
|---|---|
| Trace ID | Identifikátor celého řetězce provádění |
| Spans | Operace: volání modelů, volání nástrojů, kroky workflow |
| Duration | Doba trvání každého rozsahu a celé stopy |
| Tokens | Vstupní a výstupní tokeny pro každé volání modelu |
| Status | Úspěch nebo chyba, včetně chybové zprávy |
| Source | Původní produkt: SDK, Workflows, Vibe Work |
| Tags | Štítky aplikované SDK a automatická metadata, jako je model |
Kliknutím na stopu otevřeš její strom rozsahů; každý rozsah se rozbalí a zobrazí vstup, výstup, latenci a tokeny.
Vyhledávací jazyk
Průzkumník přijímá jazyk výrazů: podmínky pro pole stop kombinované pomocí AND, OR a NOT.
| Kategorie | Operátory | Příklad |
|---|---|---|
| Porovnání | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Vzor | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Podřetězec | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Regulární výraz | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Rozsah | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Seznam | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Existence | EXISTS, NOT EXISTS | error_message EXISTS |
Mezi dostupná pole patří service_name, status_code (Ok nebo Error), duration_ns (v nanosekundách), error_message, start_time, models_used (seznam) a jakýkoli atribut rozsahu pomocí syntaxe závorek: span_attributes['gen_ai.request.model']. Pro seznamy funkce has(models_used, 'mistral-medium-latest'), hasany(...) a hasall(...) doplňují operátor CONTAINS.
# Všechny neúspěšné stopy ze služby
service_name = 'agent-support' AND status_code = 'Error'
# Stopy delší než 5 sekund
duration_ns > 5000000000
# Stopy, které volaly konkrétní model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Pokud vyhledávání nevrátí žádné výsledky, odstraň všechny podmínky kromě časového rozsahu a poté je znovu přidávej po jedné. Častou chybou je filtrování podle status_code = 'Error', když většina stop uspěje.
Dotazování na stopy prostřednictvím SDK
Stejné vyhledávání můžeš provádět programově 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")
Odpověď využívá stránkování založené na kurzoru. Reference API dokumentuje koncové body Traces a Spans (vyhledávání, jednotlivá stopa, možná pole a hodnoty, rozsahy stopy).
Přidávání rozsahů do datové sady
Průzkumník slouží také jako výchozí bod pro testovací datové sady. Ze stopy nabízí nabídka rozsahu možnost Add span to dataset; v zobrazení Spans můžeš najednou vybrat až 500 položek a namapovat každé pole rozsahu na pole záznamu. Tato funkce souvisí s offline evaluacemi, které jsou vyhrazeny pro organizace Enterprise (lekce 15).
Klíčové poznatky
- Trasování je ve výchozím nastavení vypnuto:
configure_telemetry(client)jej povolí pro Python SDK,OTEL_ENABLED=truepro Workflows - Volání modelů jsou trasována automaticky; volání nástrojů vyžadují ruční trasování pomocí
get_telemetry_tracer - Průzkumník filtruje stopy pomocí jazyka výrazů (
service_name,status_code,duration_ns,span_attributes['…']) - SDK poskytuje stejnou funkci vyhledávání:
client.beta.observability.traces.search(search_expression=...) - Zajímavé rozsahy se stanou záznamy datové sady jedním kliknutím nebo v dávkách po 500