پایش، هشدار و نسخه‌بندی ورک‌فلو

سه لایه پایش برای n8n: Error Workflow برای شکست، ضربان قلب و ناظر بیرونی برای سکوت و خاموشی، و خروجی Git برای دیدن و برگرداندن هر تغییر.

بعد از این درس می‌توانی

  • سه نوع خرابی را از هم جدا کند (شکست اجرا، سکوت ورک‌فلو، خاموشی نمونه) و برای هرکدام لایه پایش مناسب را انتخاب کند.
  • Error Workflow منتشرشده با هشدار کم‌داده بسازد و شرط‌های اجرای آن را بداند.
  • ضربان قلب پس از موفقیت و ناظر بیرونی با readiness و /metrics راه بیندازد که هر هشدار را یک بار بفرستد.
  • ورک‌فلوها را منظم به Git صادر کند، تغییر را با diff ببیند و نسخه قبلی را برگرداند.

چرا این درس مهم است

ورک‌فلوی همگام‌سازی سفارش برگ سبز سه هفته کار نکرد و کسی نفهمید. خطایی هم نداد: پس از یک به‌روزرسانی، n8n دوباره بالا آمده بود ولی آن ورک‌فلو منتشر نشده بود. وقتی مشتری‌ها شکایت کردند، کسی هم نمی‌دانست ورک‌فلو آخرین بار چه کسی و چرا عوض کرده است.

ورک‌فلویی که «هر روز بدون نظارت» کار می‌کند، بدون پایش در واقع «هر روز بدون اطلاع» کار می‌کند. این درس سه پرسش را جواب می‌دهد: اگر اجرایی شکست خورد، چه کسی خبردار می‌شود؟ اگر ورک‌فلو یا کل n8n ساکت شد، چه کسی خبردار می‌شود؟ و اگر تغییری چیزی را خراب کرد، چطور می‌بینیم چه عوض شده و برمی‌گردیم؟

مفاهیم کلیدی

یادآوری: Error Workflow را در پروژه ۴ و بررسی سلامت (Healthcheck) را در درس Docker دیدی.

  • Readiness Check (بررسی آمادگی): پرسشی که جوابش «آماده پذیرش کار» است، نه فقط «زنده»؛ در n8n یعنی پایگاه داده وصل و به‌روز است.
  • Metrics Endpoint (نقطه سنجه‌ها): نشانی‌ای که شمارنده‌ها و اندازه‌های لحظه‌ای سامانه را با قالب متنی استاندارد برای ابزار پایش می‌دهد.
  • Heartbeat Monitoring (پایش ضربان قلب): کار زمان‌بندی‌شده پس از هر اجرای موفق «زنده‌ام» ثبت می‌کند و ناظر بیرونی اگر این ثبت قدیمی شد هشدار می‌دهد.
  • Alert Fatigue (خستگی از هشدار): وقتی هشدارها آن‌قدر زیاد یا تکراری‌اند که کسی دیگر آن‌ها را نمی‌خواند.
  • Workflow Versioning (نسخه‌بندی ورک‌فلو): نگهداری هر نسخه ورک‌فلو جای دیگری (مثلاً Git) تا تغییر دیده، بازبینی و برگردانده شود.

مدل ذهنی

پایش را مثل هشدارهای یک ساختمان ببین. حسگر دود داخل هر اتاق است (Error Workflow): وقتی در یک اتاق مشکلی پیش آمد، خبر می‌دهد. ولی اگر برق کل ساختمان رفت، حسگر دود هم خاموش است. برای همین نگهبان بیرون از ساختمان هر چند دقیقه چراغ‌ها را نگاه می‌کند (ناظر بیرونی) و انتظار دارد هر ساعت گزارش «همه چیز مرتب» برسد (ضربان قلب). دفتر تغییرات ساختمان (Git) هم نشان می‌دهد چه کسی کدام دیوار را جابه‌جا کرد.

