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

Workflowien kestävyys ja luotettavuus

Oppitunti 2 / 14 Päivitetty 29. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Miksi kestävyys muuttaa kaiken
  2. Event Sourcing: Ydinperiaate
  3. Automaattinen toisto: Palautuminen virhetilanteista
  4. Viansieto: Katetut skenaariot
  5. Determinismin vaatimus
  6. Vertailu perinteisiin lähestymistapoihin
  7. Täsmälleen kerran: Looginen takuu
  8. Keskeiset asiat

Miksi kestävyys muuttaa kaiken

Kuvittele kymmenen vaiheen putki, joka käsittelee erän laskuja: ekstraktio, validointi, mallikutsu, tietokantakirjoitus ja ilmoitus. Tavallisessa Python-skriptissä kaatuminen vaiheessa 7 pakottaa sinut aloittamaan alusta, vaiheesta 1. Kuusi ensimmäistä vaihetta suoritetaan uudelleen, mikä aiheuttaa vakavia ongelmia, jos jokin niistä kirjoitti tietokantaan tai lähetti viestin. Kestävän workflowin avulla järjestelmä jatkaa täsmälleen vaiheesta 7. Se ohittaa kuusi ensimmäistä vaihetta, välttää toimintojen duplikoinnin eikä menetä dataa.

Tämä kyky perustuu tiettyyn mekanismiin, jota kutsutaan event sourcingiksi. Tämän käsitteen ymmärtäminen on välttämätöntä, koska se selittää rajoitteet, joita kohtaat myöhemmin.

Event Sourcing: Ydinperiaate

Event sourcing tallentaa jokaisen workflow-toiminnon muuttumattomana tapahtumana lokitiedostoon. Ero perinteiseen lähestymistapaan tiivistyy yhteen lauseeseen: nykytilan (esim. “käynnissä, vaihe 7”) tallentamisen sijaan alusta pitää yllä täydellistä historiaa operaatioista ja niiden tuloksista. Workflow-suoritus, jossa on kaksi aktiviteettia, jättää seuraavan jäljen:

  1. Workflow käynnistyy ja vastaanottaa syöteparametrit → tapahtuma tallennettu
  2. Workflow kutsuu aktiviteettia A → tapahtuma tallennettu
  3. Aktiviteetti A valmistuu tuloksen kera → tapahtuma tallennettu
  4. Workflow kutsuu aktiviteettia B → tapahtuma tallennettu
  5. Aktiviteetti B valmistuu → tapahtuma tallennettu
  6. Workflow palauttaa lopullisen tuloksensa → tapahtuma tallennettu

Järjestelmä pysyväistää jokaisen vaiheen ennen siirtymistä seuraavaan. Ei ole olemassa aikaväliä, jolloin toiminto tapahtuisi ilman, että loki tietäisi siitä. Tästä lokista tulee ainoa totuudenlähde; workflown tilaa ei ole missään muualla.

Automaattinen toisto: Palautuminen virhetilanteista

Kun worker kaatuu, uusi worker ottaa vastuun, noutaa tapahtumalokin ja toistaa workflow-koodin alusta alkaen. Sana “toisto” (replay) yllättää usein: koodi käynnistyy todellakin riviltä yksi, mutta jokaisen jo valmistuneen aktiviteetin osalta moottori ei kutsu funktiotasi uudelleen. Sen sijaan se korvaa kutsun lokista löytyvällä tallennetulla tuloksella. Workflow etenee lukunopeudella, kunnes se osuu ensimmäiseen keskeneräiseen aktiviteettiin. Vasta silloin varsinainen työ jatkuu.

Aktiviteetteja, jotka ovat jo onnistuneet, ei koskaan suoriteta uudelleen toiston aikana. Alla oleva esimerkki tekee tästä takuusta konkreettisen herkimmässä tapauksessa: sähköpostin lähettämisessä.

import mistralai.workflows as workflows

@workflows.activity()
async def send_email(recipient: str, content: str) -> dict:
    """This activity runs only once,
    even if the workflow replays multiple times."""
    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:
        # If the workflow crashes AFTER sending the email,
        # the email will NOT be resent during replay.
        email_result = await send_email(recipient, "Your report is ready")

        # The workflow resumes here
        log_result = await log_notification(recipient, email_result)
        return log_result

Viansieto: Katetut skenaariot

Alusta hallitsee neljäntyyppisiä häiriötilanteita vaatimatta sinulta ainoatakaan koodiriviä. Ensinnäkin workerin kaatuminen: Python-prosessi pysähtyy äkillisesti muistivirheen, kill-signaalin tai palvelimen uudelleenkäynnistyksen vuoksi. Toinen worker poimii workflown täsmälleen siitä kohdasta, mihin se jäi. Toiseksi ohimenevä verkkovirhe: API-kutsu epäonnistuu aikakatkon vuoksi. Uudelleenyrityskäytäntö käynnistää aktiviteetin automaattisesti uudelleen eksponentiaalisella viiveellä (exponential backoff) käyttäen kasvavia viiveitä välttääkseen kuormittamasta kamppailevaa palvelua.

