n8n töövoogude seire: mitte ühtegi vaikset riket

Unustatud käsitsi tehtav ülesanne tuleb lõpuks välja. Rikkis automatiseerimine aga ei tule. Tellimusi enam ei kopeerita, arveid enam ei looda ja esimene signaal võib tulla kliendilt päevi hiljem. n8n töövoogude seire tähendab hoolitsemist selle eest, et see signaal jõuaks kohe teieni koos kõigega, mida parandamiseks vaja.

Me käitame n8n töövooge tootmises, nende hulgas kulude sisestamise agenti Telegramis ja töövoogu, mis määrab sisemise identifikaatori igale uuele objektile Palmora Property CRM-is, kinnisvaraportaalis, mida me toetame. See juhend tugineb n8n dokumentatsioonile ja meie enda intsidentidele. Tööriista valikut ja API-ta tarkvara juhtumit käsitlevad teised juhendid meie automatiseerimise rubriigis.

Lühidalt

• Üksainus veatöövoog, mis algab sõlmega Error Trigger, võib anda häiret kõigi teie protsesside kohta.
• Puudumise häire katab selle, mida see ei näe: protsessi, mis enam ei käivitu.
• Ajalugu on kasulik ainult siis, kui seda säilitatakse: kontrollige, mida salvestatakse ja kui kauaks.
• Uuesti käivitamine on lihtne; duplikaatide vältimine valmistatakse ette kavandamisel.
• Töövoog võib õnnestuda valede andmetega: kontrollige ka mahtusid ja välju.

Kuidas saada teade, kui n8n töövoog ebaõnnestub?

n8n võimaldab määrata iga töövoo jaoks veatöövoo, mis käivitub, kui mõni käivitus ebaõnnestub. Veahalduse dokumentatsiooni järgi peab see töövoog algama sõlmega Error Trigger ja sama töövoog võib teenida mitut töövoogu. Seega ehitatakse see üks kord ja hoolikalt:

1. 01Looge veatöövoog.

   Selle esimene sõlm on Error Trigger. Andke sellele selge nimi (näiteks „Häired“) ja salvestage see: töötamiseks ei pea see olema avaldatud.

2. 02Ühendage häire.

   Lisage Error Triggeri järele häire saatmine oma meeskonna kanalisse.

3. 03Siduge see iga töövooga.

   Avage iga jälgitava töövoo seaded (Settings) ja valige see töövoog Error Workflow’ks.

4. 04Testige.

   Tekitage automaatses käivituses rike, et kontrollida, kas häire tõesti kohale jõuab.

Neljas samm on oluline: sõlme dokumentatsiooni järgi käivitub Error Trigger ainult siis, kui automaatne käivitus ebaõnnestub, mitte kunagi käsitsi käivitamisel. Testiks paneb sõlm Stop And Error käivituse teie valitud tingimustel ebaõnnestuma.

Mida hea häire peab sisaldama:

• protsessi nimi äri keeles („Tarnijate arvete loomine“, mitte „Workflow 14“);
• ebaõnnestunud samm ja veateade;
• link ebaõnnestunud käivitusele, mille n8n annab, kui käivitus salvestatakse (mitte siis, kui viga tuleb käivitajast endast);
• mida häire saaja peab tegema või kellele helistama.

Kanal loeb sama palju kui sisu. Üks e-kiri rohkem ülekoormatud postkastis ei aita: häire peab jõudma sinna, kus meeskond juba loeb, ainult häiretele mõeldud kanalisse, mis jääb vaikseks, kui kõik on korras. Palmora Propertys on selleks kaks eraldi Discordi kanalit.

Kuidas teada, mis on töödeldud ja mis mitte?

n8n hoiab käivituste jälge. Käivituste nimekirja saab filtreerida töövoo, oleku (ebaõnnestunud, töös, õnnestunud, ootel) ja alguskuupäeva järgi ning seal saab käivituse avada, et näha selle andmeid samm-sammult. Eeldusel, et see on säilitatud, ja seda seadistatakse:

• Mida salvestatakse. n8n dokumentatsiooni järgi otsustavad iga töövoo seaded, kas säilitada ebaõnnestunud tootmiskäivitused, õnnestunud käivitused ja käsitsi käivitused. Säilitage alati ebaõnnestumised. Säilitage ka olulise protsessi õnnestumised: need on ainus tõend, et töötlus toimus, kui keegi küsib, kas teisipäevane tellimus läks läbi.
• Kui kauaks. Ise majutatud instantsil kustutab n8n vaikimisi lõpetatud käivitused, mis on vanemad kui 14 päeva või ületavad 10 000 käivitust, alustades vanimatest, vastavalt selle käivitusandmete dokumentatsioonile. Seadke need lävendid oma vajaduse järgi, unustamata, et ajalugu sisaldab teie andmeid: nimesid, summasid, aadresse.
• Mis kaob koos töövooga. Töövoo kustutamine kustutab ka selle käivituste ajaloo. Peatage pigem kui kustutage protsess, mille kohta võidakse teilt aru pärida.
• Selgelt nimetatud sammud. Käivitus peab olema loetav ilma selle autorita: „Loo arve“, mitte „HTTP Request 3“.

