Uuri: otsi ja kontrolli tootmise jälgi
Sellel lehel
Õppetund kirjutati ümber 2. novembril 2026, tuginedes Mistrali lehtedele Send traces ja Explore traces ning
mistralaiSDK versioonile 3.7.0: Explorer keskendub OpenTelemetry jälgedele, mida päritakse otsinguväljendi keele abil; aegunud meetodchat_completion_events.searchenam 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äli | Sisu |
|---|---|
| Trace ID | Kogu täitmise ahela identifikaator |
| Spans | Toimingud: mudelikutsungid, tööriistakutsungid, töövoo sammud |
| Kestus | Iga span-i ja kogu jälje kestus |
| Tokenid | Sisend- ja väljundtokenid iga mudelikutsungi kohta |
| Olek | Õnnestumine või viga, sealhulgas veateade |
| Allikas | Päritolutoodet: SDK, Workflows, Vibe Work |
| Sildid | SDK 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.
| Kategooria | Operaatorid | Näide |
|---|---|---|
| Võrdlus | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Muster | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Alamstring | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Regulaaravaldis | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Vahemik | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Loend | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Olemasolu | EXISTS, NOT EXISTS | error_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=trueWorkflowsi jaoks - Mudelikutsungid jälgitakse automaatselt; tööriistakutsungid nõuavad käsitsi jälgimist
get_telemetry_tracerabil - 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