سه لایه پایش n8n: ورک‌فلوی زمان‌بندی‌شده هنگام شکست، Error Workflow را صدا می‌زند که به کانال عملیات هشدار می‌دهد. پس از موفقیت، ضربان قلب ثبت می‌کند. ناظر بیرونی خارج از n8n، readiness و metrics را می‌خواند و سن ضربان را بررسی می‌کند و هنگام تغییر وضعیت یک بار هشدار می‌دهد. خروجی Git هر روز ورک‌فلوها را صادر و ثبت می‌کند.

سه لایه پایش n8n

این تشبیه کجا غلط است؟ نگهبان ساختمان خودش ممکن است خواب بماند. ناظر بیرونی هم یک برنامه است و اگر خودش از کار بیفتد، سکوتش شبیه «همه چیز مرتب است» به نظر می‌رسد. برای همین ناظر را روی سامانه‌ای جدا اجرا کن و دست‌کم یک بار در هفته آزمایشی‌اش کن (مثلاً یک ورک‌فلوی آزمایشی را عمداً از کار بینداز).

گام‌به‌گام

گام ۱: سه نوع خرابی، سه لایه

خرابینمونهچه کسی می‌فهمد
اجرا شکست خوردAPI بیرونی 503 دادError Workflow داخل n8n
ورک‌فلو ساکت شدورک‌فلو منتشر نیست، ماشه دیگر اجرا نمی‌شود، یا داده‌ای نمی‌رسدضربان قلب و ناظر بیرونی
کل n8n خاموش یا خراب استفرایند متوقف شد، دیسک پر شد، پایگاه داده قطع شدناظر بیرونی با readiness

هیچ لایه‌ای جای دیگری را نمی‌گیرد؛ در آزمون این درس، وقتی n8n متوقف شد، Error Workflow هیچ هشداری نداد و فقط ناظر بیرونی خبر داد (assets/monitoring-session.txt).

گام ۲: Error Workflow، با دو شرط که کمتر گفته می‌شود

Error Workflow با گره Error Trigger شروع می‌شود و در تنظیمات هر ورک‌فلو (Workflow Settings) انتخاب می‌شود؛ یکی می‌تواند برای چند ورک‌فلو کار کندsrc-n8n-error-handling. فایل assets/n8n-error-workflow.json فقط نام ورک‌فلو، گره، پیام خطا، شناسه و حالت اجرا را به کانال عملیات می‌فرستد، نه داده مشتری.

دو شرط که در کد n8n 2.44.4 دیدیم و در آزمون واقعی به آن خوردیم:

  1. خود Error Workflow باید منتشر شده باشد. پیش از انتشار، دو اجرای شکست‌خورده هیچ هشداری نساختند و لاگ n8n نوشت: Workflow "LkyA204ErrAlrt01" is not active and cannot be executed.
  2. در اجرای دستی صدا زده نمی‌شود. فقط اجرای خودکار (زمان‌بند، Webhook، ماشه) Error Workflow را فرا می‌خواند؛ پس با دکمه اجرای دستی آزمایشش نکن.

شناسه و نشانی اجرا فقط وقتی در داده خطا هست که اجرا در پایگاه داده ذخیره شودsrc-n8n-error-handling؛ اگر ذخیره اجراهای خطادار را خاموش کرده‌ای، هشدار بی‌پیوند می‌شود. حذف خودکار اجراهای قدیمی پیش‌فرض روشن است (۳۳۶ ساعت یا ۱۰٬۰۰۰ اجرا)src-n8n-execution-data؛ برای بررسی خطا بعد از دو هفته، خلاصه را بیرون نگه دار.

اجرای شکست‌خورده ورک‌فلوی همگام‌سازی در n8n با فهرست اجراهای خطادار و موفق

اجرای خودکار شکست‌خورده؛ گره دریافت سفارش 503 گرفت

اجرای Error Workflow در n8n که هشدار را به کانال عملیات فرستاد

Error Workflow پس از شکست، خودکار اجرا شد

گام ۳: ضربان قلب پس از موفقیت

