وداعاً لقراءة الـ Logs الخام: كيف جعلت n8n و Vertex AI يحللان الخطأ قبل أن أفتح اللابتوب

جمعة الأهل، وصوت تنبيه يُعكّر صفو فنجان القهوة

يا جماعة الخير، الله يعطيكم العافية. اسمحولي أبدأ بقصة صارت معي قبل كم شهر. كانت الدنيا يوم جمعة، وبعد غداء دسم، قاعد مع الأهل والحبايب، وفنجان القهوة باليمين وصينية الكنافة النابلسية باليسار، والأمور تمام والحمد لله. فجأة، الهاتف يهتز بصوت أعرفه جيدًا، صوت تنبيه من نظام المراقبة: “Server Error 500 on Main App”.

في تلك اللحظة، كل سيناريوهات الرعب تمر في ذهن أي مطور. هل هو ضغط على السيرفر؟ هل قاعدة البيانات “ضربت”؟ هل تحديث جديد عمل مصيبة؟ استأذنت من الوالد والوالدة “شغلة خمس دقايق وراجع”، وركضت على غرفة المكتب. فتحت اللابتوب، وشبكت الـ VPN، ثم دخلت بـ SSH على السيرفر الأول، ثم الثاني… وبدأت رحلة التنقيب في ملفات الـ logs. عشرات، بل مئات الأسطر من النصوص غير المفهومة تمر أمام عيني. بعد حوالي ربع ساعة من البحث والتحليل، اكتشفت أن المشكلة كانت بسيطة: أحد الـ workers استهلك كل الذاكرة المتاحة وتوقف عن العمل. الحل كان مجرد إعادة تشغيل للخدمة.

رجعت للجميع وأنا أفكر: “كل هذه المعاناة والوقت الضايع عشان مشكلة حلها بكبسة زر؟”. هنا، وكما يقولون “الحاجة أم الاختراع”، قررت أن هذا الأسلوب البدائي في التعامل مع الأخطاء يجب أن ينتهي. قررت أن أجعل الآلة تعمل من أجلي، لا أن أكون أنا عبدًا لها. ومن هنا بدأت رحلتي مع نظامي الذكي لتحليل الأخطاء.

لماذا الأتمتة؟ لأن وقت المطور أغلى من أن يضيع في البحث

قبل أن ندخل في التفاصيل التقنية، خلينا نتفق على مبدأ. وظيفتنا كمطورين ومهندسين هي حل المشاكل وبناء الحلول، وليس قضاء ساعات في البحث اليدوي المتكرر. كل دقيقة تقضيها في قراءة ملفات الـ log هي دقيقة كان من الممكن أن تقضيها في تطوير ميزة جديدة أو تحسين أداء التطبيق. المشكلة (قبل) كانت واضحة:

• تنبيه غامض: “Server Error 500” لا يخبرك بشيء.
• عملية يدوية مرهقة: فتح SSH، التنقل بين الملفات، استخدام أوامر مثل grep و tail و less.
• وقت استجابة بطيء: قد تمر دقائق ثمينة قبل أن تعرف السبب الحقيقي للمشكلة.

الحل الذي صممتُه (بعد) يقلب المعادلة:

• تنبيه ذكي: “خطأ 500. السبب المحتمل: استهلاك الذاكرة تجاوز 90%. الحل المقترح: إعادة تشغيل الخدمة X”.
• عملية مؤتمتة بالكامل: النظام يقوم بكل شيء في الخلفية خلال ثوانٍ.
• استجابة فورية: أعرف المشكلة والحل المقترح في نفس اللحظة التي يحدث فيها الخطأ.

أدواتنا في هذه المعركة الرقمية

لتحقيق هذا الهدف، اعتمدت على أداتين رئيسيتين، كل واحدة لها دورها المحدد والمهم:

1. n8n.io: أعتبرها “المايسترو” أو “المُخ” تبع الأتمتة. هي منصة مفتوحة المصدر تتيح لك ربط تطبيقات وخدمات مختلفة معًا في سير عمل (Workflow) مرئي وسهل. بدل ما تكتب كود معقد لربط واجهات برمجية (APIs)، بتقدر تسحب وتفلت “عُقد” (Nodes) وتربطها ببعض.
2. Google Vertex AI: هذه هي “العضلات الذكية” أو الخبير التقني الذي لا ينام. هي منصة الذكاء الاصطناعي من جوجل التي تتيح الوصول إلى نماذج لغوية قوية جدًا (مثل Gemini). سنستخدمها لتحليل نص الـ log وفهم معناه وتقديم ملخص وحل.

