Izpēte: Ražošanas pēdu meklēšana un inspekcija
Šajā lapā
Nodarbība pārrakstīta 2026. gada 2. novembrī, balstoties uz Mistral lapām Send traces un Explore traces, kā arī
mistralaiSDK 3.7.0 versiju: Explorer koncentrējas uz OpenTelemetry pēdām, ko vaicā, izmantojot meklēšanas izteiksmju valodu; vecāchat_completion_events.searchmetode vairs nepastāv. Avoti: Send traces · Explore traces.
Explorer: Tavs logs uz ražošanas vidi
Trace Explorer ir vieta, kur tu meklē, filtrē un inspicē katru pēdu, kas plūst caur taviem AI lietojumiem. Tu to atradīsi Studio sadaļā Observability → Traces. Tomēr pēdas tur neparādīsies, ja vispirms tās neiespēiosi: pēc noklusējuma izsekošana ir atspējota.
Pēdu nosūtīšana
Izmantojot Python SDK, instalē telemetrijas paplašinājumu (mistralai[telemetry], 2.4.13 vai jaunāka versija) un pēc tam iespējo to klientā:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
No šī brīža SDK automātiski izseko modeļu izsaukumus, iegulšanas (embeddings), aģentu operācijas, FIM pabeigšanas un OCR. Tavi pašu rīku izsaukumi netiek izsekoti automātiski: tev ir jāpievieno to diapazoni (spans), izmantojot SDK traseri.
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
Citi avoti uzvedas citādāk: Workflows izseko katru izpildi, tiklīdz servisā ir iestatīts OTEL_ENABLED=true, savukārt Vibe Work tiek aktivizēts, izmantojot administratora iestatījumu Studio vidē. TypeScript SDK piedāvā configureTelemetry. Turpretī Vibe Code (CLI un Web) un Studio Playground nosūtīšanas pēdas neveic. Visi avoti pēc noklusējuma pirms eksportēšanas dzēš daļu datu; lapa Data redaction detalizēti apraksta šo politiku un to, kā to pielāgot.
Ko satur pēda
Pēda ir diapazonu (spans) koks, kur katrs diapazons apzīmē ķēdes operāciju:
| Lauks | Saturs |
|---|---|
| Trace ID | Visa izpildes ķēdes identifikators |
| Spans | Operācijas: modeļu izsaukumi, rīku izsaukumi, darbplūsmas soļi |
| Duration | Laiks katram diapazonam un visai pēdai |
| Tokens | Ievades un izvades tokeni katram modeļa izsaukumam |
| Status | Veiksme vai kļūda, tostarp kļūdas ziņojums |
| Source | Izcelsmes produkts: SDK, Workflows, Vibe Work |
| Tags | Etiķetes, ko pielieto SDK, un automātiskie metadati, piemēram, modelis |
Noklikšķinot uz pēdas, tiek atvērts tās diapazonu koks; katrs diapazons izvēršas, lai parādītu ievadi, izvadi, latentumu un tokenus.
Meklēšanas valoda
Explorer pieņem izteiksmju valodu: nosacījumus par pēdu laukiem, kas kombinēti ar AND, OR un NOT.
| Kategorija | Operatori | Piemērs |
|---|---|---|
| Salīdzinājums | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Šablons | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Apakšvirkne | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Regulārā izteiksme | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Diapazons | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Saraksts | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Esamība | EXISTS, NOT EXISTS | error_message EXISTS |
Pieejamie lauki ietver service_name, status_code (Ok vai Error), duration_ns (nanosekundēs), error_message, start_time, models_used (saraksts) un jebkuru diapazona atribūtu, izmantojot iekavu sintaksi: span_attributes['gen_ai.request.model']. Sarakstiem funkcijas has(models_used, 'mistral-medium-latest'), hasany(...) un hasall(...) papildina CONTAINS.
# Visas neizdevušās pēdas no servisa
service_name = 'agent-support' AND status_code = 'Error'
# Pēdas, kas garākas par 5 sekundēm
duration_ns > 5000000000
# Pēdas, kas izsauca konkrētu modeli
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Ja meklēšana neatgriež rezultātus, noņem visus nosacījumus, izņemot laika diapazonu, un pēc tam pievieno tos atpakaļ pa vienam. Izplatīta kļūda ir filtrēt pēc status_code = 'Error', lai gan lielākā daļa pēdu ir veiksmīgas.
Pēdu vaicāšana, izmantojot SDK
Tu vari veikt tās pašas meklēšanas programmētiski noteiktā laika posmā:
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")
Atbilde izmanto kursora balstītu lapošanu. API atsauce dokumentē Traces un Spans galapunktus (meklēšana, viena pēda, iespējamie lauki un vērtības, pēdas diapazoni).
Diapazonu pievienošana datu kopai
Explorer kalpo arī kā sākumpunkts testu datu kopām. No pēdas diapazona izvēlne piedāvā Add span to dataset; skatā Spans tu vari atlasīt līdz 500 vienlaicīgi un kartēt katru diapazona lauku uz ieraksta lauku. Šī funkcija ir saistīta ar bezsaistes novērtējumiem, kas paredzēti tikai Enterprise organizācijām (15. nodarbība).
Galvenās atziņas
- Izsekošana pēc noklusējuma ir atspējota:
configure_telemetry(client)to iespējo Python SDK, betOTEL_ENABLED=true— Workflows - Modeļu izsaukumi tiek izsekoti automātiski; rīku izsaukumiem nepieciešama manuāla izsekošana ar
get_telemetry_tracer - Explorer filtrē pēdas, izmantojot izteiksmju valodu (
service_name,status_code,duration_ns,span_attributes['…']) - SDK nodrošina tādu pašu meklēšanas iespēju:
client.beta.observability.traces.search(search_expression=...) - Interesanti diapazoni kļūst par datu kopas ierakstiem viena klikšķa laikā vai partijās pa 500