Istraži: Pretraživanje i inspekcija produkcijskih tragova
Na ovoj stranici
Lekcija je ponovno napisana 2. studenoga 2026. na temelju Mistralovih stranica Send traces i Explore traces te SDK-a
mistralaiverzije 3.7.0: Explorer se fokusira na OpenTelemetry tragove upitane putem jezika za izraze pretraživanja; zastarjela metodachat_completion_events.searchviše ne postoji. Izvori: Send traces · Explore traces.
Explorer: Tvoj prozor u produkciju
Trace Explorer mjesto je gdje pretražuješ, filtriraš i inspektiraš svaki trag koji prolazi kroz tvoje AI aplikacije. Pronaći ćeš ga u Studiju pod Observability → Traces. Međutim, tragovi se tamo neće pojaviti ako ih prvo ne omogućiš: praćenje je prema zadanim postavkama onemogućeno.
Slanje tragova
Koristeći Python SDK, instaliraj proširenje za telemetriju (mistralai[telemetry], verzija 2.4.13 ili novija), a zatim ga omogući na klijentu:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Od tog trenutka, SDK automatski prati pozive modela, ugradnje (embeddings), operacije agenata, FIM kompletiranja i OCR. Pozivi tvojim vlastitim alatima nisu automatski praćeni: moraš dodati njihove raspone (spans) koristeći tracer iz SDK-a.
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
Ostali izvori ponašaju se drugačije: Workflows prate svako izvršenje čim je na servisu postavljeno OTEL_ENABLED=true, dok se Vibe Work aktivira putem administratorske postavke u Studiju. TypeScript SDK nudi configureTelemetry. Suprotno tome, Vibe Code (CLI i Web) i Studio Playground ne šalju tragove. Svi izvori prema zadanim postavkama anonimiziraju dio podataka prije izvoza; stranica Data redaction detaljno opisuje ovu politiku i način njezine prilagodbe.
Što trag sadrži
Trag je stablo raspona (spans), gdje svaki raspon predstavlja operaciju u lancu:
| Polje | Sadržaj |
|---|---|
| Trace ID | Identifikator cijelog lanca izvršavanja |
| Spans | Operacije: pozivi modela, pozivi alata, koraci workflowa |
| Duration | Vrijeme trajanja svakog raspona i cijelog traga |
| Tokens | Ulazni i izlazni tokeni za svaki poziv modela |
| Status | Uspjeh ili pogreška, uključujući poruku o pogrešci |
| Source | Izvorni proizvod: SDK, Workflows, Vibe Work |
| Tags | Oznake koje primjenjuje SDK i automatski metapodaci, poput modela |
Klikom na trag otvara se njegovo stablo raspona; svaki se raspon može proširiti kako bi se prikazali ulaz, izlaz, latencija i tokeni.
Jezik pretraživanja
Explorer prihvaća jezik izraza: uvjete na poljima tragova kombinirane s AND, OR i NOT.
| Kategorija | Operatori | Primjer |
|---|---|---|
| Usporedba | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Uzorak | 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-' |
| Raspon | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Popis | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Prisutnost | EXISTS, NOT EXISTS | error_message EXISTS |
Dostupna polja uključuju service_name, status_code (Ok ili Error), duration_ns (u nanosekundama), error_message, start_time, models_used (popis) te bilo koji atribut raspona koristeći sintaksu s uglatim zagradama: span_attributes['gen_ai.request.model']. Za popise, funkcije has(models_used, 'mistral-medium-latest'), hasany(...) i hasall(...) nadopunjuju CONTAINS.
# Svi neuspjeli tragovi iz servisa
service_name = 'agent-support' AND status_code = 'Error'
# Tragovi dulji od 5 sekundi
duration_ns > 5000000000
# Tragovi koji su pozvali određeni model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Ako pretraživanje ne vrati rezultate, ukloni sve uvjete osim vremenskog raspona, a zatim ih ponovno dodaj jedan po jedan. Česta je pogreška filtriranje po status_code = 'Error' kada većina tragova uspije.
Upitivanje tragova putem SDK-a
Iste pretrage možeš programski izvršiti unutar vremenskog raspona:
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 koristi paginaciju temeljenu na kursoru. Referenca API-ja dokumentira krajnje točke Traces i Spans (pretraživanje, pojedinačni trag, moguća polja i vrijednosti, rasponi traga).
Dodavanje raspona u skup podataka
Explorer također služi kao polazište za testne skupove podataka. Iz traga, izbornik raspona nudi opciju Add span to dataset; u prikazu Spans možeš odabrati do 500 odjednom i mapirati svako polje raspona na polje zapisa. Ova se funkcija odnosi na offline evaluacije, koje su rezervirane za Enterprise organizacije (Lekcija 15).
Ključne točke
- Praćenje je prema zadanim postavkama onemogućeno:
configure_telemetry(client)ga omogućuje za Python SDK, aOTEL_ENABLED=trueza Workflows - Pozivi modela prate se automatski; pozivi alata zahtijevaju ručno praćenje s
get_telemetry_tracer - Explorer filtrira tragove koristeći jezik izraza (
service_name,status_code,duration_ns,span_attributes['…']) - SDK izlaže istu mogućnost pretraživanja:
client.beta.observability.traces.search(search_expression=...) - Zanimljivi rasponi postaju zapisi u skupu podataka jednim klikom ili u serijama od 500