Esplora: Iftex u eżamina t-traċċi tal-produzzjoni
F'din il-paġna
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
mistralai3.7.0: L-Explorer jiffoka fuq traċċi OpenTelemetry mistoqsija permezz ta’ lingwa ta’ espressjoni għat-tiftix; il-metodu antikchat_completion_events.searchm’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:
| Qasam | Kontenut |
|---|---|
| Trace ID | Identifikatur għaċ-ċ catena kollha ta’ eżekuzzjoni |
| Spans | Operazzjonijiet: sejħiet tal-mudelli, sejħiet tal-għodod, passi tal-workflow |
| Duration | Ħin għal kull span u għat-traċċa kollha |
| Tokens | Tokens tal-input u tal-output għal kull sejħa tal-mudell |
| Status | Suċċess jew żball, inkluż il-messaġġ tal-iżball |
| Source | Il-prodott ta’ oriġini: SDK, Workflows, Vibe Work |
| Tags | Tikketta 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.
| Kategorija | Operaturi | Eżempju |
|---|---|---|
| Tqabbil | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Mudell | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Sottostringa | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Espressjoni regolari | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Firxa | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Lista | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Preżenza | EXISTS, NOT EXISTS | error_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=truegħ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