Naršyklė: paieška ir gamybinių pėdsakų tikrinimas
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 2 d. remiantis „Mistral“ puslapiais Send traces ir Explore traces bei
mistralaiSDK 3.7.0 versija: „Explorer“ daugiausia dėmesio skiria OpenTelemetry pėdsakams, užklausiamiems naudojant paieškos išraiškų kalbą; senasischat_completion_events.searchmetodas nebeegzistuoja. Šaltiniai: Send traces · Explore traces.
Naršyklė: tavo langas į gamybinę aplinką
Pėdsakų naršyklė (Trace Explorer) – tai vieta, kurioje ieškai, filtruoji ir tikrini kiekvieną pėdsaką, tekantį per tavo DI programas. ją rasi „Studio“ skiltyje Observability → Traces. Tačiau pėdsakai ten neatsiras, kol jų neįjungsi: pagal nutylėjimą pėdsakų rinkimas yra išjungtas.
Pėdsakų siuntimas
Naudodamas Python SDK, įdiek telemetrijos plėtinį (mistralai[telemetry], 2.4.13 arba naujesnės versijos), tada įjunk jį kliento lygmenyje:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Nuo šio momento SDK automatiškai fiksuoja modelio kvietimus, įterpinius (embeddings), agento operacijas, FIM užbaigimus ir OCR. Tavo pačių įrankių kvietimai pagal nutylėjimą nefiksuoja: jų diapazonus (spans) turi pridėti naudodamas SDK traserį.
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
Kiti šaltiniai elgiasi kitaip: „Workflows“ fiksuoja kiekvieną vykdymą, kai paslaugai nustatyta OTEL_ENABLED=true, o „Vibe Work“ suaktyvinamas per administratoriaus nustatymą „Studio“ aplinkoje. TypeScript SDK siūlo configureTelemetry. Priešingai, „Vibe Code“ (CLI ir Web) bei „Studio Playground“ pėdsakų nesiunčia. Visi šaltiniai pagal nutylėjimą prieš eksportuodami išvalo (redact) dalį duomenų; puslapis Data redaction išsamiai aprašo šią politiką ir kaip ją koreguoti.
Ką sudaro pėdsakas
Pėdsakas yra diapazonų (spans) medis, kuriame kiekvienas diapazonas reiškia grandinės operaciją:
| Laukas | Turinys |
|---|---|
| Trace ID | Visos vykdymo grandinės identifikatorius |
| Spans | Operacijos: modelio kvietimai, įrankių kvietimai, darbo eigos žingsniai |
| Duration | Kiekvieno diapazono ir viso pėdsako trukmė |
| Tokens | Įvesties ir išvesties tokenai kiekvienam modelio kvietimui |
| Status | Sėkmė arba klaida, įskaitant klaidos pranešimą |
| Source | Kilmės produktas: SDK, Workflows, Vibe Work |
| Tags | SDK priskirtos etiketės ir automatiniai metaduomenys, pavyzdžiui, modelis |
Paspaudus pėdsaką, atsiveria jo diapazonų medis; kiekvieną diapazoną galima išskleisti ir pamatyti įvestį, išvestį, delsą bei tokenus.
Paieškos kalba
Naršyklė priima išraiškų kalbą: sąlygas pėdsakų laukams, sujungtas operatoriais AND, OR ir NOT.
| Kategorija | Operatoriai | Pavyzdys |
|---|---|---|
| Palyginimas | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Šablonas | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Poaibis | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Reguliarusis reiškinys | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Diapazonas | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Sąrašas | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Buvimas | EXISTS, NOT EXISTS | error_message EXISTS |
Galimi laukai: service_name, status_code (Ok arba Error), duration_ns (nanosekundėmis), error_message, start_time, models_used (sąrašas) ir bet kuris diapazono atributas naudojant laužtinių skliaustų sintaksę: span_attributes['gen_ai.request.model']. Sąrašams funkcijos has(models_used, 'mistral-medium-latest'), hasany(...) ir hasall(...) papildo CONTAINS.
# Visi nepavykę pėdsakai iš tarnybos
service_name = 'agent-support' AND status_code = 'Error'
# Pėdsakai, trunkantys ilgiau nei 5 sekundes
duration_ns > 5000000000
# Pėdsakai, kurie iškvietė konkretų modelį
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Jei paieška negrąžina jokių rezultatų, pašalink visas sąlygas, išskyrus laiko intervalą, tada pridėkite jas po vieną. Dažna klaida – filtruoti pagal status_code = 'Error', kai dauguma pėdsakų yra sėkmingi.
Pėdsakų užklausos per SDK
Tas pačias paieškas gali atlikti programiškai nurodytu laiko intervalu:
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")
Atsakymas naudoja žymeklio pagrindu vykdomą puslapiavimą. API nuorodose dokumentuojami Traces ir Spans galiniai taškai (paieška, vienas pėdsakas, galimi laukai ir reikšmės, pėdsako diapazonai).
Diapazonų pridėjimas į duomenų rinkinį
Naršyklė taip pat tarnauja kaip startinė vieta testų duomenų rinkiniams kurti. Iš pėdsako, diapazono meniu pasirink Add span to dataset; rodinyje Spans vienu metu gali pasirinkti iki 500 elementų ir susieti kiekvieną diapazono lauką su įrašo lauku. Ši funkcija susijusi su neakivaizdiniais vertinimais (offline evaluations), skirtais tik „Enterprise“ organizacijoms (15 pamoka).
Svarbiausi punktai
- Pėdsakų rinkimas pagal nutylėjimą išjungtas: Python SDK jį įjungia
configure_telemetry(client), o „Workflows“ –OTEL_ENABLED=true - Modelio kvietimai fiksuojami automatiškai; įrankių kvietimams reikia rankinio fiksavimo naudojant
get_telemetry_tracer - Naršyklė filtruoja pėdsakus naudodama išraiškų kalbą (
service_name,status_code,duration_ns,span_attributes['…']) - SDK suteikia tą pačią paieškos galimybę:
client.beta.observability.traces.search(search_expression=...) - Įdomūs diapazonai vienu paspaudimu arba grupėmis po 500 tampa duomenų rinkinių įrašais