Scréan: Cuardaigh agus iniúch tarlúintí táirgeachta
Ar an leathanach seo
An ceacht athscríofa an 2 Samhain, 2026 bunaithe ar leathanaigh Send traces agus Explore traces de chuid Mistral agus ar an SDK
mistralai3.7.0: Díríonn an tIniúchadóir ar tharlúintí OpenTelemetry a chuardaítear trí theanga sloinn chuardaigh; níl an modh seanbhunaithechat_completion_events.searchann a thuilleadh. Foinse: Send traces · Explore traces.
An tIniúchadóir: Do fhuinneog ar an táirgeadh
Is é an Tarchuradóir Tarlúintí (Trace Explorer) an áit a ndéanann tú gach tarlúint a shreabhann trí d’fheidhmchláir IA a chuardach, a scagadh agus a iniúchadh. Gheobhaidh tú é i Studio faoi Observability → Traces. Mar sin féin, ní bheidh tarlúintí le feiceáil ann mura gcuireann tú ar chumas iad ar dtús: tá rianú díchumasaithe de réir réamhshocraithe.
Tarchur tarlúintí
Leis an Python SDK, suiteáil an leathnú teileiméadrachta (mistralai[telemetry], leagan 2.4.13 nó níos déanaí), agus ansin cumasaigh é ar an gcliant:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Ón bpointe sin amach, déanann an SDK rianú go huathoibríoch ar ghlaochanna samhaltaithe, leabaithe, oibríochtaí gníomhairí, críochnuithe FIM, agus OCR. Ní dhéantar rianú ar ghlaochanna chuig do chuid uirlisí féin as an mbosca: caithfidh tú a spáin a chur leis ag baint úsáide as rianaire an SDK.
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
Bíonn iompar difriúil ag foinse eile: déanann Workflows rianú ar gach feidhmiú chomh luath agus a shocraítear OTEL_ENABLED=true ar an tseirbhís, agus gníomhachtaítear Vibe Work trí shocrú riaracháin i Studio. Tairgeann an TypeScript SDK configureTelemetry. Os a choinne sin, ní sheolann Vibe Code (CLI agus Gréasán) ná Cluiche Staidéir Studio aon tarlúintí. Déanann gach foinse codanna den sonraí a dheargadh go huathoibríoch sula ndéantar iad a onnmhairiú; míníonn an leathanach Data redaction an polasaí seo agus conas é a choigeartú.
Cad atá i dtarlúint
Is crann spán é tarlúint, áit a léiríonn gach spán oibríocht sa slabhra:
| Réimse | Ábhar |
|---|---|
| Aitheantas Tarchurtha (Trace ID) | Aitheantóir don slabhra feidhmithe iomlán |
| Spáin | Oibríochtaí: glaochanna samhaltaithe, glaochanna uirlisí, céimeanna sreabha oibre |
| Fad | Am do gach spán agus don tarlúint iomlán |
| Tokenanna | Tokenanna ionchuir agus aschuir do gach glaoch samhail |
| Stádas | Rath nó earráid, lena n-áirítear an teachtaireacht earráide |
| Foinse | An táirge tionscnaimh: SDK, Workflows, Vibe Work |
| Clibeanna | Lipéid a chuir an SDK i bhfeidhm agus meiteashonraí uathoibríocha, mar shampla an tsamhail |
Nuair a chliceálann tú ar tharlúint, osclaítear a crann spán; leathnaíonn gach spán chun ionchur, aschur, moill, agus tokenanna a thaispeáint.
An teanga chuardaigh
Glacann an tIniúchadóir le teanga sloinn: coinníollacha ar réimsí tarlúintí arna gcomhcheangal le AND, OR, agus NOT.
| Catagóir | Oibreoirí | Sampla |
|---|---|---|
| Comparáid | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Patrún | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Fotheaghrán | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Slonn rialta | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Raon | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Liosta | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Láithreacht | EXISTS, NOT EXISTS | error_message EXISTS |
I measc na réimsí atá ar fáil tá service_name, status_code (Ok nó Error), duration_ns (i nanasoicindí), error_message, start_time, models_used (liosta), agus aon airí spáin ag baint úsáide as comhreire lúibíní: span_attributes['gen_ai.request.model']. I gcás liostaí, forlíonann has(models_used, 'mistral-medium-latest'), hasany(...), agus hasall(...) an t-oibreoir CONTAINS.
# Gach tarlúint theipthe ó sheirbhís
service_name = 'agent-support' AND status_code = 'Error'
# Tarchurtha níos faide ná 5 soicind
duration_ns > 5000000000
# Tarchurtha a ghlaogh ar shamhail ar leith
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Mura dtugann cuardach aon toradh, bain gach coinníoll seachas an raon ama, agus ansin cuir ar ais iad ceann ar cheann. Is botún coitianta ná scagadh do status_code = 'Error' nuair a éiríonn leis an gcuid is mó de tharlúintí.
Tarchurtha a chuardach tríd an SDK
Is féidir leat na cuardaigh chéanna a dhéanamh go cláraithe thar raon ama:
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")
Úsáideann an freagra leathanú bunaithe ar chúrsóir. Doiciméadaíonn an tagairt API na pointí deiridh Traces agus Spans (cuardach, tarlúint amháin, réimsí agus luachanna féideartha, spáin tarlúinte).
Spáin a chur le tacar sonraí
Feidhmíonn an tIniúchadóir freisin mar phointe tosaigh do thacair sonraí tástála. Ó tharlúint, tairgeann roghchlár spáin Add span to dataset; san amharc Spans, is féidir leat suas le 500 a roghnú ag an am agus gach réimse spáin a mhapáil le réimse taifid. Baineann an fheidhm seo le meastóireachtaí as líne, atá in áirithe d’eagraíochtaí Fiontar (Ceacht 15).
Príomhphointí
- Tá rianú díchumasaithe de réir réamhshocraithe: cumasaíonn
configure_telemetry(client)é don Python SDK, agusOTEL_ENABLED=truedo Workflows - Déantar rianú ar ghlaochanna samhaltaithe go huathoibríoch; éilíonn glaochanna uirlisí rianú láimhe le
get_telemetry_tracer - Scagann an tIniúchadóir tarlúintí ag baint úsáide as teanga sloinn (
service_name,status_code,duration_ns,span_attributes['…']) - Nochtann an SDK an cumas cuardaigh céanna:
client.beta.observability.traces.search(search_expression=...) - Is féidir spáin suimiúla a dhéanamh ina dtaifid tacair sonraí le cliceáil amháin nó i mbaitseanna de 500