Tutustu: Tuotantoseurantojen haku ja tarkastelu
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026 perustuen Mistralin sivuihin Send traces ja Explore traces sekä
mistralaiSDK:n versioon 3.7.0: Explorer keskittyy OpenTelemetry-seurantoihin, joita haetaan hakukielillä; vanhentunutchat_completion_events.search-metodi ei ole enää olemassa. Lähteet: Send traces · Explore traces.
Explorer: Ikkunasi tuotantoon
Trace Explorer on paikka, jossa haet, suodatat ja tarkastelet kaikkia tekoälysovellustesi läpi virtaavia seurantoja. Löydät sen Studiosta kohdasta Observability → Traces. Seurannat eivät kuitenkaan ilmesty sinne, ellei niitä ole ensin otettu käyttöön: seuranta on oletusarvoisesti pois päältä.
Seurantojen lähettäminen
Asenna Python SDK:hon telemetria-laajennus (mistralai[telemetry], versio 2.4.13 tai uudempi) ja ota se käyttöön asiakasohjelmassa:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Tästä eteenpäin SDK jäljittää automaattisesti mallikutsut, upotukset, agenttien toiminnot, FIM-täydennykset ja OCR:n. Omien työkalujesi kutsuja ei jäljitetä oletuksena: sinun on lisättävä niiden spanit SDK:n tracerilla.
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
Muut lähteet toimivat eri tavalla: Workflows jäljittää jokaisen suorituksen heti, kun palvelulle on asetettu OTEL_ENABLED=true, kun taas Vibe Work aktivoituu Studion ylläpitoasetuksella. TypeScript SDK tarjoaa metodin configureTelemetry. Sitä vastoin Vibe Code (CLI ja Web) sekä Studio Playground eivät lähetä seurantoja. Kaikki lähteet peittävät osan tiedoista oletusarvoisesti ennen vientiä; Data redaction -sivu kertoo tästä käytännöstä ja sen muokkaamisesta.
Mitä seuranta sisältää
Seuranta on span-puiden muodostama rakenne, jossa jokainen span edustaa ketjun yhtä toimintoa:
| Kenttä | Sisältö |
|---|---|
| Trace ID | Koko suoritusketjun tunniste |
| Spans | Toiminnot: mallikutsut, työkalukutsut, workflow-vaiheet |
| Duration | Kunkin spanin ja koko seurannan kesto |
| Tokens | Syöte- ja tulostetokenit jokaiselle mallikutsulle |
| Status | Onnistuminen tai virhe, mukaan lukien virheilmoitus |
| Source | Alkuperäinen tuote: SDK, Workflows, Vibe Work |
| Tags | SDK:n lisäämät tunnisteet ja automaattiset metatiedot, kuten malli |
Seurannan napsauttaminen avaa sen span-puun; jokainen span laajenee näyttämään syötteen, tulosteen, viiveen ja tokenit.
Hakukieli
Explorer hyväksyy lausekekielen: ehtoja seurannan kentille yhdistettynä operaattoreilla AND, OR ja NOT.
| Luokka | Operaattorit | Esimerkki |
|---|---|---|
| Vertailu | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Hahmo | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Alimerkkijono | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Säännöllinen lauseke | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Alue | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Luettelo | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Olemassaolo | EXISTS, NOT EXISTS | error_message EXISTS |
Käytettävissä olevia kenttiä ovat service_name, status_code (Ok tai Error), duration_ns (nanosekunteina), error_message, start_time, models_used (luettelo) sekä mikä tahansa span-attribuutti hakasuljesyntaksilla: span_attributes['gen_ai.request.model']. Luetteloille funktiot has(models_used, 'mistral-medium-latest'), hasany(...) ja hasall(...) täydentävät operaattoria CONTAINS.
# Kaikki epäonnistuneet seurannat palvelusta
service_name = 'agent-support' AND status_code = 'Error'
# Yli 5 sekuntia kestävät seurannat
duration_ns > 5000000000
# Seurannat, jotka kutsuivat tiettyä mallia
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Jos haku ei tuota tuloksia, poista kaikki ehdot aikaväliä lukuun ottamatta ja lisää ne takaisin yksi kerrallaan. Yleinen virhe on suodattaa ehdolla status_code = 'Error', vaikka useimmat seurannat onnistuvat.
Seurantojen kysely SDK:n kautta
Voit suorittaa samat haut ohjelmallisesti määritetyllä aikavälillä:
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")
Vastaus käyttää kohdistinpohjaista sivutusta. API-viite dokumentoi Traces- ja Spans-päätepisteet (haku, yksittäinen seuranta, mahdolliset kentät ja arvot, seurannan spanit).
Spanien lisääminen aineistoon
Explorer toimii myös lähtökohtana testausaineistoille. Seurannasta spanin valikosta löytyy vaihtoehto Add span to dataset; Spans-näkymässä voit valita kerralla jopa 500 spania ja mapittaa jokaisen span-kentän tietueen kentäksi. Tämä toiminto liittyy offline-arviointeihin, jotka ovat varattu Enterprise-organisaatioille (oppitunti 15).
Keskeiset asiat
- Seuranta on oletusarvoisesti pois päältä:
configure_telemetry(client)ottaa sen käyttöön Python SDK:ssa,OTEL_ENABLED=trueWorkflowsissa - Mallikutsut jäljitetään automaattisesti; työkalukutsut vaativat manuaalista jäljitystä funktiolla
get_telemetry_tracer - Explorer suodattaa seurantoja lausekekielen avulla (
service_name,status_code,duration_ns,span_attributes['…']) - SDK tarjoaa saman hakukyvyn:
client.beta.observability.traces.search(search_expression=...) - Kiinnostavista spaneista tulee aineiston tietueita yhdellä napsautuksella tai 500 kappaleen erissä