إدارة الأخطاء

وحدة تحكم إدارة الأخطاء (EMC)

توفر علامة تبويب Error Monitor في تطبيق DQS واجهة مخصصة لمراقبة وحل الأخطاء التي تحدث أثناء معالجة الفحص. تمنح رؤية كاملة لفشل الدُفعات وأخطاء الاستراتيجيات ومشكلات المنصة — كل ذلك في مكان واحد.

التخطيط

تستخدم وحدة تحكم إدارة الأخطاء تخطيطًا من 3 مناطق:

• الشريط الجانبي للفلاتر (يسار) — تصفية الأخطاء حسب نوع الخطأ والفئة المصدر ورسالة الخطأ والنطاق الزمني (من/إلى) وعنوان IP. يُجمّع قسم Breakdowns الأخطاء حسب النوع أو المصدر أو معايير أخرى، مع عرض الأعداد بجانب كل فئة لتسريع الفرز.
• جدول سجل الأخطاء (وسط) — جدول قابل للفرز يسرد جميع الأخطاء مع أعمدة ملخص. يعرض إجمالي عدد الأخطاء عبر ثلاث نوافذ زمنية: آخر 24 ساعة وآخر 7 أيام والمنتهية صلاحيتها قريبًا. انقر على أي صف لعرض التفاصيل الكاملة.
• لوحة الإجراءات (يمين) — تحديث السجل وإنشاء تصدير CSV قابل للتنزيل وحذف الإدخالات المحددة وتهيئة فترة الاحتفاظ.

جدول سجل الأخطاء

يعرض كل صف خطأ في الجدول الأعمدة التالية:

العمود	الوصف
Error ID	معرّف فريد لإدخال سجل الخطأ
Type	فئة الخطأ (مثل DML_FAILED وQUERY_FAILED وFIELD_INSERT_FAILED وBATCH_EXECUTE_FAILED)
Message	وصف مختصر للخطأ (مقتطع — انقر على الصف لرؤية الرسالة الكاملة)
Source	فئة Apex التي أنشأت الخطأ (مثل DQS_ExportFileService وDQS_DynamicQueryBuilder01)
Event Time	الطابع الزمني لوقت حدوث الخطأ

يعرض أعلى الجدول عدادات إجمالية — Total Errors وLast 24 Hours وLast 7 Days وExpiring Soon — مما يمنحك نظرة سريعة على الحالة العامة.

نافذة تفاصيل الصف

انقر على أي صف خطأ لفتح نافذة تفصيلية تعرض السياق الكامل:

• Error ID وType (مُبرَّزان باللون الأحمر لتسهيل التعرف)
• Source — فئة Apex المصدر
• uniqueIdentifier_01 — معرّف السجل أو الدُفعة المرتبطة
• Insert Type — ما إذا كانت العملية إدراجًا أو تحديثًا أو نوعًا آخر من DML
• Event Time وFirst Event Time — الطوابع الزمنية لحدوث الخطأ
• Message — رسالة الخطأ الكاملة بما في ذلك نوع استثناء Salesforce (مثل System.AsyncException وSystem.DmlException)
• Stack Trace — تتبع مكدس Apex الكامل لأغراض التصحيح

مصادر الأخطاء

المصدر	أمثلة
المعالجة الدُفعية	تجاوز حدود governor، انتهاء مهلة الاستعلام
استراتيجية البُعد	وصول غير صالح للحقل، مؤشر فارغ في منطق الاستراتيجية
أحداث المنصة	فشل نشر الحدث
الجدولة	مشكلات تعبير CRON، أخطاء الصلاحيات

تكامل أحداث المنصة

يستخدم DQS أحداث المنصة DQS_Processing_Error__e لعرض الأخطاء في الوقت الفعلي. عند حدوث خطأ أثناء المعالجة الدُفعية:

1. يتم التقاط الخطأ وتسجيله
2. يتم نشر حدث منصة
3. تستقبل EMC الحدث وتعرضه

هذا يستبدل كتل catch الصامتة بإبلاغ مرئي عن الأخطاء.

احتفاظ الأخطاء

يتم حذف سجلات الأخطاء تلقائيًا بناءً على فترة الاحتفاظ المهيأة. الاحتفاظ الافتراضي هو 7 أيام.

لتغيير فترة الاحتفاظ، استخدم قسم Retention Configuration في لوحة الإجراءات على الجانب الأيمن من وحدة التحكم. أدخل عدد الأيام المطلوب في حقل Error Log Retention (days) وانقر على Save. ستُحذف سجلات الأخطاء الأقدم من الفترة المحددة تلقائيًا. تُنشر التغييرات عبر Metadata API وقد تستغرق لحظة لتصبح سارية المفعول.

أفضل الممارسات

• تحقق من EMC بانتظام بعد إعداد تعريفات فحص جديدة
• راجع الأخطاء بعد تغيير تكوينات القدرات
• استخدم أنماط الأخطاء لتحديد المشكلات المنهجية (مثل صلاحيات الوصول للحقول)
• استخدم عداد Expiring Soon لمراجعة الأخطاء قبل حذفها تلقائيًا
• صدّر سجلات الأخطاء إلى CSV قبل انتهاء صلاحيتها إذا كنت بحاجة إلى الاحتفاظ بها لتحليل أطول
• تواصل مع الدعم إذا استمرت أخطاء المنصة عبر عمليات فحص متعددة