Felfedezés: Termelési nyomok keresése és vizsgálata
Ezen az oldalon
A leckét 2026. november 2-án írtuk át a Mistral Send traces és Explore traces oldalai, valamint a
mistralaiSDK 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égichat_completion_events.searchmetó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 ID | Azonosító a teljes végrehajtási lánchoz |
| Spans | Műveletek: modellhívások, eszköz hívások, munkafolyamat lépések |
| Időtartam | Az egyes spanok és a teljes nyom ideje |
| Tokenek | Bemeneti és kimeneti tokenek minden modellhíváshoz |
| Állapot | Sikeres vagy hiba, beleértve a hibaüzenetet is |
| Forrás | Eredeti termék: SDK, Workflows, Vibe Work |
| Címkék | Az 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ória | Operátorok | Példa |
|---|---|---|
| Összehasonlítás | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Minta | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Részkarakterlánc | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Reguláris kifejezés | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Tartomány | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Lista | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Létezés | EXISTS, NOT EXISTS | error_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 azOTEL_ENABLED=trueengedé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_tracerhaszná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