الملخص
تتيح لك ميزة سجلات وحالة التكامل (Integration Logs and Status) مراجعة سجل تشغيل تكاملات حساب معيّن ورؤية حالة كل مهمة تكامل. تحمل كل مهمة حالة واحدة من: waiting، أو in_process، أو succeeded، أو failed، أو canceled، أو locked، إلى جانب سجلها ومحاولاتها، ويسجّل سجل تدقيق (audit record) تغييرات التهيئة. يوضح هذا المقال كيفية قراءة هذه السجلات وتفسير كل حالة.
مقدمة
تنقل تكاملات KnowledgeCity بيانات فعلية — المستخدمين، والتسجيلات، والنتائج — بين المنصة والأنظمة الخارجية المتصلة. يعمل كل إجراء تكامل كمهمة تعمل في الخلفية، وتُعد واجهة Logs المكان الذي تراقب فيه تشغيل هذه المهام وتتأكد من انتهائها كما هو متوقع.
يستخدم هذه الواجهة بشكل أساسي فرق دعم العملاء والعمليات (Customer Support and Operations). عندما تتعطل مزامنة أو تفشل أو تُنتج نتائج غير متوقعة، تُعد السجلات والحالات أول مكان يجب النظر إليه لفهم ما حدث ولماذا.
المفاهيم الأساسية
- المهمة (Job) — مهمة تكامل واحدة (مثل استيراد مستخدمين) تعمل في الخلفية، ولكل منها حالتها وسجلها الخاصان.
- الحالة (Status) — الوضع الحالي للمهمة: waiting، أو in_process، أو succeeded، أو failed، أو canceled، أو locked.
- السجل (Log) — السجل الخاص بكل مهمة والذي يوضح ما قامت به، ويُستخدم للتحقيق في سبب سلوكها بالطريقة التي سلكتها.
- المحاولات (Attempts) — عدد المرات التي جُرّبت فيها المهمة، وهو ما يساعدك على رصد المهام التي تُعيد المحاولة بشكل متكرر أو المتوقفة.
- المُعالج (Handler) — العملية التي تُشغّل المهمة، وتحدد نوع عمل التكامل الذي تم تنفيذه.
- سجل التدقيق (Audit record) — سجل تاريخي لتغييرات تهيئة التكامل الخاصة بالحساب، مفيد للتأكد من الشخص الذي غيّر شيئًا ما وموعد ذلك.
الخطوات المطلوبة
فتح واجهة السجلات
انتقل إلى التكامل الخاص بالحساب الذي تُحقّق فيه وافتح تبويب Logs الخاص به. تعرض هذه الواجهة مهام التكامل مع الحالة والسجل لكل تشغيل، بحيث يمكنك مراجعة سجل تشغيل التكامل للحساب في مكان واحد.
قراءة حالة المهمة
تعرض كل مهمة Status يوضح موضعها في دورة حياتها. فسّر الحالات كما يلي:
- waiting — المهمة في قائمة الانتظار ولم تبدأ التشغيل بعد.
- in_process — المهمة قيد التشغيل حاليًا.
- succeeded — اكتملت المهمة بنجاح.
- failed — لم تكتمل المهمة؛ افتح سجلها لمعرفة السبب.
- canceled — تم إيقاف المهمة قبل اكتمالها.
- locked — المهمة مُعلّقة وغير مؤهلة للتشغيل في الوقت الحالي.
فحص السجلات والمحاولات
عندما لا تنتهي المهمة كما هو متوقع، افتح Log الخاص بها لرؤية تفاصيل التشغيل، وتحقق من Attempts لمعرفة عدد المرات التي جُرّبت فيها. يُعد ارتفاع عدد المحاولات لمهمة بحالة failed أو locked إشارة قوية على أن المزامنة تحتاج إلى انتباه.
مراجعة سجل التدقيق
بالإضافة إلى سجل التشغيل، استخدم Audit Log الخاص بالتكامل لمراجعة تغييرات التهيئة الخاصة بالحساب. يُعد هذا مفيدًا عندما تبدأ المزامنة بالتصرف بشكل مختلف وتحتاج إلى التأكد من ما إذا كان قد تم تغيير إعداد ما مؤخرًا، ومن قام بذلك.
ملاحظة: تُزامن مهام التكامل بيانات فعلية للمستخدمين والدورات مع الأنظمة الخارجية. راجع دائمًا سجل المهمة وتأكد من السبب قبل إعادة تشغيل المزامنة أو تغيير حالتها.
الخاتمة
تُعد واجهة السجلات والحالة النافذة التشغيلية على تكاملات الحساب: فهي تعرض حالة كل مهمة وسجلها ومحاولاتها، وتربط سجل التشغيل بسجل تدقيق لتغييرات التهيئة. تُعد قراءة هذه الحالات والسجلات أسرع طريقة للتأكد من نجاح مزامنة ما — أو لتشخيص مزامنة لم تنجح.