بناء ورشة العمل الرقمية (The Workflow) خطوة بخطوة

الآن، لننتقل إلى الجزء العملي. سأشرح لكم كيف بنيت الـ Workflow في n8n الذي يقوم بكل هذا السحر. تخيلوا معي لوحة بيضاء، وسنبدأ برسم الخطوات عليها.

الخطوة الأولى: نقطة البداية (Webhook Node)

كل عملية أتمتة تحتاج إلى مُشغّل (Trigger). في حالتنا، المُشغّل هو وصول إشعار بالخطأ. أفضل طريقة لاستقبال هذه الإشعارات هي عبر “الخطاف الرقمي” أو الـ Webhook.

• ما هو الـ Webhook؟ ببساطة، هو عبارة عن رابط (URL) فريد يوفره n8n. أي خدمة ترسل طلبًا (HTTP POST request) إلى هذا الرابط، ستقوم بتشغيل الـ workflow فورًا.
• كيف نستخدمه؟ في أداة المراقبة التي تستخدمها (سواء كانت Sentry, UptimeRobot, Prometheus Alertmanager, أو حتى سكربت بسيط من عندك)، تقوم بضبطها لترسل طلبًا إلى رابط الـ Webhook هذا كلما حدث خطأ من نوع “Server 500”.

بمجرد إضافة عقدة الـ Webhook في n8n، سيعطيك الرابط. انسخه وجهّزه للاستخدام.

الخطوة الثانية: المحقق الميداني (SSH Node)

الآن بعد أن وصل التنبيه، نحتاج إلى جمع الأدلة. الأدلة موجودة في ملفات سجل الأخطاء (Error Logs) على السيرفر. هنا يأتي دور عقدة الـ SSH.

• الإعداد: تقوم بإضافة عقدة SSH وتربطها بعقدة الـ Webhook. في إعدادات العقدة، ستحتاج إلى إضافة بيانات الدخول للسيرفر (العنوان، اسم المستخدم، ومفتاح SSH الخاص).
• الأمر (Command): في خانة الأمر، نكتب أمرًا بسيطًا ليقوم بسحب آخر 50 سطرًا من ملف سجل الأخطاء. هذا يعطينا سياقًا كافيًا حول الخطأ الأخير.

tail -n 50 /var/log/nginx/error.log

طبعًا، يجب أن تغيّر المسار /var/log/nginx/error.log إلى المسار الصحيح لملف الأخطاء في تطبيقك (قد يكون ملف log خاص بـ Laravel, Django, Node.js, etc.).

نصيحة من أبو عمر: لا تستخدم كلمة مرور للدخول عبر SSH في الأتمتة أبدًا! دائمًا استخدم أزواج مفاتيح SSH (SSH Keys). قم بإنشاء مفتاح SSH مخصص لهذه المهمة فقط، وأعطه صلاحيات محدودة جدًا على السيرفر (فقط قراءة ملف الـ log) لزيادة الأمان.

الخطوة الثالثة: العقل المدبّر (Vertex AI Node)

هنا يحدث السحر الحقيقي. لقد حصلنا على نص الـ log الخام، وهو نص تقني بحت. الآن، نريد من شخص خبير أن يقرأه ويخبرنا “شو القصة؟”. هذا الخبير هو Vertex AI.

• الإعداد: أضف عقدة Vertex AI (أو أي عقدة LLM أخرى مثل OpenAI). ستحتاج إلى ربط حسابك في Google Cloud وتقديم بيانات الاعتماد (API Key).
• الـ Prompt (التلقين): هذا هو أهم جزء. الـ Prompt هو السؤال أو الأمر الذي نعطيه للذكاء الاصطناعي. يجب أن يكون واضحًا ومحددًا. نرسل له نص الـ log الذي حصلنا عليه من عقدة الـ SSH مع الـ Prompt التالي:

أنت مهندس DevOps خبير ومحترف. أمامك جزء من سجل أخطاء (log) من سيرفر. قم بتحليل هذا الخطأ ثم أجب على النحو التالي بالضبط:

السبب المحتمل: [اشرح السبب الرئيسي للمشكلة في جملة واحدة بسيطة ومباشرة].

الحل المقترح: [اقترح حلاً تقنياً عملياً ومباشراً للمشكلة في جملة واحدة].

هذا هو سجل الأخطاء:

{{ $json.data }}

