Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Felfedezés: Termelési nyomok keresése és vizsgálata

12. lecke 16 közül Frissítve 2026. november 2. Haladó
Ezen az oldalon
  1. A Felfedező: Ablakod a termelésre
  2. Nyomok küldése
  3. Mit tartalmaz egy nyom (trace)?
  4. A keresési nyelv
  5. Nyomok lekérdezése az SDK-n keresztül
  6. Spanok hozzáadása egy adathalmazhoz
  7. Főbb megállapítások

A leckét 2026. november 2-án írtuk át a Mistral Send traces és Explore traces oldalai, valamint a mistralai SDK 3.7.0 verziója alapján: A Felfedező (Explorer) az OpenTelemetry nyomokra fókuszál, amelyeket egy keresési kifejezésnyelven keresztül lehet lekérdezni; a régi chat_completion_events.search metódus már nem létezik. Források: Send traces · Explore traces.

A Felfedező: Ablakod a termelésre

A Trace Felfedező az a hely, ahol megkeresheted, szűrheted és megvizsgálhatod az AI alkalmazásaidon átfolyó összes nyomkövetési adatot (trace). A Stúdióban a Megfigyelhetőség → Nyomok menüpont alatt találod. Ugyanakkor a nyomok csak akkor jelennek meg itt, ha előtte engedélyezted őket: a nyomkövetés alapértelmezetten ki van kapcsolva.

Nyomok küldése

Python SDK használata esetén telepítsd a telemetriai kiegészítőt (mistralai[telemetry], 2.4.13-as vagy újabb verzió), majd engedélyezd azt a kliensen:

from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry

client = Mistral(api_key="your-api-key")
configure_telemetry(client)

Ettől a ponttól kezdve az SDK automatikusan nyomköveti a modellhívásokat, a beágyazásokat (embeddings), az ügynökműveleteket, a FIM-kiegészítéseket és az OCR-t. A saját eszközeidre (tools) végzett hívások nincsenek alapértelmezetten nyomkövetve: ehhez manuálisan kell hozzáadnod a spanjaikat az SDK nyomkövetőjével.

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

Más források eltérően viselkednek: a Workflows minden végrehajtást automatikusan nyomkövet, amint a szolgáltatáson beállítod az OTEL_ENABLED=true környezeti változót, míg a Vibe Work a Stúdió adminisztrációs beállításaiban aktiválható. A TypeScript SDK a configureTelemetry függvényt kínálja. Ezzel szemben a Vibe Code (CLI és Web) és a Stúdió Playground nem küld nyomkövetési adatokat. Minden forrás alapértelmezetten kitakar (redact) bizonyos adatokat exportálás előtt; az Adatkitakarás (Data redaction) oldal részletezi ezt a szabályzatot és annak módosítási lehetőségeit.

Mit tartalmaz egy nyom (trace)?

Egy nyom a spanok fája, ahol minden span a láncolat egy műveletét jelöli:

MezőTartalom
Trace IDAzonosító a teljes végrehajtási lánchoz
SpansMűveletek: modellhívások, eszköz hívások, munkafolyamat lépések
IdőtartamAz egyes spanok és a teljes nyom ideje
TokenekBemeneti és kimeneti tokenek minden modellhíváshoz
ÁllapotSikeres vagy hiba, beleértve a hibaüzenetet is
ForrásEredeti termék: SDK, Workflows, Vibe Work
CímkékAz SDK által alkalmazott címkék és automatikus metaadatok, például a modell neve

Ha rákattintasz egy nyomra, megnyílik a span-fája; minden span kibontható, hogy megmutassa a bemenetet, kimenetet, késleltetést és a tokeneket.

A keresési nyelv

A Felfedező egy kifejezésnyelvet fogad el: feltételeket a nyom mezőire, amelyeket az AND, OR és NOT operátorokkal kombinálhatsz.

KategóriaOperátorokPélda
Összehasonlítás=, !=, <, <=, >, >=duration_ns > 5000000000
MintaLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
RészkarakterláncCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Reguláris kifejezésREGEXP, NOT REGEXPservice_name REGEXP '^my-'
TartományBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
ListaIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
LétezésEXISTS, NOT EXISTSerror_message EXISTS

Az elérhető mezők közé tartozik a service_name, a status_code (Ok vagy Error), a duration_ns (nanoszekundumban), az error_message, a start_time, a models_used (lista), valamint bármely span attribútum szögletes zárójeles szintaxissal: span_attributes['gen_ai.request.model']. Listák esetén a has(models_used, 'mistral-medium-latest'), a hasany(...) és a hasall(...) függvények egészítik ki a CONTAINS operátort.

# Egy szolgáltatás összes sikertelen nyoma
service_name = 'agent-support' AND status_code = 'Error'

# 5 másodpercnél hosszabb nyomok
duration_ns > 5000000000

# Nyomok, amelyek egy adott modellt hívtak meg
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'

Ha egy keresés nem ad találatot, távolíts el minden feltételt az időtartomány kivételével, majd egyesével add vissza őket. Gyakori hiba, amikor a status_code = 'Error' feltételre szűrsz, miközben a nyomok többsége sikeres.

Nyomok lekérdezése az SDK-n keresztül

Ugyanezeket a kereséseket programozottan is elvégezheted egy időtartományon belül:

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")

A válasz kurzoralapú lapozást (pagination) használ. Az API referenciadokumentáció részletezi a Traces és Spans végpontokat (keresés, egyetlen nyom, lehetséges mezők és értékek, egy nyom spanjai).

Spanok hozzáadása egy adathalmazhoz

A Felfedező teszt-adathalmazok kiindulópontjaként is szolgál. Egy nyomból kiindulva egy span menüje felajánlja az Add span to dataset lehetőséget; a Spans nézetben egyszerre akár 500-at is kiválaszthatsz, és minden span mezőt hozzárendelhetsz egy rekord mezőhöz. Ez a funkció az offline értékelésekhez kapcsolódik, amelyek kizárólag az Enterprise szervezetek számára elérhetők (15. lecke).

Főbb megállapítások

  • A nyomkövetés alapértelmezetten ki van kapcsolva: a Python SDK esetén a configure_telemetry(client), a Workflows esetén az OTEL_ENABLED=true engedélyezi azt
  • A modellhívások automatikusan nyomkövetettek; az eszköz hívások manuális nyomkövetést igényelnek a get_telemetry_tracer használatával
  • A Felfedező egy kifejezésnyelvvel szűri a nyomokat (service_name, status_code, duration_ns, span_attributes['…'])
  • Az SDK ugyanazt a keresési képességet teszi elérhetővé: client.beta.observability.traces.search(search_expression=...)
  • Az érdekes spanok egyetlen kattintással vagy 500-as csoportokban adathalmaz-rekordokká válnak