Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Raziskovanje: Iskanje in pregled sledi v proizvodnji

Lekcija 12 od 16 Posodobljeno 2. november 2026 Napredni
Na tej strani
  1. Raziskovalnik: Tvoje okno v proizvodnjo
  2. Pošiljanje sledi
  3. Kaj vsebuje sled
  4. Iskalni jezik
  5. Poizvedovanje po sledih prek SDK
  6. Dodajanje razponov v nabor podatkov
  7. Ključne ugotovitve

Lekcija ponovno napisana 2. novembra 2026 na podlagi strani Send traces in Explore traces ter SDK-ja mistralai različice 3.7.0: Raziskovalnik se osredotoča na sledi OpenTelemetry, poizvedovane z iskalnim jezikom izrazov; zastarela metoda chat_completion_events.search ne 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:

PoljeVsebina
Trace IDIdentifikator celotne verige izvajanja
SpansOperacije: klici modelov, klici orodij, koraki delovnega toka
DurationČas trajanja za vsak razpon in celotno sled
TokensVhodni in izhodni žetoni za vsak klic modela
StatusUspeh ali napaka, vključno s sporočilom o napaki
SourceIzvorni izdelek: SDK, Workflows, Vibe Work
TagsOznake, 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.

KategorijaOperatorjiPrimer
Primerjava=, !=, <, <=, >, >=duration_ns > 5000000000
VzorecLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
PodnizCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Regularni izrazREGEXP, NOT REGEXPservice_name REGEXP '^my-'
ObsegBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
SeznamIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
PrisotnostEXISTS, NOT EXISTSerror_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=true pa 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