Izturība un uzticamība darbplūsmās
Šajā lapā
Kāpēc izturība maina visu
Iedomājies desmit soļu konveijeru, kas apstrādā rēķinu partiju: ekstrakcija, validācija, modeļa izsaukums, ieraksts datubāzē, paziņojums. Standarta Python skriptā kļūme 7. solī tevi spiež atgriezties pie 1. soļa. Pirmie seši soļi tiek izpildīti atkārtoti, radot nopietnas problēmas, ja kāds no tiem jau bija veicis ierakstu datubāzē vai nosūtījis ziņojumu. Ar izturīgu darbplūsmu sistēma atsāk darbu tieši pie 7. soļa. Tā izlaiž pirmos sešus soļus, izvairās no darbību dublēšanas un nezaudē datus.
Šī spēja balstās uz specifisku mehānismu, ko sauc par notikumu avotizāciju (event sourcing). Šīs koncepcijas izpratne ir būtiska, jo tā skaidro ierobežojumus, ar kuriem saskarsies vēlāk.
Notikumu avotizācija: Pamatprincips
Notikumu avotizācija fiksē katru darbplūsmas darbību kā nemaināmu notikumu žurnālā. Atšķirība no tradicionālās pieejas slēpjas vienā teikumā: tā vietā, lai glabātu tikai pašreizējo stāvokli (piemēram, “notiek process, 7. solis”), platforma uztur pilnu operāciju un to rezultātu vēsturi. Darbplūsmas izpilde ar divām aktivitātēm atstāj šādu pēdu:
- Darbplūsma sākas un saņem ievades parametrus → notikums ierakstīts
- Darbplūsma izsauc A aktivitāti → notikums ierakstīts
- A aktivitāte pabeidz darbu ar rezultātu → notikums ierakstīts
- Darbplūsma izsauc B aktivitāti → notikums ierakstīts
- B aktivitāte pabeidz darbu → notikums ierakstīts
- Darbplūsma atgriež savu gala rezultātu → notikums ierakstīts
Sistēma saglabā katru soli pirms pārejas pie nākamā. Nav neviena brīža, kad darbība notiktu, bet žurnāls par to nezinātu. Šis žurnāls kļūst par vienīgo patiesības avotu; darbplūsmas stāvoklis nepastāv nekur citur.
Automātiska atskaņošana: Atgūšanās pēc kļūmes
Kad strādnieks (worker) piedzīvo kļūmi, jauns strādnieks pārņem vadību, iegūst notikumu žurnālu un atskaņo darbplūsmas kodu no paša sākuma. Vārds “atskaņošana” bieži pārsteidz: kods tiešām restartējas no pirmās rindiņas, taču katrai aktivitātei, kas jau ir pabeigta, dzinējs vairs neizsauc tavu funkciju. Tā vietā tas aizstāj to ar ierakstīto rezultātu no žurnāla. Darbplūsma virzās uz priekšu ar lasīšanas ātrumu, līdz sasniedz pirmo nepabeigto aktivitāti. Tikai tad atsākas reāls darbs.
Aktivitātes, kas jau ir veiksmīgas, atskaņošanas laikā nekad netiek izpildītas atkārtoti. Zemāk redzamais piemērs padara šo garantiju taustāmu visjutīgākajā gadījumā: e-pasta nosūtīšanā.
import mistralai.workflows as workflows
@workflows.activity()
async def send_email(recipient: str, content: str) -> dict:
"""Šī aktivitāte tiek izpildīta tikai vienreiz,
pat ja darbplūsma tiek atskaņota vairākas reizes."""
response = await email_service.send(recipient, content)
return {"status": "sent", "id": response.id}
@workflows.workflow.define(name="notification_workflow")
class NotificationWorkflow:
@workflows.workflow.entrypoint
async def run(self, recipient: str) -> dict:
# Ja darbplūsma piedzīvo kļūmu PĒC e-pasta nosūtīšanas,
# e-pasts atskaņošanas laikā NETIKS nosūtīts atkārtoti.
email_result = await send_email(recipient, "Jūsu pārskats ir gatavs")
# Darbplūsma atsākas šeit
log_result = await log_notification(recipient, email_result)
return log_result
Kļūdu noturība: Apskatītie scenāriji
Platforma apstrādā četru veidu incidentus, no tevis neprasaot nevienu koda rindiņu. Pirmkārt, strādnieka kļūme: Python process pēkšņi apstājas atmiņas kļūdas, kill signāla vai servera restarta dēļ. Cits strādnieks pārņem darbplūsmu tieši tur, kur tā apstājās. Otrkārt, pārejoša tīkla kļūme: API izsaukums neizdodas noildzes (timeout) dēļ. Atkārtošanas politika automātiski restartē aktivitāti, izmantojot eksponenciālu atkāpšanos (exponential backoff), palielinot aiztures, lai “nebombardētu” grūtībās nonākušu servisu.
Treškārt, kļūdas tavā pašā kodā: izņēmums, kas radies aktivitātē, tiek atkārtots noteiktu reižu skaitu saskaņā ar konfigurēto politiku, pirms tas tiek atzīts par neatgriezeniski neizdevušos. Ceturtkārt, trešās puses servisa īslaicīga nepieejamība. Efekts šeit ir dramatisks: ja partnera API nedarbojas desmit minūtes, tavs nakts konveijers vairs neizgāžas. Gaidošās aktivitātes atsākas, kad serviss atgriežas, un apstrāde tiek pabeigta tikai ar desmit minūšu kavēšanos.
Determinisma ierobežojums
Atskaņošana nāk ar cenu. Lai žurnāla atskaņošana precīzi reproducētu sākotnējo izpildi, darbplūsmas kodam (nevis aktivitātēm) ir jābūt deterministiskam. Pie vienādām ievadēm tam jārada vienāda operāciju secība. Ja tava darbplūsma veic zarošanos, balstoties uz if datetime.now().hour < 12, atskaņošana šovakar varētu izvēlēties otru zaru, pilnībā desinhronizējot žurnālu.
Tāpēc darbplūsmas kodā nekad nedrīkst darīt sekojošo:
- Izmantot
datetime.now()→ izmantoworkflow.now() - Izmantot
uuid.uuid4()→ izmantoworkflow.uuid4() - Izmantot
random.random()→ izmantoworkflow.random() - Veikt tīkla vai I/O izsaukumus tieši → pārvieto tos uz aktivitāti
Šīs trīs aizvietojuma funkcijas atgriež vērtības, kas ierakstītas pirmās caurlaides laikā, un vēlāk tiek atskaņotas identiski. Šo ierobežojumu detalizēti aplūkosim 8. nodarbībā, kas fokusējas uz determinismu.
Salīdzinājums ar tradicionālajām pieejām
| Pieeja | Kļūmju atgūšana | Izpildes garantija | Sarežģītība |
|---|---|---|---|
| Vienkāršs Python skripts | Nav | Nav | Zema |
| Ziņojumu rinda (Celery, RQ) | Daļēja | Vismaz vienreiz (At-least-once) | Vidēja |
| Cron + Datubāze | Manuāla | Atkarīgs no implementācijas | Augsta |
| Mistral Workflows (Temporal) | Automātiska | Tieši vienreiz (loģiski) | Zema (SDK) |
Pievērs īpašu uzmanību sarežģītības kolonnai. Ziņojumu rinda šķiet vienkārša sākumā, taču tās daļējā atgūšana liek tev rakstīt stāvokļa pārvaldības loģiku, ko SDK nodrošina jau gatavu.
”Tieši vienreiz”: Loģiska garantija
Platforma garantē, ka tava darbplūsmas loģika tiek izpildīta tieši vienreiz. Ja aktivitāte ir veiksmīga, sistēma ieraksta rezultātu un nekad to neatkārto. Ja tā neizdodas, sistēma to atkārto saskaņā ar konfigurēto politiku.
Vārds “loģiski” nav tikai rotājums. Tīkla līmenī izsaukums faktiski var tikt nosūtīts divreiz: tavs pieprasījums izveidot klientu sasniedz CRM, bet apstiprinājums pazūd ceļā. No tava skatupunkta aktivitāte neizdevās un tiks atkārtota, lai gan klients jau eksistē. Tas rada nepieciešamību pēc idempotentām aktivitātēm, kas rada vienu un to pašu rezultātu pat tad, ja tās tiek izsauktas vairākas reizes ar vienādiem parametriem. Praksē tas nozīmē dot priekšroku PUT pieprasījumam ar stabilu ID, nevis POST, kas ar katru izsaukumu rada jaunu rindu.
Galvenās atziņas
- Notikumu avotizācija fiksē katru soli kā nemaināmu notikumu žurnālā
- Automātiska atskaņošana ļauj atsākt pārtrauktu darbplūsmu, neatkārtojot pabeigtās aktivitātes
- Platforma automātiski apstrādā kļūmes, tīkla problēmas un servisu pārtraukumus
- Darbplūsmas kodam ir jābūt deterministiskam, lai atskaņošana darbotos
- Aktivitātēm ir jābūt idempotentām, lai nodrošinātu konsekvenci atkārtojumu laikā
- Izpildes garantija ir loģiska “tieši vienreiz”