در assets/n8n-order-sync-monitored.json آخرین گره، پس از کار اصلی، به /heartbeat/order-sync پیام «زنده‌ام» می‌دهد. چون آخر زنجیره است، فقط وقتی ثبت می‌شود که همه گره‌ها موفق بوده‌اند. پس ضربان قدیمی یعنی یکی از این‌ها: اجرا شکست می‌خورد، اجرا نمی‌شود، یا n8n خاموش است. ناظر لازم نیست بداند کدام؛ فقط می‌داند «کار انجام نشده».

حداکثر سن مجاز = فاصله زمان‌بندی + حاشیه. برای ورک‌فلوی هر دقیقه در آزمون، ۱۵۰ ثانیه؛ برای ورک‌فلوی روزانه، مثلاً ۲۶ ساعت. در محیط واقعی، به‌جای API آزمایشی، سرویس‌های پایش ضربان (cron monitoring) یا یک جدول در پایگاه داده خودت این نقش را دارند.

اجرای موفق پس از دو شکست که ضربان قلب ثبت کرده است

اجرای سوم موفق شد و ضربان قلب ثبت شد

گام ۴: ناظر بیرونی، readiness و /metrics

n8n این نقطه‌ها را داردsrc-n8n-monitoring:

  • /healthz: نمونه در دسترس است؛ وضعیت پایگاه داده را نشان نمی‌دهد.
  • /healthz/readiness: پایگاه داده وصل و migration انجام شده است. ناظر باید این را بپرسد.
  • /metrics: پیش‌فرض خاموش؛ با N8N_METRICS=true روشن می‌شود و فقط برای نسخه خودمیزبان است.

در n8n 2.44.4، /metrics بدون ورود پاسخ داد و شمارنده‌های n8n_workflow_failed_total و n8n_workflow_success_total فقط با N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true ظاهر شدند (assets/monitoring.env.example). چون ورود ندارد، از اینترنت ببندش؛ assets/Caddyfile همان پیکربندی درس استقرار با یک قانون است که /metrics را 404 می‌دهد (این فایل در آزمایشگاه درس اجرا نشد؛ با caddy validate بررسی‌اش کن).

assets/watch_n8n.py هر دور سه چیز را می‌سنجد و فقط هنگام تغییر وضعیت هشدار می‌دهد: یک بار هنگام خرابی و یک بار هنگام بازگشت. در آزمون واقعی:

  • ابتدا، پیش از اولین ضربان، یک هشدار «هنوز ضربانی نیست»، سپس دو دور بدون تکرار.
  • پس از توقف n8n، یک هشدار readiness در دور بعد؛ ۱۵۴ ثانیه پس از آخرین موفقیت، یک هشدار ضربان.
  • پس از راه‌اندازی دوباره، هشدار بازگشت readiness فوراً؛ ولی بازگشت ضربان چند دقیقه بعد، چون سرویس بیرونی هنوز دو بار 503 داد.

یک نکته از همان آزمون: شمارنده‌های /metrics با راه‌اندازی دوباره n8n از صفر شروع شدند. ابزار پایش باید «افزایش در بازه» را بسنجد، نه عدد خام.

گام ۵: هشدار خوب، کم و قابل اقدام

در آزمون، Error Workflow برای هر اجرای شکست‌خورده یک پیام فرستاد: چهار پیام برای دو قطعی کوتاه. برای ورک‌فلوی هر دقیقه، یک قطعی یک‌ساعته یعنی ۶۰ پیام؛ این همان خستگی از هشدار است. قاعده‌ها:

  • هشدار فقط برای چیزی که کسی باید درباره‌اش کاری بکند.
  • برای خطای گذرا، اول تلاش دوباره در خود گره (اگر اقدام ایدمپوتنت است) و هشدار فقط وقتی همه تلاش‌ها شکست خورد.
  • برای ورک‌فلوهای پرتکرار، به‌جای پیام برای هر شکست، به ضربان قلب و ناظر با هشدار تغییر وضعیت تکیه کن.
  • هر هشدار: چه چیزی، کجا، پیوند اجرا، و کار بعدی. بدون داده مشتری.

