يتضمن تطبيق IBM® Enterprise Records ملف نموذج log4j.properties الذي يمكن توصيفه.
الملف log4j.properties يوجد في الحافظة ier_install_path\ RecordsManagerSweep، ويمكنك توصيف طريقة عمل التسجيل من خلال تحديد القيم في الملف لما يلي:
يتم تخصيص مستوى معين لكل من أدوات التسجيل في الملف log4j.properties. اذا لم تقم بتخصيص مستوى لأداة التسجيل، فسيقوم log4j آليا بتخصيص المستوى لأداة التسجيل الرئيسية وذلك لأدوات التسجيل الغير مخصصة. وبصفة مفترضة، يتم تخصيص المستوى WARN لأداة التسجيل.
ويمكن توصيف الملف log4j.properties بمحددات مختلفة من أداة التسجيل، وأداة الالحاق، والشكل العام. ويجب أن يكون الملف log4j.properties متاحا للتطبيق أثناء التشغيل من مسار الفئة. ويمكن التعقيب على الادخالات في نفس الملف من خلال تذييل العبارة بالرمز (#)؛ ولن يتم تنفيذ الادخالات التي تم تعليمها بالرمز (#) أثناء التشغيل.
لفتح الملف log4j.properties، قم بالانتقال الى الحافظة ier_install_path\RecordsManagerSweep، ثم قم بفتح الملف باستخدام أحد برامج تحرير النصوص.
ويجب أن تقوم أولا بتحديد أداة التسجيل. ويمكن أن يكون لديك عدد من أدوات التسجيل لتصنيف نوع التسجيل المطلوب للتطبيق. لاتاحة التسجيل لكل الفئات من com.filenet.rm ومجموعات البرامج الفرعية الخاصة بها، قم بتحديد أداة التسجيل كما هو موضح في العبارة التالية:
log4j.logger.com.filenet.rmor
ويمكن تحديد أي اسم لأداة التسجيل. على سبيل المثال، يمكنك تسمية أداة التسجيل APILOG الخاصة بك كما هو موضح في العبارة التالية:
log4j.logger.com.filenet.rm=warn, APILOG
ويجب أن توقم بتحديد مستوى التسجيل لتحديد مستوى التفاصيل للرسائل التي سيتم تسجيلها من خلال log4j عند التشغيل. ويدعم log4j خمس من المستويات العادية من التسجيل كما هو موضح في الجدول التالية.
المستوى | الوصف |
---|---|
DEBUG | يحدد أحداث اعلامية غنية والتي يمكن الاستفادة منها بأقصى درجة في تصحيح الأخطاء الخاصة بالتطبيق. |
INFO | تحدد الرسائل الاعلامية التي تقوم باظهار التطور في التطبيق على مستوى رديء. |
WARN | يحدد المواقف الخطرة المحتملة. |
ERROR | يحدد أحداث الخطأ التي قد تسمح للتطبيق بالاستمرار في التشغيل. |
FATAL | لتحديد أحداث الخطأ الجسيم التي من المحتمل أن تقوم بايقاف التطبيق. |
أنظر لمطبوعات الفنية الى log4j على موقع الانترنت الى Apache للحصول على معلومات عن مستويات التسجيل المهبأة والخاصة. ويصفة مفترضة، يتم بدء التطبيق في المستوى WARN. وهذا يمكن تعديله الى المستويات DEBUG أو INFO أو ERROR أو WARN أو FATAL عند التشغيل. ويمكن أيضا تضمين العديد من عبارات أداة التسجيل، كل لنفس أداة التسجيل ولكن بمستويات مختلفة (مثل DEBUG لأحدها، و WARN لآخر). ويمكن التعقيب على واحد أو آخر في نفس الملف النموذج من خلال تذييل العبارة بالرمز (#)؛ والتنقل بين المستويات DEBUG و WARN. ولن يتم تنفيذ الادخالات التي تم تعليمها بالرمز (#) أثناء التشغيل. وأي أداة التسجيل تفتقد لأحد المستويات ستقوم بتوارث المستوى الخاص بأداة التسجيل الرئيسية. وبصفة مفترضة، يتم تخصيص المستوى WARN لأداة التسجيل RM API في IBM Enterprise Records.
يتم ارفاق أداة التسجيل مع واحد أو أكثر من أدوات الالحاق لاتاحة كتابة الرسائل التي يتم تسجيلها في وسط المخرجات. ويمكن أن تقوم بتحديد أنواع مختلفة من أدوات الالحاق بالملف log4j.propertiesالذي يقوم بارسال معلومات السجل الى مكان المخرجات المحدد. الجدول التالي يقدم كشف بكل أدوات الالحاق التي يتم استخدامها في الملف log4j.properties مع وصف وصف مختصر والاختيارات المتعلقة.
أداة الالحاق | الوصف ومقاطع الكود |
---|---|
NTEventLogAppender | للالحاق الى Microsoft Windows NT Event Log. يمكن تركيب واستخدام أداة الالحاق هذه على نظام Windows. log4j.appender.APILOG=org.apache.log4j.nt.NTEventLogAppender |
ConsoleAppender | لالحاق رسائل السجل بالملف System.out (وهو المفترض) أو System.err باستخدام الشكل العام الذي يتم تحديده من خلال المستخدم. log4j.appender.APILOG=org.apache.log4j.ConsoleAppender الاختيارات:
|
FileAppender | لالحقا رسائل السجل الى أحد الملفات. log4j.appender.APILOG=org.apache.log4j.FileAppender الاختيارات:
|
RollingFileAppender | لتمديد FileAppender لعمل نسخة احتياطية من ملفات السجل عند وصولها الى مستوى معين. log4j.appender.APILOG=org.apache.log4j.RollingFileAppender الاختيارات:
|
يمكن أن تقوم بتحديد شكل عام مختلف في الملف log4j.properties التي تقوم بتحديد نسق رسالة السجل. يمكنك تحديد أن رسائل السجل تتضمن التاريخ والوقت واسم وحدة البرامج واسم سلسلة العمليات وهكذا. يتم استخدام محددات التوصيف هذه عند التشغيل أثناء تسجيل الرسالة.
الجدول التالي يقدم كشف بكل الأشكال العامة التي يتم استخدامها في IBM Enterprise Records الملف log4j.properties مع وصف وصف مختصر والاختيارات المتعلقة.
الشكل العام | الوصف ومقاطع الكود |
---|---|
SimpleLayout | لطباعة المستوى، ثم شرطة (-) متبوع بنص رسالة السجل. org.apache.log4j.SimpleLayout |
PatternLayout | النسق تقوم بتسجيل الأحداث طبقا لنموذج التحويل المحدد. تتكون نماذج التحويل من نص حرفي ومحددات التحويل. النص الحرفي يمثل المخرجات كما هي. محددات التحويل تتكون من الحرف % متبوع بأحد أدوات التعديل للنسق الاختياري وحرف التحويل الالزامي. على سبيل المثال، %-5p [%t]: %m%n هو نموذج التحويل والذي يتكون من الأولوية (المستوى a.k.a.) لمحدد التحويل متبوع بالحرف النصي " ["، ومتبوع بسلسلة من محددات التحويل، متبوعة بالحرف النصي "]: " متبوعة بمحدد الرسالة للرسالة وحرف الفاصل الذي يكون على أساس النظام. org.apache.log4j.PatternLayout الاختيارات:
|
HTMLLayout | لتنسيق المخرجات كجدول HTML. org.apache.log4j.HTMLLayout الاختيارات:
|
لتنسيق المخرجات في صورة HTML. org.apache.log4j.xml.XMLLayout الاختيارات:
|
الملف log4j.properties الذي يتم تحديده من خلال IBM Enterprise Records يقوم باستخدام PatternLayout لنسق رسالة السجل. الجدول التالي يحدد كشف بنماذج التحويل التي يمكن نشرها في ملف التوصيف مع الوصف المختصر الخاص بها.
النموذج | الوصف |
---|---|
%t | اسم سلسلة العمليات التي تشكل طلب السجل |
%c | اسم أداة التسجيل الخاصة بطلب السجل |
%-60c | ضبط يسار لاسم أداة التسجيل في نطاق 60 مساحة بحد أدنى |
%r | عدد الملي ثانية المنقضية منذ بدء التطبيق |
%p | مستوى عبارة السجل |
%m | الرسالة |
%Time | الوقت الذي سيتم به التسجيل |
%d | تاريخ تسجيل الحدث |
%n | سطر جديد |
عبارة الكود التالية توضح كيفية اتاحة PatternLayout وتحديد نموذج تحويل بسيط:
log4j.appender.APILOG.layout=org.apache.log4j.PatternLayout log4j.appender.APILOG.layout.ConversionPattern=%-5p %d {dd MMM yyyy HH:mm:ss,SSS}, -%m, %r, [%M] % n
على سبيل المثال:
WARN, 20 Jun 2005 14:48:20,900, -[enter] getObjectStoreXML(ObjectStores), 102042, [setLoggerMessage] WARN, 20 Jun 2005 14:48:21,100, -[exit] getObjectStoreXML(ObjectStores), 102342, [setLoggerMessage]