Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Uuri: otsi ja kontrolli tootmise jälgi

Õppetund 12 / 16 Värskendatud 2. november 2026 Edasijõudnutele
Sellel lehel
  1. Explorer: sinu aken tootmisse
  2. Jälgede saatmine
  3. Mida jälg sisaldab
  4. Otsingukeel
  5. Jälgede pärimine SDK kaudu
  6. Span-ide lisamine andmestikku
  7. Peamised punktid

Õppetund kirjutati ümber 2. novembril 2026, tuginedes Mistrali lehtedele Send traces ja Explore traces ning mistralai SDK versioonile 3.7.0: Explorer keskendub OpenTelemetry jälgedele, mida päritakse otsinguväljendi keele abil; aegunud meetod chat_completion_events.search enam ei eksisteeri. Allikad: Send traces · Explore traces.

Explorer: sinu aken tootmisse

Trace Explorer on koht, kus sa otsid, filtreerid ja uurid kõiki jälgi, mis läbivad sinu tehisintellekti rakendusi. Leiad selle Studiost menüüst Observability → Traces. Jäljed ei ilmu sinna aga enne, kui oled need lubanud: jälgimine on vaikimisi välja lülitatud.

Jälgede saatmine

Pythoni SDK kasutamisel paigalda telemetria laiendus (mistralai[telemetry], versioon 2.4.13 või uuem) ja seejärel luba see kliendil:

from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry

client = Mistral(api_key="your-api-key")
configure_telemetry(client)

Alates sellest hetkest jälgib SDK automaatselt mudelikutsunguid, manuseid, agentide toiminguid, FIM-i täiendusi ja OCR-i. Sinu enda tööriistade kutsungid ei ole vaikimisi jälgitavad: pead nende span-id lisama SDK jälguri abil.

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

Teised allikad käituvad erinevalt: Workflows jälgib iga täitmist kohe, kui teenusel on määratud OTEL_ENABLED=true, samas kui Vibe Work aktiveerub Studio administraatori seadistuse kaudu. TypeScripti SDK pakub meetodit configureTelemetry. Seevastu Vibe Code (CLI ja Web) ning Studio Playground ei saada jälgi. Kõik allikad anonümiseerivad osa andmetest vaikimisi enne eksportimist; leht Data redaction kirjeldab seda poliitikat ja selle kohandamise võimalusi.

Mida jälg sisaldab

Jälg on span-ide puu, kus iga span tähistab ahelas olevat toimingut:

VäliSisu
Trace IDKogu täitmise ahela identifikaator
SpansToimingud: mudelikutsungid, tööriistakutsungid, töövoo sammud
KestusIga span-i ja kogu jälje kestus
TokenidSisend- ja väljundtokenid iga mudelikutsungi kohta
OlekÕnnestumine või viga, sealhulgas veateade
AllikasPäritolutoodet: SDK, Workflows, Vibe Work
SildidSDK poolt rakendatud sildid ja automaatsed metaandmed, nagu mudel

Jäljele klõpsamine avab selle span-ide puu; iga span-i saab laiendada, et näha sisendit, väljundit, latentsust ja tokeneid.

Otsingukeel

Explorer aktsepteerib avaldiste keelt: tingimused jälje väljadele, kombineeritud operaatoritega AND, OR ja NOT.

KategooriaOperaatoridNäide
Võrdlus=, !=, <, <=, >, >=duration_ns > 5000000000
MusterLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
AlamstringCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
RegulaaravaldisREGEXP, NOT REGEXPservice_name REGEXP '^my-'
VahemikBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
LoendIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
OlemasoluEXISTS, NOT EXISTSerror_message EXISTS

Saadaolevad väljad hõlmavad service_name, status_code (Ok või Error), duration_ns (nanosekundites), error_message, start_time, models_used (loend) ja kõiki span-i atribuute, kasutades sulgude süntaksit: span_attributes['gen_ai.request.model']. Loendite puhul täiendavad CONTAINS-i funktsioonid has(models_used, 'mistral-medium-latest'), hasany(...) ja hasall(...).

# Kõik ebaõnnestunud jäljed teenusest
service_name = 'agent-support' AND status_code = 'Error'

# Jäljed, mis kestavad üle 5 sekundi
duration_ns > 5000000000

# Jäljed, mis kutsusid kindlat mudelit
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'

Kui otsing ei tagasta tulemusi, eemalda kõik tingimused peale ajavahemiku ja lisa need seejärel ükshaaval tagasi. Levinud viga on filtreerida status_code = 'Error', kuigi enamik jälgi õnnestub.

Jälgede pärimine SDK kaudu

Saad teha samu otsinguid programmeeritavalt üle kindla ajavahemiku:

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")

Vastus kasutab kursoripõhist lehitsemist. API referents dokumenteerib Traces ja Spans lõpp-punkte (otsing, üksik jälg, võimalikud väljad ja väärtused, jälje span-id).

Span-ide lisamine andmestikku

Explorer toimib ka lähtepunktina testandmike loomisel. Jälje sees pakub span-i menüü valikut Add span to dataset; vaates Spans saad valida korraga kuni 500 span-i ja kaardistada iga span-i välja kirje väljale. See funktsioon on seotud offline hindamisega, mis on reserveeritud Enterprise organisatsioonidele (Õppetund 15).

Peamised punktid

  • Jälgimine on vaikimisi välja lülitatud: configure_telemetry(client) lubab selle Pythoni SDK jaoks, OTEL_ENABLED=true Workflowsi jaoks
  • Mudelikutsungid jälgitakse automaatselt; tööriistakutsungid nõuavad käsitsi jälgimist get_telemetry_tracer abil
  • Explorer filtreerib jälgi avaldiste keele abil (service_name, status_code, duration_ns, span_attributes['…'])
  • SDK pakub sama otsinguvõimalust: client.beta.observability.traces.search(search_expression=...)
  • Huvipakkuvad span-id muutuvad andmestiku kirjeteks ühe klõpsuga või 500-kaupa partiidena