گام ۶: نسخه‌بندی با خروجی Git

فرمان n8n export:workflow --backup --output=<پوشه> همه ورک‌فلوها را هرکدام در یک فایل JSON خوانا صادر می‌کندsrc-n8n-cli. assets/export_workflows.sh این کار را انجام می‌دهد، فایل‌ها را برای الگوهای رایج رمز بررسی می‌کند و فقط اگر تغییری بود، commit می‌کند. در اجرای واقعی (assets/versioning-session.txt):

  • صدور اول: ۱۰ فایل، یک commit.
  • صدور دوباره بدون تغییر: «no workflow changes»؛ یعنی صدور پایدار است و diff بی‌معنا نمی‌سازد.
  • تغییر تعداد تلاش دوباره هشدار از ۳ به ۵: diff دقیقاً همان خط را به‌علاوه versionId و versionCounter نشان داد.
  • بازگرداندن: git show HEAD~1:workflows/<id>.json و n8n import:workflow --input=...، سپس صدور دوباره.

Credentialها صادر نمی‌شوند و رمزشده در n8n می‌مانند؛ ولی توکنی که کسی مستقیم در پارامتر گره چسبانده، صادر می‌شود. برای همین اسکریپت پیش از commit بررسی می‌کند و مخزن را خصوصی نگه دار. n8n 2.x خودش هم تاریخچه نسخه دارد (--version و --published در همان فرمان)، و Source control داخلی مبتنی بر Git در پلن‌های Business و Enterprise هستsrc-n8n-source-control؛ خروجی Git خودت در همه نسخه‌ها کار می‌کند و از نمونه n8n مستقل است.

مثال‌ها

پیاده‌سازی عملی

سه لایه پایش و یک بازگرداندن. حدود ۳۰ دقیقه.

  1. API آزمایشی را اجرا کن (shared/barg-sabz-mock-api.py).
  2. یکی از مسیرهای پایین را برو.
  3. برای یکی از ورک‌فلوهای خودت جدول بنویس: سه نوع خرابی، لایه پایش، حداکثر سن ضربان و گیرنده هشدار.
اجرای محلی

در n8n محلی، با N8N_METRICS=true و N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true: دو فایل ورک‌فلو را import کن، Credential «Barg Sabz mock API (Header Auth)» را بساز، هر دو را منتشر کن (Error Workflow هم) و n8n را دوباره راه بینداز. python watch_n8n.py --loop 45 را در پنجره‌ای جدا اجرا کن (assets/watch_n8n.py). چهار دقیقه صبر کن، سپس n8n را متوقف کن و سه دقیقه بعد دوباره راه بینداز. خروجی را با assets/monitoring-session.txt مقایسه کن. در پایان، ورک‌فلوی هر دقیقه را از انتشار خارج کن. بعد با export_workflows.sh صادر کن، یک تنظیم را عوض کن، دوباره صادر کن، diff را بخوان و نسخه قبلی را برگردان.

بدون اجرا / شبیه‌ساز

بدون اجرا: assets/monitoring-session.txt و assets/versioning-session.txt را بخوان و سه اسکرین‌شات را ببین. بنویس: (۱) در مرحله توقف n8n، چرا Error Workflow ساکت بود و کدام خط ناظر جای آن را گرفت؛ (۲) چرا بازگشت ضربان چند دقیقه دیرتر از بازگشت readiness آمد؛ (۳) اگر ناظر به‌جای هشدار تغییر وضعیت در هر دور هشدار می‌داد، در آن ۵ دقیقه چند پیام می‌رسید؛ (۴) در diff، کدام خط‌ها تغییر واقعی‌اند و کدام را n8n خودش عوض کرده.

اشتباه‌های رایج

