Inbhreathnaitheacht agus OpenTelemetry
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 bunaithe ar SDK
mistralai3.7.0: tá modhanna rianaithe suite faoiclient.workflows.executions; tá an iarmhír_asyncar a leagananna neamhshioncrónacha (teipeann ar fhreastal ar an leagan sioncrónach), cuirtearexecution_idar fáil mar argóint eochairfhocail, agus nochtann freagraíotel_trace_data,span_tree, agusevents(níl na réimsíspans,activity_count, nóerror_counta léigh an seanleagan ann a thuilleadh); cuirteartraceparentar fáil mar pharaiméadar feidhmithe, ós rud é go bhfuil an ceanntásc HTTP dímholta. Foinse: Inbhreathnaitheacht Sreabha Oibre · client-python.
Cúis le do shreabha oibre a bheith inbhreathnaithe
Is féidir le sreabhadh oibre i dtáirgeadh dosaen gníomhaíocht a shlabhrú, glaoch a chur ar sheirbhísí seachtracha iolracha, agus rith ó chúpla soicind go dtí roinnt laethanta. Gan inbhreathnaitheacht, tá fadhb a dhiagnóisiú cosúil le snáthaid a aimsiú i dtuar: tá a fhios agat gur theip ar an fheidhmiú, ach ní fios cá céim, tar éis cé mhéad iarracht, nó an é do chód féin nó API tríú páirtí is cúis leis. Cuireann ardán Sreabha Oibre Mistral OpenTelemetry ar fáil go dúchasach chun an cheist seo a fhreagairt: taifeadtar gach gníomhaíocht, gach earráid, agus gach fad mar spán i rian dáilte, gan aon ionstraimiú de dhíth ortsa.
Tá dhá choincheap ag struchtúrú an mhúnla seo. Léiríonn an rian turas iomlán feidhmithe, ón spreagadh tosaigh go dtí an toradh deiridh. Ar an láimh eile, is oibríocht aonair laistigh den rian sin é an spán: cruthaíonn gach gníomhaíocht ceann go huathoibríoch, ag iompar a ainm, amanna tosaigh agus deiridh, fad an fheidhmithe, stádas (rath nó earráid), agus aon tréithe saincheaptha. Cruthaíonn na spáin seo ordlathas—is é spán an tsreabha oibre an tuismitheoir, agus is iad spáin na ngníomhaíochtaí a chuid páistí—a athchruthaíonn struchtúr iomlán an fheidhmithe.
Ainmnigh gníomhaíochtaí le haghaidh inléiteachta
Cinneann an paraiméadar name den maisitheoir gníomhaíochta an lipéad a fheictear i rianta. Is infheistíocht deich soicind é seo agus tú ag scríobh a shábhálfaidh go leor ama duit le linn teagmhais.
import mistralai.workflows as workflows
@workflows.activity(name="Extract source text")
async def extraire_texte(url: str) -> dict:
async with httpx.AsyncClient() as client:
response = await client.get(url)
return {"texte": response.text}
@workflows.activity(name="Mistral sentiment analysis")
async def analyser_sentiment(texte: str) -> dict:
client = Mistral()
response = await client.chat.complete_async(
model="mistral-large-latest",
messages=[
{"role": "system", "content": "Analyze the sentiment."},
{"role": "user", "content": texte}
]
)
return {"sentiment": response.choices[0].message.content}
@workflows.activity(name="Send email notification")
async def envoyer_notification(destinataire: str, contenu: str) -> dict:
# ...
return {"status": "sent"}
Cuir tú féin in ionad an innealtóra atá ar dualgas ag oscailt amhairc rian ag 3 a.m. Idir fetch_user_data agus “Retrieve user profile,” tá an ceann deireanach intuigthe láithreach, fiú do dhuine nár léigh an cód seo riamh.
Rianta a aisghabháil go cláraithe
Nochtann an SDK trí mhodh rochtana faoi client.workflows.executions; tá an iarmhír _async ar a leagananna neamhshioncrónacha. Tugann an chéad cheann sonraí amh OpenTelemetry ar ais—spáin, faid, tréithe, caidrimh tuismitheora-páiste—ag ligean duit iad a ath-ionghabháil isteach in d’uirlis inbhreathnaitheachta féin (Jaeger, Grafana Tempo, srl.).
from mistralai.client import Mistral
client = Mistral()
# Raw OpenTelemetry data for the execution
trace = await client.workflows.executions.get_workflow_execution_trace_otel_async(
execution_id="exec_abc123def456"
)
print(f"OTel Trace: {trace.otel_trace_id}")
otel_data = trace.otel_trace_data # Full trace, to re-export to your backend
Nuair is mian leat go príomha a fháil amach an raibh rath ar an bhfeidhmiú agus cá fhad a thóg sé, tá an achoimre go leor. Áirítear inti an stádas, an fad iomlán, agus an crann spáin, ar féidir leat dul tríd go hathfhillteach:
summary = await client.workflows.executions.get_workflow_execution_trace_summary_async(
execution_id="exec_abc123def456"
)
print(f"Workflow: {summary.workflow_name} — status {summary.status}")
print(f"Total duration: {summary.total_duration_ms} ms")
def display(span, depth=0):
end = span.end_time_unix_nano or span.start_time_unix_nano
duration_ms = (end - span.start_time_unix_nano) / 1e6
print(f"{' ' * depth}{span.name}: {duration_ms:.0f} ms, {len(span.events)} event(s)")
for child in span.children or []:
display(child, depth + 1)
if summary.span_tree:
display(summary.span_tree)
Filleann an tríú modh liosta crónatrach d’imeachtaí feidhmithe:
response = await client.workflows.executions.get_workflow_execution_trace_events_async(
execution_id="exec_abc123def456",
include_internal_events=False, # Exclude internal platform events
)
for event in response.events or []:
print(event)
Scagann an paraiméadar include_internal_events=False imeachtaí teicniúla an ardáin amach, ag coinneáil díobh siúd ó do shreabhadh oibre agus do ghníomhaíochtaí amháin. Ar shreabhadh oibre atá beagán fada, tá an difríocht in inléiteacht suntasach. Maidir leis na logaí féin—siúd a thaispeántar in Studio—filleann get_workflow_execution_logs iad leathanach ar leathanach.
Sampláil a mháistriú
De réir réamhshocraithe, onnmhairítear gach rian: déanann an t-oibrí sampláil ag 100%. Chun ID an rian a shocrú nó chun sampláil a rialú d’fheidhmiú, cuir traceparent i bhformáid W3C isteach i gcorp an iarratais feidhmithe. Úsáideann an t-oibrí samplóir bunaithe ar thuismitheoir: leanann sé do chinneadh, a iompraítear ag an réimse deireanach (01 le bailiú, 00 gan bailiú).
execution = await client.workflows.execute_workflow_async(
workflow_identifier="my_workflow",
input={"data": "test"},
traceparent="00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
)
Déanann SDKanna Mistral é seo go huathoibríoch: le gach feidhmiú, tarchuireann siad traceparent an spáin reatha. Glactar fós le traceparent a chur i gceanntásc HTTP ach tá sé dímholta, toisc gur féidir ceanntásc a athscríobh idirghabhála; úsáid an paraiméadar ina ionad.
Monatóireacht a dhéanamh i dtáirgeacht
Tá cúig tháscaire go leor chun sreabhadh oibre a choinneáil faoi smacht: an ráta ratha, .i. an céatadán feidhmithe a chríochnaíonn gan earráid; meánfhad feidhmithe iomláin; faid P95 agus P99, a nochtann na feidhmithe is moille a cheileann an meán; an ráta athiarrtha in aghaidh na gníomhaíochta, a nochtann seirbhís sheachtrach éagobhsaí i bhfad roimh dhíghrádú an ráta ratha; agus ar deireadh, sainaithint na gníomhaíochta is moille, do bhacphointe.
Ós rud é go n-urramaíonn rianta an caighdeán OpenTelemetry, ní gá duit iad a chomhairliú ón SDK: is féidir iad a onnmhairiú chuig Datadog trína bhailitheoir OTel, chuig Grafana agus Tempo tríd an meicníocht chéanna, chuig Jaeger le haghaidh amhairc ar rianta dáilte, nó chuig New Relic trína onnmhaireoir tiomnaithe. Mar sin, bíonn do shreabhaí oibre ar an deais bhoird áit a bhfuil an chuid eile de d’infreastruchtúr cheana féin.
Sreabhadh oibre teipthe a dhífhabhtú
Agus tú os comhair teipe, seachnaíonn nós imeachta modhúil buille faoi thuairim.
- Faigh an ID feidhmithe ó na logaí nó ó fhreagra an API
- Comhairligh achoimre an rian chun an stádas a bheith ar eolas agat agus chun an ghníomhaíocht lochtach a aimsiú sa chrann spáin
- Scrúdaigh imeachtaí mionsonraithe chun an seicheamh a threoraigh go dtí an earráid a thuiscint
- Seiceáil athiarrtha: an ndearnadh an ghníomhaíocht a atosú? Cé huaire?
- Déan anailís ar theachtaireacht na hearráide: am-teorainn, earráid líonra, earráid gnó?
Is féidir an chéad dá chéim a scriptiú i roinnt línte, ag baint úsáide as an bhfeidhm display a chonaic tú thuas, rud a thugann uirlis dhiagnóiseach in-athúsáidte duit.
async def diagnose_failure(execution_id: str):
client = Mistral()
executions = client.workflows.executions
# Step 1: Summary and span tree
summary = await executions.get_workflow_execution_trace_summary_async(execution_id=execution_id)
print(f"Status: {summary.status}")
if summary.span_tree:
display(summary.span_tree)
# Step 2: Events from your code, in order
response = await executions.get_workflow_execution_trace_events_async(
execution_id=execution_id,
include_internal_events=False,
)
for event in response.events or []:
print(event)
Tuilleann líon na n-iarracht aird ar leith: insíonn gníomhaíocht a theipeann ar an gcéad iarracht agus ceann a theipeann tar éis cúig athiarracht scéalta difriúla agus éilíonn siad deisiúcháin difriúla.
Achoimre an chúrsa
Comhghairdeas, tá an cúrsa seo ar Shreabhaí Oibre Mistral críochnaithe agat. Thug an turas ó eagrú marthanach agus an mheicníocht foinseú imeachtaí go dtí suiteáil an SDK (ceachtanna 1 go 3), ansin go dtí gníomhaíochtaí, sreabhaí oibre agus oibrithe a chruthú, iad a spreagadh agus a thástáil (ceachtanna 4 go 7). Leag ceachtanna 8 go 11 na srianta struchtúrtha amach—cinnteachas, ionchuir Pydantic, am-teorainneacha, teorainneacha—sula ndearna siad oscailt ar phatrúin chasta comhthreomhaireachta agus leanúnachais. Chumhdaigh na trí cinn dheireanacha polasaithe athiarrtha, an riachtanas d’I/A neamhshioncrónach, agus inbhreathnaitheacht le OpenTelemetry.
Tá an t-ardán i Réamhamharc Poiblí: d’fhéadfadh APIanna agus gnéithe teacht chun cinn. Seiceáil an doiciméadú oifigiúil go rialta ag docs.mistral.ai/workflows chun coimeád suas le nuashonruithe.
Príomhphointí
- Cruthaíonn gach gníomhaíocht spáin OpenTelemetry go huathoibríoch le hainm, fad agus stádas
- Ainmnigh do ghníomhaíochtaí leis an bparaiméadar
namechun dífhabhtú a éascú - Trí mhodh chun rochtain a fháil ar rianta, faoi
client.workflows.executions: OTel amh, achoimre (stádas, fad, crann spáin), agus imeachtaí mionsonraithe - Rialaítear sampláil leis an bparaiméadar
traceparentden fheidhmiú (100% de réir réamhshocraithe; tá an ceanntásc HTTP dímholta) - I dtáirgeacht, déan monatóireacht ar an ráta ratha, ar an bhfad, agus ar an ráta athiarrtha
- Tá rianta OTel caighdeánacha in-onnmhairithe chuig Datadog, Grafana, Jaeger, nó New Relic
Tástáil do chuid eolais
Sreabhaí oibre marthanacha: rialacha an innill roimh tháirgeadh.
1. Cad a ráthaíonn ardán Sreabhaí Oibre Mistral?
Freagra: Marthanacht: mairfidh sreabhadh oibre teipeanna agus tosóidh sé arís ón áit ar fhág sé—déantar eagrú fadtréimhseach iontaofa de réir dearaidh.
2. Gníomhaíocht, sreabhadh oibre, oibrí: cé a dhéanann cad?
Freagra: Is é an ghníomhaíocht an t-aonad oibre (glao seachtrach, ríomhaireacht), déanann an sreabhadh oibre eagrú ar ghníomhaíochtaí, feidhmíonn an t-oibrí—an deighilt a chumasaíonn atosú agus scálú.
3. Cad a fhorchuireann an riail chinnteachais?
Freagra: Caithfidh cód an tsreabha oibre a bheith in-athsheinm go hionann: gan randamacht nó rochtain dhíreach ar an gclog in eagrú—cónaíonn éifeachtaí neamhchinntitheacha i ngníomhaíochtaí.
4. Conas a láimhseáiltear teipeanna sealadacha?
Freagra: Tríd an bpolasaí athiarrtha gníomhaíochta (iarrachtaí, cúlaom) agus am-teorainneacha—is gnáthchás é an teip, láimhseáiltear go deachtóireach é seachas de láimh.
5. Cad a thugann comhtháthú OpenTelemetry?
Freagra: Inbhreathnaitheacht chaighdeánach: rianta feidhmithe, méadrachtaí, agus comhcheangal le chuid eile do chórais—riachtanach chun sreabhaí oibre a oibriú i dtáirgeacht.
Marthanacht, cinnteachas, athiarracht, inbhreathnaitheacht: ceithre riail a choinníonn eagraithe fadtréimhseacha le chéile—déanann an t-inneall an chuid eile.