كيفية تكوين Log4Net لتسجيل رسائل مستوى Info فقط

يعتبر التسجيل جزءًا أساسيًا من تطوير البرمجيات، حيث يساعد المطورين على تصحيح الأخطاء وحل المشكلات بكفاءة. ومع ذلك، يمكن أن تكون السيطرة على ما يتم تسجيله مهمة صعبة. إذا كنت تبحث عن طريقة لتكوين Log4Net لتسجيل الرسائل بمستوى Info فقط، فأنت في المكان المناسب! في هذه المقالة، سنرشدك عبر الخطوات اللازمة لتحقيق ذلك باستخدام قدرات Log4Net.

المشكلة: الرغبة في تسجيل معلومات فقط

قد تكون قد قمت بتكوين Log4Net لتسجيل المستوى Info، ولكن لا تزال تلاحظ أن الرسائل على مستويات مختلفة (مثل Debug أو Warn) يتم تسجيلها أيضًا. مما يطرح السؤال: هل من الممكن تقييد Log4Net لتسجيل سجلات مستوى Info فقط؟ الإجابة هي نعم! مع التكوين الصحيح، يمكنك تصفية أي تسجيل غير ضروري والحفاظ على مخرجات تسجيل نظيفة.

فهم تكوين Log4Net

لتكوين Log4Net بفعالية، من المهم فهم هيكله. يتم عادةً تحديد تكوين التسجيل في شكل XML. إليك مثال على إعداد قد تمتلكه:

<logger name="BrokerCollection.Model.XmlDocumentCreationTask">
  <appender-ref ref="SubmissionAppender"/>
  <level value="Info" />
</logger>

في هذا المقتطف، يمكنك أن ترى أن المسجل مضبوط على مستوى Info، لكن هذا بمفرده لا يقوم بتصفية السجلات التي هي أقل من هذا المستوى. لتحقيق هدفك المتمثل في تسجيل معلومات فقط، يجب أن نقدم فلترًا داخل مرفق.

الحل: استخدام فلتر نطاق المستوى

لتقييد Log4Net لتسجيل رسائل مستوى Info فقط، يمكنك تنفيذ LevelRangeFilter داخل تكوين المرفق. إليك كيفية إعداد ذلك:

مثال على التكوين

يمكنك تعديل تعريف المرفق كما يلي:

<appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
    <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="INFO"/>
        <param name="LevelMax" value="INFO"/>
    </filter>
    ...
</appender>

في هذا التكوين:

• LevelMin: يحدد الحد الأدنى لمستوى الرسائل التي ترغب في تسجيلها (INFO في حالتنا).
• LevelMax: يحدد الحد الأقصى لمستوى الرسائل التي ترغب في تسجيلها (أيضًا مضبوط على INFO لضمان تسجيل هذه السجلات فقط).

خطوات التنفيذ

1. حدد موقع ملف تكوين Log4Net الخاص بك: عادة ما يكون هذا ملف XML حيث يتم تعريف المرفقات والمسجلين.
2. حدد المرفق الذي تستخدمه: تأكد من تعديل المرفق الصحيح.
3. أضف الفلتر: استخدم LevelRangeFilter كما هو موضح أعلاه لتقييد التسجيل بسجلات مستوى Info فقط.
4. اختبر التكوين: قم بتوليد سجلات على مستويات مختلفة للتأكد من أنه يتم التقاط سجلات Info فقط.

الخاتمة

من خلال الاستفادة من LevelRangeFilter في تكوين Log4Net الخاص بك، يمكنك بفعالية تحديد مخرجات تسجيلك لتظهر فقط الرسائل المهمة والمفيدة. يسهل ذلك إدارة السجلات، خاصة في التطبيقات الكبيرة حيث يمكن أن يؤدي التسجيل الزائد إلى الفوضى والارتباك.

الآن، يمكنك تنفيذ هذا التكوين في إعداد Log4Net الخاص بك. تسجيل سعيد!