Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Naršyklė: paieška ir gamybinių pėdsakų tikrinimas

Paskaita 12 iš 16 Atnaujinta 2026 m. lapkričio 2 d. Pažengusiems
Šiame puslapyje
  1. Naršyklė: tavo langas į gamybinę aplinką
  2. Pėdsakų siuntimas
  3. Ką sudaro pėdsakas
  4. Paieškos kalba
  5. Pėdsakų užklausos per SDK
  6. Diapazonų pridėjimas į duomenų rinkinį
  7. Svarbiausi punktai

Pamoka perrašyta 2026 m. lapkričio 2 d. remiantis „Mistral“ puslapiais Send traces ir Explore traces bei mistralai SDK 3.7.0 versija: „Explorer“ daugiausia dėmesio skiria OpenTelemetry pėdsakams, užklausiamiems naudojant paieškos išraiškų kalbą; senasis chat_completion_events.search metodas 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ą:

LaukasTurinys
Trace IDVisos vykdymo grandinės identifikatorius
SpansOperacijos: modelio kvietimai, įrankių kvietimai, darbo eigos žingsniai
DurationKiekvieno diapazono ir viso pėdsako trukmė
TokensĮvesties ir išvesties tokenai kiekvienam modelio kvietimui
StatusSėkmė arba klaida, įskaitant klaidos pranešimą
SourceKilmės produktas: SDK, Workflows, Vibe Work
TagsSDK 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.

KategorijaOperatoriaiPavyzdys
Palyginimas=, !=, <, <=, >, >=duration_ns > 5000000000
ŠablonasLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
PoaibisCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Reguliarusis reiškinysREGEXP, NOT REGEXPservice_name REGEXP '^my-'
DiapazonasBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
SąrašasIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
BuvimasEXISTS, NOT EXISTSerror_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