اشتباهنتیجهکار درست
Error Workflow منتشرنشدههیچ هشداری، فقط یک خط لاگانتشار و آزمون با اجرای خودکار
آزمون Error Workflow با اجرای دستی«کار نمی‌کند»اجرای زمان‌بندی‌شده یا Webhook
فقط Error Workflowسکوت و خاموشی دیده نمی‌شودضربان قلب و ناظر بیرونی
ناظر روی همان سروربا سرور خاموش می‌شودماشین یا سرویس جدا
/healthz به‌جای readinessn8n «سالم» بدون پایگاه داده/healthz/readiness
/metrics عمومینشت اطلاعات نمونهبستن در پروکسی
هشدار برای هر شکست ورک‌فلوی پرتکرارخستگی از هشدارهشدار تغییر وضعیت و تلاش دوباره
ویرایش مستقیم ورک‌فلوی تولیدی بدون خروجیتغییر نامعلوم، برگشت ناممکنصدور پیش و پس از تغییر، با پیام commit

اشکال‌زدایی

ورک‌فلو شکست می‌خورد ولی هیچ هشداری نمی‌رسد.

Error Workflow منتشر نشده، در تنظیمات ورک‌فلو انتخاب نشده، یا آزمون با اجرای دستی بوده است.

در لاگ n8n is not active and cannot be executed؛ در Executions، حالت اجرای شکست‌خورده؛ در Executions خود Error Workflow، هیچ اجرایی.

انتشار Error Workflow، انتخاب آن در Workflow Settings، و آزمون با شکست عمدی در اجرای خودکار (مثلاً گره Stop and Error).

هیچ خطایی نیست ولی کار انجام نمی‌شود (گزارشی نرسید، داده‌ای به‌روز نشد).

ورک‌فلو منتشر نیست، ماشه اجرا نمی‌شود، یا ورک‌فلو «موفق» است ولی هیچ آیتمی پردازش نمی‌کند.

سن ضربان قلب؛ آخرین اجرای موفق در Executions؛ تعداد آیتم‌های پردازش‌شده.

ضربان پس از موفقیت با سقف سن، و اگر «صفر آیتم» غیرعادی است، ضربان را فقط وقتی ثبت کن که آیتمی پردازش شده یا با شمار آیتم بفرست.

کانال عملیات با ده‌ها پیام شکست پر شده و تیم دیگر نمی‌خواندش.

خطای گذرای سرویس بیرونی برای ورک‌فلوی پرتکرار، و هشدار برای هر اجرا.

تعداد پیام در ساعت؛ نسبت خطاهای گذرا (503، 429، timeout) به کل.

تلاش دوباره در گره برای اقدام ایدمپوتنت، هشدار تغییر وضعیت در ناظر، و حذف یا تجمیع پیام‌های تکراری.

تمرین کوتاه

تمرین · 13 دقیقه

هدف: طراحی پایش برای سه ورک‌فلو.

گام‌ها: برای هرکدام لایه‌ها، حداکثر سن ضربان و سیاست هشدار را بنویس: (الف) Webhook سفارش که روزی حدود ۲۰۰ بار اجرا می‌شود؛ (ب) گزارش فروش روزانه ساعت ۸ صبح؛ (ج) پشتیبان‌گیری شبانه پایگاه داده n8n (اسکریپت بیرون از n8n، درس استقرار).

معیار پذیرش: برای الف، هشدار برای هر شکست نیست؛ برای ب، سن ضربان کمی بیش از یک روز است؛ برای ج، Error Workflow بی‌ربط است و ضربان از خود اسکریپت می‌آید.

راه‌حل نمونه

(الف) Error Workflow با تلاش دوباره در گره‌ها، ولی هشدار در کانال فقط از ناظر وقتی نسبت شکست در ۱۵ دقیقه از آستانه گذشت (با شمارنده‌های /metrics)؛ ضربان برای Webhook معنای کمتری دارد چون اجرا به رسیدن رویداد بستگی دارد، پس «هیچ سفارشی در ۶ ساعت کاری» را جدا بسنج. (ب) Error Workflow برای هر شکست (روزی یک اجرا، پس پیام کم است)، ضربان پس از ارسال گزارش با سقف حدود ۲۵ ساعت تا اگر ورک‌فلو منتشر نبود فردا صبح بفهمی. (ج) n8n در آن نقش ندارد: اسکریپت پشتیبان پس از موفقیت و بررسی فایل، خودش ضربان ثبت می‌کند (سقف حدود ۲۵ ساعت)؛ و یک بار در ماه بازگردانی آزمایشی.

