وحدة التحكم

اعرض سجلات المحرك والتطبيق في الوقت الفعلي مع التصفية والتصنيفات الملوّنة وإمكانات التصدير.

هذه هي صفحة «السجلات»

في الشريط الجانبي للمشروع، يُسمّى هذا العرض Logs (ضمن مجموعة Observe) ويقع على المسار /console. لتتبّع أخطاء التطبيق تحديداً، راجع صفحة الأخطاء المخصصة.

نظرة عامة

توفّر وحدة التحكم عرضاً مباشراً لسجلات محرك مشروعك. كل إجراء في مشروعك — استدعاءات endpoints واستعلامات قاعدة البيانات وأحداث المصادقة وعمليات الذكاء الاصطناعي — يولّد إدخالات سجل تظهر هنا في الوقت الفعلي.

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

الوضع المباشر

فعّل Live mode لتمكين جلب السجلات تلقائياً. عند التفعيل، تنتقل الوحدة تلقائياً لإظهار أحدث الإدخالات فور وصولها.

يمكنك ضبط فترة الجلب حسب حاجتك:

الفترة	حالة الاستخدام
`2s`	تصحيح نشط — أعلى معدّل تحديث
`4s`	الافتراضي — توازن بين الأداء والحداثة
`10s`	مراقبة معتدلة — استهلاك موارد أقل
`30s`	مراقبة في الخلفية — حد أدنى من العبء

أوقف الوضع المباشر مؤقتاً لفحص إدخالات محددة دون أن يبتعد العرض بالتمرير. يظهر زر «الانتقال إلى الأسفل» عندما تمرّر لأعلى.

التصفية

توفّر الوحدة بُعدي تصفية يمكن دمجهما:

حسب النطاق

النطاق	يعرض
User	نشاط المستخدم فقط (استدعاءات endpoints وأحداث المصادقة وعمليات التخزين)
All	مخرجات التصحيح الكاملة بما فيها سجلات المحرك الداخلية وفحوصات الصحة وأحداث النظام

حسب مستوى السجل

التصفية	المستويات المعروضة
All	DEBUG, INFO, WARN, ERROR
Warnings + Errors	WARN, ERROR
Errors only	ERROR

تصنيفات السجلات

كل إدخال سجل يحمل تصنيفاً ولوناً للتعرّف البصري السريع. هذا يسهّل مسح كميات كبيرة من السجلات والعثور على الإدخالات ذات الصلة:

الوسم	اللون	المصدر
`[ERROR]`	أحمر	أخطاء التطبيق والاستثناءات غير المعالجة
`[WARN]`	أصفر	إشعارات الإيقاف التدريجي والتحذيرات قرب الحدود
`[ENDPOINT]`	أزرق	تنفيذ endpoint في الـ API (الطريقة والمسار والحالة)
`[WORKFLOW]`	بنفسجي	خطوات تنفيذ عقد محرر التدفق
`[AUTH]`	برتقالي	تسجيل الدخول والخروج وتجديد الرمز وأحداث المزوّد
`[AI]`	زمردي	استدعاءات LLM وتنفيذ الوكيل واستخدام أدوات MCP
`[DATABASE]`	سماوي	استعلامات SQL وعمليات الجداول والهجرات
`[STORAGE]`	كهرماني	رفع الملفات وتنزيلها وعمليات الحاويات
`[HTTP]`	سماوي فاتح	طلبات HTTP الصادرة (عقدة HTTP Request وعقد التكامل)
`[RATE_LIMIT]`	أحمر	أحداث تحديد المعدّل والطلبات المقيّدة
`[INFO]`	أزرق	رسائل معلوماتية عامة
`[DEBUG]`	رمادي	مخرجات تصحيح تفصيلية (في نطاق All فقط)

قراءة إدخالات السجل

يتبع كل إدخال سجلاً بتنسيق ثابت:

JavaScript

[2024-03-15 14:32:01] [ENDPOINT] POST /api/users → 201 (45ms)
[2024-03-15 14:32:01] [DATABASE] INSERT INTO users (email, name) VALUES ($1, $2)
[2024-03-15 14:32:02] [AUTH] Token issued for user_id=abc123
[2024-03-15 14:32:05] [ERROR] Code node timeout after 30000ms

يشمل التنسيق طابعاً زمنياً ووسم تصنيف ورسالة وصفية. تتضمن سجلات endpoints أيضاً طريقة HTTP والمسار ورمز الحالة ومدة التنفيذ.

خيارات التصدير

يوفر شريط أدوات الوحدة عدة إجراءات للعمل مع السجلات:

الإجراء	الوصف
Copy	نسخ كل السجلات الظاهرة إلى الحافظة كنص عادي
Download	تصدير السجلات كملف `.txt` مع الطوابع الزمنية
Clear	مسح كل السجلات من العرض الحالي
Refresh	جلب أحدث السجلات يدوياً من الخادم

مسح السجلات يزيلها من عرضك الحالي فقط. لا يحذف سجل السجلات على الخادم.

حاويات متعددة

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

الخطوات التالية