Kolmanneksi omassa koodissasi tapahtuvat virheet: aktiviteetissa heitetty poikkeus yritetään määritetyn määrän kertoja konfiguroidun käytännön mukaisesti ennen pysyvää epäonnistumista. Neljänneksi kolmannen osapuolen palvelun väliaikainen saavuttamattomuus. Vaikutus on tässä dramaattinen: jos kumppanin API on alhaalla kymmenen minuuttia, yöputkesi ei enää epäonnistu. Odottavat aktiviteetit käynnistyvät uudelleen palvelun palattua, ja käsittely valmistuu vain kymmenen minuuttia myöhässä.

Determinismin vaatimus

Toistolla on hintansa. Jotta lokin toisto toistaisi alkuperäisen suorituksen uskollisesti, workflow-koodin (ei aktiviteettien) on oltava determinististä. Samojen syötteiden on tuotettava sama operaatioiden sekvenssi. Jos workflowsi haarautuu ehdon if datetime.now().hour < 12 perusteella, toisto tänä iltana saattaa valita toisen haaran, mikä desynkronoi lokin täysin.

Siksi sinun on ei koskaan tehdä seuraavia asioita workflow-koodissa:

  • Käytä datetime.now() → käytä workflow.now()
  • Käytä uuid.uuid4() → käytä workflow.uuid4()
  • Käytä random.random() → käytä workflow.random()
  • Tee verkkokutsuja tai I/O-operaatioita suoraan → siirrä ne aktiviteettiin

Nämä kolme korvausta palauttavat arvot, jotka on tallennettu ensimmäisen läpimenon aikana ja toistettu identtisesti myöhemmin. Käsittelemme tätä rajoitetta yksityiskohtaisesti oppitunnilla 8, joka keskittyy determinismiin.

Vertailu perinteisiin lähestymistapoihin

LähestymistapaVirhepalautuminenSuoritustakuuMonimutkaisuus
Yksinkertainen Python-skriptiEiEi oleMatala
Viestijono (Celery, RQ)OsittainenVähintään kerran (At-least-once)Keskitaso
Cron + tietokantaManuaalinenRiippuu toteutuksestaKorkea
Mistral Workflows (Temporal)AutomaattinenTäsmälleen kerran (looginen)Matala (SDK)

Kiinnitä erityistä huomiota monimutkaisuus-sarakkeeseen. Viestijono vaikuttaa helpolta aloittaa, mutta sen osittainen palautuminen pakottaa sinut kirjoittamaan tilanhallintalogiikkaa, jonka SDK tarjoaa valmiina.

Täsmälleen kerran: Looginen takuu

Alusta takaa, että workflown logiikka suoritetaan täsmälleen kerran. Jos aktiviteetti onnistuu, järjestelmä tallentaa tuloksen eikä koskaan suorita sitä uudelleen. Jos se epäonnistuu, järjestelmä yrittää sitä uudelleen konfiguroidun käytännön mukaisesti.

Sana “looginen” ei ole koriste. Verkkotasolla kutsu saattaa todellisuudessa lähteä kahdesti: pyyntösi luoda asiakas saapuu CRM-järjestelmään, mutta kuittaus katoaa matkalla. Näkökulmastasi aktiviteetti epäonnistui ja se yritetään uudelleen, vaikka asiakas on jo olemassa. Tämä luo tarpeen idempotenteille aktiviteeteille, jotka tuottavat saman tuloksen vaikka niitä kutsuttaisiin useita kertoja samoilla parametreilla. Käytännössä tämä tarkoittaa sitä, että kannattaa suosia PUT-kutsua vakaalle ID:lle eikä POST-kutsua, joka luo uuden rivin jokaisella kutsulla.

Keskeiset asiat

  • Event sourcing tallentaa jokaisen vaiheen muuttumattomana tapahtumana lokiin
  • Automaattinen toisto mahdollistaa keskeytyneen workflown jatkamisen suorittamatta valmiita aktiviteetteja uudelleen
  • Alusta hallitsee automaattisesti kaatumiset, verkkovirheet ja palvelukatkokset
  • Workflow-koodin on oltava determinististä, jotta toisto toimii
  • Aktiviteettien on oltava idempotentteja johdonmukaisuuden varmistamiseksi uudelleenyritysten aikana
  • Suoritustakuu on looginen täsmälleen kerran