Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Istraži: Pretraživanje i inspekcija produkcijskih tragova

Lekcija 12 od 16 Ažurirano 2. studenoga 2026. Napredno
Na ovoj stranici
  1. Explorer: Tvoj prozor u produkciju
  2. Slanje tragova
  3. Što trag sadrži
  4. Jezik pretraživanja
  5. Upitivanje tragova putem SDK-a
  6. Dodavanje raspona u skup podataka
  7. Ključne točke

Lekcija je ponovno napisana 2. studenoga 2026. na temelju Mistralovih stranica Send traces i Explore traces te SDK-a mistralai verzije 3.7.0: Explorer se fokusira na OpenTelemetry tragove upitane putem jezika za izraze pretraživanja; zastarjela metoda chat_completion_events.search viš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:

PoljeSadržaj
Trace IDIdentifikator cijelog lanca izvršavanja
SpansOperacije: pozivi modela, pozivi alata, koraci workflowa
DurationVrijeme trajanja svakog raspona i cijelog traga
TokensUlazni i izlazni tokeni za svaki poziv modela
StatusUspjeh ili pogreška, uključujući poruku o pogrešci
SourceIzvorni proizvod: SDK, Workflows, Vibe Work
TagsOznake 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.

KategorijaOperatoriPrimjer
Usporedba=, !=, <, <=, >, >=duration_ns > 5000000000
UzorakLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
PodnizCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Regularni izrazREGEXP, NOT REGEXPservice_name REGEXP '^my-'
RasponBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
PopisIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
PrisutnostEXISTS, NOT EXISTSerror_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, a OTEL_ENABLED=true za 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