Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Tutustu: Tuotantoseurantojen haku ja tarkastelu

Oppitunti 12 / 16 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Explorer: Ikkunasi tuotantoon
  2. Seurantojen lähettäminen
  3. Mitä seuranta sisältää
  4. Hakukieli
  5. Seurantojen kysely SDK:n kautta
  6. Spanien lisääminen aineistoon
  7. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026 perustuen Mistralin sivuihin Send traces ja Explore traces sekä mistralai SDK:n versioon 3.7.0: Explorer keskittyy OpenTelemetry-seurantoihin, joita haetaan hakukielillä; vanhentunut chat_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 IDKoko suoritusketjun tunniste
SpansToiminnot: mallikutsut, työkalukutsut, workflow-vaiheet
DurationKunkin spanin ja koko seurannan kesto
TokensSyöte- ja tulostetokenit jokaiselle mallikutsulle
StatusOnnistuminen tai virhe, mukaan lukien virheilmoitus
SourceAlkuperäinen tuote: SDK, Workflows, Vibe Work
TagsSDK: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.

LuokkaOperaattoritEsimerkki
Vertailu=, !=, <, <=, >, >=duration_ns > 5000000000
HahmoLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
AlimerkkijonoCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Säännöllinen lausekeREGEXP, NOT REGEXPservice_name REGEXP '^my-'
AlueBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
LuetteloIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
OlemassaoloEXISTS, NOT EXISTSerror_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=true Workflowsissa
  • 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ä