Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izpēte: Ražošanas pēdu meklēšana un inspekcija

Nodarbība 12 no 16 Atjaunota 2026. gada 2. novembris Augstākais
Šajā lapā
  1. Explorer: Tavs logs uz ražošanas vidi
  2. Pēdu nosūtīšana
  3. Ko satur pēda
  4. Meklēšanas valoda
  5. Pēdu vaicāšana, izmantojot SDK
  6. Diapazonu pievienošana datu kopai
  7. Galvenās atziņas

Nodarbība pārrakstīta 2026. gada 2. novembrī, balstoties uz Mistral lapām Send traces un Explore traces, kā arī mistralai SDK 3.7.0 versiju: Explorer koncentrējas uz OpenTelemetry pēdām, ko vaicā, izmantojot meklēšanas izteiksmju valodu; vecā chat_completion_events.search metode 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:

LauksSaturs
Trace IDVisa izpildes ķēdes identifikators
SpansOperācijas: modeļu izsaukumi, rīku izsaukumi, darbplūsmas soļi
DurationLaiks katram diapazonam un visai pēdai
TokensIevades un izvades tokeni katram modeļa izsaukumam
StatusVeiksme vai kļūda, tostarp kļūdas ziņojums
SourceIzcelsmes produkts: SDK, Workflows, Vibe Work
TagsEtiķ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.

KategorijaOperatoriPiemērs
Salīdzinājums=, !=, <, <=, >, >=duration_ns > 5000000000
ŠablonsLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
ApakšvirkneCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Regulārā izteiksmeREGEXP, NOT REGEXPservice_name REGEXP '^my-'
DiapazonsBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
SarakstsIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
EsamībaEXISTS, NOT EXISTSerror_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, bet OTEL_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