Olulise protsessi jaoks kaaluge eraldi logi: üks rida iga töödeldud elemendi kohta (arve X, klient Y) koos olekuga, mida ärivaldkonna inimene saab vaadata ilma n8n-i avamata ja mis ei sõltu tööriista puhastusest.

Kuidas käivitust uuesti käivitada ilma duplikaati loomata?

Kui põhjus on parandatud, jääb üle töödelda see, mis töötlemata jäi. Käivituste nimekirjast käivitab n8n ebaõnnestunud käivituse uuesti kahel viisil: töövooga, nagu see on täna salvestatud, ehk parandatuna, või algse töövooga. Et riket enne uuesti käivitamist mõista, kopeerib dokumentatsioonis kirjeldatud funktsioon Debug in editor varasema käivituse andmed redaktorisse, kinnitatuna esimese sõlme külge (isemajutuse korral sõltuvalt väljaandest). Seadistus Save execution progress võimaldab ka jätkata sealt, kus käivitus peatus, veidi suurema latentsuse hinnaga.

Lõks on duplikaat. Kui töövoog lõi arve ja ebaõnnestus seejärel e-kirja saatmisel, loob algusest uuesti käivitamine teise arve. Kaitse ehitatakse kavandamisel, mitte rikke ajal:

• iga kirjutav samm kontrollib kõigepealt, kas element on juba olemas, viiteidentifikaatori (tellimuse number, tarnija arve number) järgi;
• kõige olulisem salvestus tuleb enne kõrvaltegevusi (teavitus, e-kiri), mitte kunagi pärast;
• ebaõnnestunud element ei peata teisi: viiekümne arve partiis ei tohi veaga neljakümne seitsmes blokeerida järgmist kolme.

Üks klient õppis teise reegli kibedal kogemusel.

Kuidas märgata töövoogu, mis õnnestub valede andmetega?

Töövoog võib õnnestuda ja anda vale tulemuse: tühi eksport, mida töödeldi „edukalt“, nulliks loetud summa, sest vorming muutus, PDF, mille väljavõtmisel jäi üks väli vahele. Ükski neist juhtudest ei käivita veatöövoogu. Palmora Propertys avaldaks ilma avaldamise kaitsemehhanismideta API tühi vastus null tootega saidi, rohelisena kuvatava töövooga.

Mõni lihtne kontroll püüab need juhtumid kinni:

• mahulävend: tunduvalt vähem elemente kui tavalisel päeval või üldse mitte ühtegi, ja midagi ei avaldata enne, kui inimene on üle vaadanud;
• kustutuste kontroll: töötlus, mis kavatseb kustutada palju rohkem kui tavaliselt, peatub ja hoiatab;
• kohustuslikud väljad, mida kontrollitakse enne kirjutamist (pole arvet ilma summa või tarnijata);
• inimkontrolli järjekord kahtlaste juhtumite jaoks, mitte automaatne kirjutamine.

n8n-is muudab sõlm Stop And Error ebaõnnestunud kontrolli tõeliseks ebaõnnestumiseks:

Need kontrollid on veelgi olulisemad, kui automatiseerimine kulgeb kõrvaltee kaudu (eksport, e-kiri, ekraan), nagu meie juhendis API-ta tarkvara automatiseerimiseks: vormingu muutus allika poolel annab seal kiiresti vale tulemuse ilma nähtava veata.

Kas tuleb jälgida ka serverit, millel n8n töötab?

Kui n8n on ise majutatud, siis jah: server on osa süsteemist. Peatunud instants ei saada ühtegi häiret, sest see ei tee enam midagi. Vähemalt:

• väline sond, mis töötab mujal kui jälgitav server ja kontrollib, kas instants vastab;
• ketas: n8n dokumentatsiooni järgi võib andmebaas kasvada, kuni salvestusruum täis saab; ärge säilitage midagi tarbetut ja jätke puhastus aktiivseks (SQLite’i puhul ei anta vabanenud ruumi automaatselt tagasi);
• varukoopiad ja uuendused, mille tegelikke nõrku kohti kirjeldame oma artiklis oma serveri varundamisest.

Mida kontrollida enne töövoo tootmisse viimist?

Töövoog, mis ei täida neid kuut punkti, ei ole tootmises: see on katsetamisel ja keegi peab seda teadma.

Seda me oma pakkumises tarnime: iga automatiseeritud protsess tuleb koos häirete ja iga käivituse ajalooga, lisaks käivituse kulu loendur, ja vana töökorraldus jääb varuks, kuni uus pole end tõestanud. Seire ja parandused on hinnas vähemalt 3 kuud, 350 € kuus, ning jätkuvad seejärel igakuiselt.

Korduma kippuvad küsimused

Allikad

1. Veahalduse dokumentatsiooni (uus vahekaart)docs.n8n.io
2. Käivituste nimekirja (uus vahekaart)docs.n8n.io
3. Selle käivitusandmete dokumentatsioonile (uus vahekaart)docs.n8n.io