چالش

تمرین · 45 دقیقه

موقعیت: برای نمونه n8n خودت (یا نمونه آزمایشی) پایش و نسخه‌بندی کامل بساز. داده ساختگی یا ناشناس‌شده برای آزمون کافی است؛ اگر داده واقعی است، هشدارها نباید داده مشتری داشته باشند.

  1. یک Error Workflow منتشرشده با هشدار کم‌داده، و انتخاب آن برای همه ورک‌فلوهای تولیدی.
  2. ضربان پس از موفقیت برای دست‌کم دو ورک‌فلوی زمان‌بندی‌شده با سقف سن مستند.
  3. ناظر بیرونی روی ماشین یا سرویس جدا با readiness، سن ضربان و هشدار تغییر وضعیت؛ /metrics بسته از اینترنت.
  4. صدور روزانه به مخزن خصوصی Git و یک تمرین بازگرداندن نسخه.
  5. سه آزمون: شکست عمدی، توقف n8n، و ورک‌فلوی از انتشار خارج‌شده.

خروجی مورد انتظار: جدول لایه‌ها، شاهد سه آزمون (پیام‌ها و زمان‌ها)، پیوند یا خروجی git log و یادداشت بازگرداندن.

معیار پذیرش:

  • هر سه آزمون در کمتر از سقف تعیین‌شده هشدار دادند و هر خرابی فقط یک هشدار شروع و یک هشدار بازگشت داشت.
  • هیچ هشداری داده مشتری ندارد.
  • بازگرداندن نسخه با فرمان‌های مستند انجام و آزموده شد.

پرسش‌های سنجش

جمع‌بندی

  • سه خرابی، سه لایه: شکست اجرا با Error Workflow، سکوت با ضربان قلب، خاموشی با ناظر بیرونی.
  • Error Workflow باید منتشر باشد و در اجرای دستی صدا زده نمی‌شود.
  • ضربان را آخر زنجیره و فقط پس از موفقیت ثبت کن؛ سقف سن = فاصله اجرا + حاشیه.
  • ناظر بیرون از سرور n8n، /healthz/readiness را بپرسد و فقط هنگام تغییر وضعیت هشدار دهد.
  • /metrics ورود ندارد؛ از اینترنت ببندش. شمارنده‌ها با راه‌اندازی دوباره صفر می‌شوند.
  • ورک‌فلوها را منظم به Git خصوصی صادر کن؛ diff بخوان و بازگرداندن را تمرین کن.

پرسش‌های سنجش

سه گزارش از یک هفته: (الف) گزارش فروش دوشنبه نرسید؛ در Executions هیچ اجرایی برای دوشنبه نیست و خطایی هم ثبت نشده. (ب) سه‌شنبه ساعت ۳ بامداد دیسک سرور پر شد و n8n تا صبح پاسخ نداد. (ج) چهارشنبه API انبار نیم ساعت 500 داد. هرکدام کدام نوع خرابی است و کدام لایه پایش باید آن را گزارش می‌کرد؟

پاسخ نمونه و معیار ارزیابی

(الف) سکوت ورک‌فلو (اجرا نشده، شاید منتشر نبود یا ماشه کار نکرد)؛ Error Workflow چیزی نمی‌بیند چون اجرایی نیست؛ ضربان قلب پس از موفقیت با سقف حدود ۲۵ ساعت و ناظر بیرونی باید سه‌شنبه صبح خبر می‌داد. (ب) خاموشی یا خرابی نمونه؛ ناظر بیرونی روی ماشین جدا با /healthz/readiness (و هشدار ضربان‌ها). (ج) شکست اجرا؛ Error Workflow، ترجیحاً پس از تلاش دوباره در گره و با کنترل تعداد پیام.

  • الف: سکوت، ضربان و ناظر، نه Error Workflow (1 امتیاز)
  • ب: ناظر بیرونی جدا و readiness (1 امتیاز)
  • ج: Error Workflow با کنترل تکرار (1 امتیاز)
  • Error Workflow برای همه ← Error Workflow فقط وقتی اجرا هست و n8n روشن است خبر می‌دهد.

