Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izturība un uzticamība darbplūsmās

Nodarbība 2 no 14 Atjaunota 2026. gada 29. jūlijs Augstākais
Šajā lapā
  1. Kāpēc izturība maina visu
  2. Notikumu avotizācija: Pamatprincips
  3. Automātiska atskaņošana: Atgūšanās pēc kļūmes
  4. Kļūdu noturība: Apskatītie scenāriji
  5. Determinisma ierobežojums
  6. Salīdzinājums ar tradicionālajām pieejām
  7. ”Tieši vienreiz”: Loģiska garantija
  8. Galvenās atziņas

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:

  1. Darbplūsma sākas un saņem ievades parametrus → notikums ierakstīts
  2. Darbplūsma izsauc A aktivitāti → notikums ierakstīts
  3. A aktivitāte pabeidz darbu ar rezultātu → notikums ierakstīts
  4. Darbplūsma izsauc B aktivitāti → notikums ierakstīts
  5. B aktivitāte pabeidz darbu → notikums ierakstīts
  6. 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() → izmanto workflow.now()
  • Izmantot uuid.uuid4() → izmanto workflow.uuid4()
  • Izmantot random.random() → izmanto workflow.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

PieejaKļūmju atgūšanaIzpildes garantijaSarežģītība
Vienkāršs Python skriptsNavNavZema
Ziņojumu rinda (Celery, RQ)DaļējaVismaz vienreiz (At-least-once)Vidēja
Cron + DatubāzeManuālaAtkarīgs no implementācijasAugsta
Mistral Workflows (Temporal)AutomātiskaTieš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”