Raziskovanje: Iskanje in pregled sledi v proizvodnji
Na tej strani
Lekcija ponovno napisana 2. novembra 2026 na podlagi strani Send traces in Explore traces ter SDK-ja
mistralairazličice 3.7.0: Raziskovalnik se osredotoča na sledi OpenTelemetry, poizvedovane z iskalnim jezikom izrazov; zastarela metodachat_completion_events.searchne obstaja več. Viri: Send traces · Explore traces.
Raziskovalnik: Tvoje okno v proizvodnjo
Raziskovalnik sledi (Trace Explorer) je mesto, kjer iščeš, filtriraš in pregleduješ vsako sled, ki teče skozi tvoje aplikacije z umetno inteligenco. Najdeš ga v Studiu pod Observability → Traces. Vendar se sledi tam ne bodo pojavile, če jih najprej ne omogočiš: sledenje je privzeto onemogočeno.
Pošiljanje sledi
S Python SDK namesti razširitev za telemetrijo (mistralai[telemetry], različica 2.4.13 ali novejša) in jo nato omogoči v odjemalcu:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Od tega trenutka naprej SDK samodejno sledi klicem modelov, vgradnjam (embeddings), operacijam agentov, dopolnitvam FIM in OCR. Klici tvojih lastnih orodij niso samodejno sledeni: njihove razpone (spans) moraš dodati ročno z uporabo sledilnika 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
Drugi viri se obnašajo drugače: delovni tokovi (Workflows) sledijo vsakemu izvajanju, takoj ko je na storitvi nastavljeno OTEL_ENABLED=true, medtem ko se Vibe Work aktivira preko administratorske nastavitve v Studiu. TypeScript SDK ponuja configureTelemetry. Po drugi strani Vibe Code (CLI in Web) in Studio Playground ne pošiljata sledi. Vsi viri privzeto pred izvozom delno anonimizirajo podatke; stran Data redaction podrobneje opisuje to politiko in način njenega prilagajanja.
Kaj vsebuje sled
Sled je drevo razponov (spans), kjer vsak razpon predstavlja operacijo v verigi:
| Polje | Vsebina |
|---|---|
| Trace ID | Identifikator celotne verige izvajanja |
| Spans | Operacije: klici modelov, klici orodij, koraki delovnega toka |
| Duration | Čas trajanja za vsak razpon in celotno sled |
| Tokens | Vhodni in izhodni žetoni za vsak klic modela |
| Status | Uspeh ali napaka, vključno s sporočilom o napaki |
| Source | Izvorni izdelek: SDK, Workflows, Vibe Work |
| Tags | Oznake, ki jih doda SDK, in samodejni metapodatki, kot je model |
Klik na sled odpre njeno drevo razponov; vsak razpon se razširi in prikaže vhod, izhod, zakasnitev in žetone.
Iskalni jezik
Raziskovalnik sprejema jezik izrazov: pogoje za polja sledi, združene z AND, OR in NOT.
| Kategorija | Operatorji | Primer |
|---|---|---|
| Primerjava | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Vzorec | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Podniz | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Regularni izraz | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Obseg | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Seznam | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Prisotnost | EXISTS, NOT EXISTS | error_message EXISTS |
Razpoložljiva polja vključujejo service_name, status_code (Ok ali Error), duration_ns (v nanosekundah), error_message, start_time, models_used (seznam) in poljuben atribut razpona z uporabo oglate oklepaje: span_attributes['gen_ai.request.model']. Za sezname funkciji has(models_used, 'mistral-medium-latest'), hasany(...) in hasall(...) dopolnjujeta operator CONTAINS.
# Vse neuspešne sledi iz storitve
service_name = 'agent-support' AND status_code = 'Error'
# Sledi, daljše od 5 sekund
duration_ns > 5000000000
# Sledi, ki so poklicale določen model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Če iskanje ne vrne rezultatov, odstrani vse pogoje razen časovnega obsega in jih nato dodajaj po enem. Pogosta napaka je filtriranje po status_code = 'Error', čeprav je večina sledi uspešnih.
Poizvedovanje po sledih prek SDK
Enaka iskanja lahko izvajaš programsko v določenem časovnem obsegu:
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")
Odgovor uporablja paginacijo na osnovi kazalca. Referenca API dokumentira končni točki Traces in Spans (iskanje, posamezna sled, možna polja in vrednosti, razponi sledi).
Dodajanje razponov v nabor podatkov
Raziskovalnik služi tudi kot izhodišče za testne nabore podatkov. Iz menija razpona znotraj sledi izberi Add span to dataset; v pogledu Spans lahko hkrati izbereš do 500 razponov in preslikaš vsako polje razpona v polje zapisa. Ta funkcija je povezana z offline evalvacijami, ki so rezervirane za organizacije Enterprise (lekcija 15).
Ključne ugotovitve
- Sledenje je privzeto onemogočeno:
configure_telemetry(client)ga omogoči za Python SDK,OTEL_ENABLED=truepa za Workflows - Klici modelov so samodejno sledeni; klici orodij zahtevajo ročno sledenje z
get_telemetry_tracer - Raziskovalnik filtrira sledi z uporabo jezika izrazov (
service_name,status_code,duration_ns,span_attributes['…']) - SDK omogoča enako možnost iskanja:
client.beta.observability.traces.search(search_expression=...) - Zanimivi razponi postanejo zapisi v naboru podatkov z enim klikom ali v serijah po 500