دو دلیل جداگانه برای نرسیدن پیام را بنویس و بگو چطور درست آزمایش کند.

سازنده می‌گوید: «Error Workflow ساختم، در تنظیمات ورک‌فلوی سفارش انتخابش کردم، یک گره Stop and Error گذاشتم و دکمه Execute workflow را زدم. اجرا قرمز شد ولی هیچ پیامی نیامد.» در لاگ سرور، از روزهای قبل این خط هست:

Calling Error Workflow for "Ord01". Workflow "Err01" is not active and cannot be executed
پاسخ نمونه و معیار ارزیابی

(۱) اجرای دستی Error Workflow را فرا نمی‌خواند؛ فقط اجرای خودکار (زمان‌بند، Webhook، ماشه). (۲) طبق لاگ، Error Workflow منتشر نشده است و در اجراهای خودکار قبلی هم صدا زده نشده. آزمون درست: Error Workflow را منتشر کند، ورک‌فلوی سفارش را منتشر کند و با یک رویداد واقعی (یا زمان‌بند آزمایشی) آن را به شکست عمدی برساند، سپس Executions خود Error Workflow و کانال هشدار را ببیند؛ در پایان گره شکست عمدی را بردارد.

  • اجرای دستی Error Workflow را صدا نمی‌زند (1 امتیاز)
  • Error Workflow منتشر نیست (از لاگ) (1 امتیاز)
  • آزمون با اجرای خودکار و برداشتن شکست عمدی (1 امتیاز)
  • Stop and Error کار نمی‌کند ← Stop and Error اجرا را به شکست می‌رساند؛ مسئله حالت اجرا و انتشار است.

ورک‌فلوی «پشتیبان‌گیری Google Sheets» هر ۶ ساعت اجرا می‌شود و معمولاً ۲ دقیقه طول می‌کشد. محل ضربان در ورک‌فلو، سقف سن، و رفتار ناظر برای یک قطعی ۱۸ ساعته را بنویس.

پاسخ نمونه و معیار ارزیابی

ضربان آخرین گره، پس از نوشتن و بررسی خروجی پشتیبان؛ پس فقط پس از موفقیت ثبت می‌شود. سقف سن: ۶ ساعت به‌علاوه حاشیه (مثلاً ۶ ساعت و ۳۰ دقیقه، یا ۷ ساعت اگر اجراها گاهی دیر می‌شوند). ناظر هر چند دقیقه می‌سنجد؛ وقتی سن از سقف گذشت یک هشدار خرابی می‌فرستد، در طول ۱۸ ساعت هیچ هشدار تکراری نمی‌فرستد (وضعیت قبلی را نگه می‌دارد)، و پس از اولین ضربان تازه یک هشدار بازگشت می‌فرستد.

  • ضربان آخر زنجیره پس از موفقیت (1 امتیاز)
  • سقف = فاصله + حاشیه (1 امتیاز)
  • یک هشدار شروع و یک بازگشت، بدون تکرار (1 امتیاز)
  • ضربان در ابتدای ورک‌فلو ← ضربان اول زنجیره فقط می‌گوید ماشه اجرا شد، نه اینکه کار انجام شد.

ناظر بیرونی کدام نقطه را برای «n8n آماده کار است» بپرسد؟

  • /healthz، چون همیشه روشن است.
  • /healthz/readiness، چون اتصال و به‌روز بودن پایگاه داده را هم نشان می‌دهد.
  • /metrics، چون اطلاعات بیشتری دارد.
  • صفحه ورود ویرایشگر.
