Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Esplora: Iftex u eżamina t-traċċi tal-produzzjoni

Lezzjoni 12 / 16 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. L-Explorer: It-tieqa tiegħek lejn il-produzzjoni
  2. L-ibgħat tat-traċċi
  3. X’fiha traċċa
  4. Il-lingwa tat-tiftix
  5. Il-mistoqsija tat-traċċi permezz tal-SDK
  6. Żieda ta’ spans f’dataset
  7. Punti Ewlenin

Lezzjoni miktuba mill-ġdid fit-2 ta’ Novembru 2026 ibbażata fuq il-paġni Send traces u Explore traces ta’ Mistral u l-SDK mistralai 3.7.0: L-Explorer jiffoka fuq traċċi OpenTelemetry mistoqsija permezz ta’ lingwa ta’ espressjoni għat-tiftix; il-metodu antik chat_completion_events.search m’għadux jeżisti. Sorsi: Send traces · Explore traces.

L-Explorer: It-tieqa tiegħek lejn il-produzzjoni

L-Explorer tat-Traċċi (Trace Explorer) huwa fejn tfittex, tiffiltra, u teżamina kull traċċa li tgħaddi mill-applikazzjonijiet tal-AI tiegħek. Issibu fl-Istudjo taħt Observability → Traces. Madankollu, it-traċċi mhux se jidhru hemm sakemm ma tattivahomx l-ewwel: it-traċċar huwa diżattivat b’mod predefinit.

L-ibgħat tat-traċċi

Bl-SDK tal-Python, installa l-estensjoni tat-telemetrija (mistralai[telemetry], verżjoni 2.4.13 jew aktar riċenti), imbagħad attivalha fuq il-klijent:

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

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

Minn dak il-mument ‘il quddiem, l-SDK jittraċċa awtomatikament is-sejħiet tal-mudelli, l-embeddings, l-operazzjonijiet tal-aġenti, it-tlestijiet FIM, u l-OCR. Is-sejħiet lejn l-għodod tiegħek stess mhumiex imtraċċati b’mod awtomatiku: trid iżżid is-spans tagħhom bl-użu tat-tracer tal-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

Sorsi oħra jaġixxu b’mod differenti: il-Workflows jittraċċaw kull eżekuzzjoni hekk kif OTEL_ENABLED=true jiġi stabbilit fuq is-servizz, filwaqt li Vibe Work jiġi attivat permezz ta’ setting tal-amministratur fl-Istudjo. L-SDK tat-TypeScript joffri configureTelemetry. Min-naħa l-oħra, Vibe Code (CLI u Web) u l-Playground tal-Istudjo ma jibgħatux traċċi. Is-sorsi kollha jneħħu parti mid-data b’mod awtomatiku qabel l-esportazzjoni; il-paġna Data redaction tiddettalja din il-politika u kif tista’ taġġustaha.

X’fiha traċċa

Traċċa hija siġra ta’ spans, fejn kull span jirrappreżenta operazzjoni fil-katina:

QasamKontenut
Trace IDIdentifikatur għaċ-ċ catena kollha ta’ eżekuzzjoni
SpansOperazzjonijiet: sejħiet tal-mudelli, sejħiet tal-għodod, passi tal-workflow
DurationĦin għal kull span u għat-traċċa kollha
TokensTokens tal-input u tal-output għal kull sejħa tal-mudell
StatusSuċċess jew żball, inkluż il-messaġġ tal-iżball
SourceIl-prodott ta’ oriġini: SDK, Workflows, Vibe Work
TagsTikketta applikata mill-SDK u metadata awtomatiku, bħall-mudell

Meta tikklikkja fuq traċċa, tiftaħ is-siġra tal-ispans tagħha; kull span jespandi biex juri l-input, l-output, il-latency, u t-tokens.

Il-lingwa tat-tiftix

L-Explorer jaċċetta lingwa ta’ espressjoni: kundizzjonijiet fuq oqsma tat-traċċa kkombinati b’AND, OR, u NOT.

KategorijaOperaturiEżempju
Tqabbil=, !=, <, <=, >, >=duration_ns > 5000000000
MudellLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
SottostringaCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Espressjoni regolariREGEXP, NOT REGEXPservice_name REGEXP '^my-'
FirxaBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
ListaIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
PreżenzaEXISTS, NOT EXISTSerror_message EXISTS

L-oqsma disponibbli jinkludu service_name, status_code (Ok jew Error), duration_ns (f’nanosekondi), error_message, start_time, models_used (lista), u kwalunkwe attribut tal-span bl-użu tas-sintassi tal-brakits: span_attributes['gen_ai.request.model']. Għal-listi, has(models_used, 'mistral-medium-latest'), hasany(...), u hasall(...) jikkompletaw CONTAINS.

# It-traċċi kollha li fallew minn servizz
service_name = 'agent-support' AND status_code = 'Error'

# Traċċi itwal minn 5 sekondi
duration_ns > 5000000000

# Traċċi li sejħu mudell speċifiku
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'

Jekk tfittxija ma tirritorna l-ebda riżultat, neħħi l-kundizzjonijiet kollha ħlief il-firxa ta’ żmien, imbagħad erġa’ żidhom waħda waħda. Żball komuni huwa li tiffiltra għal status_code = 'Error' meta l-biċċa l-kbira tat-traċċi jkunu suċċess.

Il-mistoqsija tat-traċċi permezz tal-SDK

Tista’ twettaq l-istess tfittxijiet programmament fuq firxa ta’ żmien:

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

Ir-risposta tuża paġinazzjoni bbażata fuq kursor. Ir-referenza tal-API tiddokumenta l-endpoints Traces u Spans (tiftix, traċċa waħda, oqsma u valuri possibbli, spans ta’ traċċa).

Żieda ta’ spans f’dataset

L-Explorer iservi wkoll bħala punt tat-tluq għal datasets tat-test. Minn traċċa, il-menu ta’ span joffri Add span to dataset; fil-vista Spans, tista’ tagħżel sa 500 fl-istess ħin u timmappja kull qasam tal-span ma’ qasam tar-rekord. Din il-funzjoni hija relatata mal-evalwazzjonijiet offline, riżervati għall-organizzazzjonijiet Enterprise (Lezzjoni 15).

Punti Ewlenin

  • It-traċċar huwa diżattivat b’mod predefinit: configure_telemetry(client) jattivah għall-SDK tal-Python, OTEL_ENABLED=true għall-Workflows
  • Is-sejħiet tal-mudelli huma mtraċċati awtomatikament; is-sejħiet tal-għodod jeħtieġu traċċar manwali b’get_telemetry_tracer
  • L-Explorer jiffiltra t-traċċi bl-użu ta’ lingwa ta’ espressjoni (service_name, status_code, duration_ns, span_attributes['…'])
  • L-SDK jesponi l-istess kapaċità ta’ tfittxija: client.beta.observability.traces.search(search_expression=...)
  • Spans interessanti jsiru rekords ta’ dataset f’klikka waħda jew f’lotti ta’ 500