لاحظ أن {{ $json.data }} هي الطريقة في n8n لسحب البيانات القادمة من العقدة السابقة (في حالتنا، مخرجات أمر SSH).

الخطوة الرابعة: الرسول (Telegram Node)

الآن، لدينا تحليل جاهز وواضح للمشكلة مع حل مقترح. آخر خطوة هي أن يصلنا هذا التقرير الثمين على هاتفنا مباشرةً.

• الإعداد: أضف عقدة Telegram، وقم بربطها بحساب البوت الخاص بك (إنشاء بوت تليجرام سهل جدًا عبر BotFather) وأدخل الـ Chat ID الخاص بك.
• صياغة الرسالة: نستخدم البيانات القادمة من عقدة Vertex AI لصياغة رسالة واضحة ومنظمة.

ستبدو الرسالة التي ستصممها في n8n كالتالي:

🚨 تنبيه خطأ حرج في السيرفر! 🚨

تم اكتشاف خطأ (HTTP 500) في التطبيق الرئيسي.

—

تحليل الذكاء الاصطناعي:

{{ $json.data }}

—

تم إرسال هذا التنبيه بواسطة نظام المراقبة الذكي (أبو عمر).

الجميل هنا أن {{ $json.data }} ستحتوي على الإجابة المنظمة التي طلبناها من Vertex AI، مما يجعل الرسالة النهائية التي تصلك على تيليجرام بهذا الشكل:

🚨 تنبيه خطأ حرج في السيرفر! 🚨
تم اكتشاف خطأ (HTTP 500) في التطبيق الرئيسي.
—
تحليل الذكاء الاصطناعي:
السبب المحتمل: استنفاد الذاكرة المتاحة (Out of Memory) بسبب عملية PHP-FPM.
الحل المقترح: قم بإعادة تشغيل خدمة PHP-FPM أو فكر في زيادة ذاكرة الخادم.
—
تم إرسال هذا التنبيه بواسطة نظام المراقبة الذكي (أبو عمر).

نصائح ذهبية لتحسين النظام

هذا النظام رائع كنقطة بداية، ولكن مع الخبرة، يمكنك تحسينه أكثر:

• تحسين الـ Prompt: كلما كان الـ Prompt أفضل، كانت النتائج أدق. يمكنك إضافة سياق أكثر للـ Prompt مثل: “علماً بأن هذا التطبيق يعمل بتقنية Laravel على سيرفر Ubuntu مع Nginx”. هذا يساعد النموذج على إعطاء إجابات أكثر دقة.
• التعامل مع الأخطاء المختلفة: يمكنك توسيع الـ workflow ليقرأ من ملفات log مختلفة بناءً على نوع التنبيه الأولي.
• إجراءات تلقائية (بحذر!): للمحترفين فقط، يمكن إضافة خطوة خامسة. إذا كان الذكاء الاصطناعي واثقًا من الحل (مثلاً “إعادة تشغيل خدمة”)، يمكنك إضافة عقدة SSH أخرى تقوم بتنفيذ أمر إعادة التشغيل تلقائيًا! لكن ابدأ بهذه الخطوة بحذر شديد وبعد اختبارات مكثفة.

الخلاصة: من مطوّر مُرهَق إلى مطوّر مُسيطر 🧘‍♂️

يا جماعة الخير، الانتقال من مطور يركض ليفتح اللابتوب في منتصف الليل إلى مطور يصله ملخص المشكلة وحلها على هاتفه وهو يشرب قهوته، هو نقلة نوعية. هذا النظام لا يوفر الوقت والجهد فقط، بل يمنحك راحة بال وثقة أكبر في أنظمتك.

الأتمتة والذكاء الاصطناعي ليسا مجرد كلمات طنانة، بل هما أدوات حقيقية يمكنها أن تجعل حياتنا كمهندسين ومطورين أفضل وأكثر إنتاجية. لم نعد بحاجة للقيام بالمهام المتكررة والمملة التي يمكن للآلة القيام بها بشكل أسرع وأفضل.

نصيحتي الأخيرة لكم: لا تخافوا من تجربة هذه الأدوات. ابدأوا بمشكلة صغيرة ومزعجة في عملكم اليومي، وفكروا كيف يمكن لـ n8n والذكاء الاصطناعي حلها. ستتفاجؤون من النتائج. يلا، شدوا حيلكم وجربوها، وإذا احتجتم أي مساعدة، أنا موجود. الله يوفقكم. 🚀