پاسخ نمونه و معیار ارزیابی
  • a ← /healthz فقط در دسترس بودن را نشان می‌دهد، نه وضعیت پایگاه داده.
  • c ← /metrics پیش‌فرض خاموش است و برای سنجه است، نه پاسخ آماده/ناآماده.
  • d ← صفحه ورود ممکن است بالا باشد وقتی پایگاه داده قطع است.

تیم دو نفره برگ سبز با n8n Community خودمیزبان می‌خواهد تغییرات ورک‌فلو را ببیند و برگرداند. گزینه‌ها: (الف) صدور روزانه با CLI به مخزن خصوصی Git؛ (ب) تکیه بر تاریخچه نسخه داخلی n8n؛ (ج) ارتقا به پلنی که Source control داخلی دارد. موازنه‌ها و انتخابت را بنویس.

پاسخ نمونه و معیار ارزیابی

(الف) در همه نسخه‌ها کار می‌کند، مستقل از نمونه است (اگر سرور از دست رفت، ورک‌فلوها هست)، diff و پیام commit دارد؛ ولی فقط به اندازه دفعات صدور دقیق است، credential ندارد و باید برای رمزهای چسبانده‌شده بررسی شود. (ب) بی‌هزینه و فوری است و هر ذخیره را دارد، ولی داخل همان نمونه و پایگاه داده است: با از دست رفتن سرور از دست می‌رود و بازبینی بیرونی ندارد. (ج) جریان push/pull و محیط‌ها را می‌دهد، ولی هزینه پلن Business یا Enterprise دارد و برای دو نفر احتمالاً بیش از نیاز است. انتخاب: (ب) برای برگشت سریع روزمره به‌علاوه (الف) روزانه و پیش از هر تغییر مهم؛ (ج) وقتی تیم و محیط‌های جدا (آزمایشی و تولید) لازم شد.

  • الف: استقلال از نمونه و محدودیت دفعات و رمز (1 امتیاز)
  • ب: داخل همان نمونه (1 امتیاز)
  • ج: هزینه پلن و تناسب با تیم، و انتخاب ترکیبی با دلیل (1 امتیاز)
  • تاریخچه داخلی کافی است ← تاریخچه‌ای که روی همان سرور است، با همان سرور از دست می‌رود.

فایل‌های درس

Error Workflow با هشدار کم‌داده به پیام‌رسان آزمایشی (غیرفعال)

n8n-error-workflow.json

ورک‌فلوی زمان‌بندی‌شده با Error workflow و ضربان قلب پس از موفقیت (غیرفعال)

n8n-order-sync-monitored.json

ناظر بیرونی: readiness، سن ضربان، /metrics، هشدار یک‌باره

watch_n8n.py

خروجی واقعی سه مرحله: شکست و بازگشت، خاموشی n8n، راه‌اندازی دوباره

monitoring-session.txt

متغیرهای پایش n8n با توضیح

monitoring.env.example

پیکربندی پروکسی درس استقرار به‌علاوه بستن /metrics از اینترنت

Caddyfile

صدور ورک‌فلوها به Git با بررسی رمز

export_workflows.sh

خروجی واقعی صدور، diff و بازگرداندن نسخه

versioning-session.txt

اسکرین‌شات اجرای شکست‌خورده و فهرست اجراها

n8n-sync-failed-run.webp

اسکرین‌شات اجرای Error Workflow

n8n-error-workflow-run.webp

اسکرین‌شات اجرای موفق با ثبت ضربان قلب

n8n-sync-recovered-run.webp

API آزمایشی با /flaky، /heartbeat و پیام‌رسان آزمایشی

barg-sabz-mock-api.py

ابزارها و جایگزین‌ها

  • Python 3.9 یا بالاتر و API آزمایشی برگ سبز — ناظر بیرونی و ضربان قلب — مسیر بدون اجرا با خروجی واقعی

منابع

Handle errors gracefully n8n accessed 2026-10-16

Manage execution data n8n n8n docs, 2026-10

Monitor n8n n8n n8n docs, 2026-10

Use the command line (CLI commands) n8n n8n docs, 2026-10

Use source control and environments n8n n8n docs, 2026-10

دوره

n8n در تولید