IBM FileNet P8, النسخة 5.1.+            

توصيف التسجيل في Workplace XT

يقوم IBM® FileNet Workplace XT باستخدام Apache log4j لادارة عملية التسجيل. وأثناء التسجيل، يتم كتابة المعلومات الخاصة بأنشطة التطبيق في أماكن المخرجات مثل شاشة التحكم الرئيسية أو الملفات. يقوم الأشخاص المسئولين عن تقديم الدعم وخدمات التطوير باستخدام المعلومات الموجودة في ادخالات السجل لتحليل أنشطة التطبيق بالاضافة الى تشخيص وحل المشاكل. التسجيل يختص بأغراض التشخيص فقط ولا يقدم أي معلومات للسرية أو المراجعة.

يتم تركيب البرنامج log4j أثناء تركيب Workplace XT. وبصفة مفترضة، لا يتم اتاحة التسجيل أثناء عملية التركيب.

لاتاحة أو الغاء اتاحة التسجيل:

  1. الانتقال الى حافظة توصيف Workplace XT التي يتم تحديدها أثناء عملية التركيب. المسار المفترض هو: Workplace XT حافظة التوصيف التي يتم تحديدها أثناء عملية التركيب. المسار المفترض هو:
    • Windows: <drive>:\Program Files\FileNet\Config\WebClient
    • UNIX: /opt/FileNet/config/WebClient
  2. قم باتاحة أو الغاء اتاحة التسجيل من خلال اعادة تسمية ملف التوصيف. نموذج ملف التوصيف لعملية التسجيل يسمى __log4j.properties.
    • لاتاحة التسجيل، أعد تسمية __log4j.properties الى log4j.properties.
    • لالغاء اتاحة التسجيل، أعد تسمية log4j.properties الى اسم آخر؛ على سبيل المثال __log4j.properties.
  3. أعد بدء التطبيق ليظهر تأثير التغييرات الخاصة بك.

توصيف محددات التسجيل

ملف النموذج 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 للحصول على المزيد من المعلومات عن المستويات.

جدول 1. يقدم هذا الجدول شرح لمستويات التسجيل القياسية INFO و WARN و ERROR و FATAL بالاضافة الى المستويات ALL و OFF.
المستوى الوصف
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 Common Base Event ‏(CBE)‏. حيث أن القيام بذلك يؤدي الى جعل عملية التحويل البياني للمخرجات غير مقروءة باستخدام أدوات IBM Support Assistant. tools.

تحليل المخرجات

المسئول عن الدعم الفني يمكن أن يقوم باختبار الادخالات في ملف السجل لتحليل أنشطة التطبيق وتشخيص المشاكل التي تحدث في التطبيق. بالاضافة الى ذلك، يؤدي استخدام أدوات ‏‎IBM Support Assistant ‎(ISA)‎‏ الى التشغيل الآلي لمرحلة التحليل. الأدوات ISA تستخدم ادخالات CBE في تسجيل المخرجات من log4j.

يمكنك أيضا استخدام أحد الأدوات مثل Apache Chainsaw أو برنامج مشاهدة السجل على أساس واجهة تعامل بيانية لاختبار ادخالات السجل خلاف CBE بنفسك.



تعليق توضيحي

آخر تحديث: يوليو 2011


© .IBM حقوق النشر لشركة 2011.
يتم تشغيل مركز المعلومات هذا من خلال تقنيات Eclipse. ‏‎(http://www.eclipse.org)‎‏