يقوم IBM® FileNet Workplace XT باستخدام Apache log4j لادارة عملية التسجيل. وأثناء التسجيل، يتم كتابة المعلومات الخاصة بأنشطة التطبيق في أماكن المخرجات مثل شاشة التحكم الرئيسية أو الملفات. يقوم الأشخاص المسئولين عن تقديم الدعم وخدمات التطوير باستخدام المعلومات الموجودة في ادخالات السجل لتحليل أنشطة التطبيق بالاضافة الى تشخيص وحل المشاكل. التسجيل يختص بأغراض التشخيص فقط ولا يقدم أي معلومات للسرية أو المراجعة.
يتم تركيب البرنامج log4j أثناء تركيب Workplace XT. وبصفة مفترضة، لا يتم اتاحة التسجيل أثناء عملية التركيب.
لاتاحة أو الغاء اتاحة التسجيل:
توصيف محددات التسجيل
ملف النموذج log4j.properties له مجموعة من الاختيارات المفترضة، يتم تحديدها في أزواج keyword=value. لتغيير القيم المفترضة، قم بفتح log4j.properties باستخدام برنامج تحرير النصوص، قم باجراء التعديلات كما يلزم، ثم قم بحفظ الملف. يمكنك توصيف محددات التسجيل في أي وقت بعد عملية التركيب. سيتم التعرف على التغييرات التي تقوم بها في ملف توصيف التسجيل آليا؛ ولا يتطلب الأمر أن تقوم باعادة بدء التطبيق أو وحدة خدمة التطبيق.
الموضوعات التالية تقدم بعض المعلومات الخاصة ببعض اختيارات التوصيف التي ستشاهدها في الملف. للحصول على المزيد من المعلومات عن اختيارات التسجيل، يمكنك الرجوع الى موقع Apache على الانترنت (http://apache.org) تحت Logging Project، وموقع تسجيل Apache على الانترنت (http://logging.apache.org/log4j/).
أداة التسجيل
تقوم أداة التسجيل بتسجيل الطلبات الى أدوات الالحاق. في الملف log4j.properties، تقوم الكلمة المرشدة الأولى بتحديد أداة التسجيل الرئيسية. أداة التسجيل الرئيسية هي أداة التسجيل في أعلى مستوى بالتسلسل الهرمي وتقدم المفترضات الشاملة؛ وأي من أدوات التسجيل الفرعية التي ليس لها نفس مجموعة الاختيارات تتوارث طريقة عملها من أداة التسجيل الرئيسية.
أداة الالحاق
يمكنك تحديد المكان الذي سيتم كتابة بيانات السجل فيه من خلال توصيف أداة الحاق، والتي تقوم بارسال ادخالات السجل المنسقة الى جهة المخرجات المستهدفة. أنواع الجهات المستهدفة يمكن أن تكون ملف أو شاشة التحكم الرئيسية؛ ويمكن اعادة توجيه المخرجات الى سجل Windows Event، ويتم توجيهه الى وحدة خدمة log4j عن بعد، وهكذا. (أنظر المطبوعات الفنية الى Apache log4j للتعرف على اختيارات التنسيق والجهات المستهدفة.) أداة التسجيل الواحدة يمكن أن يكون لها أكثر من أداة الحاق واحدة. على سبيل المثال، يمكنك كتابة المخرجات الى شاشة التحكم الرئيسية والى ملف في نفس الوقت. مع العلم بأن زيادة عدد الجهات المستهدفة يمكن أن يؤثر على الأداء.
في Workplace XT، يتم توصيف اثنين من أدوات الالحاق بصفة مفترضة. تقوم احدى أدوات الالحاق بكتابة بيانات السجل بنسق IBM Common Base Event (CBE)، والذي يتم استخدامه بواسطة أدوات IBM Support Assistant لتشغيل السجل، وتقوم الأخرى بالكتابة بالنسق الذي يمكن قراءته من خلال الأشخاص. ويكن تغيير ذلك فيما بعد لتقليل عدد المخرجات، أو يمكن ايقاف أداة الحاق هذه بالكامل.
المستوى
مستوى التسجيل الذي تقوم بتحديده يحدد النوع ومقدار المعلومات التي يتم تجميعها. يوجد ارتباط مباشر بين كمية المعلومات التي تم تجميعها وتأثير الأداء على النظام.
يدعم تطبيق Workplace XT للتسجيل المستويات القياسية INFO و WARN و ERROR و FATAL بالاضافة الى المستويات ALL و OFF. الجدول التالي يقدم شرح ملخص للمستويات القياسية؛ أنظر المطبوعات الفنية الى Apache log4j للحصول على المزيد من المعلومات عن المستويات.
المستوى | الوصف |
---|---|
INFO | الرسائل الاعلامية للطلبات التي تقوم بتوضيح التطور في التطبيق على مستوى رديء. |
WARN | لطلب التسجيل للمواقف الخطرة المحتملة. |
خطأ | لتسجيل الاعتراضات والحالات الاستثنائية التي تنشأ في التطبيق. |
FATAL | لتسجيل الأحداث الحرجة فقط من الأحداث التي يمكن أن تؤدي بالضرورة الى فشل في التطبيق. |
المستوى الذي تقوم بتحديده يحدد حجم المعلومات التي سيتم تجميعها. يوجد ارتباط مباشر بين كمية المعلومات التي تم تجميعها وتأثير الأداء على النظام.
نسق ملف المخرجات
عند توصيف أداة الالحاق، يمكنك استخدام محددات الشكل العام لتحديد النسق الذي تريد كتابة البيانات به. ويمكن تحديد PatternLayout أو ConversionPattern. حيث PatternLayout تقوم بتحديد نموذج معين لتسجيل الادخالات، وتقوم ConversionPattern، بتعريف النموذج الخاص بالعناصر التي سيتم كتابتها في أداة الحاق، التي تقوم بتعريف النموذج. ويجب ملاحظة هذا المثال:
log4j.appender.ErrorOutputFile=org.apache.log4j.RollingFileAppender log4j.appender.ErrorOutputFile.layout=org.apache.log4j.PatternLayout log4j.appender.ErrorOutputFile.layout.ConversionPattern=%d [%t] - %-5p %m\r\n
ينتج عند ادخال السجل المنسق التالي:
2007-05-31 17:36:12:801 [cwrap] - Document/Checkin ConnectionWrapper.send send.before
للحصول على المزيد من المعلومات عن اختياارت التنسيق، يمكنك الرجوع الى المطبوعات الفنية الى Apache log4j.
تحليل المخرجات
المسئول عن الدعم الفني يمكن أن يقوم باختبار الادخالات في ملف السجل لتحليل أنشطة التطبيق وتشخيص المشاكل التي تحدث في التطبيق. بالاضافة الى ذلك، يؤدي استخدام أدوات IBM Support Assistant (ISA) الى التشغيل الآلي لمرحلة التحليل. الأدوات ISA تستخدم ادخالات CBE في تسجيل المخرجات من log4j.
يمكنك أيضا استخدام أحد الأدوات مثل Apache Chainsaw أو برنامج مشاهدة السجل على أساس واجهة تعامل بيانية لاختبار ادخالات السجل خلاف CBE بنفسك.