ARCH_NCاستودیو معماری دیجیتال
اتوماسیون

مدیریت خطا در n8n: Error Trigger، تلاش مجدد و هشدار تلگرامی

مدیریت خطا در n8n یعنی هر گردش‌کاری که شکست خورد، شما را خبر کند و داده‌ی آن گم نشود. سه ابزار اصلی دارید: Error Trigger برای هشدار، Retry On Fail برای خطاهای گذرا و مسیر خطا برای ادامه‌ی کار بدون توقف کل گردش‌کار.

چرا مدیریت خطا مهم است؟

گردش‌کاری که بی‌صدا شکست بخورد، از نبودن اتوماسیون هم بدتر است، چون همه فکر می‌کنند کار انجام می‌شود. اگر ثبت سفارش در CRM شکست بخورد و کسی خبردار نشود، سفارش گم می‌شود. دلیل شکست معمولاً ساده است: قطع‌شدن API، اعتبارنامه‌ی منقضی، داده‌ی ناقص یا محدودیت تعداد درخواست.

ساخت گردش‌کار هشدار خطا با Error Trigger

برای هشدار خطا، یک گردش‌کار جدا با گره‌ی Error Trigger می‌سازید و آن را در تنظیمات گردش‌کارهای دیگر به‌عنوان «گردش‌کار خطا» معرفی می‌کنید. هر بار گردش‌کاری شکست بخورد، این گردش‌کار با اطلاعات خطا اجرا می‌شود.

  1. یک گردش‌کار جدید بسازید و گره‌ی Error Trigger را اضافه کنید.
  2. گره‌ی Telegram (یا ایمیل یا Slack) را وصل کنید و پیام بسازید: نام گردش‌کار، آخرین گره‌ی اجراشده، متن خطا و لینک اجرا؛ این اطلاعات در خروجی Error Trigger هست.
  3. در تنظیمات هر گردش‌کار، همین گردش‌کار را به‌عنوان Error Workflow انتخاب کنید.
  4. گردش‌کار خطا را فعال کنید و با یک خطای عمدی آزمایش کنید.

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

تلاش مجدد برای خطاهای گذرا (Retry On Fail)

بعضی خطاها گذرا هستند: تایم‌اوت، خطای ۵۰۰ سرور مقصد یا محدودیت موقت تعداد درخواست. در تنظیمات هر گره می‌توانید Retry On Fail را روشن کنید و تعداد تلاش و فاصله‌ی بین آن‌ها را تعیین کنید. تلاش مجدد خطاهای دائمی را درست نمی‌کند، پس برای خطای اعتبارسنجی یا داده‌ی اشتباه بی‌فایده است.

  • تعداد کم، فاصله‌ی بیشتر: چند تلاش با فاصله بهتر از ده تلاش پشت‌سرهم است.
  • مراقب تکرار باشید: اگر گره «ساخت سفارش» است و تلاش مجدد ممکن است دو سفارش بسازد، پیش از ساخت وجود سفارش را بررسی کنید یا شناسه‌ی یکتا بدهید.

مسیر خطا و ادامه‌ی کار (On Error)

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

حالترفتارمناسب برای
توقف گردش‌کاراجرا همان‌جا قطع می‌شود و گردش‌کار خطا فعال می‌شودمراحل حیاتی مثل ثبت سفارش
ادامهخطا نادیده گرفته می‌شود و اجرا ادامه می‌یابدمراحل غیرحیاتی، فقط با احتیاط
ادامه با خروجی خطاآیتم خراب به مسیر جدا می‌رودپردازش چند آیتم و ثبت موارد شکست‌خورده

ذخیره‌ی داده‌ی شکست‌خورده

هشدار کافی نیست؛ داده‌ای که پردازش نشده باید بماند تا بشود دوباره پردازشش کرد. در مسیر خطا، آیتم را در یک جدول (مثل Google Sheets یا PostgreSQL) با زمان، متن خطا، داده‌ی ورودی و وضعیت ذخیره کنید. بعد یک گردش‌کار زمان‌بندی‌شده می‌تواند موارد «در انتظار» را دوباره امتحان کند یا برای بررسی دستی اعلام کند.

پایش خود n8n

گردش‌کار خطا فقط زمانی هشدار می‌دهد که خود n8n کار کند. اگر سرور یا پایگاه‌داده از کار بیفتد، باید یک پایشگر بیرونی خبر بدهد. n8n آدرس سلامت (/healthz) دارد که ابزارهای پایش می‌توانند مرتب بخوانند. روش دیگر یک گردش‌کار «ضربان» است که هر چند دقیقه پیام می‌فرستد و نبودن پیامش هشدار می‌دهد. اصول نصب و پشتیبان‌گیری در n8n روی سرور خودتان یا ابری آمده است.

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

  • ادامه با خطای نادیده‌گرفته‌شده: در مراحل حیاتی «Continue» نگذارید.
  • هشدار بیش از حد: اگر هر خطای کوچک پیام بدهد، تیم هشدارها را نمی‌خواند. فقط خطاهای اقدام‌پذیر را اعلام کنید.
  • ذخیره‌ی داده‌ی حساس در لاگ: اجرای موفق و ناموفق داده‌ی ورودی را نگه می‌دارد؛ سیاست نگهداری را تنظیم کنید.
  • نداشتن گردش‌کار خطا برای گردش‌کارهای جدید: هر گردش‌کار تازه را به Error Workflow وصل کنید.

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

آیا Error Trigger وقتی خود n8n از کار بیفتد هم هشدار می‌دهد؟

نه. اگر n8n خاموش یا خراب باشد، خودش نمی‌تواند هشدار بدهد. برای این حالت به پایش بیرونی یا گردش‌کار ضربان نیاز دارید.

چند بار تلاش مجدد بگذارم؟

معمولاً دو یا سه تلاش با فاصله‌ی چند ثانیه برای خطاهای گذرا کافی است. تلاش بیشتر ممکن است باعث تکرار عمل یا فشار به سرویس مقصد شود.

سابقه‌ی اجرا را چقدر نگه دارم؟

بسته به نیاز عیب‌یابی. سابقه‌ی طولانی به پایگاه‌داده فشار می‌آورد و ممکن است داده‌ی حساس را نگه دارد؛ تنظیم نگهداری اجراها را در n8n بررسی کنید.

گام بعد

برای ساخت گردش‌کارهایی که از اول خطاپذیر طراحی شده‌اند، صفحه‌ی اتوماسیون n8n برای کسب‌وکار را ببینید. اگر هنوز مبانی را نمی‌دانید، اتوماسیون n8n چیست را بخوانید و برای مثال کاربردی، اتوماسیون فروش با n8n را ببینید.

خدمت مرتبط: اتوماسیون n8n برای کسب‌وکار شما